프로그래밍 방식으로 사물에 속성 추가
AddPropertyDefinition 서비스는 사물, 사물 템플릿 또는 사물 형태에 새로운 로컬 또는 원격으로 바인딩된 속성을 생성하는 데 사용할 수 있습니다. 이 서비스에는 다음과 같은 매개 변수가 있습니다.
|
매개 변수
|
기본 유형
|
설명
|
|---|---|---|
|
이름
|
STRING
|
필수 사항입니다. 생성할 속성의 이름입니다.
|
|
type
|
BASETYPENAME
|
필수 사항입니다. 속성의 ThingWorx 기본 유형입니다. ThingWorx 기본 유형 목록은 사물 속성의 "기본 유형" 표를 참조하십시오.
|
|
description
|
STRING
|
속성의 설명입니다.
|
|
category
|
STRING
|
속성을 분류하는 카테고리 이름입니다.
|
|
dataShape
|
DATASHAPENAME
|
속성의 기본 유형이 인포테이블인 경우 속성에 사용되는 데이터 셰이프를 정의합니다.
• 서비스를 실행하려면 이 매개 변수에 대해 지정된 데이터 셰이프 엔티티가 존재해야 합니다.
• 이 매개 변수는 필수 매개 변수가 아닙니다. 그러나 데이터 셰이프가 지정되지 않은 상태로 Composer를 통해(설정 버튼 사용) INFOTABLE을 설정할 수 없습니다.
|
|
defaultValue
|
STRING
|
속성의 기본값을 지정합니다.
|
|
readOnly
|
BOOLEAN
|
속성이 읽기 전용이면 true이고, 그렇지 않으면 false입니다.
|
|
persistent
|
BOOLEAN
|
ThingWorx 서비스를 재시작할 때 값이 지속되면(값은 지속성 공급자에 저장됨) true이고, ThingWorx 서비스를 재시작할 때 값이 지워지면 false입니다.
|
|
logged
|
BOOLEAN
|
true이면 속성은 구성된 가치 스트림에 저장됩니다.
|
|
dataChangeType
|
STRING
|
로깅/경고 목적을 위해 속성 값의 변경 내용을 정의합니다. 항상, 없음, 켜기, 끄기 또는 값 중 하나입니다.
• 항상 - 속성 값 변경 시 변경 이벤트가 개시됩니다.
• 없음 - 속성 값 변경 시 변경 이벤트가 개시되지 않습니다.
• 켜기 - 대부분의 값에서 속성을 변경하면 Data Changed 이벤트가 개시됩니다.
• 끄기 - 새로운 값이 부울 '거짓'으로 평가되면 Data Changed 이벤트가 개시됩니다.
• 값 - 숫자 유형(NUMBER, INTEGER, LONG 등)의 경우 이전 속성 값과 새 속성 값 사이의 차이가 dataChangeThreshold 매개 변수에 지정된 허용치를 초과하면 변경 이벤트가 개시됩니다.
|
|
dataChangeThreshold
|
NUMBER
|
데이터 변경 이벤트를 개시하기 전에 숫자 속성을 변경해야 하는 최소 숫자입니다.
|
|
accessModifier
|
JSON
|
사물에 대한 액세스 가능성 또는 범위를 정의합니다.
|
원격 속성
원격으로 바인딩된 속성에 대한 추가 매개 변수가 있습니다. remoteBindingAspects의 배열로 지정됩니다.
 |
정의되는 속성이 원격 속성에 바인딩되지 않은 한 이러한 속성을 지정할 필요는 없습니다.
|
|
매개 변수
|
기본 유형
|
설명
|
||
|---|---|---|---|---|
|
remote
|
BOOLEAN
|
속성이 원격 속성에 바인딩된 경우 true이고 그렇지 않으면 false입니다. (기본값: false)
|
||
|
remotePropertyName
|
STRING
|
바인딩할 원격 사물의 속성 이름입니다.
|
||
|
cacheMethod
|
STRING
|
바인딩된 에지 속성 값을 읽는 방법:
• Read from server cache는 서버가 에지에 속성 값을 요청할 수 없도록 금지합니다. 값은 항상 서버 캐시에서 검색됩니다. 캐시된 값에 대한 업데이트는 속성의 dataChangeType 및 검색 속도에 따라 달라집니다. 속성에 대한 속성 설정이 에지에 없으면 서버가 에지에서 값을 가져올 수 없으므로 서버에 저장된 기본값만 반환합니다. 속성의 dataChangeType이 ALWAYS 또는 VALUE이면 cacheMethod의 기본값이 이 설정입니다.
• Fetch from remote every read는 모든 요청에 대해 에지에서 값을 검색합니다. 이 옵션과 관련된 캐싱은 없습니다. 속성의 dataChangeType이 NEVER이면 캐시 유형의 기본값이 이 설정입니다.
• Cached for specific time을 사용하면 에지에 대해 요청이 만들어지는 빈도를 제어할 수 있습니다. 첫 번째 요청 후 서버는 에지 장치의 속성에 액세스하여 해당 값을 가져옵니다. 정의된 cacheInterval이 만료될 때까지 에지에 대해 다른 요청이 만들어지지 않습니다. 해당 기간 동안 에지 장치가 푸시를 통해 서버의 값을 업데이트할 수 있습니다.
|
||
|
cacheInterval
|
NUMBER
|
cacheMethod가 Cached for specific time인 경우 속성 값을 가져오기 위해 요청이 에지로 전송되기 전에 서버가 속성 값을 캐시하는 시간(초)입니다. 값은 항상 첫 번째 요청 시 에지에서 검색됩니다.
|
||
|
timeout
|
INTEGER
|
원격 사물로부터의 응답을 기다리는 시간(초)입니다.
|
||
|
pushType
|
STRING
|
원격 장치에서 값이 푸시되는 방법을 정의합니다. 정의는 위의 dataChangeType과 비슷하며 항상, 없음, 켜기, 끄기 또는 값으로 설정합니다.
|
||
|
pushThreshold
|
NUMBER
|
데이터 변경이 원격 장치로 푸시되기 전에 숫자 유형 속성이 초과해야 하는 허용치를 정의합니다.
|