Guia de Início Rápido do 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 de seu primeiro projeto do Design Studio.

Se você não estiver usando o Design Studio e estiver usando o Cloud Studio, nosso aplicativo de design de projeto baseado na Web, consulte o Guia de início rápido do Cloud Studio. Entre em contato com seu gerente de sucesso do cliente para determinar qual aplicativo Studio melhor atende às suas necessidades para novos projetos ou para agendar uma verificação de avaliação de prontidão para mover projetos existentes do Design Studio para o Cloud Studio.

Para este guia, começamos com o processo de importando um projeto existente e executando operações. Em seguida, mostramos como desenhar 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 amostra Starter Pack Jitterpak (.JPK).

As duas partes deste passo a passo cobrem estas tarefas no Design Studio:

• Parte 1: Introdução a um projeto de amostra
  • Importar um Jitterpak
  • Verificar dados existentes
  • Executar operações e verificar novos dados
• Parte 2: Criar 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 transferência de dados do cliente de uma variedade de fontes diferentes (CSV, JSON, banco de dados, XML) para o Salesforce. Após cada upsert, podemos verificar o Salesforce para ver se os dados foram criados.

Importe um Jitterpak¶

Importe o projeto de amostra 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 Select Jitterpak, conclua cada etapa da seguinte forma:

      1. Selecione JPK: Navegue ou insira a localização do Jitterpak. Em seguida, clique em Próximo.

         

      2. Opções: Para aceitar todos os padrões, clique em Avançar.

         

      3. Variáveis do projeto: Forneça credenciais para sua conta do Salesforce substituindo o Valor de 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ê deverá ver os itens do projeto sob os títulos Operações, Transformações, Fontes, Métodos de serviço da Web, Arquivo Formatos, Variáveis do projeto e Jitterbit Connect > Salesforce.

   

Verifique os Dados Existentes¶

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

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

2. Vá até o objeto Contas e acesse a visualização Novas esta semana (no Lightning Experience) ou Contas novas hoje.

   

3. Nenhum registro deverá ser devolvido. Deixe esta tela aberta para retornar posteriormente neste processo.

   

Execute Operações e Verifique Novos Dados¶

As operações incluídas no Jitterpak importado são usadas para fazer upload de dados de clientes de diversas 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 o Salesforce para ver se os dados foram criados.

Carregar CSV para Salesforce¶

Esta operação transfere os dados do cliente 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 na área 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 da área 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 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 limpar sua instância do Salesforce para seu estado pré-existente. Se continuar para a próxima etapa deste guia, deixe esta tela aberta para retornar mais tarde.

      

Atualize JSON para Salesforce¶

Esta operação transfere os dados do cliente de um arquivo JSON 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 (JSON)" para abri-la na área 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 da área 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 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 pré-existente. Se continuar para a próxima etapa deste guia, deixe esta tela aberta para retornar mais tarde.

      

Upsert Banco de Dados para Salesforce¶

Esta operação transfere os dados do cliente 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 na área 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 da área 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 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 pré-existente. Se continuar para a próxima etapa deste guia, deixe esta tela aberta para retornar mais tarde.

      

Fazer Upload de XML para Salesforce¶

Esta operação transfere os dados do cliente de um arquivo XML 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 (XML)" para abri-la na área 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 da área 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 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 XML).

      

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

      

Pontas¶

Saiba mais sobre as operações que você acabou de executar observando como funcionam as variáveis de transformação e de projeto.

Transformações¶

Clique duas vezes na transformação chamada "Solicitação de Upsert Contas (CSV)" para abri-la no espaço de trabalho de design. Dentro da transformação, o lado esquerdo representa a estrutura da origem 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 destino Account objeto no Salesforce.

Variáveis do Projeto¶

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

Se você ou outro usuário fizer alterações nessas credenciais no futuro, poderá 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 em Jitterbit Connect > Salesforce > Salesforce Orgs na sua organização.

Outro local no projeto de amostra em que a organização do Salesforce é usada é nas próprias 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: Elabore 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) fazer upload de dados do cliente de um banco de dados para o Salesforce e (2) fazer upload de dados do cliente de um arquivo JSON para o Salesforce.

Crie 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, estas etapas mostram como criar operações de exemplo para fazer o upser dos dados do cliente de um banco de dados para o Salesforce e fazer o upser dos dados do cliente de um arquivo JSON para o Salesforce.

Upsert Banco de Dados para Salesforce¶

Esta operação transfere os dados do cliente de um banco de dados para o Salesforce para criar novos registros de conta no Salesforce. Para criar esta operação:

