Configurar pesquisa para a interface do usuário do AEM Assets id192SC800MY4

Por padrão, o AEM não reconhece o conteúdo DITA e, portanto, não fornece nenhum mecanismo para pesquisar conteúdo DITA em seu repositório. O AEM Guides permite adicionar o recurso de pesquisa de conteúdo DITA no repositório AEM.

Por padrão, o AEM não reconhece o conteúdo DITA e, portanto, não fornece nenhum mecanismo para pesquisar conteúdo DITA em seu repositório. Além disso, não há recurso de OOTB para pesquisar conteúdo com base em sua UUID. O AEM Guides permite adicionar os recursos de pesquisa de conteúdo DITA e pesquisa baseada em UUID no repositório AEM.

A configuração da pesquisa de conteúdo DITA envolve as seguintes tarefas:

Além de adicionar o recurso de pesquisa, você também pode configurar as pastas que não devem ser incluídas na pesquisa. Para obter mais detalhes, consulte Excluir arquivos temporários dos resultados da pesquisa.

Adicionar componente de pesquisa do elemento DITA na interface do usuário do Assets id192SF0F50HS

Execute o seguinte para adicionar o componente de pesquisa de conteúdo DITA na interface do usuário do AEM Assets:

Adicionar componente de pesquisa baseado em UUID na interface do usuário do Assets id2034F04K05Z

Execute o seguinte para adicionar o componente de pesquisa baseada em UUID na interface do usuário do AEM Assets:

Fornecer permissões aos usuários id192SF0G0RUI

Os autores e editores precisariam receber permissões explícitas para acessar os recursos de pesquisa na interface do usuário do Assets. Se você não conceder essas permissões, os usuários não poderão pesquisar conteúdo DITA com base em seus valores de elemento/atributo ou UUID.

Execute as seguintes etapas para fornecer acesso ao recurso Pesquisa DITA:

O usuário ou grupo de usuários selecionado terá acesso ao recurso de conteúdo DITA de pesquisa na interface do usuário do Assets.

Adicionar elementos ou atributos personalizados na pesquisa id192SF0G10YK

Para que a pesquisa DITA funcione, é necessário algum pré-processamento do conteúdo DITA. Essa etapa de pré-processamento extrai conteúdo seletivo de mapas e tópicos DITA individuais para que ele possa ser indexado para uma pesquisa mais rápida. Internamente, esse processo é chamado de Serialização. A serialização de arquivos DITA ocorre durante o upload do conteúdo ou também pode ser executada sob demanda. Ele usa um arquivo de configuração para determinar quanto conteúdo de cada arquivo DITA deve ser indexado. O local padrão do arquivo de serialização é:

/libs/fmdita/config/serializationconfig.xml

A configuração de pesquisa padrão permite procurar todos os elementos e atributos dentro do elemento prolog DITA. Se quiser pesquisar com base em outros elementos ou atributos, será necessário configurar o arquivo de serialização de pesquisa.

Esse arquivo contém duas seções principais: conjunto de atributos e conjunto de regras. Um trecho da seção do conjunto de regras é fornecido abaixo:

<ruleset filetypes="xml dita"><!-- Element rules --><rule xpath="//[contains(@class, 'topic/topic')]/[contains(@class, 'topic/prolog')]//*[not(*)]" text="yes" attributeset="all-attrs" /><!-- Attribute rules --><rule xpath="//[contains(@class, 'topic/topic')]/[contains(@class, 'topic/prolog')]///@[local-name() != 'class']" /></ruleset>

Na seção do conjunto de regras, você pode especificar:

Uma regra consiste no seguinte:

• xpath

  Essa é a consulta XPath que recupera os elementos ou atributos de arquivos DITA. A configuração padrão para a regra de elemento recupera todos os prolog elementos. E a configuração padrão para a regra de atributo recupera todos os atributos de prolog elementos. Você pode especificar uma consulta XPath para serializar os elementos ou atributos que deseja pesquisar.

A consulta XPath contém o nome de classe do tipo de documento. A classe topic/topic é usada para documentos DITA do tipo de tópico. Se você quiser criar uma regra para outros documentos DITA, use os seguintes nomes de classe:

• texto

  Se quiser pesquisar o texto dentro do elemento especificado, especifique o valor yes. Se você especificar não como valor, apenas os atributos dentro do elemento serão serializados. Os atributos que você deseja pesquisar precisam ser especificados na seção de conjunto de atributos.

• atributeset

  Especifique a ID do conjunto de atributos que você deseja associar a esta regra. O valor all-attrs é um caso especial para indicar que todos os atributos para essa regra devem ser serializados.

Um conjunto de atributos contém uma lista de atributos que você deseja pesquisar no conteúdo DITA. O conjunto de atributos contém o seguinte:

• id

  Um identificador exclusivo para o conjunto de atributos. Essa ID é especificada no parâmetro attributeset de um conjunto de regras.

• atributo

  Uma lista de atributos que você deseja pesquisar. Para cada atributo, você precisa criar uma entrada individual no elemento attribute.

Execute as seguintes etapas para adicionar elementos ou atributos DITA personalizados no arquivo de serialização de pesquisa:

As novas informações de serialização são armazenadas e ativadas para pesquisa. No entanto, é necessário extrair os metadados do conteúdo DITA existente para disponibilizá-los para pesquisa.

Extrair metadados de conteúdo existente id192SF0GA0HT

Depois de fazer qualquer alteração no arquivo de serialização de pesquisa padrão, você deve habilitar a opção Extração de metadados DITA no pacote com.adobe.fmdita.config.ConfigManager e executar o fluxo de trabalho para extrair metadados. Isso extrai os metadados necessários dos arquivos DITA existentes, e os mesmos são então disponibilizados para pesquisa.

Caso você crie novos arquivos ou edite qualquer arquivo após atualizar o arquivo de serialização, os metadados serão automaticamente extraídos desses arquivos. O processo de extração de metadados só é necessário para arquivos que já existem no repositório AEM.

A extração de metadados de arquivos DITA existentes envolve duas tarefas:

Execute as seguintes etapas para habilitar a opção de extração de metadados no configMgr:

Execute as seguintes etapas para executar o fluxo de trabalho de extração de metadados:

Excluir arquivos temporários dos resultados da pesquisa id197AHI0035Z

Por padrão, a pesquisa é executada em todo o repositório do AEM. Pode haver alguns locais que você gostaria de excluir da pesquisa. Por exemplo, ao iniciar o fluxo de trabalho de tradução de conteúdo, os arquivos não aprovados permanecem em um local de pasta temporária. Quando você executa a pesquisa, os arquivos desse local temporário também são retornados nos resultados da pesquisa.

Para impedir que o AEM Guides pesquise o local da pasta de tradução temporária, é necessário adicionar o local da pasta temporária na lista de exclusões.

Execute as seguintes etapas para excluir a pasta de tradução temporária da pesquisa: