Workshop은 두 가지 기능을 제공하여 다른 Workshop 모듈에 포함할 수 있는 기능을 지원합니다: Embedded Module 위젯과 Loop 섹션 레이아웃("루프 레이아웃").
이러한 기능은 다른 Workshop 모듈 내에 포함될 수 있는 Workshop 모듈을 구축할 수 있습니다. 포함된 모듈은 Workshop이 제공하는 모든 기능을 지원하지만, 포함된 모듈과 포함하는 모듈 간의 상호 작용에는 일부 제한 사항이 있습니다. 이 문서에서는 때때로 다른 모듈을 포함하는 모듈을 "부모" 모듈이라고 하고, 포함된 모듈을 "자식" 모듈이라고 합니다. 이 문서에서 "포함된 모듈"이라는 용어가 사용되면, 이는 Embedded Module 위젯과 Loop 레이아웃에 포함된 모듈 모두를 의미합니다. 따로 표시되지 않는 한.
포함된 모듈은 다음과 같은 여러 가지 유즈케이스를 가집니다:
포함된 모듈을 사용하면 하나의 자식 모듈을 구성하고 여러 부모 모듈에서 재사용할 수 있습니다. 구축할 수 있는 포함된 모듈의 예시로는 다음과 같은 것들이 있습니다:
루프 레이아웃 또는 개별 포함된 모듈 위젯을 통해 하나의 부모 모듈에서 여러 번 사용할 수 있는 포함된 모듈입니다. 같은 부모 모듈에서 여러 번 포함될 자식 모듈의 예시로는 다음과 같은 것들이 있습니다:
포함된 모듈은 더 큰 부모 모듈을 여러 자식 모듈로 나누어 더 나은 유지 관리성을 제공할 수 있습니다. 이를 통해 각 자식 모듈이 고유한 변수 범위를 가질 수 있고, 다른 Workshop 빌더가 동시에 각 자식 모듈을 편집할 수 있습니다.
포함된 모듈은 Marketplace와 함께 Workshop 모듈을 패키징할 때 사용자 정의 영역을 제공하는 데 사용할 수 있습니다. 포함된 자식 모듈은 종속성으로 패키징되며, 설치 시 Marketplace 사용자는 동일한 모듈 인터페이스 변수 유형 서명을 가진 모듈을 선택하여 설치된 부모 모듈의 일부를 사용자 정의할 수 있습니다.
포함된 모듈은 이벤트 전달 개념을 지원하지 않습니다. 이벤트 전달은 빌더가 부모 모듈에서 자식 모듈로 이벤트 구성을 전달할 수 있게 하여, 자식 모듈이 부모 모듈의 구성을 참조하는 이벤트를 호출할 수 있게 합니다(예: 자식 모듈이 부모 모듈에서 오버레이를 여는 이벤트 호출).
부모 모듈은 자식 모듈의 모듈 인터페이스 변수에 레이아웃 상태를 지원하는 변수를 전달하여, 자식이 부모의 레이아웃 상태를 수정할 수 있습니다.
Workshop의 다른 "Foundry 앱" 위젯과 마찬가지로, 다른 Workshop 모듈에서 사용하는 포함된 모듈의 출처는 Data Lineage에 의해 보고되지 않습니다.
모듈은 직접적으로 또는 자식 모듈 체인을 통해 자신을 포함할 수 없습니다. 자기 참조가 구성된 경우, 모듈은 빌더에게 경고를 표시하고 무한한 포함된 모듈 체인을 방지하기 위해 뷰어에게 아무 것도 표시하지 않습니다. 재귀 또는 자기 참조 포함된 모듈이 필요한 유즈케이스가 있는 경우 Palantir 대표에게 문의하십시오.
포함된 모듈은 고유한 권한 설정이 있는 별도의 리소스입니다. 사용자가 자식 모듈의 보기 권한이 없는 부모 모듈을 볼 수 있는 권한이 있는 경우, 사용자는 "모듈 로드 실패" 오류를 볼 것입니다.
포함된 모듈은 일반적인 Workshop 모듈과 유사한 성능 특성을 가져야 합니다. 주목할 만한 차이점은 포함된 모듈의 초기화가 포함된 모듈이 뷰에 표시될 때까지 지연된다는 것입니다. 초기화되면 포함된 모듈은 같은 위치에서 전체 모듈이 구성된 것처럼 실행될 것으로 예상됩니다.
자식 모듈 구성은 인스턴스당 한 번 초기화되며, 변수를 초기화하는 데 드는 비용이 있지만, 여러 인스턴스에서 재사용되는 경우 자식 모듈 구성은 한 번만 로드해야 합니다.
포함된 모듈과 루프 레이아웃의 사용으로 빌더가 매우 크고 복잡한 모듈을 구성하기 쉬워집니다. 빌더는 특히 로드하는 데 비용이 많이 드는 것들을 한 번에 표시되는 위젯과 변수의 총 수에 유의해야 합니다.
Embedded Module 위젯과 Loop 레이아웃은 모듈이 모바일 모드인 경우에만 다른 모바일 모듈을 포함할 수 있습니다.