Módulo 3: XML para Banco de Dados¶

Introdução¶

Módulo 3 na Introdução ao Harmony Cloud Studio demonstra a leitura de dados XML de um servidor SFTP e sua atualização para um banco de dados PostgreSQL.

Pré-requisitos¶

Esta página pressupõe que você concluiu o Módulo 1 - Banco de dados para texto, onde você configurou conexões com o banco de dados PostgreSQL de treinamento do Jitterbit e o servidor SFTP.

Resumo¶

Neste módulo, você se conectará ao servidor SFTP de treinamento para extrair registros do customer.xml arquivo e adicioná-los ao customer tabela no banco de dados PostgreSQL.

A operação concluída ficará assim:

Esta operação usa este mapeamento de transformação:

1. Baixe um Esquema XML¶

Primeiro, baixe um arquivo XML para fornecer como um esquema em uma etapa posterior:

1. Faça login no servidor SFTP de treinamento do Jitterbit.
2. No DataSets > Customer diretório, baixe o customer.xml arquivo.

2. Configurar uma Atividade de FTP¶

Para este módulo, você continua trabalhando no mesmo projeto e reutiliza a mesma conexão de servidor SFTP do Módulo 1, mas configura uma atividade separada de leitura de FTP para obter os dados XML do servidor:

1. No mesmo projeto do Módulo 1, crie um novo workflow e nomeie-o como "Módulo 3".

2. Na aba Connections da paleta de componentes sob o filtro Endpoints, clique na conexão "SFTP" que você criou no Módulo 1 para mostrar os tipos de atividade da conexão:

   

3. Arraste um tipo de atividade de Leitura de FTP para a área de inserção de componentes na quadro de design para criar uma instância de uma atividade de Leitura de FTP em uma nova operação.

4. Renomeie a operação para "XML to DB".

5. Clique duas vezes na atividade FTP Read dentro da operação para abrir sua configuração.

6. Configure a Atividade de leitura de FTP:

   • Nome: "XML SFTP"
   • Fornecer esquema de resposta: Selecione Sim, fornecer novo esquema e clique em Carregar arquivo para navegar e carregar o customer.xml arquivo que você baixou do servidor SFTP de treinamento.
   • Caminho: Forneça o caminho para o customer.xml arquivo no servidor SFTP de treinamento: "/DataSets/Customer"
   • Obter arquivos: "*.xml". Clique em Avançar.
   • Esquema de dados: Revise o esquema de dados e clique em Concluído para retornar à quadro de design.

A tela final de configuração da atividade deve ser semelhante a esta:

3. Configurar uma Atividade de Banco de Dados¶

Nesta etapa, você usa a mesma conexão com o banco de dados PostgreSQL do Módulo 1, mas configura uma atividade Upsert separada:

1. Na aba Connections da paleta de componentes sob o filtro Endpoints, clique na conexão "Postgres Database" que você criou no Módulo 1 para mostrar os tipos de atividade da conexão:

   

2. Arraste uma atividade Database Upsert para uma área de inserção de componentes à direita da atividade FTP Read dentro da operação na quadro de design.

3. Clique duas vezes na atividade Database Upsert dentro da operação para abrir sua configuração.

4. Configure a Atividade de atualização do banco de dados:

   • Nome: "Upsert to Postgres DB"
   • Forneça a referência dos nomes das tabelas: Atualize as tabelas e selecione a tabela do cliente. Clique em Avançar.
   • Selecione Atualizar Chaves: Limpe o id (Chave) e selecione o company campo. Clique em Avançar.
   • Esquema de dados: Revise o esquema de dados e clique em Concluído para retornar à quadro de design.

A tela final de configuração da atividade deve ser semelhante a esta:

4. Configurar uma Transformação¶

Em seguida, você cria uma transformação para transformar os dados da origem do FTP no destino do banco de dados:

1. Na quadro de design, passe o mouse sobre a área entre a atividade FTP Read e a atividade Database Upsert até que uma área de inserção de componentes apareça.

2. Clique na área de inserção e selecione Nova Transformação. Uma nova transformação se abrirá para você configurar:

   • Nome da Transformação: "XML to DB"
   • Fonte: O esquema fonte já está fornecido (à esquerda).
   • Destino: O esquema de destino já está fornecido (à direita).

3. Arraste o customer nó de origem para o customer nó de destino e selecione Automap.

4. Na parte superior do cabeçalho da transformação, clique no botão cinza Visualizar para iniciar o processo de visualização para testar e validar os mapeamentos. Clique em Avançar para implantar os componentes listados. Na próxima tela, selecione Carregar novo arquivo para teste e forneça o customer.xml arquivo que você baixou anteriormente. Clique em Concluído.

5. A tela de visualização exibe os dados preenchidos da origem e mapeados para o destino. Clique nas setas para a direita e para a esquerda para percorrer os dados importados.

6. Após revisar os dados, clique em Return to Workflow. Clicar neste botão salva o trabalho que você fez na transformação.

A visualização da transformação deve ser semelhante a esta:

5. Implantar e Executar a Operação¶

Por fim, com todas as etapas da operação configuradas, você implantar e executa a operação:

1. No canto superior direito da operação, clique no ícone do menu de ações e no menu clique em Deploy and Run. O status da operação é exibido no canto inferior esquerdo da operação.
2. Depois que a operação for bem-sucedida, faça login no banco de dados PostgreSQL do Jitterbit e exiba os registros adicionais na tabela de clientes.