Assistente de banco de dados para XML no Jitterbit Design Studio

O Jitterbit Connect^TM oferece uma maneira rápida e fácil de transformação de dados. Isso é possível através de uma ferramenta de integração baseada em assistente, incorporada diretamente no Jitterbit. O assistente executa para o usuário todas as operações e componentes complexos e detalhados de um projeto de Transformação. Ao seguir o assistente, os usuários podem criar um projeto de integração sem a necessidade de codificação. As convenções de tela neste documento são Fonte à esquerda e Destino à direita.

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

• Faça login no Salesforce via Jitterbit.

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

OU

• Abra o Jitterbit e clique no Ícone Jitterbit Connect na parte superior da tela.

• O menu do Assistente Jitterbit Connect aparece.

• Inicie o Assistente clicando no botão Banco de Dados para XML na coluna Padrão do menu do Assistente Jitterbit Connect. Isso exibe a tela de Seleção de Fonte de Banco de Dados.

• Comece a criar seu Projeto com o assistente.

Criar seleção de fonte de banco de dados

• Das Fontes de Banco de Dados Disponíveis, selecione Criar Novo… ou uma Fonte de Banco de Dados Existente.

Para criar uma Nova Fonte de Banco de Dados, preencha as Informações solicitadas.

• Insira um Nome apropriado para sua nova fonte no campo Nome.

• Escolha Banco de Dados no menu suspenso Tipo.

• Selecione o Driver de Banco de Dados apropriado clicando no botão Selecionar ao lado do campo do driver. Dependendo do driver que você selecionar, diferentes campos podem ser habilitados ou desabilitados.

• Insira o Nome do Servidor de Banco de Dados (seja nome ou endereço IP) que você deseja acessar no campo Nome do Servidor.

• Insira o Nome do banco de dados que você deseja acessar no campo Nome do Banco de Dados.

• Insira um Nome de Usuário e uma Senha válidos que permitirão o acesso ao seu banco de dados nos campos Login e Senha.

OPCIONAL:

• Se o servidor de banco de dados estiver escutando em uma porta não padrão, você pode desmarcar Usar Porta Padrão e especificar uma Porta Personalizada. A porta padrão varia dependendo do driver selecionado.

• Selecione o Nível de Isolamento de Transação no menu suspenso. As opções são as padrão do Transact-SQL. Níveis de isolamento de transação específicos do driver não são suportados. O padrão é usar o nível de isolamento de transação padrão do driver ou do servidor de banco de dados.

• Se você deseja definir um limite para quanto tempo esperar por uma conexão bem-sucedida ao banco de dados, insira o Número de Segundos no campo de tempo limite.

• Se você estiver usando um driver JDBC, pode definir a Propriedade de Tamanho de Busca. Essa propriedade dá uma dica ao driver sobre o número de linhas que devem ser buscadas no banco de dados quando mais linhas são necessárias. Essa configuração pode ser usada para um processamento mais eficiente de grandes conjuntos de dados.

• Se houver quaisquer parâmetros adicionais que você deseja adicionar à sua string de conexão do banco de dados, insira os Parâmetros no campo Parâmetros Adicionais da String de Conexão.

• A caixa de seleção Construir String de Conexão Manualmente está desmarcada por padrão. Se você gostaria de defini-la você mesmo, marque esta Caixa de Seleção. Você deve então inserir a String de Conexão no campo de texto correspondente. Para mais informações, consulte String de conexão manual.

  • Você pode querer testar suas Conexões antes de clicar em Avançar. Clicar neste Botão garante que todas as suas conexões funcionem. 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. Você também pode entrar em contato com o Suporte da Jitterbit.
  • Clique no botão Avançar para ir para Seleção de Tabela.

Criar seleção de fonte de tabela

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

OPCIONAL:

• Você pode inserir uma String de Pesquisa na janela de Filtro de Pesquisa. Marque as Caixas de Seleção de Tabela ou Visualização para limitar os objetos a serem selecionados.

• Você pode selecionar a Caixa de Seleção para incluir tabelas do sistema nos nomes das tabelas baixadas.

• Você pode selecionar a Caixa de Seleção para incluir o esquema/proprietário.

Uma vez que as tabelas sejam 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.

• Para remover tabelas da coluna Tabelas Selecionadas, destaque as Tabelas a serem copiadas na coluna Tabelas Selecionadas e clique na Seta Esquerda.

• As seleções são então movidas de volta para a coluna Tabelas Disponíveis.

Após completar suas tabelas:

• Clique no botão Próximo para exibir a tela de Relações Hierárquicas de Fonte, se as tabelas selecionadas tiverem uma relação hierárquica. Caso contrário, a tela de opções da Cláusula Where SQL será exibida.

• Clique no botão Cancelar para fechar o Assistente e retornar à aba Começando Sem Salvar suas entradas.

• Para retornar à tela anterior, clique no botão Voltar.

Criar relações hierárquicas

• Clique no dropdown Selecionar Tabela Pai e faça uma Seleção. Neste exemplo, selecionamos OrderHeader da lista.

• Clique no dropdown Selecionar Tabela Filha e faça uma Seleção. Neste exemplo, selecionamos OrderDetail da lista.

• Clique no botão Join Tables. A caixa de diálogo Join Properties aparece.

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

• Você pode selecionar um Link entre duas colunas para ativar o botão Remove Link, e então 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 completar a junção entre pai e filho, selecione um botão Radio para identificar o tipo de junção. O padrão é Um ou Mais. Neste exemplo, deixamos o padrão em Um ou Mais.

