설명서AEM as a Cloud Service사용 안내서

콘텐츠 조각 선택기 - 관련 속성 content-fragment-selector-related-properties

Last update: Wed Apr 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 적용 대상:
  • Experience Manager as a Cloud Service

작성 대상:

  • 관리자
  • 사용자

마이크로 프론트엔드 콘텐츠 조각 선택기를 사용하면 저장소에서 콘텐츠 조각을 찾아보거나 검색하고 애플리케이션에서 사용할 수 있습니다.

다음 속성을 사용하여 콘텐츠 조각 선택기를 렌더링하는 방법과 사용 방법을 사용자 지정할 수 있습니다.

콘텐츠 조각 선택기 속성 content-fragment-selector-properties

속성
유형
필수
기본값
설명
imsToken
문자열
아니요
인증에 사용되는 IMS 토큰입니다.
repoId
문자열
아니요
인증에 사용되는 저장소 ID.
orgId
문자열
예
인증에 사용되는 조직 ID입니다.
locale
문자열
아니요
로케일 데이터.
env
환경
아니요
콘텐츠 조각 선택기 배포 환경.
filters
조각 필터
아니요
콘텐츠 조각 목록에 적용할 필터. 기본적으로 /content/dam 아래의 조각이 표시됩니다. 기본값: { folder: "/content/dam" }
isOpen
부울
예
false
선택기 열기 또는 닫기를 트리거하는 플래그입니다.
onDismiss
() => void
예
취소 ​를 선택하면 호출할 함수입니다.
onSubmit
({ contentFragments: {id: string, path: string}[], domainNames: string[] }) => void
예

하나 이상의 콘텐츠 조각을 선택한 후 Select ​을(를) 사용하면 호출할 함수입니다.

함수가 받게 되는 값:

  • id 및 path 필드가 있는 선택된 콘텐츠 조각
  • 및 저장소의 프로그램 id 및 환경 id와 관련된 도메인 이름으로, 상태가 ready이고 게시가 tier입니다.

도메인 이름이 없으면 게시 인스턴스를 대체 도메인으로 사용합니다.

theme
"light" 또는 "dark"
아니요
콘텐츠 조각 선택기의 테마입니다. 기본 테마는 UnifiedShell 환경의 테마로 설정됩니다.
selectionType
"single" 또는 "multiple"
아니요
single
FragmentSelector에 대한 선택을 제한하는 데 사용할 수 있는 선택 유형입니다.
dialogSize
"fullscreen" 또는 "fullscreenTakeover"
아니요
fullscreen
대화 상자 크기를 제어하는 선택적 속성입니다.
waitForImsToken
부울
아니요
false
콘텐츠 조각 선택기가 SUSI 흐름 컨텍스트에서 렌더링되는지 여부를 나타내며 imsToken이(가) 준비될 때까지 기다려야 합니다.
imsAuthInfo
ImsAuthInfo
아니요
로그인한 사용자의 IMS 인증 정보가 포함된 개체입니다.
runningInUnifiedShell
부울
아니요
콘텐츠 조각 선택기가 UnifiedShell에서 실행 중인지 또는 독립 실행형인지 여부를 나타냅니다.
readonlyFilters
리소스 읽기 전용 필터 필드
아니요
콘텐츠 목록에 적용할 수 있고 제거할 수 없는 읽기 전용 필터.

ImsAuthProps 속성 imsauthprops-properties

ImsAuthProps 속성은 콘텐츠 조각 선택기에서 imsToken을(를) 가져오는 데 사용하는 인증 정보 및 흐름을 정의합니다. 이러한 속성을 설정하여 인증 플로우의 동작 방법을 제어하고 다양한 인증 이벤트에 대한 리스너를 등록할 수 있습니다.

