Ir para o conteúdo

Atualização de Atividade do Square

Introdução

Uma atividade de Atualização do Square atualiza um cliente existente em uma conexão do Square e é destinada a ser usada como um alvo para consumir dados em uma operação. Após configurar uma conexão do Square, você pode configurar quantas atividades do Square desejar para cada conexão do Square.

Criar uma Atividade do Square

Uma instância de uma atividade é criada a partir de uma conexão usando um tipo de atividade.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para mais detalhes, veja Criar uma instância de atividade ou ferramenta em Reutilização de Componentes.

Uma atividade existente pode ser editada a partir destes locais:

Configurar uma Atividade de Atualização do Square

Siga estas etapas para configurar uma atividade de Atualização do Square:

Etapa 1: Insira um nome e especifique as configurações

  • Nome: Insira um nome para identificar a atividade de Atualização do Square. O nome deve ser exclusivo para cada atividade de Atualização e não deve conter barras (/) ou dois pontos (:).

  • Continuar em Caso de Erro: Selecione para continuar a execução da atividade se um erro for encontrado para um conjunto de dados em uma solicitação em lote. Se algum erro for encontrado, ele será registrado no log da operação.

  • Salvar e Sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar Alterações: Após fazer alterações, clique em Descartar Alterações para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pedirá que você confirme que deseja descartar as alterações.

Etapa 2: Revisar os esquemas de dados

  • Esquema de Dados: Os esquemas de dados de solicitação e resposta para o Square serão exibidos. Se a operação usar uma transformação, os esquemas de dados serão exibidos novamente mais tarde durante o processo de mapeamento de transformação, onde você pode mapear para campos de destino usando objetos de origem, scripts, variáveis, valores personalizados e mais.

    O conector Square utiliza a API REST do Square. Consulte a documentação da API para obter informações sobre os campos do esquema.

    • Solicitação:

      Campo/Nó do Esquema de Solicitação Notas
      cliente Nó do cliente
      customerID ID do cliente específico
      givenName O nome (primeiro) do cliente
      familyName O sobrenome (último) do cliente
      companyName A empresa do cliente
      nickname O apelido do cliente
      emailAddress O endereço de email do cliente
      phoneNumber O número de telefone do cliente
      referenceID O ID de referência do cliente
      note Uma nota sobre o cliente
      birthday O aniversário do cliente

    • Resposta:

      Campo/Nó do Esquema de Resposta Notas
      atualizar Nó da atualização
      isUpdated Se o registro do cliente foi atualizado (true) ou não atualizado (false)
      mensagem Mensagem da atividade de Criação
      cliente Nó do cliente
      givenName O nome (primeiro) do cliente
      familyName O sobrenome (último) do cliente
      companyName A empresa do cliente
      nickname O apelido do cliente
      emailAddress O endereço de email do cliente
      phoneNumber O número de telefone do cliente

  • Atualizar: Clique no ícone de atualizar ou na palavra Atualizar para regenerar esquemas do endpoint. Esta ação também regenera o esquema em outros locais ao longo do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração para todas as etapas e fechar a configuração da atividade.

  • Descartar Alterações: Após fazer alterações, clique em Descartar Alterações para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pedirá que você confirme que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade de Atualização do Square, complete a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas da operação. Você também pode configurar as configurações da operação, que incluem a capacidade de encadear operações que estão no mesmo ou em diferentes fluxos de trabalho.

Depois que uma atividade do Square for criada, as ações do menu para essa atividade estão acessíveis no painel do projeto nas abas Fluxos de Trabalho ou Componentes, e no canvas de design. Consulte o Menu de ações da atividade para mais detalhes.

As atividades de Atualização do Square podem ser usadas como um alvo com esses padrões de operação: - Padrão de transformação - Padrão de duas transformações (como o primeiro ou segundo alvo)

Outros padrões não são válidos usando atividades de Atualização do Square. Consulte os padrões de validação na página de Validade da operação.

Para usar a atividade com funções de script, escreva os dados em um local temporário e, em seguida, use esse local temporário na função de script.

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.