Guia de início rápido para o Jitterbit Design Studio

Introdução

Este guia é destinado a novos usuários do Design Studio, o aplicativo de desktop da Jitterbit onde você pode projetar, testar e implantar projetos de integração. Este guia orienta você na criação do seu primeiro projeto no Design Studio.

Se você não estiver usando o Design Studio e, em vez disso, estiver utilizando o Studio, nosso aplicativo de design de projetos baseado na web, consulte o guia de início rápido do Studio. Entre em contato com seu Gerente de Sucesso do Cliente para determinar qual aplicativo Studio atende melhor às suas necessidades para novos projetos ou para agendar uma Avaliação de Prontidão para mover projetos existentes do Design Studio para o Studio.

Para este guia, começamos com o processo de importação de um projeto existente e execução de operações. Em seguida, mostramos como projetar um projeto do zero, incluindo a criação de um projeto e a configuração de duas das mesmas operações já fornecidas no projeto de exemplo.

Para acompanhar, baixe o projeto de exemplo Starter Pack Jitterpak (.JPK).

As duas partes deste walkthrough cobrem estas tarefas no Design Studio:

• Parte 1: Comece com um projeto de exemplo
  • Importar um Jitterpak
  • Verificar dados existentes
  • Executar operações e verificar novos dados
• Parte 2: Projetar um novo projeto
  • Criar um projeto
  • Criar operações

Parte 1: Comece com um projeto de exemplo

Esta parte cobre a importação de um Jitterpak, a verificação de dados existentes no Salesforce e, em seguida, a inserção de dados de clientes a partir de uma variedade de fontes diferentes (CSV, JSON, banco de dados, XML) para o Salesforce. Após cada inserção, podemos verificar o Salesforce para ver se os dados foram criados.

Importar um Jitterpak

Importe o projeto de exemplo Starter Pack Jitterpak (.JPK).

1. Abra o aplicativo Design Studio.

   

2. Importe o projeto de exemplo Starter Pack Jitterpak (.JPK). Para fazer isso:

   1. Vá para Arquivo > Importar Jitterpak:

      

   2. Na janela Selecionar Jitterpak, complete cada etapa da seguinte forma:

      1. Selecionar JPK: Navegue até ou insira o local do Jitterpak. Em seguida, clique em Próximo.

         

      2. Opções: Para aceitar todas as configurações padrão, clique em Próximo.

         

      3. Variáveis do Projeto: Forneça credenciais para sua conta do Salesforce substituindo o Valor para cada uma das Variáveis. Em seguida, clique em Concluir.

         

3. Verifique se os itens do projeto foram importados.

   No painel esquerdo do Design Studio, você deve ver os itens do projeto sob os cabeçalhos de Operações, Transformações, Fontes, Métodos de Serviço Web, Formatos de Arquivo, Variáveis do Projeto e Jitterbit Connect > Salesforce.

   

Verificar dados existentes

Verifique a presença de contas existentes criadas hoje no Salesforce.

1. Faça login na sua instância do Salesforce (fora do Design Studio).

2. Vá para o objeto Accounts e acesse a visualização New This Week (na Lightning Experience) ou Accounts New Today.

   

3. Nenhum registro deve ser retornado. Deixe esta tela aberta para retornar mais tarde neste processo.

   

Execute operações e verifique novos dados

As operações incluídas no Jitterpak importado são usadas para upsertar dados de clientes de uma variedade de fontes diferentes para uma instância do Salesforce. As fontes incluem CSV, JSON, banco de dados e XML. Após cada upsert, você também pode verificar no Salesforce se os dados foram criados.

Upsert CSV para Salesforce

Esta operação upserta dados de clientes de um arquivo CSV para o Salesforce para criar novos registros de conta no Salesforce. Para executar esta operação e verificar se foi bem-sucedida:

1. No painel esquerdo, clique duas vezes na operação chamada "Upsert Accounts (CSV)" para abri-la no espaço de trabalho de design.

2. Clique no ícone do raio no canto superior direito para executar a operação.

   

3. Se solicitado, clique em Continue para implantar os itens do projeto necessários para a execução da operação.

   

4. Verifique o Status da operação na parte inferior do espaço de trabalho de design. Clique duas vezes nos ícones de status para mostrar a mensagem de log da operação, que deve indicar que a operação foi concluída com sucesso com informações.

   

