[AEM Assets]{class="badge positive" title="Aplicável ao AEM Assets)."}
Instalação e propriedades do Supervisor de conteúdo content-advisor-installation-properties
O Content Advisor também está disponível para integração com aplicativos que não sejam da Adobe (de terceiros), ampliando a detecção inteligente de ativos para além dos aplicativos da Adobe. O mesmo conjunto de recursos avançados, incluindo pesquisa alimentada por IA, recomendações de reconhecimento de contexto, descoberta baseada em resumo da campanha, acesso a representações do Dynamic Media, descoberta de fragmentos de conteúdo, filtros e metadados de ativos, é compatível com integrações de terceiros.
Pré-requisitos prereqs
Você deve garantir os seguintes métodos de comunicação:
- O aplicativo host está sendo executado em HTTPS.
- Você não pode executar o aplicativo em
localhost. Para integrar o Supervisor de Conteúdo ao computador local, é necessário criar um domínio personalizado, por exemplo[https://<your_campany>.localhost.com:<port_number>], e adicionar esse domínio personalizado aoredirectUrl list. - Você pode configurar e adicionar clientID na variável de ambiente do AEM Cloud Service com o respectivo
imsClientId. - A lista de escopos IMS precisa ser definida na configuração de ambiente.
- O URL do aplicativo está na lista de permissões de URLs de redirecionamento do cliente IMS.
- O fluxo de logon do IMS é configurado e renderizado usando um pop-up no navegador da Web. Portanto, os pop-ups devem ser ativados ou permitidos no navegador de destino.
Use os pré-requisitos acima se você precisar do fluxo de trabalho de autenticação IMS do Supervisor de conteúdo. Como alternativa, se você já estiver autenticado com o fluxo de trabalho do IMS, é possível adicionar as informações do IMS.
- Nomes de domínio em que o aplicativo de integração está hospedado.
- Após o provisionamento, sua organização receberá
imsClientId,imsScopee umredirectUrlcorrespondentes aos ambientes solicitados que são essenciais para a configuração do Supervisor de conteúdo. Sem essas propriedades válidas, não é possível executar as etapas de instalação.
Instalação content-advisor-installation
O Supervisor de Conteúdo está disponível por meio da CDN do ESM (por exemplo, esm.sh/skypack) e da versão UMD.
Nos navegadores usando a Versão UMD (recomendado):
<script src="https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/assets-selectors.js"></script>
<script>
const { renderAssetSelector } = PureJSSelectors;
</script>
Em navegadores com suporte a import maps usando a Versão CDN do ESM:
<script type="module">
import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
</script>
No Deno/Webpack Module Federation usando a Versão CDN do ESM:
import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
Propriedades do Supervisor de Conteúdo content-advisor-propertiess
Você pode usar as propriedades do Supervisor de Conteúdo para personalizar a forma como o Supervisor de Conteúdo é renderizado. A tabela a seguir lista as propriedades que você pode usar para personalizar e usar o Supervisor de Conteúdo.
true, o Supervisor de Conteúdo é renderizado em um modo de exibição do painel esquerdo. Se estiver marcado como false, o Supervisor de Conteúdo será renderizado na exibição modal.imsOrg é necessária para autenticar se a organização que você está acessando está no Adobe IMS ou não.imsToken é necessário se você estiver usando um aplicativo Adobe para a integração.apiKey é necessário se você estiver usando uma integração de aplicativos Adobe.<Object>[{id: 'urn:234}, {id: 'urn:555'}] Um ativo deve estar disponível no diretório atual. Se precisar usar um diretório diferente, forneça um valor para a propriedade path também.rail para habilitar a exibição do painel do visualizador de ativos.Object<{ id?: string, defaultMessage?: string, description?: string}>i18nSymbols. Transmitir um valor por meio dessa interface substitui as traduções padrão fornecidas e usará suas próprias traduções. Para executar a substituição, deverá transmitir um objeto Descritor de mensagem à chave de i18nSymbols que deseja substituir.intl.locale. Por exemplo: intl={{ locale: "es-es" }}As cadeias de caracteres de localidade com suporte seguem a ISO 639 - Códigos para a representação de nomes de padrões de idiomas.
Lista de locais com suporte: Inglês - 'en-us' (padrão) Espanhol - 'es-es' Alemão - 'de-de' Francês - 'fr-fr' Italiano - 'it-it' Japonês - 'ja-jp' Coreano - 'ko-kr' Português - 'pt-br' Chinês (Tradicional) - 'zh-cn' Chinês (Taiwan) - 'zh-tw'
Array<string>{allowList?: Object}default e express. Também aceita @react-spectrum/theme-express.Chamado com a matriz de itens do ativo quando os ativos são selecionados e o botão Select no modal é clicado. Essa função só é invocada na exibição modal. Para exibição do painel, use as funções handleAssetSelection ou onDrop. Exemplo:
handleSelection=(assets: Asset[])=> {…}
Consulte seleção de ativos para obter detalhes.
Invocado com uma matriz de itens enquanto os ativos estão sendo selecionados ou desmarcados. É útil quando você deseja acompanhar os ativos à medida que o usuário os seleciona. Exemplo:
handleAssetSelection=(ativos: Ativo[])=> {…}
Consulte seleção de ativos para obter detalhes.
Close na exibição modal é pressionado. Somente é chamado na exibição modal e desconsiderado na exibição rail.single ou multiple de ativos de cada vez.Sintaxe:
aemTierType: "author" "delivery"Por exemplo, se ambos
["author","delivery"] forem usados, o alternador de repositório exibirá opções para o autor e para a entrega.EXPIRED, EXPIRING_SOON ou NOT_EXPIRED com base na data de expiração de um ativo fornecido. Consulte personalizar ativos expirados. Além disso, você pode usar allowSelectionAndDrag, no qual o valor da função pode ser true ou false. Quando o valor é definido como false, o ativo expirado não pode ser selecionado ou arrastado na tela.uploadConfig. Adicione uma matriz de campos fornecida para coletar metadados do usuário. Usando essa propriedade, também é possível usar metadados ocultos que são atribuídos a um ativo automaticamente, mas que não estão visíveis para o usuário.uploadConfig. Consiste em property e value. Property é igual a mapToProperty do campo passado de metadataSchema cujo valor está sendo atualizado. Por outro lado, value é igual ao novo valor fornecido como uma entrada."/content/dam"uploadConfig. O caminho de upload de destino para os arquivos cujo padrão é a raiz do repositório de ativos.uploadConfig.(uploadInfo: UploadInfo) => void. Esta propriedade está aninhada sob a propriedade uploadConfig.sourceTypes usa uma matriz das fontes de importação que você deseja habilitar. As fontes compatíveis são Onedrive e Dropbox. Sintaxe { sourceTypes?: ImportSourceType[]; apiKey?: string; }. Além disso, esta propriedade está aninhada sob a propriedade uploadConfig.(uploadStats: UploadStats) => void. Além disso, esta propriedade está aninhada sob a propriedade uploadConfig.uploadConfig. É uma função de retorno de chamada usada para mostrar o comportamento de upload quando um arquivo é alterado. Ele passa a nova matriz de arquivos pendentes para upload e o tipo de origem do upload. O tipo de Source pode ser nulo em caso de erro. A sintaxe é (newFiles: File[], uploadType: UploadType) => void{ href: string; alt: string; }. Além disso, essa propriedade está aninhada na propriedade uploadConfig.featureSet:[ ] é usada para habilitar ou desabilitar uma funcionalidade específica no aplicativo Supervisor de Conteúdo. Para ativar o componente ou um recurso, você pode passar um valor de string na matriz ou deixar a matriz vazia para desativar recursos adicionados e apenas ter a funcionalidade base. Por exemplo, se você deseja habilitar a funcionalidade de carregamento no Supervisor de Conteúdo, use a sintaxe featureSet:["upload"]. Da mesma forma, você pode usar featureSet:["content-fragments"] para habilitar Fragmentos de conteúdo no Supervisor de conteúdo. Para usar vários recursos juntos, a sintaxe é featureSet:["upload", "content-fragments"].ImsAuthProps ims-auth-props
As propriedades ImsAuthProps definem as informações de autenticação e o fluxo que o Supervisor de Conteúdo usa para obter um imsToken. Ao definir essas propriedades, é possível controlar como o fluxo de autenticação deve se comportar e registrar ouvintes para vários eventos de autenticação.
imsClientIdimsScoperedirectUrlredirectUrl não for fornecido, ImsAuthService usará o redirectUrl usado para registrar o imsClientIdmodalModetrue, o fluxo de autenticação será exibido em um pop-up. Se definido como false, o fluxo de autenticação será exibido em um recarregamento de página completo. _Observação :_para melhor UX, você pode controlar dinamicamente esse valor se o usuário tiver o pop-up do navegador desabilitado.onImsServiceInitializedservice, que é um objeto que representa o serviço Adobe IMS. Consulte ImsAuthService para obter mais detalhes.onAccessTokenReceivedimsToken é recebido do serviço de autenticação do Adobe IMS. Esta função recebe um parâmetro, imsToken, que é uma cadeia de caracteres que representa o token de acesso.onAccessTokenExpiredonErrorReceivedImsAuthService ims-auth-service
A classe ImsAuthService manipula o fluxo de autenticação para o Supervisor de Conteúdo. Ele é responsável por obter um imsToken do serviço de autenticação do Adobe IMS. O imsToken é usado para autenticar o usuário e autorizar o acesso ao Adobe Experience Manager como um repositório do Assets Cloud Service. O ImsAuthService usa as propriedades ImsAuthProps para controlar o fluxo de autenticação e registrar ouvintes de vários eventos de autenticação. Você pode usar a conveniente função registerAssetsSelectorsAuthService para registrar a instância ImsAuthService com o Supervisor de Conteúdo. As seguintes funções estão disponíveis na classe ImsAuthService. No entanto, se você estiver usando a função registerAssetsSelectorsAuthService, não será necessário chamar essas funções diretamente.
isSignedInUsergetImsTokenimsToken para o usuário conectado no momento, que pode ser usada para autenticar solicitações para outros serviços, como a geração de _representação de ativos.signInImsAuthProps para mostrar autenticação em um pop-up ou em um recarregamento de página completosignOutrefreshTokencontentFragmentSelectorProps content-fragment-selector-properties
contentFragmentSelectorProps permite configurar como os fragmentos de conteúdo são acessados e exibidos no Supervisor de conteúdo. Ao ativar o recurso de fragmentos de conteúdo no featureSet e fornecer a configuração necessária, você pode integrar facilmente a seleção de Fragmento de conteúdo com os ativos. Isso permite que os usuários naveguem, pesquisem e selecionem fragmentos de conteúdo na mesma interface unificada, garantindo uma experiência consistente de seleção de conteúdo em ativos e conteúdo estruturado.
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} />
Em contentFragmentSelectorProps, você pode mencionar qualquer uma das propriedades disponíveis em Propriedades do Seletor de Fragmento de Conteúdo.
Para obter informações sobre como integrar o Supervisor de Conteúdo aos aplicativos do Angular, React e JavaScript, consulte exemplos de integração do Supervisor de Conteúdo.