DocumentaçãoAEM GuidesDocumentação do AEM Guides

Predefinição do AEM Sites no console Mapa

Last update: Wed Aug 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Usuário

Você pode criar uma predefinição do AEM Sites no console Mapa e configurá-la para gerar a saída do AEM Sites. Há duas maneiras de criar a saída do AEM Sites:

TIP
É recomendável usar o mapeamento de componente composto, disponível na versão Experience Manager Guides 2502, e versões mais recentes, para melhorar o desempenho.

Usar mapeamento de componente composto

O mapeamento de componentes compostos oferece uma publicação mais rápida e escalável no AEM Sites em comparação ao mapeamento de componentes herdados. Ele vem com modelos editáveis prontos para uso, que podem ser personalizados de acordo com seus requisitos usando o editor de modelos do AEM. Os modelos utilizam uma combinação de componentes principais do WCM e o guides-components especializado para garantir que os usuários finais obtenham a melhor experiência nas páginas do AEM Sites. Você também pode personalizar seus modelos existentes usando o método de mapeamento de componentes compostos.

O Experience Manager Guides fornece modelos predefinidos para a criação de AEM Sites. Esses modelos ajudam a garantir a consistência no layout e na estrutura do conteúdo.

Criar Predefinição Do AEM Sites

Execute as seguintes etapas para criar a predefinição do AEM Sites usando o mapeamento de componente composto:

  1. Abra o arquivo de mapa DITA no console de mapa.

  2. No painel Predefinições de saída, selecione o ícone + para criar uma predefinição de saída.

  3. Selecione AEM Sites no menu suspenso Tipo na caixa de diálogo Nova predefinição de saída.

  4. Desmarque a opção Usar mapeamento de componente herdado.

  5. Selecione a opção Adicionar ao perfil de pasta atual para criar uma predefinição de saída no perfil de pasta atual. O ícone de perfil de pasta indica uma predefinição de nível de perfil de pasta.

    Saiba mais sobre Gerenciar predefinições de saída de perfil Global e de Pasta.

  6. Selecione Adicionar.

    A predefinição do AEM Sites é criada.

    Novo(a) {width="300"}

Configuração de predefinição do AEM Sites para mapeamento de componente composto

NOTE
Antes de configurar a predefinição do AEM Sites para o Experience Manager Guides, o administrador precisa criar uma estrutura do AEM Sites usando os modelos.

No console Mapa, as opções de configuração predefinidas para o mapeamento de componentes compostos são organizadas nas seguintes guias:

  • Geral
  • Conteúdo
  • Lista de tópicos
  • Referências de mapa cruzado

Novo(a) {width="650"}

Geral

A guia Geral contém as seguintes opções de configuração:

Opções do AEM Sites
Descrição
Usar caminho do site
Use essa opção para publicar seu conteúdo em um site do Experience Manager.
Caminho do site
Esta opção aparecerá se você selecionar a opção Usar caminho do site ​. Procure o caminho predefinido do site do Experience Manager ou especifique um caminho personalizado no qual deseja que a saída seja publicada. A opção Usar sites permite especificar o caminho de publicação inteiro mesmo que o caminho especificado não tenha sido pré-criado dentro da estrutura do AEM Sites. Nesses casos, o sistema cria a estrutura necessária durante o processo de publicação usando o modelo de página inicial do mapa selecionado.

