Configurar um fluxo simples
Objetivos de aprendizagem
Após concluir esta unidade, você estará apto a:
- Configurar um fluxo simples.
- Configurar uma agenda e um filtro para o seu fluxo.
- Confirmar que o AppFlow está conectado na configuração do Salesforce.
O texto a seguir orienta você pela configuração de um fluxo simples entre a AWS e o Salesforce. Como é um serviço pago e seus dados podem variar, você não precisará configurar um fluxo usando um Trailhead Playground ou uma organização de desenvolvedor. Vamos oferecer estas etapas como diretrizes para a integração. Isso também gera familiarização com o processo para que você possa configurar a automação e fazer os dados fluírem em diferentes direções mais tarde.
Vamos primeiro olhar para o caso de uso de um fluxo simples, um fluxo que envia dados do Salesforce para a AWS em uma agenda definida. Você começa no Console de gerenciamento da AWS.
Navegue até o AppFlow e dê um nome ao seu fluxo
Você usa o Console de gerenciamento da AWS para configurar sua integração com o AppFlow.
-
Faça login no AWS e insira Console de gerenciamento da AWS.
- Digite
AppFlow
no campo Find Services (Encontrar serviços) e clique em Amazon AppFlow.
- Clique em Criar fluxo.
- Na seção Detalhes do fluxo, dê um nome ao fluxo e digite uma descrição.
Neste exemplo, o nome do fluxo é "SalesforceToAmazonS3Demo" (1) e a descrição é "Copiar registros de oportunidade do Salesforce para uma partição do Amazon S3". (2). É melhor ser claro e conciso para que seus colegas saibam exatamente do que se trata o fluxo.
- Em seguida, clique em Avançar.
Conectar o Salesforce
- Selecione Salesforce na lista suspensa Nome da fonte.
- Escolha uma conexão Salesforce na lista suspensa. Se não houver conexão, selecione Criar conexãoou Criar conexão com o AWS PrivateLink se estiver usando o Salesforce Private Connect.
- Clique em Conectar.
- Na janela pop-up, escolha sua organização de produção ou sandbox.
- Digite um nome no campo Nome da conexão. Neste exemplo, Production (Produção) é selecionado e o nome da conexão é "MySalesforceProdConnection".
- Clique em Continuar.
- Você é levado para a página de autorização do Salesforce. Dependendo das configurações no Salesforce:
- Você pode precisar apenas permitir o acesso. Se esse for o caso, verifique se você está se conectando com o nome de usuário do Salesforce correto e clique em Permitir.
- Se você for solicitado a inserir suas credenciais do Salesforce, digite as credenciais apropriadas, faça login e clique em Permitir.
- Em seguida, você tem que selecionar se quer buscar objetos Salesforce específicos ou se quiser assinar eventos Salesforce (Change Data Capture e Eventos de plataforma) no Amazon S3. Você pode escolher entre todos os objetos, incluindo os personalizados.
- No destino, selecione Amazon S3.
- No menu suspenso, escolha uma partição S3 na mesma região AWS em que você está criando esse fluxo. Se você não tem uma partição S3, aqui estão os passos para criar um.
- Em Additional Settings (Configurações adicionais), você também pode escolher configurações avançadas para configurar diferentes formatos de dados, como JSON, CSV ou Parquet, nomenclatura de arquivos e preferências de agregação.
Configure seu fluxo
Em seguida, você escolhe quando executar o fluxo. A opção sob demanda permite que você execute o fluxo assim que salvar sua configuração. A outra opção é agendar o fluxo. Neste exemplo, a opção Executar o fluxo com agendamento (1) é selecionada. O fluxo é definido para repetir a cada minuto (2), configurado apenas para transferir novos dados (3).
Você pode escolher entre diferentes campos de data do Salesforce, como Data de criação ou Última data de modificação, para identificar alterações.
Depois de configurar o fluxo do jeito que você quer, clique em Avançar.
Mapear os campos
É hora de mapear campos entre o Salesforce e a Amazon S3. O AppFlow permite mapear campos manualmente (1) ou carregar arquivos CSV com campos mapeados.
Na seção Mapear campos de dados, selecione os campos do objeto Salesforce que você deseja transferir. Você também pode optar por mapear todos os campos com um clique. Neste exemplo (2), os campos a seguir são selecionados.
- ID da conta
- Excluído/a
- ID do registro mestre
- Tipo de conta
- ID de conta principal
- Rua de cobrança
Durante esta etapa, você também pode adicionar fórmula aos campos; é possível mascarar caracteres ou truncar campos. Você também pode combinar dois campos para criar um novo campo de destino.
Clique em Avançar quando estiver pronto para seguir em frente.
Validações
Na seção Validações, você pode adicionar validações específicas por campo para gerar ações específicas. Por exemplo, você pode selecionar o campo Account Type (Tipo de conta) e aplicar uma condição de forma que se o Account Type (Tipo de conta) estiver ausente ou for nulo, o registro será ignorado. A configuração das validações é opcional.
Filtrar seus dados
Em seguida, você tem a opção de filtrar dados. Por exemplo, no campo de data de criação, você pode filtrar registros que foram criados antes ou depois de determinada data.
Clique em Avançar quando estiver pronto para seguir em frente.
Reveja seu fluxo
A etapa final é rever e criar seu fluxo. Revise a configuração de fluxo e clique em Criar fluxo. Pronto. Seu fluxo está pronto para execução.
Clique em Ativar fluxo se você configurou o fluxo para ser executado em uma agenda definida ou Executar fluxo se você configurou o fluxo para execução sob demanda.
Verifique se o fluxo está conectado
De volta ao Salesforce, verifique duas vezes se o AppFlow está conectado.
- Conecte-se ao Salesforce.
- Clique em e selecione Setup (Configuração).
- Insira
connected app
(aplicativo conectado) na caixa Busca rápida e selecione Manage Connected Apps (Gerenciar aplicativos conectados).
- Verifique se Aplicativo de login incorporado do Amazon AppFlow está na sua lista de aplicativos conectados. Uma vez concluída a etapa de autenticação, esse aplicativo conectado foi ativado automaticamente no Salesforce.
Mais uma verificação.
- Digite
connected app
(aplicativo conectado) na Busca rápida se você ainda não estiver lá e selecioneConnected Apps OAuth Usage
(Uso de OAuth de aplicativos conectados).
- O Aplicativo de login incorporado do AppFlow deve estar listado e deve ter Token de atualização válido até que seja revogado em Gerenciar políticas de aplicativo. Você pode editar a política para refletir isso, se precisar.