Assistente de XML para banco de dados no Jitterbit Design Studio

Crie uma transformação XML para banco de dados padrão com o assistente de conexão Jitterbit

O Jitterbit Connect^TM fornece uma rotear rápida e fácil para a transformação de dados. Isso é possível por meio de uma ferramenta de integração baseada em assistente, construída diretamente no Jitterbit. O assistente cria para o usuário todas as operações e componentes complexos e detalhados de um projeto de Transformação. Ao percorrer o assistente, os usuários podem criar um projeto de integração sem a necessidade de codificação.

Esta seção de ajuda abrange a criação de XML para Database. As convenções de tela neste documento são: Source está à esquerda, Target está à direita.

Crie uma transformação XML para padrão de banco de dados

• Entre no seu Jitterbit.

• Para usar o Jitterbit Connect Wizard, no menu principal, clique em Ajuda > Introdução. A aba Introdução aparece no painel direito da tela.

• Agora clique no botão denominado Iniciar o Assistente Connect^TM; OU

• Clique em ícone na parte superior da tela para exibir o menu Jitterbit Connect.

  

• Inicie o assistente clicando no botão XML para Banco de Dados na coluna Padrão no menu do Assistente do Jitterbit Connect, que exibe a tela Seleção de Origem do Banco de Dados; OU

• Clique com o botão direito do mouse no sub-branch desejado do Jitterbit Connect no painel Design e selecione Novo XML para Banco de Dados.

• Comece a criar seu projeto com o assistente.

  Nota

  Se você não tiver efetuado login no início do projeto, será solicitado a fazê-lo quando clicar em XML para banco de dados.

  

• Preencha os campos da seguinte forma:

  Campo	Descrição
  Servidor Jitterbit	Selecione o nome do servidor Jitterbit no menu suspenso.
  Usuário	Insira seu nome de usuário.
  Senha	Digite sua senha.
  Caixa de seleção Lembrar senha	Marque esta caixa se quiser que o sistema lembre sua senha no futuro.
  Link avançado	Clique no triângulo esquerdo para revelar opções de link avançadas: Uso de HTTPS ao se comunicar com o servidor. Seleção de uma porta. Para obter detalhes, clique no botão Ajuda no canto inferior direito desta caixa de diálogo.

• Após preencher os campos:

  Controle	Descrição
  Login	Clique neste botão para fazer login no servidor Jitterbit e exibir a tela Source.
  Cancelar	Clique neste botão para fechar o assistente sem salvar suas entradas.
  Ponto de interrogação	Clique no ponto de interrogação para exibir ajuda para este diálogo.

Criar estrutura XML de origem

• Selecione um dos botões de opção:

  • Selecionar uma estrutura XML - revela quaisquer esquemas XML existentes (extensão .xsd ou .dtd). Em seguida, destaque sua seleção.
  • Carregar um arquivo de estrutura XML - permite que você navegue e carregue outro DTD ou esquema.

• Neste exemplo, escolhemos o botão de opção Selecionar uma estrutura XML e destacamos PurchaseOrder.dtd.

  Controle	Descrição
  Próximo	Clique neste botão para exibir a tela Source Select a Root.
  Cancelar	Clique neste botão para fechar o assistente sem salvar suas entradas.

• Clique no botão Voltar para retornar à tela anterior.

Criar elemento raiz de origem

• Selecione um dos botões de opção:

  • Selecione um nó raiz da lista - revela nós de dados, e você pode escolher um como raiz.
  • Procure a raiz em um documento XML de amostra - permite que você navegue para outro documento XML para determinar seu nó raiz.

• Neste exemplo, escolhemos o botão de opção Selecione um nó raiz da lista e destacamos company_name.

  Controle	Descrição
  Próximo	Clique neste botão para exibir a tela Opções de fonte.
  Cancelar	Clique neste botão para fechar o assistente sem salvar suas entradas.

• Clique no botão Voltar para retornar à tela anterior.

  

