[AEM Assets]{class="badge positive" title="(Se aplica a los AEM Assets)."}
Instalación y propiedades del Asesor de contenido content-advisor-installation-properties
El Asesor de contenido también está disponible para la integración con aplicaciones que no son de Adobe (de terceros), lo que amplía la detección inteligente de recursos más allá de las aplicaciones de Adobe. El mismo conjunto de funciones enriquecidas, que incluye búsqueda con tecnología de IA, recomendaciones según el contexto, detección basada en instrucciones de campaña, acceso a representaciones de Dynamic Media, detección de fragmentos de contenido, filtros y metadatos de recursos, se admite en integraciones de terceros.
Requisitos previos prereqs
Debe asegurarse de que dispone de los siguientes métodos de comunicación:
- La aplicación host se está ejecutando en HTTPS.
- No puede ejecutar la aplicación en
localhost. Si desea integrar el Asesor de contenido en su equipo local, debe crear un dominio personalizado, por ejemplo[https://<your_campany>.localhost.com:<port_number>], y agregar este dominio personalizado enredirectUrl list. - Puede configurar y añadir clientID a la variable de entorno de AEM as a Cloud Service con el
imsClientIdcorrespondiente. - La lista de ámbitos de IMS debe definirse en la configuración del entorno.
- La URL de la aplicación está en la lista de URL de redirección permitidas del cliente de IMS.
- El flujo de inicio de sesión de IMS se configura y se representa mediante una ventana emergente en el explorador web. Por lo tanto, las ventanas emergentes deben habilitarse o permitirse en el explorador de destino.
Utilice los requisitos previos anteriores si necesita el flujo de trabajo de autenticación IMS del Asesor de contenido. Alternativamente, si ya está autenticado con el flujo de trabajo de IMS, puede añadir la información de IMS en su lugar.
- Nombres de dominio en los que está alojada la aplicación integradora.
- Después del aprovisionamiento, se proporcionará a su organización
imsClientId,imsScopey unredirectUrlcorrespondientes a los entornos solicitados que son esenciales para la configuración del Asesor de contenido. Sin estas propiedades válidas, no se pueden ejecutar los pasos de instalación.
Instalación content-advisor-installation
El Asesor de contenido está disponible a través de la CDN de ESM (por ejemplo, esm.sh/skypack) y la versión UMD.
En navegadores que utilizan la Versión de UMD (recomendado):
<script src="https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/assets-selectors.js"></script>
<script>
const { renderAssetSelector } = PureJSSelectors;
</script>
En navegadores con compatibilidad con import maps con Versión de CDN de ESM:
<script type="module">
import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
</script>
En la federación de módulos Deno/Webpack mediante Versión de CDN de ESM:
import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
Propiedades del Asesor de contenido content-advisor-propertiess
Puede utilizar las propiedades del Asesor de contenido para personalizar la forma en que se procesa el Asesor de contenido. En la tabla siguiente se enumeran las propiedades que puede utilizar para personalizar y utilizar el Asesor de contenido.
true, el Asesor de contenido se representa en una vista del carril izquierdo. Si está marcado false, el Asesor de contenido se procesará en la vista modal.imsOrg es necesaria para autenticar si la organización a la que accede se encuentra en Adobe IMS o no.imsToken es necesario si utiliza una aplicación Adobe para la integración.apiKey es necesario si utiliza una integración de aplicación Adobe.<Object>[{id: 'urn:234}, {id: 'urn:555'}] Un recurso debe estar disponible en el directorio actual. Si necesita utilizar un directorio diferente, proporcione un valor para la propiedad de path también.rail para habilitar la vista de carril del visor de recursos.Object<{ id?: string, defaultMessage?: string, description?: string}>i18nSymbols. Al pasar un valor a través de esta interfaz, se anulan las traducciones predeterminadas proporcionadas y, en su lugar, se utilizan las suyas. Para realizar la anulación, debe pasar un objeto Descriptor del mensaje válido a la clave de i18nSymbols que desee anular.intl.locale. Por ejemplo: intl={{ locale: "es-es" }}Las cadenas de configuración regional admitidas siguen la norma ISO 639 - Códigos para la representación de nombres de estándares de idiomas.
Lista de configuraciones regionales admitidas: Inglés - 'en-us' (predeterminado) Español - 'es-es' Alemán - 'de-de' Francés - 'fr-fr' Italiano - 'it-it' Japonés - 'ja-jp' Coreano - 'ko-kr' Portugués - 'pt-br' Chino (tradicional) - 'zh-cn' Chino (Taiwán) - 'zh-tw'
Array<string>{allowList?: Object}default y express. También admite @react-spectrum/theme-express.Se invoca con la matriz de elementos de recurso cuando se seleccionan los recursos y se hace clic en el botón Select en el modal. Esta función solo se invoca en la vista modal. Para la vista de carril, utilice las funciones handleAssetSelection o onDrop. Ejemplo:
handleSelection=(recursos: Asset[])=> {…}
Consulte selección de recursos para obtener detalles.
Se invoca con una matriz de elementos cuando los recursos se seleccionan o no. Esto resulta útil cuando desea escuchar los recursos a medida que el usuario los selecciona. Ejemplo:
handleAssetSelection=(assets: Asset[])=> {…}
Consulte selección de recursos para obtener detalles.
Close en la vista modal. Esto solo se llama en la vista modal y se ignora en la vista rail.single o multiple de recursos a la vez.Sintaxis:
aemTierType: "author" "delivery"Por ejemplo, si se usan ambos
["author","delivery"], el conmutador de repositorios mostrará opciones para la creación y la entrega.EXPIRED, EXPIRING_SOON o NOT_EXPIRED según la fecha de caducidad del recurso que proporcione. Consulte personalizar recursos caducados. Además, puede usar allowSelectionAndDrag, en el que el valor de la función puede ser true o false. Cuando el valor se establece en false, el recurso caducado no se puede seleccionar ni arrastrar al lienzo.uploadConfig. Añada una matriz de campos que proporcione para recopilar metadatos del usuario. Con esta propiedad, también puede utilizar metadatos ocultos que se asignan automáticamente a un recurso, pero que no son visibles para el usuario.uploadConfig. Consta de property y value. Property es igual a mapToProperty del campo pasado desde metadataSchema cuyo valor se está actualizando. Mientras que value es igual al nuevo valor proporcionado como entrada."/content/dam"uploadConfig. La ruta de carga de destino para los archivos que tiene el valor predeterminado de raíz del repositorio de recursos.uploadConfig.(uploadInfo: UploadInfo) => void. Esta propiedad está anidada en la propiedad uploadConfig.sourceTypes utiliza una matriz de los orígenes de importación que desea habilitar. Las fuentes compatibles son Onedrive y Dropbox. La sintaxis es { sourceTypes?: ImportSourceType[]; apiKey?: string; }. Además, esta propiedad está anidada en la propiedad uploadConfig.(uploadStats: UploadStats) => void. Además, esta propiedad está anidada en la propiedad uploadConfig.uploadConfig. Es una función de llamada de retorno que se utiliza para mostrar el comportamiento de carga cuando se cambia un archivo. Pasa la nueva matriz de archivos pendientes de carga y el tipo de origen de la carga. El tipo de Source puede ser nulo en caso de error. La sintaxis es (newFiles: File[], uploadType: UploadType) => void{ href: string; alt: string; }. Además, esta propiedad está anidada en la propiedad uploadConfig.featureSet:[ ] se usa para habilitar o deshabilitar una funcionalidad concreta en la aplicación Asesor de contenido. Para habilitar el componente o una función, puede pasar un valor de cadena en la matriz o dejar la matriz vacía para deshabilitar las funciones agregadas y simplemente tener la funcionalidad base. Por ejemplo, si desea habilitar la funcionalidad de carga en el Asesor de contenido, utilice la sintaxis featureSet:["upload"]. Del mismo modo, puede utilizar featureSet:["content-fragments"] para habilitar los fragmentos de contenido en el Asesor de contenido. Para usar varias características juntas, la sintaxis es featureSet:["upload", "content-fragments"].ImsAuthProps ims-auth-props
Las propiedades de ImsAuthProps definen la información de autenticación y el flujo que utiliza el Asesor de contenido para obtener un imsToken. Al establecer estas propiedades, puede controlar cómo debe comportarse el flujo de autenticación y registrar los agentes de escucha para varios eventos de autenticación.
imsClientIdimsScoperedirectUrlredirectUrl, ImsAuthService usa la redirectUrl utilizada para registrar imsClientIdmodalModetrue, el flujo de autenticación se mostrará en una ventana emergente. Si se establece en false, el flujo de autenticación se mostrará en una recarga de página completa. _Note :_para un mejor UX, puede controlar dinámicamente este valor si el usuario tiene deshabilitada la ventana emergente del navegador.onImsServiceInitializedservice, que es un objeto que representa el servicio IMS de Adobe. Consulte ImsAuthService para obtener más detalles.onAccessTokenReceivedimsToken del servicio de autenticación IMS de Adobe. Esta función toma un parámetro, imsToken, que es una cadena que representa el token de acceso.onAccessTokenExpiredonErrorReceivedImsAuthService ims-auth-service
La clase ImsAuthService administra el flujo de autenticación para el Asesor de contenido. Es responsable de obtener un imsToken del servicio de autenticación IMS de Adobe. imsToken se usa para autenticar al usuario y autorizar el acceso a Adobe Experience Manager como un repositorio de Assets de Cloud Service. ImsAuthService usa las propiedades ImsAuthProps para controlar el flujo de autenticación y registrar agentes de escucha para varios eventos de autenticación. Puede utilizar la práctica función registerAssetsSelectorsAuthService para registrar la instancia de ImsAuthService con el Asesor de contenido. Las funciones siguientes están disponibles en la clase ImsAuthService. Sin embargo, si está utilizando la función registerAssetsSelectorsAuthService, no necesita llamar a estas funciones directamente.
isSignedInUsergetImsTokenimsToken del usuario que ha iniciado sesión actualmente, que se puede utilizar para autenticar solicitudes en otros servicios como la generación de _representación de recursos.signInImsAuthProps para mostrar la autenticación en una ventana emergente o en una recarga de página completasignOutrefreshTokencontentFragmentSelectorProps content-fragment-selector-properties
contentFragmentSelectorProps le permite configurar cómo se accede y se muestran los fragmentos de contenido dentro del Asesor de contenido. Al habilitar la característica de fragmentos de contenido en featureSet y proporcionar la configuración necesaria, puede integrar sin problemas la selección de fragmentos de contenido junto con los recursos. Esto permite a los usuarios examinar, buscar y seleccionar fragmentos de contenido dentro de la misma interfaz unificada, lo que garantiza una experiencia de selección de contenido coherente en todos los recursos y el contenido estructurado.
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} />
En contentFragmentSelectorProps, puede mencionar cualquiera de las propiedades disponibles en Propiedades del selector de fragmentos de contenido.
Para obtener información sobre cómo integrar el Asesor de contenido con aplicaciones de Angular, React y JavaScript, consulte Ejemplos de integración del Asesor de contenido.