[AEM Assets]{class="badge positive" title="適用於AEM Assets)。"}
Content Advisor安裝和屬性 content-advisor-installation-properties
Content Advisor也可與非Adobe (協力廠商)應用程式整合,將智慧型資產探索延伸至Adobe應用程式之外。 協力廠商整合支援相同的豐富功能集,包括AI支援的搜尋、內容感知建議、行銷活動簡訊式探索、存取動態媒體轉譯、內容片段探索、篩選器和資產中繼資料。
先決條件 prereqs
您必須確保以下通訊方式:
- 該主機應用程式於 HTTPS 上執行。
- 您無法於
localhost上執行該應用程式。 如果您想要在本機電腦上整合內容警告程式,您必須建立自訂網域,例如[https://<your_campany>.localhost.com:<port_number>],並在redirectUrl list中新增此自訂網域。 - 您可以使用相應的
imsClientId設定並新增 clientID 至 AEM Cloud Service 環境變數中。 - IMS 範圍清單需要在環境設定中進行定義。
- 應用程式的 URL 位於 IMS 用戶端的重新導向 URL 允許清單中。
- IMS 登入流程是使用網頁瀏覽器上的快顯視窗進行設定和轉譯。 因此,應在目標瀏覽器上啟用或允許快顯視窗。
如果您需要Content Advisor的IMS驗證工作流程,請使用上述先決條件。 或者,如果您已透過 IMS 工作流程進行驗證,則可以改為新增 IMS 資訊。
- 託管整合應用程式的網域名稱。
- 布建後,您的組織將獲得
imsClientId、imsScope,以及對應到設定內容顧問所需必要環境的redirectUrl。 如果沒有這些有效屬性,您就無法執行安裝步驟。
安裝 content-advisor-installation
內容警告器可透過ESM CDN (例如esm.sh/skypack)和UMD版本使用。
在使用 UMD 版 的瀏覽器中 (建議):
<script src="https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/assets-selectors.js"></script>
<script>
const { renderAssetSelector } = PureJSSelectors;
</script>
在具備 import maps 支援並使用 ESM CDN 版的瀏覽器中:
<script type="module">
import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
</script>
在使用 ESM CDN 版的 Deno/Webpack Module Federation 中:
import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
內容警告器屬性 content-advisor-propertiess
您可以使用「內容建議程式」屬性來自訂「內容建議程式」的呈現方式。 下表列出可用於自訂及使用「內容建議程式」的特性。
true,內容警告器會在左側邊欄檢視中轉譯。 如果標示為false,內容警告器會在強制回應檢視中呈現。imsOrg金鑰是驗證您所存取的組織是否位於Adobe IMS下的必要專案。imsToken。apiKey。<Object>[{id: 'urn:234}, {id: 'urn:555'}] 資產。 如果您需要使用不同的目錄,請為該 path 屬性提供一個值。rail屬性搭配使用,以啟用資產檢視器的邊欄檢視。Object<{ id?: string, defaultMessage?: string, description?: string}>i18nSymbols prop傳遞自己的自訂本地化值。 透過此介面傳遞的值會覆寫已提供的預設翻譯,並改為使用您自己的翻譯。 若要執行覆寫,您必須傳遞一個有效的 Message Descriptor 物件至您想要覆寫的 i18nSymbols 金鑰。intl.localeprop 提供有效的語言環境字串,以選擇翻譯語言。 例如: intl={{ locale: "es-es" }}支援的地區設定字串會遵循ISO 639 — 代表語言標準名稱的程式碼。
支援的地區設定清單:英文 — 'en-us' (預設)西班牙文 — 'es-es'德文 — 'de-de'法文 — 'fr-fr'義大利文 — 'it-it'日文 — 'ja-jp'韓文 — 'ko-kr'葡萄牙文 — 'pt-br'中文(繁體) - 'zh-cn'中文(台灣) - 'zh-tw'
Array<string>{allowList?: Object}default到express之間的內容建議程式應用程式。 它也支援@react-spectrum/theme-express。在選取資產並按一下Select模組上的按鈕時,叫用資產項目陣列。 此函數僅在模組視圖中叫用。 對於邊欄視圖,請使用 handleAssetSelection或onDrop 函數。 範例:
handleSelection=(資產:資產[])=> {…}
如需詳細資訊,請參閱選取的資產。
在選擇或取消選擇資產時,以項目陣列叫用。 當您想要在使用者選擇資產時進行監聽,這是十分實用的功能。 範例:
handleAssetSelection=(資產:資產[])=> {…}
如需詳細資訊,請參閱選取的資產。
Close模組視圖中的按鈕時叫用。 這只在modal視圖中呼叫,而在rail視圖中忽略。single或multiple資產選擇方式。語法:
aemTierType: "author" "delivery"例如,如果同時使用
["author","delivery"],則存放庫切換器會顯示製作和傳遞的選項。EXPIRED、EXPIRING_SOON或NOT_EXPIRED。 請參閱自訂過期的資產。 此外,您可以使用allowSelectionAndDrag,函式值可以是true或false。 當值設定為false時,無法在畫布上選取或拖曳過期的資產。uploadConfig屬性之下。 新增您提供的欄位陣列,以從使用者收集中繼資料。 使用此屬性,您也可以使用自動指派給資產但使用者不可見的隱藏中繼資料。uploadConfig屬性之下。 它包含property和value。 Property等於從值正在更新的 metadataSchema 傳遞之欄位的mapToProperty。 而提供value等於新值作為輸入。"/content/dam"uploadConfig屬性之下。 預設為資產存放庫根的檔案目標上傳路徑。uploadConfig屬性之下。(uploadInfo: UploadInfo) => void。 此屬性巢狀於uploadConfig屬性之下。sourceTypes使用您要啟用的匯入來源陣列。 支援的來源為Onedrive和Dropbox。 語法為{ sourceTypes?: ImportSourceType[]; apiKey?: string; }。 此外,此屬性是巢狀位於uploadConfig屬性下。(uploadStats: UploadStats) => void。 此外,此屬性是巢狀位於uploadConfig屬性下。uploadConfig屬性之下。 這是一個回呼函式,用來顯示檔案變更時上傳的行為。 它會傳遞擱置上傳的新檔案陣列以及上傳的來源型別。 如果發生錯誤,Source型別可以是null。 語法為(newFiles: File[], uploadType: UploadType) => void{ href: string; alt: string; },此外,此屬性是巢狀位於uploadConfig屬性下。featureSet:[ ]屬性是用來啟用或停用「內容建議程式」應用程式中的特定功能。 若要啟用元件或功能,您可以在陣列中傳遞字串值,或讓陣列保持空白以停用新增的功能,而僅具備基本功能。 例如,您想在「內容警告器」中啟用上載功能,請使用語法featureSet:["upload"]。 同樣地,您可以使用featureSet:["content-fragments"]在內容警告器中啟用內容片段。 若要同時使用多個功能,語法為featureSet:["upload"、"content-fragments"]。ImsAuthProps ims-auth-props
ImsAuthProps屬性定義內容顧問用來取得imsToken的驗證資訊和流程。 藉由設定這些屬性,您可以控制驗證流程應該如何行為並註冊各種驗證事件的接聽程式。
imsClientIdimsScoperedirectUrlredirectUrl,ImsAuthService會使用用來登入imsClientId的redirectUrlmodalModetrue,驗證流程會以快顯視窗顯示。 如果設為false,則驗證流程會以全頁重新載入顯示。 _Note :_若要獲得較好的UX,您可以在使用者停用瀏覽器快顯視窗時動態控制此值。onImsServiceInitializedservice,此引數是代表Adobe IMS服務的物件。 如需詳細資訊,請參閱ImsAuthService。onAccessTokenReceivedimsToken時所呼叫的回呼函式。 此函式接受一個引數imsToken,該引數是代表存取權杖的字串。onAccessTokenExpiredonErrorReceivedImsAuthService ims-auth-service
ImsAuthService類別會處理內容警告器的驗證流程。 其負責從Adobe IMS驗證服務取得imsToken。 imsToken可用來驗證使用者,並授權以Cloud Service Assets存放庫身分存取Adobe Experience Manager。 ImsAuthService使用ImsAuthProps屬性來控制驗證流程並註冊各種驗證事件的接聽程式。 您可以使用方便的registerAssetsSelectorsAuthService函式,向內容顧問註冊 ImsAuthService 執行個體。 ImsAuthService類別上有以下可用函式。 不過,如果您使用 registerAssetsSelectorsAuthService 函式,則不需要直接呼叫這些函式。
isSignedInUsergetImsTokenimsToken,此驗證可用於驗證其他服務的要求,例如產生資產_rendition。signInImsAuthProps在快顯視窗或整頁重新載入中顯示驗證signOutrefreshTokencontentFragmentSelectorProps content-fragment-selector-properties
contentFragmentSelectorProps可讓您設定如何存取內容片段,以及如何在內容警告器中顯示。 透過啟用featureSet中的內容片段功能並提供所需的設定,您可以順暢地整合內容片段選擇與資產。 這可讓使用者在相同的統一介面中瀏覽、搜尋和選取內容片段,確保跨資產和結構化內容的一致內容選取體驗。
const assetSelectorProps = {
featureSet: [
'upload', /* Include upload or other featureSet values to ensure no missing functionality */
'content-fragments', /* Content Fragments pill will be shown */
],
contentFragmentSelectorProps: {
/* Configures the Content Fragments Pill experience */
/* ...props @aem-sites/content-fragment-selector MFE supports */
}
}
<AssetSelector {...assetSelectorProps} />
在contentFragmentSelectorProps中,您可以提及內容片段選擇器屬性中可用的任何屬性。
如需如何將「內容建議程式」與Angular、React和JavaScript應用程式整合的相關資訊,請參閱內容建議程式整合範例。