Usar dados da sua fonte de dados

Selecionar Fontes de dados no painel esquerdo para exibir as fontes de dados conectadas.

Selecione uma fonte de dados para exibir os geradores de trecho de conteúdo disponíveis para a fonte de dados selecionada.

{width="300"}

O painel Fontes de dados lista os geradores de snippet de conteúdo disponíveis.

Selecionar Adicionar para adicionar um novo gerador de trecho de conteúdo. A variável Adicionar gerador de trecho de conteúdo é aberto.

Insira a consulta no Consulta de dados texto. Selecionar Copiar exemplo de consulta para copiar rapidamente uma consulta de dados. Em vez de criar manualmente a query, você pode copiar e colar a amostra de query na Consulta de dados texto. Em seguida, basta editar a query de acordo com seus requisitos de dados.

Se você usar um conector de arquivo, poderá fazer upload do arquivo JSON do seu computador ou procurar um arquivo JSON nos ativos da Adobe Experience Manager.

Selecione o modelo que mapeia com sua fonte de dados na Modelo de mapeamento de dados lista suspensa.
Os modelos prontos para uso da fonte de dados selecionada são exibidos na lista suspensa. Por exemplo, você pode exibir o modelo "sql-table" para a origem de dados denominada "PostgreSQL".

A variável Recurso é exibida para alguns conectores, como REST Client, Salsify, Akeneo e Microsoft ADO. Selecione qualquer recurso na lista suspensa e conecte-se a ele para criar um trecho de conteúdo ou um tópico usando o gerador para ele.

Clique em Buscar para buscar os dados da fonte de dados e aplicar o modelo nos dados resultantes da consulta SQL.

É possível exibir os dados na visualização ou na exibição da fonte DITA.

1. A visualização mostra como os dados serão exibidos quando inseridos no conteúdo. A visualização exibe uma pequena fração dos dados no formato do modelo selecionado.
   Por exemplo:

   • Se você selecionou o template sql-table, é possível exibir os dados SQL em formato tabular.
   • Se você selecionou o modelo jira-ordered-list, é possível visualizar uma lista ordenada para os problemas do Jira.

2. A exibição fonte mostra os dados na exibição fonte DITA.

   {width="800"} *Adicione um gerador de snippet de conteúdo. Exibir os dados no modo de origem ou de visualização.*

Para salvar os resultados da consulta, digite o nome do gerador e clique em ADICIONAR. Um novo gerador de trecho de conteúdo é adicionado à lista.

Selecione uma fonte de dados para exibir os geradores de trechos de conteúdo e os geradores de tópicos disponíveis para a fonte de dados selecionada.

{width="300"}

Adicione um gerador de tópico para uma origem de dados conectada.

Selecionar Adicionar e selecione Gerador de tópico na lista suspensa para adicionar um novo gerador de tópico. A variável Adicionar gerador de tópico é aberto.

Insira os valores nos campos sob as três guias do Adicionar gerador de tópico painel:

Buscar configuração

{width="300"}

Adicione a Consulta de dados, o modelo de mapeamento de dados e os detalhes do nó Raiz do gerador de tópicos e dê a ele um nome exclusivo no painel Buscar configuração.

1. Insira a consulta no Consulta de dados texto. Selecionar Copiar exemplo de consulta para copiar rapidamente uma consulta de dados. Em vez de criar manualmente a query, você pode copiar e colar a amostra de query na Consulta de dados texto. Em seguida, basta editar a query de acordo com seus requisitos de dados.

   note note
   NOTE
   O Experience Manager fornece exemplos diferentes de consulta para todos os recursos nas várias fontes de dados. Eles são mapeados para a fonte de dados da qual você está buscando os dados.

2. Se você usar um conector de arquivo, poderá fazer upload do arquivo JSON do seu computador ou procurar um arquivo JSON nos ativos da Adobe Experience Manager.

   note note
   NOTE
   Você visualizará as opções para fazer upload ou procurar arquivos no lugar de uma consulta de dados se usar um conector de arquivos.

3. Selecione o modelo que mapeia com sua fonte de dados na Modelo de mapeamento de dados lista suspensa.

   note note
   NOTE
   Se o administrador tiver configurado modelos personalizados, esses modelos também serão exibidos na lista suspensa (com base nas configurações de caminho do modelo feitas pelo administrador). Por exemplo, você pode criar um modelo de tópico contendo uma lista ordenada, tabelas, parágrafos ou outros elementos DITA.

4. Insira o Nó raiz. Esse é o nó no qual você deseja acessar seus dados. O gerador de tópicos cria cada tópico no nível definido no nó raiz. Por exemplo, você pode adicionar ‘problemas’ como o nó raiz no Jira. Portanto, se um query retornar 13 problemas, você terá 13 tópicos, um tópico para cada problema.

5. Clique em Buscar para buscar os dados da fonte de dados e aplicar o modelo nos dados resultantes da consulta SQL. A visualização mostra uma pequena fração de como o tópico aparece no formato do modelo selecionado. Por exemplo, você pode visualizar um único problema do Jira com todos os campos resultantes da query.

6. Informe o nome do gerador de tópico.

   note note
   NOTE
   Você precisa seguir a convenção de nomenclatura de arquivo para o nome do novo gerador de tópico. Você não pode ter um espaço no nome do gerador de tópico. Além disso, não é possível salvar um novo gerador de tópicos com o nome de um gerador de tópicos existente. Ocorre um erro.

Configuração de saída

{width="300"}

Insira os detalhes do Caminho de saída e da Convenção de nomenclatura do tópico no painel Configuração de saída. Gere um mapa DITA e nomeie-o.

1. Insira o Caminho de saída detalhes em que você deseja salvar seus tópicos.
2. No Convenção de nomenclatura de tópico, você pode inserir um valor ou uma variável com tags do velocity. Os novos tópicos seguirão a convenção. Por exemplo, você pode inserir a variável $key para criar tópicos com base em chaves Jira.
3. Ativar a opção Gerar um mapa se quiser criar um mapa que contenha todos os tópicos gerados.
4. Insira o nome do novo mapa DITA.

Metadados

Selecione as propriedades de metadados no menu suspenso para transmitir aos tópicos. Nome lista suspensa as propriedades personalizadas e padrão.

Por exemplo, na captura de tela a seguir, dc:description, dc:language, dc:title, e docstate são as propriedades padrão para as quais você pode definir os valores. Você pode criar uma propriedade personalizada como autor e definir seu valor.

{width="300"}

Adicione as propriedades dos metadados no painel Metadados para passar para os tópicos.

Insira o nome do gerador e clique em Salvar para salvar os resultados da consulta. Um novo gerador de tópico é adicionado à lista.

Clique em Salvar e gerar para salvar o gerador de tópicos e gerar novos tópicos a partir dele.

{width="650"}

Gerar novos tópicos a partir de um gerador de tópicos existente.

Editar um modelo do Velocity no Editor da Web.

Adicione uma ferramenta e sua função na <tool.function> formato. Por exemplo:

• Para gerar um número aleatório usando a ferramenta matemática, use $mathTool.random.
• Para gerar a soma de números usando a ferramenta matemática, use $mathTool.add(num1, num2).

Use o modelo para criar um trecho de conteúdo ou tópico.

Após aplicar o modelo aos dados, é possível exibi-los na visualização ou na exibição da fonte DITA.