1. Defina a origem 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 Nova Fonte conforme a seguir, utilizando informações de um banco de dados PostgreSQL hospedado pela Jitterbit:

      • Nome: Digite 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] e clique em OK para continuar.
        • Nome do servidor: Digite demodb.jitterbit.com.
        • Nome do banco de dados: Insira JitterbitDemoDB.
        • Login: Digite usuário somente leitura.
        • Senha: Digite usuário somente leitura.

      

   4. Na mesma tela de configuração Nova fonte, ao lado de Parâmetros de conexão, clique em Testar conexão para verificar se o Jitterbit pode 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 New Salesforce Org.

      

   2. Na tela de configuração Nova organização do 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 pode se conectar à instância do Salesforce. Em seguida, clique em OK para continuar.

      

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

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

      

   2. Na etapa Login, use o menu suspenso para selecionar a organização do Salesforce que você acabou de configurar. Em seguida, clique em Avançar para continuar.

      

   3. Na etapa 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 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 OK. Em seguida, clique em **Avançar para continuar.

         

   4. Na etapa Fonte, selecione a origem do 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 origem do 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 Avançar para continuar.

         

      3. Na próxima tela, clique em Baixar lista de tabelas para listar as tabelas e visualizações disponíveis na origem do banco de dados. Em Mesas Disponíveis à esquerda, selecione o customers tabela e clique na seta para a direita para mover a tabela em 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 em branco. Clique em próximo para continuar.

         

   5. Na etapa Programação e opções, você pode agendar operações para serem executadas em intervalos especificados. Para este exercício, não adicionaremos uma programação. 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, como segue. Quando o mapeamento for concluído, clique em Concluir para continuar.

   Fonte	Alvo
   ID	Account Number
   Company	Name
   Street	Billing Street
   City	Billing City
   State	Billing State
   Country	Billing Country
   Phone	Phone
   Zipcode	Billing Postal Code
   Industry	Industry
   Type	Type
   Annual Revenue	Annual Revenue

   

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. Neste exemplo, o espaço reservado de destino não é usado na operação, portanto podemos removê-lo. No gráfico de 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 salvar tudo para salvar todos os itens do projeto. Em seguida, clique no ícone de implantar para implantar o projeto.

   

7. Parabéns! Agora você criou a mesma operação "Upsert Accounts (Read-Only Database)" fornecida em Parte 1: Introdução a um projeto de exemplo. Consulte as etapas em Executar operações para executar a operação, verificar o status e ver os novos registros no Salesforce.

Atualize JSON para Salesforce¶

Esta operação transfere os dados do cliente de um arquivo JSON para o Salesforce para criar novos registros de conta no Salesforce. Para criar esta operação:

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

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

      

   2. Na janela Select Type, selecione HTTP, onde reside o arquivo JSON fornecido para este passo a passo. Em seguida, clique em Continuar.

      

   3. Preencha a tela de configuração Nova Fonte da seguinte forma:

      • Nome: Insira Dados JSON.
      • Parâmetros de conexão
        • URL: Entrar https://download.jitterbit.com/se/templates/sampledata/Customer_Data_JSON.json.
        • Testar conexão: Clique neste botão para verificar se o Jitterbit pode se conectar ao URL. Em seguida, clique em OK para continuar.

      

2. Se ainda não tiver feito isso, crie a conexão com o Salesforce conforme abordado no passo a passo de criação de operação anterior. Consulte a etapa 2 em Upsert Database to Salesforce para obter instruções.

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

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

      

   2. Na etapa Login, use o menu suspenso para selecionar sua organização do Salesforce. Clique em Testar login do Salesforce para verificar sua conexão. Clique OK. Em seguida, clique em **Avançar para continuar.

      

   3. Na etapa 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 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 OK. Em seguida, clique em **Avançar para continuar.

         

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

      

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

      

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

      

   7. Na próxima tela, conclua as etapas da seguinte forma:

      1. Em Selecione um arquivo de amostra, selecione URL para um arquivo JSON remoto e insira o mesmo URL 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 Avançar para continuar.

         

   8. Na etapa Programação e opções, você pode agendar operações para serem executadas quando você especificar. Para este exercício, não adicionaremos uma programação. 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 e Concluir.

      

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, como segue. Quando o mapeamento for concluído, clique em Concluir para continuar.

   Fonte	Alvo
   ID	Account Number
   Company	Name
   Street	Billing Street
   City	Billing City
   State	Billing State
   Country	Billing Country
   Phone	Phone
   Zipcode	Billing Postal Code
   Industry	Industry
   Type	Type
   Annual Revenue	Annual Revenue

   

5. No painel esquerdo, clique duas vezes na operação "Upsert Accounts JSON" para exibir a operação no espaço de trabalho de design. Neste exemplo, o espaço reservado de destino não é usado na operação, portanto podemos removê-lo. No gráfico de 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 salvar tudo para salvar todos os itens do projeto. Em seguida, clique no ícone de implantar para implantar o projeto.

   

7. Parabéns! Agora você criou a mesma operação "Upsert Accounts (JSON)" fornecida em Parte 1: Introdução a um projeto de exemplo. Consulte as etapas em Executar operações para executar a operação, verificar o status e ver os novos registros no Salesforce.