5. Verifique o Salesforce para ver se os dados foram criados e, em seguida, exclua os dados recém-criados. Para fazer isso:

   1. Atualize a visualização do Salesforce deixada aberta na etapa anterior Verificar dados existentes. Cinco registros devem ser retornados (carregados do arquivo CSV).

      

   2. Exclua os novos registros para restaurar sua instância do Salesforce ao estado anterior. Se continuar para a próxima etapa deste guia, mantenha esta tela aberta para retornar mais tarde.

      

Upsert JSON para Salesforce

Esta operação insere ou atualiza dados de clientes a partir de um arquivo JSON no Salesforce para criar novos registros de conta no Salesforce. Para executar esta operação e verificar se foi bem-sucedida:

1. No painel esquerdo, clique duas vezes na operação chamada "Upsert Accounts (JSON)" para abri-la no espaço de trabalho de design.

2. Clique no ícone do raio no canto superior direito para executar a operação.

   

3. Se solicitado, clique em Continuar para implantar os itens do projeto necessários para a execução da operação.

   

4. Verifique o Status da operação na parte inferior do espaço de trabalho de design. Clique duas vezes no ícone de status para mostrar a mensagem de log da operação, que deve indicar que a operação foi concluída com sucesso.

   

5. Verifique o Salesforce para ver se os dados foram criados e, em seguida, exclua os dados recém-criados. Para fazer isso:

   1. Atualize a visualização do Salesforce deixada aberta na etapa anterior. Cinco registros devem ser retornados (carregados do arquivo JSON).

      

   2. Exclua os novos registros para limpar sua instância do Salesforce para seu estado anterior. Se continuar para a próxima etapa deste guia, mantenha esta tela aberta para retornar mais tarde.

      

Upsert database to Salesforce

Esta operação insere ou atualiza dados de clientes de um banco de dados para o Salesforce para criar novos registros de conta no Salesforce. Para executar esta operação e verificar se foi bem-sucedida:

1. No painel esquerdo, clique duas vezes na operação chamada "Upsert Accounts (Read-Only Database)" para abri-la no espaço de trabalho de design.

2. Clique no ícone do raio no canto superior direito para executar a operação.

   

3. Se solicitado, clique em Continuar para implantar os itens do projeto necessários para a execução da operação.

   

4. Verifique o Status da operação na parte inferior do espaço de trabalho de design. Clique duas vezes nos ícones de status para mostrar a mensagem do log da operação, que deve indicar que a operação foi concluída com sucesso com informações.

   

5. Verifique o Salesforce para ver se os dados foram criados e, em seguida, exclua os dados recém-criados. Para fazer isso:

   1. Atualize a visualização do Salesforce deixada aberta na etapa anterior. Cinco registros devem ser retornados (carregados do banco de dados).

      

   2. Exclua os novos registros para limpar sua instância do Salesforce para seu estado anterior. Se continuar para a próxima etapa deste guia, mantenha esta tela aberta para retornar mais tarde.

      

Upsert XML para Salesforce

Esta operação insere ou atualiza dados de clientes a partir de um arquivo XML para o Salesforce, criando novos registros de conta no Salesforce. Para executar esta operação e verificar se foi bem-sucedida:

1. No painel esquerdo, clique duas vezes na operação chamada "Upsert Accounts (XML)" para abri-la no espaço de trabalho de design.

2. Clique no ícone do raio no canto superior direito para executar a operação.

   

3. Se solicitado, clique em Continuar para implantar os itens do projeto necessários para a execução da operação.

   

4. Verifique o Status da operação na parte inferior do espaço de trabalho de design. Clique duas vezes no ícone de status para mostrar a mensagem de log da operação, que deve indicar que a operação foi concluída com sucesso.

   

5. Verifique o Salesforce para ver se os dados foram criados e, em seguida, exclua os dados recém-criados. Para fazer isso:

   1. Atualize a visualização do Salesforce que ficou aberta na etapa anterior. Cinco registros devem ser retornados (carregados a partir do arquivo XML).

      

   2. Exclua os novos registros para limpar sua instância do Salesforce para seu estado anterior. Se continuar para a próxima etapa deste guia, mantenha esta tela aberta para retornar mais tarde.

      

Dicas

Saiba mais sobre as operações que você acabou de executar, dando uma olhada em como as transformações e variáveis do projeto funcionam.

Transformações

Dê um clique duplo na transformação chamada "Upsert Accounts (CSV) Request" para abri-la no espaço de design. Dentro da transformação, o lado esquerdo representa a estrutura da fonte, e o lado direito representa a estrutura do destino. Os campos de origem listados aqui, ID, Company, Street, City, State, Country, Phone, Zipcode, Industry, Type e Annual_Revenue, são mapeados do arquivo CSV para campos dentro do objeto Account no Salesforce.

Variáveis do projeto

Durante a importação do Jitterpak de amostra, três variáveis do projeto foram definidas como parte do seu projeto: SFDC_Username, SFDC_Password e SFDC_Security_Token. Essas variáveis do projeto permitem que as credenciais da organização Salesforce incluídas neste Jitterpak sejam alteradas sem modificar a configuração da própria organização Salesforce.

Se você ou outro usuário tiver alterações a essas credenciais no futuro, é possível alterá-las atualizando o valor da variável do projeto na seção Variáveis do Projeto no painel esquerdo. Os valores entrarão em vigor automaticamente na seção Jitterbit Connect > Salesforce > Salesforce Orgs na sua organização.

Outro lugar dentro do projeto de amostra onde a organização Salesforce é utilizada é nas operações de upsert. Em Jitterbit Connect > Salesforce > Salesforce Upserts para cada operação, você pode ver e editar todos os parâmetros usados para configurar a operação.

Parte 2: Projetar um novo projeto

A parte anterior mostrou como importar e executar operações usando o Design Studio. Esta parte aborda como criar um projeto e configurar duas das mesmas operações já fornecidas no projeto de amostra: (1) upsert de dados de clientes de um banco de dados para o Salesforce, e (2) upsert de dados de clientes de um arquivo JSON para o Salesforce.

Criar um projeto

Primeiro, crie um novo projeto usando o Design Studio.

1. Abra o aplicativo Design Studio.

   

2. Vá para Arquivo > Novo Projeto:

   

3. Na janela Novo Projeto, no campo Nome do Projeto, insira "Jitterbit Get Started." Você pode deixar os outros campos como padrão.

   

4. Clique em OK para criar seu projeto e abrir o espaço de trabalho de design.

Criar operações

Após a criação do seu novo projeto, estes passos mostram como criar operações de exemplo para inserir dados de clientes de um banco de dados para o Salesforce e inserir dados de clientes de um arquivo JSON para o Salesforce.

Inserir banco de dados no Salesforce

Esta operação insere dados de clientes de um banco de dados para o Salesforce para criar novos registros de conta no Salesforce. Para criar esta operação:

1. Defina a fonte dos dados. Para fazer isso:

   1. No painel esquerdo, clique com o botão direito em Fontes e selecione Nova Fonte.

      

   2. Na janela Selecionar Tipo, selecione Banco de Dados. Em seguida, clique em Continuar.

      

   3. Preencha a tela de configuração da Nova Fonte da seguinte forma, usando informações de um banco de dados PostgreSQL hospedado pela Jitterbit:

      • Nome: Insira Banco de Dados.
      • Parâmetros de Conexão
        • Driver: Clique no botão Selecionar para abrir a janela Selecionar Driver. Nesta janela, selecione o driver PostgreSQL [JDBC], em seguida, clique em OK para continuar.
        • Nome do Servidor: Insira demodb.jitterbit.com.
        • Nome do Banco de Dados: Insira JitterbitDemoDB.
        • Login: Insira readonlyuser.
        • Senha: Insira readonlyuser.

      

   4. Na mesma tela de configuração de Nova Fonte, ao lado de Parâmetros de Conexão, clique em Testar Conexão para verificar se o Jitterbit consegue se conectar ao banco de dados. Em seguida, clique em OK para continuar.

      

2. Crie a conexão com o Salesforce. Para fazer isso:

   1. No painel esquerdo, em Jitterbit Connect > Salesforce, clique com o botão direito em Salesforce Orgs e selecione Nova Org Salesforce.

      

   2. Na tela de configuração de Nova Org Salesforce, insira o Nome de usuário, Senha e Token de Segurança para sua instância do Salesforce. Em seguida, clique em Testar Login do Salesforce para verificar se o Jitterbit consegue se conectar à instância do Salesforce. Depois, clique em OK para continuar.

      