Você também pode usar variáveis ao definir o caminho do Site. Para obter detalhes, exiba Use variáveis para definir as opções Caminho de Destino, Nome do Site ou Nome do Arquivo
Mapear modelo de página
Esta opção aparecerá se você selecionar a opção Usar caminho do site ​. Selecione um modelo que deseja aplicar às páginas iniciais do mapa.
Site
Nome da Experience Manager Sites na qual você deseja publicar seu conteúdo. As opções na lista suspensa são preenchidas com base na lista de sites disponíveis no AEM Sites.
Selecione Atualizar ícone de atualização para obter uma nova lista de opções e refletir os dados atualizados.
Caminho de publicação
O caminho no repositório do AEM onde a saída é armazenada. O Caminho de publicação é preenchido com todos os caminhos que contêm páginas criadas com base no modelo da Página inicial. A saída do AEM Sites do mapa DITA é gerada nesse caminho. Por exemplo, se você especificar o Site como AEMG-Docs e o Caminho de Publicação como aemg-docs-en/docs/product-abc., a saída do AEM Sites será gerada sob o nó aemg-docs-en/docs/product-abc/ em crx/de.
Modelo de página de tópico
Selecione o template que deseja aplicar a todos os tópicos de saída.
Gerar nomes de página com base em
Nome do arquivo de tópico: usa o nome de arquivo do tópico DITA para criar a URL do Site.
Título do tópico: usa o título do tópico DITA para criar os nomes de site do Experience Manager.
Limpar páginas geradas anteriormente
- Excluir páginas geradas anteriormente para tópico removido do mapa: se a estrutura do mapa de DTIA for alterada, você poderá usar esta opção para remover as páginas geradas anteriormente para os tópicos removidos. Esse recurso está disponível somente para publicação de mapa completo.

Digamos que você tenha publicado um mapa DITA, que contém os tópicos a.dita, b.dita e c.dita. Antes de publicar o mapa novamente, você removeu o tópico b.dita do mapa. Agora, se você selecionou essa opção, todo o conteúdo relacionado a b.dita é removido da saída do AEM Sites e somente a.dita e c.dita são publicados.

Observação: informações sobre páginas excluídas também são capturadas nos logs de geração de saída. Para obter mais informações sobre como acessar os arquivos de log, Exiba e verifique o arquivo de log.

Cuidado: ao excluir os tópicos, as páginas ficam indisponíveis no site publicado. Portanto, antes que os tópicos sejam excluídos, um aviso é exibido. Você deve confirmar a exclusão deles.

- Excluir todas as páginas criadas por outras fontes neste caminho: se você selecionar esta opção, todas as páginas publicadas neste caminho de outros mapas, tópicos individuais ou qualquer outra fonte serão excluídas. As páginas também se tornam indisponíveis no site publicado. Portanto, antes que os tópicos sejam excluídos, um aviso é exibido. Você deve confirmar a exclusão deles.
Fluxo de trabalho de pós-geração
Ao escolher essa opção, uma nova lista suspensa Fluxo de trabalho de pós-geração é exibida contendo todos os fluxos de trabalho configurados no AEM. Você deve selecionar um workflow que deseja executar após a conclusão do workflow de geração de saída.

Conteúdo

A guia Conteúdo contém as seguintes opções de configuração:

Opções do AEM Sites
Descrição
Usar Linha de Base
Se tiver criado uma Linha de Base para o mapa DITA selecionado, selecione essa opção para especificar a versão que deseja publicar.

Exibir Trabalhar com a Linha de Base para obter mais detalhes.
Filtragem condicional
Selecione uma das seguintes opções:

None: selecione essa opção se não quiser aplicar nenhuma condição à saída publicada.
Usando DITAVAL: selecione o(s) arquivo(s) DITAVal para gerar conteúdo condicional. Você pode selecionar vários arquivos DITAVal usando a caixa de diálogo Procurar ou digitando o caminho do arquivo. Use o ícone de cruz próximo ao nome do arquivo para removê-lo. Os arquivos DITAVal são avaliados na ordem especificada, de modo que as condições especificadas no primeiro arquivo têm precedência sobre as condições correspondentes especificadas em arquivos posteriores. É possível manter a ordem dos arquivos adicionando ou excluindo arquivos. Se o arquivo DITAVal for movido para algum outro local ou excluído, ele não será excluído automaticamente do painel de mapa. Você precisa atualizar o local caso os arquivos sejam movidos ou excluídos. Você pode passar o mouse sobre o nome do arquivo para visualizar o caminho no repositório do AEM onde o arquivo está armazenado. Você só pode selecionar arquivos DITAVal e um erro será exibido se você selecionar qualquer outro tipo de arquivo.
Predefinição de condição: selecione uma predefinição de condição no menu suspenso para aplicar uma condição ao publicar a saída. Essa opção estará visível se você tiver adicionado uma condição para o arquivo de mapa DITA. As configurações condicionais estão disponíveis na guia Predefinições de condição do console do mapa DITA. Para saber mais sobre a predefinição de condição, exiba Usar predefinições de condição.
Argumentos adicionais da linha de comando DITA-OT
Especifique os argumentos adicionais que você deseja que o DITA-OT processe ao gerar saída. Para obter detalhes sobre os argumentos de linha de comando com suporte no DITA-OT, exiba a documentação do DITA-OT.
Metadados
Propriedades de
Arquivo (Assets)
Selecione as propriedades que deseja processar como metadados. Essas propriedades são definidas na página Propriedades do mapa DITA ou do arquivo de mapa. As propriedades selecionadas na lista suspensa aparecem no campo Propriedades do arquivo. Selecione o ícone cruzado ao lado da propriedade para removê-la.

