DocumentaçãoAEM GuidesDocumentação do AEM Guides

Integração de fontes de dados externas

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Usuário

Os dados de sistemas externos podem ser facilmente integrados à instância do Experience Manager Guides. A conexão com fontes de dados externas pode melhorar significativamente a funcionalidade e a usabilidade do sistema de gerenciamento de conteúdo.

Você pode conectar e buscar dados de fontes externas com eficiência usando a integração de dados. Com esse recurso, você não precisa depender da equipe de TI para obter os dados e, em seguida, copiá-los e colá-los manualmente ou atualizar constantemente as alterações no sistema externo.

Esse recurso garante a sincronização com a origem original e permite atualizações harmoniosas na documentação sem depender de operações manuais de copiar e colar. Também ajuda a manter a consistência dos dados entre o Experience Manager Guides e a fonte de dados externa.

Além disso, depois de buscar o conteúdo de fontes de dados externas, você pode criá-lo no formato DITA e também reutilizar o conteúdo integrado.

Estrutura de integração da fonte de dados

A estrutura de integração de uma fonte de dados abrange principalmente dois componentes principais: as fontes de dados externas e sua integração na instância do Experience Manager Guides.

Fontes de dados externas

Estas são algumas das fontes de dados que você pode conectar pelo Experience Manager Guides:

  • Bancos de Dados Relacionais (RDBMS)
    • PostgreSQL, MySQL, Microsoft SQL Server, MariaDB e SQLite
  • Bancos de Dados Não Relacionais
    • MongoDB, Apache Cassandra, Apache CouchDB e Redis
  • Gerenciamento de informações do produto (PIM) / Gerenciamento do ciclo de vida do produto (PLM)
    • Pimcore, Salsify, Akeneo e Informatica
  • Sistemas de gerenciamento de produtos
    • JIRA e placas DevOps do Microsoft Azure (ADO)
  • Sistemas OLAP (Online Analytical Processing, processamento analítico online) e Analytics

Integração no Experience Manager Guides

Com o uso de um conector autenticado, os dados são transferidos de um sistema externo e geram dados no Experience Manager Guides.
Arquitetura

Integração no Experience Manager Guides

Execute as seguintes etapas para integrar o conteúdo ao Experience Manager Guides:

  1. Configurar o conector de fonte de dados

    • O conector da fonte de dados serve como interface para estabelecer conectividade com as fontes de dados externas. Você deve configurar o conector para estabelecer a conexão e incluir os métodos de autenticação, como Basic Auth ou API key Auth. Todos os detalhes de configuração, incluindo informações criptografadas, são armazenados com segurança no Adobe Experience Manager.

    • A camada do conector é projetada para ser extensível, permitindo que você crie suas implementações para conexão com vários sistemas que não são fornecidos prontos para uso pela Experience Manager Guides.

      Camada de conector

    note note
    NOTE
    Acesse o módulo de definição do Konnect e implemente a interface do Conector para criar um conector personalizado. Saiba mais sobre como configurar conectores de fonte de dados personalizados.

  2. Personalizar os modelos do Velocity

    • O Experience Manager Guides é compatível com o Velocity (https://velocity.apache.org/), um mecanismo de modelo altamente robusto para transformar os dados de arquivos JSON em conteúdo DITA. A Velocity oferece flexibilidade para navegar pelas estruturas JSON com qualquer nível de aninhamento.

    • O exemplo a seguir mostra como integrar modelos do velocity e dados obtidos do Jira para gerar tabelas ou listas ordenadas facilmente.

      • Resposta do Jira

        code language-none 
        {
    "expand": "schema,names",
    "total": 5,
    "hostname": "https://jira.corp.adobe.com",
    "maxResults": "200",
    "issues": [
        {
            "key": "DXML-12756",
            "fields": {
                "description": "Implement the snippet generator in External Data Source integration",
                "summary": "Implement the snippet generator in External Data Source integration"
            }
        },
        {
            "key": "DXML-12755",
            "fields": {
                "description": "Implement the topic generator in External Data Source integration",
                "summary": "Implement the topic generator in External Data Source integration"
            }
        },
        {
            "key": "DXML-12745",
            "fields": {
                "description": "Implement the ability to register a new connector",
                "summary": "Implement the ability to register a new connector"
            }
        }
    ],
    "startAt": 0
}

      • Modelos

        Mecanismo de modelo {width="800"}

      • Dados gerados a partir da mesma fonte de dados, mas com modelos diferentes

        Dados Gerados {width="800"}

  3. Gerar conteúdo usando os modelos

    • Você pode gerar o conteúdo a partir dos modelos criados.

    • Você pode gerar vários tipos de conteúdo:

      • Trecho: este é um conteúdo utilizável único. Você pode gerar os dados do conector no modelo definido e, em seguida, incorporá-los na tag desejável.
      • Tópico DITA: Gere vários tópicos para usar como estão no conteúdo ou podem ser reutilizados como um Componente Reutilizável.
      • Tópico DITA + Mapa: Você também pode gerar um mapa completo com o tópico e, em seguida, usar os dados para publicação direta ou usá-los como um Componente reutilizável em outros dados.

  4. Publish o conteúdo integrado

    • A publicação é o recurso OOTB do Experience Manager Guides e você pode publicar diretamente todos os dados gerados a partir do sistema externo como saída do PDF ou do site AEM.
Related Articles
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178