• A caixa de seleção Valida instâncias XML em relação ao XSD selecionado ou DTD é marcada por padrão. Neste exemplo, estamos deixando a caixa de seleção marcada.

  Controle	Descrição
  Próximo	Clique neste botão para exibir a tela Selecionar uma fonte de arquivo.
  Cancelar	Clique neste botão para fechar o assistente sem salvar suas entradas.

• Clique no botão Voltar para retornar à tela anterior.

Criar fonte de arquivo

• Para editar uma fonte de arquivo existente, selecione no menu suspenso (por exemplo, fonte XML, fonte de texto, texto complexo) e clique em Editar. A tela se expande para exibir o nome e o tipo de fonte XML e os parâmetros de conexão.

• Para criar uma nova fonte de arquivo, clique no botão Criar novo e preencha os campos.

• Neste exemplo, escolhemos uma fonte XML no menu suspenso e clicamos em Editar para atualizar os parâmetros de conexão da fonte.

  Nota

  O tipo de Fonte de Arquivo selecionado determinará os parâmetros de conexão a serem inseridos. Para detalhes, veja Habilitando fontes de arquivo locais.

  

• Campos de origem XML:

  Campo	Descrição
  Nome	Este campo é preenchido automaticamente com um nome atribuído pelo sistema. Este é um campo editável onde você pode escolher inserir qualquer nome.
  Tipo	Use o menu suspenso para selecionar seu tipo. Neste exemplo, selecionamos File3-are.

• Preencha os campos de parâmetros de conexão da seguinte forma.

  Parâmetro	Descrição
  Caminho	Insira o caminho onde os arquivos "Get" residem.
  Login	Insira seu login e clique no botão Senha. Uma caixa de diálogo aparece para inserir sua senha.
  Obter arquivos	Insira o nome do arquivo de fonte de dados. Você pode incluir curingas para obter vários arquivos.
  Opções de filtro	Clique neste botão para abrir um diálogo que permite ignorar maiúsculas e minúsculas ou usar uma expressão regular.
  Link Opções	Clique neste link para executar refinamentos na operação, ou seja, excluir ou renomear um arquivo após o processamento.

• Após completar suas entradas:

  Controle	Descrição
  Testar conexão	Antes de clicar em Avançar, clique neste botão para certificar-se de que todas as suas conexões funcionam. Uma caixa de diálogo aparece confirmando que a conexão foi bem-sucedida. Se o teste de conexão não for bem-sucedido, volte e verifique seus parâmetros e corrija se necessário. Clique em OK para retornar à tela Fonte.
  Próximo	Clique neste botão para exibir a tela Seleção de destino do banco de dados.
  Cancelar	Clique neste botão para fechar o assistente sem salvar suas entradas.

• Clique no botão Voltar para retornar à tela anterior.

Criar seleção de destino do banco de dados

• Para editar um Database Target existente, selecione no menu suspenso e clique em Edit. A tela se expande para exibir o nome e o tipo do Database Target e os Connection Parameters.

• Para criar um novo destino de banco de dados, clique no botão Criar novo e preencha os campos.

• Neste exemplo, escolhemos PostgreSQL no menu suspenso e clicamos em Editar para atualizar os parâmetros de conexão.

  Nota

  O tipo de Database Target selecionado determinará os parâmetros de conexão a serem inseridos.

  

• Campos do PostgreSQL:

  Campo	Descrição
  Nome	Este campo é preenchido automaticamente com um nome atribuído pelo sistema. Este é um campo editável onde você pode escolher inserir qualquer nome.
  Tipo	Use o menu suspenso para selecionar seu tipo. Neste exemplo, selecionamos Banco de Dados.

• Preencha os campos de parâmetros de conexão da seguinte forma.

  Parâmetro	Descrição
  Driver	Clique no botão Selecionar e realce o nome do driver onde o banco de dados reside.
  Nome do servidor	Insira o nome do servidor.
  Nome do banco de dados	Insira o nome do banco de dados.
  Login	Insira seu login e Clique no botão Senha. Uma caixa de diálogo aparece para inserir sua senha.

• Após completar suas entradas:

  Controle	Descrição
  Testar conexão	Antes de clicar em Avançar, clique neste botão para certificar-se de que todas as suas conexões funcionam. Uma caixa de diálogo aparece confirmando que a conexão foi bem-sucedida. Se o teste de conexão não for bem-sucedido, volte e verifique seus parâmetros e corrija-os se necessário. Clique em OK para retornar à tela Fonte.
  Próximo	Clique neste botão para exibir a tela Seleção da Tabela de Destino.
  Cancelar	Clique neste botão para fechar o assistente sem salvar suas entradas.

• Clique no botão Voltar para retornar à tela anterior.

Criar seleção de tabela de destino

• Clique no botão Baixar lista de tabelas para baixar a lista de tabelas disponíveis.

• Opcional:

  • Você pode inserir uma sequência de pesquisa como filtro. Marque as caixas de seleção Tabela ou Visualização para limitar os objetos a serem selecionados.

  • Você pode marcar a caixa de seleção para incluir o esquema/owner.

  Nota

  Se você não tiver efetuado login no início do projeto, será solicitado a fazê-lo ao clicar no botão Download List of Tables.

  

• Preencha os campos da seguinte forma:

  Campo	Descrição
  Servidor Jitterbit	Selecione o nome do servidor Jitterbit no menu suspenso.
  Usuário	Digite seu nome de usuário.**
  Senha	Digite sua senha.
  Caixa de seleção Lembrar senha	Marque esta caixa se quiser que o sistema lembre sua senha no futuro.
  Link avançado	Clique no triângulo esquerdo para revelar opções de link avançadas: Uso de HTTPS ao se comunicar com o servidor. Seleção de uma porta. Para obter detalhes, Clique no botão Ajuda no canto inferior direito desta caixa de diálogo.

• Após preencher os campos:

  Controle	Descrição
  Login	Clique neste botão para efetuar login no servidor Jitterbit e exibir a tela Seleção de Tabela.
  Cancelar	Clique neste botão para fechar o assistente sem salvar suas entradas.
  Ponto de interrogação	Clique no ponto de interrogação para exibir ajuda para este diálogo.

  

• Depois que as tabelas forem baixadas, você pode copiar tabelas da coluna Tabelas Disponíveis para a coluna Tabelas Selecionadas.

• Destaque as tabelas a serem copiadas na coluna Tabelas Disponíveis e clique na seta direita.

• As seleções são então copiadas para a coluna Tabelas Selecionadas, como no exemplo abaixo.

  

• Após completar suas tabelas:

  Controle	Descrição
  Próximo	Clique neste botão para exibir a tela Relacionamentos hierárquicos de origem.
  Cancelar	Clique neste botão para fechar o assistente sem salvar suas entradas.

• Clique no botão Voltar para retornar à tela anterior.

Criar relacionamentos hierárquicos

• Clique no menu suspenso Selecionar tabela pai e faça uma seleção. Neste exemplo, selecionamos OrderHeader na lista.

• Clique no menu suspenso Selecionar tabela filho e faça uma seleção. Neste exemplo, selecionamos OrderDetail na lista.

• Em seguida, clique no botão Unir tabelas. A caixa de diálogo Propriedades de união é exibida.

  

• Na seção Link Keys, arraste e solte uma coluna pai (OrderHeader neste exemplo) para uma coluna filho (OrderDetail neste exemplo) para vinculá-las. Como alternativa, você pode selecionar uma coluna em cada tabela para ativar o botão Link e clicar neste botão para vincular as colunas.

• Você pode selecionar um link entre duas colunas para ativar o botão Remove Link e clicar nesse botão para remover o link.

• Clique no botão Column display order para selecionar Database (o padrão) ou Alphabetical.

• Após concluir a junção pai e filho, selecione um botão de opção para identificar o tipo de junção. O padrão é 1 para N. Neste exemplo, deixamos o padrão em 1 para N

  

• Após completar suas tabelas:

  Controle	Descrição
  OK	Clique neste botão para retornar à tela Source Hierarchical Relationships, que exibe sua árvore de tabelas mostrando os relacionamentos definidos atualmente.
  Cancelar	Clique neste botão para retornar à tela Relacionamentos hierárquicos de origem sem salvar suas entradas.

• Clique no botão Voltar para retornar à tela anterior.

  

  Controle	Descrição
  Próximo	Clique neste botão para exibir a tela SQL Where Clause.
  Cancelar	Clique neste botão para fechar o assistente sem salvar suas entradas.

• Clique no botão Voltar para retornar à tela anterior.

  

• Neste exemplo, não estamos usando condições de filtro.

  Controle	Descrição
  Próximo	Clique neste botão para exibir a tela de destino.
  Cancelar	Clique neste botão para fechar o assistente sem salvar suas entradas.

• Clique no botão Voltar para retornar à tela anterior.

Revise o resumo do banco de dados

Esta etapa permite que você revise os elementos do seu projeto antes que o Jitterbit crie automaticamente todas as definições do projeto, incluindo operações, transformações e chamadas de serviços web.

Reserve alguns minutos para navegar por todos os elementos do projeto.

• Caso precise fazer ajustes no projeto, clique no botão Voltar para retornar à tela anterior e fazer as alterações necessárias.

• Após revisar seu projeto, clique em Finish para exibir a aba Transformações. O painel Design é preenchido.

Revise o mapeamento

• Quando você clica em Concluir na tela Resumo, a aba Transformações é aberta no espaço de trabalho. (Você também pode abri-la a qualquer momento selecionando o nome do seu projeto no painel Design e clicando duas vezes.) A mensagem Mapeamentos também é exibida acima da aba.

  

• Se você deixou a caixa de seleção Use Automapper marcada, a maioria ou todos os campos já podem estar mapeados para você. O mapeamento válido é indicado por linhas verdes entre itens nas colunas Source e Target e, além disso, pela presença de um quadrado azul ao lado de cada nome de item mapeado validamente.

• Uma linha vermelha indica mapeamento inválido.

• Uma linha amarela indica que o Jitterbit não tem certeza se o mapeamento é válido para todas as possibilidades de dados, mas tentará a transformação com esse mapeamento.

• Você pode completar o mapeamento na aba Transformações arrastando e soltando de Origem à esquerda para Destino à direita. Quando você faz isso, o item Destino assumirá o mesmo nome do item Origem, e um quadrado azul aparecerá à esquerda de ambos os itens Origem e Destino. Veja Transformações para mais detalhes sobre a transformação.

• Para salvar sua transformação, clique na seta para baixo na faixa de status e selecione Salvar.

• Para sair desta tela, clique no X na extrema direita da aba.

A aba Assistentes do SFDC também abre quando você clica em Concluir.

• Clique na aba SFDC Wizards para exibir a tela Create Account. Aqui você pode alterar configurações como Chunking e Truncar Campos. A última configuração truncará os campos conforme necessário se o campo de destino for menor que o campo de origem. Na aba Assistentes do SFDC, você também pode executar ou testar a operação.

• Visualize o resumo gráfico de todo o projeto, clique na aba Operações ou clique com o botão direito no nome do projeto no painel Design.

  

Implantar o projeto

• No painel Design, em Transformações, clique com o botão direito do mouse no projeto recém-criado e, em seguida, clique com o botão esquerdo do mouse em Implementar no menu suspenso resultante; ou

• Clique com o botão direito do mouse em Operações na parte superior do painel Design e depois clique com o botão esquerdo em Implementar.

• O processo de implantação começa a enviar os dados para o servidor e uma mensagem de progresso é exibida.

• Para cancelar o processo de implantação, clique no botão Cancelar, que o retornará à tela anterior.

Isso conclui o processo XML para Banco de Dados. Se você deseja exportar este projeto como um Jitterpak, clique aqui.