Ir para o conteúdo

Atividade de Criação do Square

Introdução

Uma atividade de Criação do Square cria novos clientes 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 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 Criação do Square

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

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

  • Nome: Insira um nome para identificar a atividade de Criação do Square. O nome deve ser exclusivo para cada atividade de Criaçã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 usa a Square REST API. 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
      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
      endereço Nó do endereço

    • Resposta:

      Campo/Nó do Esquema de Resposta Notas
      cliente Nó do cliente
      isCreated Se o registro do cliente foi criado (true) ou não criado (false)
      mensagem Mensagem da atividade de Criação
      customerId ID do cliente
      preferências Nó das preferências
      email_unsubscribed Valor booleano retornado do status de descadastramento de email (true ou false)

  • 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 de 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 Criaçã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.

Após a criação de uma atividade Square, as ações do menu para essa atividade estão acessíveis no painel do projeto nas abas Workflows ou Components, e a partir da tela de design. Veja o menu de ações da atividade para mais detalhes.

As atividades Square Create 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 ao usar atividades Square Create. Veja 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.