항목 수명 주기
Fabric UI에서 항목 만들기에 권장되는 흐름은 다음과 같습니다.
- 사용자에게 항목 이름을 묻는 메시지를 표시합니다.
- "빈" 항목을 만듭니다.
- 새 항목을 편집하고 저장합니다.
이 프로세스는 다음과 같은 단계로 나눌 수 있습니다.
사용자가 모든 유형의 항목을 만드는 버튼을 선택하면 Fabric FE(포털) 코드에서 해당 항목 편집기를 로드해야 합니다. Fabric FE는 Fabric BE에 대한 API 호출을 통해 현재 컨텍스트에 해당하는 원본 URL, Microsoft Entra ID 애플리케이션 세부 정보 및 워크로드 BE URL을 비롯한 필수 정보를 가져옵니다. 이 정보를 사용할 수 있게 되면 항목이 만들어집니다. 일반적으로 항목은 CDN에서 HTML, JavaScript, CSS 및 이미지와 같은 정적 리소스를 로드합니다. 다중 하위 지역 CDN 배포를 사용하고 원본 URL이 브라우저의 현재 위치에 물리적으로 가장 가까운 CDN 서버로 확인되도록 이름 확인을 구성하는 것이 좋습니다.
참고 항목
일반적으로 항목 편집기에서는 가능하면 편집 단계에서 워크로드 BE를 호출해야 합니다. 이를 위해서는 현재 컨텍스트에 따라 워크로드 BE URL을 확인해야 합니다. 현재 코드는 하드 코딩된 BE URL을 사용할 수 있습니다.
빈 항목 만들기
Fabric에서는 항목 이름을 제외한 사용자 입력 없이 항목을 만들 수 있도록 하는 것이 일반적인 관례입니다. 이러한 항목은 의미 있는 작업을 수행하리라 예상되지 않지만(따라서 "비어 있음"), 작업 영역에 표시되고 기본 흐름 및 작업에 참여할 수 있습니다. 또한 워크로드에서 설정한 적절한 기본값에 따라 작동할 수도 있습니다.
이 흐름은 사용자에게 새 항목의 이름을 제공하라는 메시지로 시작합니다. 이 이름의 iframe은 호스트 JS API를 호출하여 항목 만들기 흐름을 시작합니다. 이때 선택적 JSON 개체를 "만들기 페이로드"로 전달하고 호스트가 Fabric BE를 호출합니다. 인증은 호스트에 의해 처리됩니다. Fabric BE는 컨텍스트에 따라 워크로드 BE URL을 확인하고 CreateItem 워크로드 API를 호출하여 iframe에서 보낸 "만들기 페이로드"를 전달합니다. 워크로드 BE는 새 항목 메타데이터를 저장하고 일부 리소스를 할당할 수 있으며(이 단계는 나중으로 연기할 수 있음) 다른 관련 작업을 수행해야 합니다. 워크로드 BE 관점에서 항목 만들기가 완료되면 항목 메타데이터 변경 시 이를 Fabric BE에 알려야 합니다. 항목 메타데이터 업데이트 시 동일한 프로세스가 수행되어야 하므로 Fabric BE 대상 그룹에 대해 주체 토큰을 교환해야 합니다.
참고 항목
항목 메타데이터 업데이트를 알리기 위한 API는 현재 사용할 수 없습니다.
항목 로드
항목을 편집하려면 iframe에서 해당 메타데이터를 로드해야 합니다. 이 프로세스는 "빈" 항목 및 "초기화된" 항목을 로드하는 작업과 동일합니다. iframe은 Fabric BE를 호출하는 호스트 JS API를 호출하며, 이후 GetItemPayload 워크로드 API를 호출합니다. 워크로드 BE는 JSON 개체를 반환할 수 있으며, 이는 다시 iframe에 전달됩니다. 인증은 호스트에 의해 처리됩니다.
항목 편집
항목 메타데이터가 로드되면 편집 세션을 시작할 수 있습니다. 이 세션의 시작 또는 도중에 iframe은 워크로드 BE를 호출해야 할 수 있습니다(예: 구성 가져오기, UI 컨트롤 채우기, 유효성 검사 수행 등). 이를 위해 호스트 JS API에서 토큰을 요청해야 합니다.