속성 이름
설명
imsClientId
인증 용도로 사용되는 IMS 클라이언트 ID를 나타내는 문자열 값입니다. 이 값은 Adobe에서 제공하며 Adobe AEM CS 조직에만 해당됩니다.
imsScope
인증에 사용되는 범위를 설명합니다. 범위는 응용 프로그램이 조직 리소스에 대해 갖는 액세스 수준을 결정합니다. 여러 범위는 쉼표로 구분할 수 있습니다.
redirectUrl
인증 후 사용자가 리디렉션되는 URL을 나타냅니다. 이 값은 일반적으로 애플리케이션의 현재 URL로 설정됩니다. redirectUrl이(가) 제공되지 않으면 ImsAuthService에서 imsClientId을(를) 등록하는 데 사용되는 redirectUrl을 사용합니다.
modalMode
인증 흐름을 모달(팝업)로 표시할지 여부를 나타내는 부울. true(으)로 설정하면 인증 흐름이 팝업에 표시됩니다. false(으)로 설정하면 전체 페이지를 다시 로드할 때 인증 흐름이 표시됩니다.
참고: 더 나은 UX를 위해 사용자에게 브라우저 팝업이 비활성화된 경우 이 값을 동적으로 제어할 수 있습니다.
onImsServiceInitialized
Adobe IMS 인증 서비스가 초기화될 때 호출되는 콜백 함수입니다. 이 함수는 Adobe IMS 서비스를 나타내는 개체인 service 매개 변수 하나를 사용합니다. 자세한 내용은 ImsAuthService을(를) 참조하십시오.
onAccessTokenReceived
Adobe IMS 인증 서비스에서 imsToken을(를) 받을 때 호출되는 콜백 함수입니다. 이 함수는 액세스 토큰을 나타내는 문자열인 imsToken 매개 변수 하나를 사용합니다.
onAccessTokenExpired
액세스 토큰이 만료된 경우 호출되는 콜백 함수입니다. 이 함수는 일반적으로 새 액세스 토큰을 얻기 위해 새 인증 흐름을 트리거하는 데 사용됩니다.
onErrorReceived
인증 중에 오류가 발생할 때 호출되는 콜백 함수입니다. 이 함수는 오류 유형과 오류 메시지의 두 매개 변수를 사용합니다. 오류 유형은 오류의 유형을 나타내는 문자열이고, 오류 메시지는 오류 메시지를 나타내는 문자열이다.

ImsAuthService 속성 imsauthservice-properties

ImsAuthService 클래스는 콘텐츠 조각 선택기에 대한 인증 흐름을 처리합니다. Adobe IMS 인증 서비스에서 imsToken을(를) 가져옵니다. imsToken은(는) 사용자를 인증하고 Adobe Experience Manager(AEM) CS 저장소에 대한 액세스 권한을 부여하는 데 사용됩니다. ImsAuthService는 ImsAuthProps 속성을 사용하여 인증 흐름을 제어하고 다양한 인증 이벤트에 대한 수신기를 등록합니다. 편리한 registerContentFragmentSelectorAuthService 함수를 사용하여 콘텐츠 조각 선택기에 ImsAuthService 인스턴스를 등록할 수 있습니다. 다음 함수는 ImsAuthService 클래스에서 사용할 수 있습니다. 그러나 registerContentFragmentSelectorAuthService 함수를 사용하는 경우에는 이러한 함수를 직접 호출할 필요가 없습니다.

함수 이름
설명
isSignedInUser
사용자가 현재 서비스에 로그인되어 있는지 여부를 확인하고 그에 따라 부울 값을 반환합니다.
getImsToken
현재 로그인한 사용자에 대한 인증 imsToken을(를) 검색합니다. 이 인증은 자산 렌디션 생성과 같은 다른 서비스에 대한 요청을 인증하는 데 사용할 수 있습니다.
signIn
사용자의 로그인 프로세스를 시작합니다. 이 함수는 ImsAuthProps을(를) 사용하여 팝업 또는 전체 페이지 다시 로드에서 인증을 표시합니다.
signOut
사용자를 서비스에서 로그아웃하고 인증 토큰을 무효화하며 보호된 리소스에 액세스하려면 다시 로그인해야 합니다. 이 함수를 호출하면 현재 페이지가 다시 로드됩니다.
refreshToken
현재 로그인한 사용자에 대한 인증 토큰을 새로 고침하여 만료되지 않도록 하고 보호된 리소스에 대한 액세스를 중단하지 않도록 합니다. 후속 요청에 사용할 수 있는 새 인증 토큰을 반환합니다.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab