복합 구성 요소는 원자 구성 요소 집합, 다른 복합 구성 요소 집합 또는 원자 구성 요소와 복합 구성 요소의 조합을 포함할 수 있습니다. 복합 구성 요소에는 몇 가지 비즈니스 로직이 포함되어 있습니다. ThingWorx 포함된 매쉬업, SDK를 사용하여 작성된 위젯은 복합 구성 요소의 몇 가지 예입니다.

복합 구성 요소를 만드는 동안 다음 모범 사례를 사용하십시오.

복합 구성 요소는 다음 하위 구성 요소 전부 또는 일부로 구성됩니다.

복합 구성 요소를 사용할 때는 이러한 하위 구성 요소 중 하나가 최상위 구성 요소로 간주됩니다. 최상위 구성 요소는 복합 구성 요소에 대한 액세스 지점으로 사용됩니다.

복합 구성 요소는 하위 구성 요소의 계층 구조를 사용하여 최상위 구성 요소를 설정합니다. 다음 그림과 같이 하위 구성 요소 계층 구조에서 가장 높은 곳에 있는 것은 UI이고 그 아래에는 비즈니스 로직, 모델과 서비스, 데이터 어댑터가 순서대로 있습니다.

예를 들어, 복합 구성 요소에 대해 정의된 UI가 있으면 UI가 구성 요소에 대한 액세스 지점입니다. 복합 구성 요소에 UI가 없고 모델이 정의되어 있으면 모델과 서비스가 액세스 지점입니다. 구성 요소에 대해 UI나 모델이 정의되어 있지 않으면 데이터 어댑터가 액세스 지점입니다.

최상위 구성 요소 아래의 모든 하위 구성 요소를 사용자에게 제공하지 않는 것이 좋습니다.

다음과 같은 복합 구성 요소 유형을 사용할 수 있습니다.

구성 테이블, 매개 변수 또는 구성 매쉬업을 사용하여 복합 구성 요소를 구성할 수 있습니다. 구성 값은 최상위 구성 요소로 전달되고 최상위 구성 요소는 값을 종속성 계층 구조에 있는 다운스트림 구성 요소로 전달합니다. 예를 들어, 키-값 쌍이 있는 구성 테이블을 사용하여 구성 요소의 동작을 변경할 수 있습니다. 구성 테이블은 구성 요소 업그레이드에 포함되지 않습니다.

업그레이드를 지원하려면 복합 구성 요소와 해당 하위 구성 요소가 편집이 불가능해야 합니다. 하위 구성 요소를 업그레이드할 때 복합 구성 요소가 분리되지 않아야 합니다.

필요에 따라 복합 구성 요소를 확장하고 사용자 정의합니다. 자세한 내용은 구성 요소 확장 및 사용자 정의 단원을 참조하십시오.

예를 들어, 기본 제공된 포함된 매쉬업을 사용자 정의하고 확장하려 한다고 가정해 보겠습니다. 기본 제공되는 포함된 매쉬업은 편집이 불가능합니다. 이 포함된 매쉬업을 구성하고 확장하려면 구성 요소의 복사본을 만듭니다. 복사본을 사용자 정의하고 확장합니다. 구성 테이블이나 매개 변수를 사용하여 원래 포함된 매쉬업을 사용자 정의된 포함된 매쉬업으로 바꿉니다.