3. Crie o upsert do Salesforce usando a fonte definida e a conexão configurada do Salesforce. Para fazer isso:

   1. No painel esquerdo, em Jitterbit Connect > Salesforce, clique com o botão direito em Upserts do Salesforce e selecione Novo Upsert do Salesforce.

      

   2. Na etapa de Login, use o menu suspenso para selecionar a org do Salesforce que você acabou de configurar. Em seguida, clique em Próximo para continuar.

      

   3. Na etapa de Objeto, você pode ver todos os objetos do Salesforce disponíveis para a conta, incluindo quaisquer objetos personalizados. Esta etapa tem duas partes:

      1. Em Selecione o Objeto do Salesforce, clique em Conta para selecionar este objeto.

         

      2. Em Selecione um Campo de ID Externo, clique no botão Selecionar Campo e, na janela pop-up, selecione o campo "Id". Clique em OK. Em seguida, clique em Próximo para continuar.

         

   4. Na etapa Fonte, selecione a fonte de banco de dados que você já configurou. Para fazer isso:

      1. Use o primeiro menu suspenso para selecionar Banco de Dados (Oracle, SQL Server, MySQL, etc.) e o segundo menu suspenso para selecionar a fonte de banco de dados que você já configurou. Clique em Próximo para continuar.

         

      2. Na próxima tela, você tem a opção de fornecer uma instrução SQL. Para este exercício, pule esta etapa clicando em Próximo para continuar.

         

      3. Na próxima tela, clique em Baixar Lista de Tabelas para listar as tabelas e visualizações disponíveis dentro da fonte de banco de dados. Em Tabelas Disponíveis à esquerda, selecione a tabela customers e clique na seta para a direita para mover a tabela para Tabelas Selecionadas à direita. Clique em Próximo para continuar.

         

      4. Na próxima tela, você tem a opção de adicionar uma cláusula WHERE. Para este exercício, deixaremos isso em branco. Clique em Próximo para continuar.

         

   5. Na etapa Agendamento e Opções, você pode agendar operações para serem executadas em intervalos que você especificar. Para este exercício, vamos pular a adição de um agendamento. Clique em Próximo para continuar.

      

   6. Na etapa Resumo, insira "Upsert Accounts DB" como o nome a ser usado para esta operação. Em seguida, clique em Mapear e Concluir.

      

4. Configure a transformação. No lado esquerdo da transformação estão os campos de origem do banco de dados, e no lado direito estão os campos de destino do Salesforce.

   Para configurar a transformação, mapeie os campos de origem para os campos de destino arrastando individualmente cada campo de origem e soltando-o sobre o campo de destino correspondente da seguinte forma. Quando o mapeamento estiver completo, clique em Concluir para continuar.

   Source	Target
   ID	Número da Conta
   Company	Nome
   Street	Rua de Cobrança
   City	Cidade de Cobrança
   State	Estado de Cobrança
   Country	País de Cobrança
   Phone	Telefone
   Zipcode	Código Postal de Cobrança
   Industry	Indústria
   Type	Tipo
   Annual Revenue	Receita Anual

   

5. No painel esquerdo, clique duas vezes na operação "Upsert Accounts DB" para exibir a operação dentro do espaço de trabalho de design. Para este exemplo, o espaço reservado de destino não é utilizado dentro da operação, então podemos removê-lo. No gráfico da operação, clique com o botão direito no ícone Target e selecione Remove From Graph.

   

6. Na barra de menu de ícones, clique no ícone de salvar tudo para salvar todos os itens do projeto. Em seguida, clique no ícone de implantar para implantar o projeto.

   

7. Parabéns! Você agora criou a mesma operação "Upsert Accounts (Banco de Dados Somente Leitura)" que foi fornecida em Parte 1: Comece com um projeto de exemplo. Consulte os passos em Executar operações para executar a operação, verificar o status e ver os novos registros no Salesforce.

Upsert JSON para Salesforce

Esta operação insere ou atualiza dados de clientes de um arquivo JSON para o Salesforce para criar novos registros de conta no Salesforce. Para criar esta operação:

1. Defina a fonte dos dados. Para fazer isso:

   1. No painel esquerdo, clique com o botão direito em Sources e selecione New Source.

      

   2. Na janela Select Type, selecione HTTP, onde o arquivo JSON fornecido para este guia está localizado. Em seguida, clique em Continue.

      

   3. Preencha a tela de configuração de New Source da seguinte forma:

      • Name: Digite JSON Data.
      • Connection Parameters
        • URL: Digite https://download.jitterbit.com/se/templates/sampledata/Customer_Data_JSON.json.
        • Test Connection: Clique neste botão para verificar se o Jitterbit pode se conectar à URL. Em seguida, clique em OK para continuar.

      

2. Se você ainda não fez isso, crie a conexão com o Salesforce conforme abordado no guia de criação de operações anterior. Veja a etapa 2 em Upsert database to Salesforce para instruções.

3. Crie o upsert do Salesforce usando a fonte definida e a conexão configurada do Salesforce. Para fazer isso:

   1. No painel esquerdo, sob Jitterbit Connect > Salesforce, clique com o botão direito em Salesforce Upserts e selecione New Salesforce Upsert.

      

   2. Na etapa Login, use o menu suspenso para selecionar sua organização do Salesforce. Clique em Test Salesforce Login para verificar sua conexão. Clique em OK. Em seguida, clique em Next para continuar.

      

   3. Na etapa Object, você pode ver todos os objetos do Salesforce disponíveis para a conta, incluindo quaisquer objetos personalizados. Esta etapa tem duas partes:

      1. Sob Select the Salesforce Object, clique em Account para selecionar este objeto.

         

      2. Em Selecionar um Campo de ID Externo, clique no botão Selecionar Campo e, na janela pop-up, selecione o campo "Id". Clique em OK. Em seguida, clique em Próximo para continuar.

         

   4. Na etapa Fonte, use o primeiro dropdown para selecionar HTTP e o segundo dropdown para selecionar a fonte HTTP que você já configurou. Clique em Próximo para continuar.

      

   5. Na próxima tela, selecione JSON como o tipo de arquivo. Clique em Próximo para continuar.

      

   6. Na próxima tela, se você já tiver um esquema de arquivo, pode selecioná-lo aqui. Para este exercício, selecione Criar uma nova estrutura JSON a partir de um arquivo de exemplo (próxima página). Clique em Próximo para continuar.

      

   7. Na próxima tela, complete os passos da seguinte forma:

      1. Em Selecionar um Arquivo de Exemplo, selecione URL para um arquivo JSON remoto e insira a mesma URL que a da sua fonte HTTP: https://download.jitterbit.com/se/templates/sampledata/Customer_Data_JSON.json.

         

      2. Em Gerar o XSD, clique em Gerar para gerar a estrutura. Em seguida, clique em Próximo para continuar.

         

   8. Na etapa Agendamento & Opções, você pode agendar operações para serem executadas quando especificar. Para este exercício, vamos pular a adição de um agendamento. Clique em Próximo para continuar.

      

   9. Na etapa Resumo, insira "Upsert Accounts JSON" como o nome a ser usado para esta operação. Em seguida, clique em Mapear & Finalizar.

      

4. Configure a transformação. No lado esquerdo da transformação estão os campos de origem do arquivo JSON, e no lado direito estão os campos de destino do Salesforce.

Para configurar a transformação, mapeie os campos de origem para os campos de destino arrastando individualmente cada campo de origem e soltando-o sobre o campo de destino correspondente da seguinte forma. Quando o mapeamento estiver completo, clique em Concluir para continuar.

1. No painel esquerdo, clique duas vezes na operação "Upsert Accounts JSON" para exibir a operação dentro do espaço de trabalho de design. Para este exemplo, o espaço reservado de destino não é utilizado dentro da operação, então podemos removê-lo. No gráfico da operação, clique com o botão direito no ícone Destino e selecione Remover do Gráfico.

1. Na barra de menu de ícones, clique no ícone de salvar tudo para salvar todos os itens do projeto. Em seguida, clique no ícone de implantar para implantar o projeto.

1. Parabéns! Você agora criou a mesma operação "Upsert Accounts (JSON)" que foi fornecida em Parte 1: Comece com um projeto de exemplo. Consulte os passos em Executar operações para executar a operação, verificar o status e ver os novos registros no Salesforce.