Observação: as propriedades de metadados diferenciam maiúsculas de minúsculas.

Se você tiver selecionado uma Linha de Base, os valores das propriedades serão baseados na versão da Linha de Base selecionada. Se você não tiver selecionado uma Linha de Base, os valores das propriedades serão baseados na versão mais recente.

Você também pode passar os metadados para a saída usando a publicação DITA-OT. Para obter mais detalhes, Passe os metadados para a saída usando DITA-OT.

Observação: se você não tiver definido a cq:tags na opção Propriedades, os valores de cq:tags serão escolhidos na cópia de trabalho atual, mesmo que você tenha selecionado uma Linha de Base para publicação.
Metadados

Usar propriedades do mapa como fallback
Se essa opção for selecionada, as propriedades definidas para o arquivo de mapa também serão copiadas para os tópicos em que essas propriedades não estão definidas. Considere os seguintes pontos ao usar esta opção:

Somente as propriedades String, Date ou Long (único e de vários valores) podem ser passadas para as páginas do site do AEM. Os valores de metadados de uma propriedade do tipo Cadeia de Caracteres não dão suporte a caracteres especiais (como @, #, " ").
* Esta opção deve ser usada com a opção Properties.

Lista de tópicos

A guia Lista de tópicos exibe a lista de tópicos presentes na cópia de trabalho atual do mapa DITA. Por padrão, todos os tópicos são incluídos. Você pode selecionar tópicos específicos e gerar a saída do AEM Sites somente para eles. Por exemplo, você atualizou alguns tópicos para poder publicar somente esses tópicos, em vez de publicar o mapa DITA inteiro.

lista de tópicos do aem sites

NOTE
Quando uma Linha de Base é selecionada na guia Conteúdo, a lista de Tópicos exibe os tópicos e suas versões da Linha de Base anexada. Além disso, a publicação incremental da lista de Tópicos deve ser usada somente quando não houver alteração na estrutura do mapa. Se houver uma alteração na estrutura do mapa/índice, o mapa inteiro deverá ser publicado uma vez para atualizar o índice.

Referências entre mapas

Esta lista contém tópicos que contêm referências entre mapas com scope ="peer". Você pode especificar o contexto de publicação para uma lista de referências de mapa cruzado com scope="peer" para tópicos disponíveis em outros mapas DITA. Essa guia será exibida se você usar a versão do Experience Manager Guides (UUID).

Para obter mais detalhes, consulte a seção Trabalhando com tópicos vinculados abaixo.

Após a configuração, salve as alterações feitas na predefinição e selecione Gerar para gerar o AEM Sites para o mapa correspondente.

NOTE
Se você estiver publicando conteúdo nos sites do AEM pela primeira vez, é recomendável publicar as páginas no nível do site. Isso garante que a saída seja exibida corretamente na instância Publish sem nenhuma interrupção de CSS.

Usar mapeamento de componente herdado

As etapas para criar a predefinição do AEM Sites usando o mapeamento de componente herdado são as mesmas descritas na seção Mapeamento de componente composto acima. No entanto, ao criar a predefinição, certifique-se de selecionar a opção Usar mapeamento de componente herdado na caixa de diálogo Nova predefinição de saída.

{width="300"}

No console Mapa, as opções de configuração predefinidas para o mapeamento de componentes herdados são organizadas nas seguintes guias:

  • Geral
  • Conteúdo
  • Referências de mapa cruzado

Novo(a) {width="500"}

Geral

A guia Geral contém as seguintes opções de configuração:

Opções do AEM Sites
Descrição
Nome do site
Um nome de site em que a saída é armazenada no repositório do AEM.

Um nó no repositório do AEM é criado com o nome especificado aqui. Se você não especificar o Nome do site, o nó do site será criado com o nome do arquivo de mapa DITA.

O Nome do Site especificado aqui também é usado como o título na guia do navegador.

Você também pode usar variáveis ao definir o Nome do Site. Para obter detalhes, exiba Use variáveis para definir as opções Caminho de Destino, Nome do Site ou Nome do Arquivo
Caminho de saída
O caminho no repositório do AEM onde a saída é armazenada. Ao gerar a saída final, o Nome do site e o Caminho de saída são combinados. Por exemplo, se você especificar o nome do site como user-guide e o Caminho de Saída como /content/output/aem-guides, a saída final será gerada sob o nó /content/output/aem-guides/user-guide.

Você também pode usar variáveis ao definir o caminho de saída. Para obter detalhes, exiba Use variáveis para definir as opções Caminho de Destino, Nome do Site ou Nome do Arquivo
Páginas de saída existentes
Selecione a opção Substituir conteúdo para substituir o conteúdo nas páginas existentes. Essa opção substitui somente o conteúdo presente nos nós de conteúdo e cabeçalho da página. Essa opção permite a publicação combinada de conteúdo. Selecionar essa opção fornece uma opção para selecionar a exclusão de páginas órfãs da saída publicada. Esta também é a opção padrão para criar a saída do AEM Sites.

Selecione a opção Excluir e Criar para forçar a exclusão de páginas existentes durante a publicação. Essa opção exclui o nó da página, juntamente com seu conteúdo e todas as páginas secundárias sob ele. Use essa opção se tiver alterado o modelo de design da predefinição de saída ou se desejar que qualquer página extra já presente no destino seja removida.
Excluir páginas geradas anteriormente para tópicos removidos do mapa
Se a estrutura do mapa de DTIA for alterada, você poderá usar essa opção para remover as páginas geradas anteriormente para os tópicos removidos. Esse recurso está disponível somente para publicação de mapa completo.

Digamos que você tenha publicado um mapa DITA, que contém os tópicos a.dita, b.dita e c.dita. Antes de publicar o mapa novamente, você removeu o tópico b.dita do mapa. Agora, se você selecionou essa opção, todo o conteúdo relacionado a b.dita é removido da saída do AEM Sites e somente a.dita e c.dita são publicados.

Observação: informações sobre páginas excluídas também são capturadas nos logs de geração de saída. Para obter mais informações sobre como acessar os arquivos de log, Exiba e verifique o arquivo de log.

Cuidado: ao excluir os tópicos, as páginas ficam indisponíveis no site publicado. Portanto, antes que os tópicos sejam excluídos, um aviso é exibido. Você deve confirmar a exclusão deles.
Design
Selecione o modelo de design que deseja usar para gerar a saída.

Para obter detalhes sobre como usar modelos de design personalizados para gerar saída, contate o administrador de publicação.
Fluxo de trabalho de pós-geração
Ao escolher essa opção, uma nova lista suspensa Fluxo de trabalho de pós-geração é exibida contendo todos os fluxos de trabalho configurados no AEM. Você deve selecionar um workflow que deseja executar após a conclusão do workflow de geração de saída.
Reter arquivos temporários
Selecione essa opção para manter os arquivos temporários gerados pelo DITA-OT. Se ocorrerem erros durante a geração de saída pelo DITA-OT, selecione essa opção para manter os arquivos temporários. Você pode usar esses arquivos para solucionar erros de geração de saída.

Depois de gerar a saída, selecione o ícone Baixar arquivos temporários baixar arquivos temporários para baixar a pasta ZIP que contém os arquivos temporários.

Observação: se as propriedades do arquivo forem adicionadas durante a geração, os arquivos temporários de saída também incluirão um arquivo metadata.xml contendo essas propriedades.

Conteúdo

Novo(a) {width="650"}

A guia Conteúdo contém as seguintes opções de configuração:

Opções do AEM Sites
Descrição
Usar Linha de Base
Se tiver criado uma Linha de Base para o mapa DITA selecionado, selecione essa opção para especificar a versão que deseja publicar.

Exibir Trabalhar com a Linha de Base para obter mais detalhes.
Filtragem condicional
Selecione uma das seguintes opções:

None: selecione essa opção se não quiser aplicar nenhuma condição à saída publicada.
Usando DITAVAL: selecione o(s) arquivo(s) DITAVal para gerar conteúdo condicional. Você pode selecionar vários arquivos DITAVal usando a caixa de diálogo Procurar ou digitando o caminho do arquivo. Use o ícone de cruz próximo ao nome do arquivo para removê-lo. Os arquivos DITAVal são avaliados na ordem especificada, de modo que as condições especificadas no primeiro arquivo têm precedência sobre as condições correspondentes especificadas em arquivos posteriores. É possível manter a ordem dos arquivos adicionando ou excluindo arquivos. Se o arquivo DITAVal for movido para algum outro local ou excluído, ele não será excluído automaticamente do painel de mapa. Você precisa atualizar o local caso os arquivos sejam movidos ou excluídos. Você pode passar o mouse sobre o nome do arquivo para visualizar o caminho no repositório do AEM onde o arquivo está armazenado. Você só pode selecionar arquivos DITAVal e um erro será exibido se você selecionar qualquer outro tipo de arquivo.
Predefinição de condição: selecione uma predefinição de condição no menu suspenso para aplicar uma condição ao publicar a saída. Essa opção estará visível se você tiver adicionado uma condição para o arquivo de mapa DITA. As configurações condicionais estão disponíveis na guia Predefinições de condição do console do mapa DITA. Para saber mais sobre a predefinição de condição, exiba Usar predefinições de condição.
Metadados
Propriedades de
Arquivo (Assets)
Selecione as propriedades que deseja processar como metadados. Essas propriedades são definidas na página Propriedades do mapa DITA ou do arquivo de mapa. As propriedades selecionadas na lista suspensa aparecem no campo Propriedades do arquivo. Selecione o ícone cruzado ao lado da propriedade para removê-la.

Observação: as propriedades de metadados diferenciam maiúsculas de minúsculas.

Se você tiver selecionado uma Linha de Base, os valores das propriedades serão baseados na versão da Linha de Base selecionada. Se você não tiver selecionado uma Linha de Base, os valores das propriedades serão baseados na versão mais recente.

Você também pode passar os metadados para a saída usando a publicação DITA-OT. Para obter mais detalhes, Passe os metadados para a saída usando DITA-OT.

Observação: se você não tiver definido a cq:tags na opção Propriedades, os valores de cq:tags serão escolhidos na cópia de trabalho atual, mesmo que você tenha selecionado uma Linha de Base para publicação.
Metadados

Usar propriedades do mapa como fallback
Se essa opção for selecionada, as propriedades definidas para o arquivo de mapa também serão copiadas para os tópicos em que essas propriedades não estão definidas. Considere os seguintes pontos ao usar esta opção:

Somente as propriedades String, Date ou Long (único e de vários valores) podem ser passadas para as páginas do site do AEM. Os valores de metadados de uma propriedade do tipo Cadeia de Caracteres não dão suporte a caracteres especiais (como @, #, " ").
* Esta opção deve ser usada com a opção Properties.

Referências entre mapas

Esta lista contém tópicos que contêm referências entre mapas com scope ="peer". Você pode especificar o contexto de publicação para uma lista de referências de mapa cruzado com scope="peer" para tópicos disponíveis em outros mapas DITA. Essa guia será exibida se você usar a versão do Experience Manager Guides (UUID).

Para obter mais detalhes, consulte a seção Trabalhando com tópicos vinculados abaixo.

Trabalhar com tópicos vinculados

O Experience Manager Guides permite criar referências de tópico usando o peer @scope. Em seguida, você pode definir o contexto de publicação dessas referências a partir das predefinições do AEM Sites e, finalmente, gerar a saída dos tópicos vinculados.

Para obter mais detalhes, exiba Gerar saída de tópicos de vinculação de outros mapas.

Execute as seguintes etapas para especificar o contexto de publicação para arquivos com links cruzados:

  1. Abra a guia Referências entre mapas. Para exibir esta guia, verifique se <xrefs> tem IDs exclusivas. IDs exclusivas para <xrefs> serão geradas automaticamente ao editar/salvar o conteúdo mais antigo se a ID não estiver lá.

    Você não poderá exibir a vinculação entre mapas nos seguintes casos:

    • Para as predefinições criadas antes da versão 4.6, a guia Referências cruzadas é desabilitada e uma dica de ferramenta, Consulte o painel de Mapa, é exibida.
    • Para predefinições criadas no painel de mapa, Consulte a dica de ferramenta Painel de mapa.
    • Para predefinições OOTB, Consulte a dica de ferramenta do painel de Mapa.
    • Para predefinições globais, crie uma cópia local dessa predefinição global para definir referências entre mapas.

  2. Uma lista de tópicos e suas referências é exibida

    note note
    NOTE
    A guia Referências de mapa cruzado mostra tópicos que estão vinculados usando somente o scope="peer". Para links com scope="local", não é necessário especificar o contexto de publicação.

    Todos os tópicos vinculados têm sua predefinição de saída e mapa mais recentes selecionados por padrão. O contexto de publicação para todos os tópicos vinculados está definido como <Most recently generated> mapear por padrão.

    Referências entre mapas

  3. Se quiser usar a saída publicada mais recentemente de cada arquivo dependente no mapa, selecione Usar contexto de publicação gerado mais recentemente para todos os tópicos dependentes.
    Você deve publicar o mapa selecionado como o mapa principal antes de publicar o mapa contendo tópicos vinculados. Se o mapa com tópicos vinculados não for publicado, os links serão exibidos como texto normal em vez de hiperlinks na saída do AEM Sites.
    Você deve selecionar o mesmo tipo de predefinição do AEM Sites para o tópico vinculado. Por exemplo, se a predefinição atual do AEM Sites usar o mapeamento de componente herdado, selecione uma predefinição AEM Sites semelhante do tópico vinculado.

  4. Na lista suspensa Mapa Pai, selecione o arquivo de mapa com cuja saída você deseja vincular a saída do mapa atual.
    Selecionar um arquivo de mapa mostra a UUID do mapa na coluna UUID do Mapa Pai. As Predefinições de saída associadas ao mapa escolhido são listadas na lista Predefinição do Mapa pai. Por exemplo, o Tópico 1 no Mapa A contém uma referência ao Tópico 2. O tópico 2 pode estar presente em mapas únicos ou múltiplos. Você pode selecionar o mapa principal e uma predefinição específica ou a saída publicada mais recentemente para cada link.

  5. Se o mesmo tópico for referido mais de uma vez em um arquivo, será possível adicionar um contexto de publicação diferente para cada instância. Isso proporciona maior flexibilidade e controle sobre o conteúdo. Por exemplo, o Tópico 3 está presente no Mapa B e no Mapa C. O Tópico 1 contém duas referências ao Tópico 3. Você pode escolher o Mapa B como o mapa principal do primeiro link e o Mapa C como principal do segundo link.

  6. Na lista suspensa Predefinição do mapa principal, selecione a predefinição de saída com a qual deseja vincular a saída do mapa atual.

    note note
    NOTE
    As diferentes predefinições de AEM Sites do mapa atual são exibidas na lista suspensa. Se você não selecionar uma predefinição, um ícone de aviso será exibido e a geração de saída falhará.

  7. Selecione o mapa necessário e sua predefinição de saída para todos os tópicos de origem e selecione Gerar.

Tópico pai: Entendendo as predefinições de saída

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178