DocumentaçãoAEM GuidesDocumentação do AEM Guides

Configurar um conector de fonte de dados na interface do usuário

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Experiente
  • Administrador

O Experience Manager Guides vem com a ferramenta Fontes de Dados que ajuda você a configurar conectores prontos para uso para fontes de dados. Você pode configurar os conectores JIRA, SQL (MySQL, PostgreSQL, Microsoft SQL Server, SQLite, MariaDB, H2DB), AdobeCommerce, Elasticsearch e Generic REST Client.

Além desses conectores prontos para uso, a Experience Manager Guides fornece os conectores para fontes de dados do Salsify, Akeneo e Microsoft Azure DevOps Boards (ADO). Você pode baixar e instalar esses conectores de código aberto do repositório central Maven. Os usuários podem então configurar esses conectores.
Saiba como instalar um conector de código aberto.

Você também pode se conectar a arquivos de dados JSON usando um conector de arquivos. Faça upload do arquivo JSON do seu computador ou navegue pelos ativos do Adobe Experience Manager. Em seguida, crie trechos de conteúdo ou tópicos usando os geradores.

Para configurar um conector, execute as seguintes etapas:

  1. Selecione o link Adobe Experience Manager na parte superior e escolha Ferramentas.

  2. Selecione Guias na lista de ferramentas.

  3. Selecione o bloco Fontes de Dados. A página Fontes de Dados é exibida. Você pode exibir as fontes de dados conectadas.

    Você pode alternar entre a Exibição de Lista ou a Exibição de Bloco para exibir as várias fontes de dados conectadas como uma lista ou como blocos.

    origens de dados listadas na página origens de dados {width="800"}

    Exibir ou criar um conector de fonte de dados.

  4. Clique em Criar.

  5. Selecione o banco de dados para o qual deseja criar o conector. Por exemplo, o conector Elasticsearch.

    note note
    NOTE
    Todos os bancos de dados prontos para uso disponíveis são listados.

  6. Clique em Avançar.

  7. Insira os detalhes de configuração e conexão de acordo com o banco de dados.

    note tip
    TIP

    • Focalizar

      ícone de informações {width="25"}

      próximo ao campo para ver mais detalhes sobre ele.

    • Os campos com * são obrigatórios. Por exemplo, você pode inserir os seguintes detalhes para o conector Elasticsearch.
    • Nome: insira o nome da fonte de dados.
    • Tipo de autenticação: selecione o tipo de autenticação no menu suspenso. Por exemplo, Autenticação básica de nome de usuário e senha
    • Nome de usuário: digite seu nome de usuário.
    • Senha: digite seu nome de usuário e senha.
    • URL: adicionar a URL da API.

  8. Selecione a opção Excluir modelos de fábrica para impedir que os modelos de fábrica sejam usados para geração de tópico e trecho. Eles não aparecerão na lista suspensa Modelo de mapeamento de dados na caixa de diálogo Adicionar gerador de trecho de conteúdo ou Adicionar gerador de tópico.

  9. Selecione Testar conexão. Você pode exibir o botão Testar Conexão habilitado somente após adicionar os detalhes necessários. Veja uma mensagem de sucesso se os detalhes da conexão estiverem corretos. Caso contrário, você poderá exibir uma mensagem de erro.

  10. Selecione Salvar na parte superior para salvar o conector. Exiba o botão Salvar habilitado depois que você preencher todos os detalhes e a conexão for bem-sucedida.

    Se o conector for salvo com sucesso, você poderá exibir a fonte de dados conectada na página.

Conectar a vários recursos

Você pode adicionar ou usar vários recursos com base em URLs diferentes para alguns conectores, como Cliente REST genérico, Salsify, Akeneo e placas DevOps (ADO) do Microsoft Azure. Em seguida, conecte-se com eles para criar trechos de conteúdo ou tópicos usando os geradores para eles.

Execute as seguintes etapas para criar um recurso:

  1. Selecione ícone adicionar na seção de recurso de URL para adicionar um recurso para cada URL.

  2. Configure todos os detalhes na caixa de diálogo Adicionar recurso.

  3. Clique em Adicionar.

  4. Você pode editar o ícone de edição ou excluir o recurso excluir da lista de recursos de URL.

  5. Você também pode usar os recursos padrão disponíveis para fontes de dados como Salsify, Akeneo e Microsoft ADO. Ative as opções DESATIVADAS para o recurso que você não deseja configurar para uma fonte de dados.

Isso ajuda a buscar dados rapidamente de qualquer um dos recursos de uma fonte de dados específica em um único trecho de conteúdo ou tópico.

Instalar um conector de código aberto install-open-source-connector

Para publicar uma dependência presente no repositório central Maven nos Cloud Service, você precisa incluir e incorporar a dependência de um conector de código aberto.

  1. Adicione a dependência em all/pom.xml no código do projeto Git do Cloud Manager. Por exemplo, você pode adicionar a seguinte dependência para o conector de fonte de dados das placas DevOps do Microsoft Azure.

    code language-none 
    <dependency>
    <groupId>com.adobe.aem.addon.guides</groupId>
    <artifactId>konnect-azure-devops</artifactId>
    <version>1.0.0</version>
    <type>jar</type>
</dependency>

  2. Incorpore a dependência adicionada.

    code language-none 
    &quot;
&lt;incorporada>
&lt;groupId>com.adobe.aem.addon.guides&lt;/groupId>
&lt;artifactId>konnect-azure-devops&lt;/artifactId>
&lt;type>jar&lt;/type>
&lt;target>/apps/aemdoxonaemcsstageprogram-vendor-packages/content/install&lt;/target>
&lt;/incorporado>
&quot;

  3. Execute o pipeline para aplicar as alterações nos Cloud Service.
    O conector é instalado em seu ambiente.

Recursos disponíveis para um conector

  • Alterne entre a Exibição de Lista ou a Exibição de Bloco para exibir as várias fontes de dados conectadas como uma lista ou como blocos.
  • Marque a caixa de seleção de um único conector. Clique em Selecionar tudo para selecionar todos os conectores. Você pode clicar em Desmarcar Tudo quando todos os conectores estiverem selecionados.

recursos das fontes de dados na página fontes de dados {width="800"}

Editar, reconectar, duplicar ou excluir um conector de fonte de dados.

Você pode usar os seguintes recursos para o conector na página Fontes de Dados:

  • Editar: edite os detalhes de configuração do conector selecionado.

  • Reconectar: reconectar a um conector desconectado.

  • Duplicar: crie um novo conector duplicado usando o conector atual como base. O conector duplicado é criado com um sufixo (como connectorname_1) por padrão. Por exemplo, sample-elastic-search_1.
    Você verá um erro se existir um conector com o mesmo nome.

  • Excluir: excluir o conector selecionado.

Após configurar a fonte de dados, o conector será listado no painel Fontes de Dados do Editor da Web. Em seguida, você pode se conectar à fonte de dados e inserir um trecho de conteúdo em seus tópicos. Para obter mais detalhes, exiba Inserir um trecho de conteúdo da sua fonte de dados.

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