Tutorial: Criando um Arquivo Local para a Integração do salesforce.com

É possível criar e executar as integrações com o IBM® Cast Iron Express. Este tutorial descreve como criar uma integração a partir de um arquivo local para o salesforce.com. É possível definir rapidamente a integração e fazer upload de seus dados em uma única operação.

Etapa 1: Criar a Integração

Após efetuar sign in no Cast Iron Express, clique em Integrações. Com a visualização Integrações aberta, crie uma integração ao selecionar seus terminais de origem e de destino.

Dica: É possível clicar em Salvar em intervalos regulares ao criar e definir uma integração. Seu trabalho não será perdido se você tiver problemas no navegador da web ou for desconectado do Cast Iron Express devido a inatividade.

Para este tutorial, selecione Arquivo Local como a Origem e salesforce.com como o Destino.

Painel de terminais de Origem e Destino

Clique em Nova Integração em Branco, que é exibido na seleção de destino.

Uma integração de estrutura de tópicos é exibida, na qual a Origem, Transformação e Destino devem ser definidos. Os números indicam a sequência de definição de integração:
  1. Definir o terminal de origem
  2. Definir o terminal de destino
  3. Definir a transformação ao mapear o caminho de dados a partir do terminal de origem para o terminal de destino

O painel Integrações

Etapa 2: Configurar os Terminais

No cabeçalho de Origem, clique em Editar.

A visualização de configuração de terminal de origem é aberta.

Clique em Selecionar Arquivo e escolha o arquivo local do qual você deseja fazer upload dos dados. O arquivo deve ser um arquivo delimitado.

Para esse tutorial, estamos usando um arquivo denominado accounts.csv.

O arquivo contém algumas informações da conta e inclui um campo chamado "id" que identifica exclusivamente cada um dos registros da conta no arquivo. O conteúdo do arquivo accounts.csv usado é incluído aqui:
id,name,streetAddress,city,postcode,phoneNumber
0,AcmeCo,10 Downing Street,London,SW1A 2AA,02012345678
1,MyOtherCompany,221b Baker Street,London,SW2B 3FG,020654321

Janela de Origem

Se desejar selecionar um arquivo diferente, clique em Alterar.

Clique em Carregar Campos e verifique os detalhes que são gerados automaticamente sobre seu arquivo selecionado. Por exemplo, o caractere delimitador utilizado no arquivo.

Para este tutorial, o arquivo accounts.csv utiliza uma vírgula como o caractere delimitador. Além disso, os campos restantes podem ser deixadas com seus valores padrão.

janela Campos Disponíveis

Clique em Continuar para exibir todos os campos disponíveis no arquivo selecionado.

Campos de origem disponíveis selecionados

Selecione os campos dos quais você deseja fazer upload dos dados. Por padrão, todos os campos são selecionados.

Para este tutorial, estamos utilizando todos os campos selecionados.

Quando concluir, clique em Concluído.

O terminal de origem é definido para essa integração.

Você é retornado para a visão geral de integração e os campos de origem selecionados são exibidos.

Campos selecionados no terminal de Origem

Agora é possível definir o terminal de destino.

No cabeçalho Destino, clique em Editar. Insira as credenciais necessárias para efetuar sign in ao salesforce.com.

Essas credenciais são validadas e, se estiverem corretas, você será conectado à conta do salesforce.com. Os objetos de negócios disponíveis que podem ser usados em sua integração são listados.

Para este tutorial, na lista de objetos, selecione Conta. A descrição do objeto Conta é apresentada na seção Campos Disponíveis que mostra todos os campos no objeto Conta.
Nota: É possível selecionar os campos que você estiver interessado e desejar carregar com os dados do seu arquivo local. Não é necessário integrar o objeto inteiro, apenas os campos que forem necessários para sua definição de integração.

Use a opção Operações para especificar o contexto da operação de dados que você deseja para sua integração.

Para este tutorial, selecione Atualizar Objetos como a operação. Quando a integração estiver em execução, ela atualizará automaticamente os campos de Contas no salesforce.com.

Selecione os campos de Conta necessários, conforme mostrado na seguinte captura de tela:

Campos disponíveis no terminal de destino

Quando terminar, clique em Concluído.

O terminal de destino é definido para essa integração.

Você é retornado para a visão geral da integração. A integração é atualizada com os campos de Destino selecionados no salesforce.com.

Os terminais de origem e de destino definidos são exibidos na visão geral de integração

Na visão geral de integração, agora é possível ver os campos de origem e de destino que estão prontos para serem mapeados.

Etapa 3: Definir a Transformação

Para concluir a integração, você deverá mapear os campos da origem para o destino.

Conecte os campos de origem e de destino, conforme necessário. Para cada campo de origem, clique no ponto de ancoragem e, em seguida, clique no ponto de ancoragem ao campo de destino correspondente.

Nesse tutorial, mapeie os dados dos campos de origem para os campos de destino, conforme mostrado na captura de tela a seguir. Não é necessário definir funções nos dados.

Definindo transformações

A definição de funções e de transformações mais complexas é abordada no tutorial sobre transformações.

Insira um nome que seja significativo e representativo da integração. Por exemplo, Contas de Arquivo Local para o salesforce.com.

Incluindo um nome de integração

Salve a integração concluída clicando em Salvar. Em seguida, clique em Fechar para retornar para a visualização Integrações.

A visualização Integrações lista todas as integrações definidas e o seu estado atual.

Integrações e seus estados atuais

Etapa 4: Executar a Integração

Agora que a integração está definida, você deverá executar a integração para copiar os dados do terminal de origem para o terminal de destino.

Clique em Executar, exibido à direita da integração que você criou.

A integração é executada e os dados são transferidos por upload de seu arquivo local de origem definido para o objeto do salesforce.com de destino definido em uma única operação.

O status da integração é alterado para execução:

Visualização da integração

É possível clicar em Atividades > Atividade da Integração para visualizar as últimas atividades de integração do Cast Iron Express. As atividades são exibidas com a mais recente na parte superior da lista.

Para este tutorial, a captura de tela a seguir mostra os detalhes completos da integração.

Feed de atividade

Para verificar a integração com sucesso, acesse o sistema de destino e verifique se os dados chegaram.

Quando a integração for concluída, uma mensagem de confirmação de integração com sucesso também é exibida momentaneamente na parte inferior da visualização.

Mensagem de Integração




Feedback | notices