• Clique em OK para retornar à tela de Source Hierarchical Relationships, que exibe sua árvore de tabelas mostrando os relacionamentos atualmente definidos OU clique em Cancel para retornar à tela de Source Hierarchical Relationships sem salvar suas entradas.

• Para retornar à tela anterior, clique no botão Back.

• Clique no botão Next para exibir a tela opcional de SQL Where Clause.

• Clique no botão Cancel para fechar o Wizard e retornar à aba "Getting Started" sem salvar suas entradas.

• Para retornar à tela anterior, clique no botão Back.

Criar seleção de cláusula SQL WHERE de origem (opcional)

• Insira qualquer cláusula SQL Where desejada para filtrar os dados de origem.

• Clique no botão Next para exibir a tela opcional de Seleção de Chave Primária.

• Clique no botão Cancel para fechar o Wizard e retornar à aba Getting Started sem salvar suas entradas.

• Para retornar à tela anterior, clique no botão Back.

Criar seleção de chave primária de origem (opcional)

• Selecione uma Chave Primária clicando na Caixa de Seleção na coluna Selecionar à esquerda do Nome.

• A caixa de seleção Nullable está marcada por padrão. Deixe selecionada se você quiser que uma coluna contenha elementos de dados nulos.

• Clique no botão Desmarcar Todos para remover suas seleções. Você pode então fazer novas seleções.

• Clique em OK para salvar suas seleções e retornar à tela de Inserir/Atualizar, que agora exibe suas seleções.

• Clique em Cancelar para descartar suas seleções e retornar à tela de Inserir/Atualizar.

Atualizar a seleção do campo de dados de origem (opcional e exibido apenas se a transformação for para um destino plano.)

• Selecione um Campo nos Dados de Origem para atualizar quando quiser filtrar linhas que já foram transformadas.

• Clique no botão Próximo para exibir a tela de seleção do Formato do Arquivo de Destino.

• Clique no botão Cancelar para fechar o Assistente e retornar à aba Começando Sem Salvar suas entradas.

• Para retornar à tela anterior, clique no botão Voltar.

Criar o destino

• Esta tela solicita que você gere um XSD (um esquema XML) com base na tabela de Origem.

• Clique no botão Não para recusar.

• Clique no botão Sim para gerar um XSD. A tela se expande para exibir um campo de nome e o botão Gerar XSD.

• Insira um Nome do Arquivo XSD e clique no botão Gerar XSD. A tela se expande para exibir o documento do esquema XML.

• Você pode clicar no botão Opções para especificar opções para o nome raiz, namespace de destino e inclusão de valores padrão.

• Clique no botão Próximo para exibir a tela de Opções de Destino.

• Clique no botão Cancelar para fechar o Assistente e retornar à aba Começando Sem Salvar suas entradas.

• Para retornar à tela anterior, clique no botão Voltar.

• A caixa de seleção "Valida instâncias XML contra o XSD ou DTD selecionado" está marcada por padrão. Neste exemplo, estamos deixando a caixa de seleção marcada.

  Nota

  Se você desejar a opção de gerar um atributo xsi:schemaLocation no XML de destino, insira um Local de Esquema no campo de texto. Neste exemplo, não estamos selecionando esta opção.

• Clique no botão Próximo para exibir a tela Selecionar um Alvo de Arquivo.

• Clique no botão Cancelar para fechar o Assistente e retornar à aba Começando sem salvar suas entradas.

• Para retornar à tela anterior, clique no botão Voltar.

Neste exemplo, o Alvo MyXML foi criado anteriormente fora da operação do Assistente e aparece aqui.

• Para selecionar um Alvo de Arquivo existente, clique no Dropdown e faça sua seleção.

• Para editar um Alvo de Arquivo existente, selecione no Dropdown, que abrirá uma caixa de diálogo na qual você pode editar os parâmetros do alvo.

• Clique no botão Criar Novo e preencha os Campos para criar um Novo Alvo de Arquivo.

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

Revise o resumo da operação

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 momentos para navegar por todos os elementos do projeto.

• Se você precisar fazer ajustes no seu projeto, clique no botão Voltar para retornar à tela anterior e fazer as alterações necessárias.

• Após revisar seu projeto, clique em Concluir para exibir a aba de Transformação. O painel de Design será preenchido.

Revisar o mapeamento

• Quando você clica em Finalizar na tela de Resumo, a aba Transformações é aberta no espaço de trabalho. A mensagem de Mapeamentos também é exibida acima da aba.

• Se você recebeu esta mensagem, clique em Fechar. Antes de fechar, você também pode selecionar a caixa de seleção Não Mostrar Novamente.

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

• 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 este mapeamento.

• Você pode completar o mapeamento na aba Transformações arrastando e soltando de Fonte à esquerda para Destino à direita. Ao fazer isso, o item de Destino assumirá o mesmo nome que o item de Fonte, e um quadrado azul aparecerá à esquerda de ambos os itens de Fonte e Destino. Veja Transformações para mais detalhes sobre transformações.

• Para visualizar o resumo gráfico da operação, clique duas vezes no Nome da Operação sob Jitterbit Connect / Banco de Dados para XML no painel à esquerda.

Implantar o projeto

• No topo do painel à esquerda, clique com o botão direito no Nome do Projeto para destacá-lo e, em seguida, clique com o botão esquerdo em Implantar no menu suspenso resultante.

• As opções para implantar o projeto serão exibidas.

• Clique no botão Implantar para implantar seu projeto.

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

• Para executar esta mensagem de progresso em segundo plano, clique no botão Executar em Segundo Plano.

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