Ir para o conteúdo

Harmony Square Criar Atividade

Introdução

Uma atividade Square Create cria novos clientes em uma conexão Square e deve ser usada como um alvo para consumir dados em uma operação. Depois de configurar uma conexão Square, você pode configurar quantas atividades Square você gosta para cada conexão Square.

Crie uma Atividade 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 quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte Criando uma instância de atividade em Reutilização de componente.

Uma atividade existente pode ser editada a partir destes locais:

Configurar uma Atividade de Criação de Square

Siga estas etapas para configurar uma atividade Square Create:

Etapa 1: Insira um Nome e Especifique as Configurações

aba Conexões

  • Nome: Insira um nome a ser usado para identificar a atividade do Square Create. O nome deve ser único para cada Cria atividade e não deve conter barras (/) ou dois pontos (:).

  • Continue on Error: 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á gravado no log de operação.

  • Save & Exit: Se ativado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.

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

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

Etapa 2: Revisar os Esquemas de Dados

aba Conexões

  • 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 muito mais.

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

    • Pedido:

      Campo/nó do esquema de solicitação Notas
      cliente Nó do cliente
      dadoNome O nome (primeiro) do cliente
      nomedafamília Nome da família (sobrenome) do cliente
      NomeEmpresa A empresa do cliente
      apelido Apelido do cliente
      endereço de e-mail O endereço e-mail do cliente
      número de telefone O número de telefone do cliente
      ID de referência O ID de referência do cliente
      nota Uma nota sobre o cliente
      aniversário Aniversário do cliente
      endereço Nó do endereço

    • Resposta:

      Campo/nó do esquema de resposta Notas
      cliente Nó do cliente
      éCriado Se o registro do cliente foi criado (true) ou não criado (false)
      mensagem Mensagem da atividade Criar
      ID do cliente Identificação do cliente
      preferências Nó das preferências
      email_unsubscribe Valor booleano retornado do status de cancelamento de assinatura e-mail (true ou false)

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

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

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

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

Próximos Passos

Depois de configurar uma atividade Square Create, conclua a configuração da operação adicionando e configurar outras atividades, transformações ou scripts como etapas da operação. Você também pode configurar uma operação configurações de operação, que incluem a capacidade de encadear operações que estão no mesmo ou em diferentes workflows.

Após a criação de uma atividade do Square, as ações do menu para essa atividade ficam acessíveis no painel do projeto nas guias Workflows ou Componentes e na quadro de design. Ver Menu de Ações de Atividade para detalhes.

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

Outros padrões não são válidos usando as atividades do Square Create. Veja os padrões de validação no Validade da Operação página.

Um caso de uso típico é usar uma atividade Square Create no Two-transformation Pattern. Neste exemplo, o primeiro A transformação (Square Create Request) cria uma estrutura de solicitação que é passada para a atividade Square Create. O a segunda transformação (Square Create Response) recebe a estrutura de resposta, que é então gravada em uma variável por uma atividade Variable Write (Write Square Create Response) e uma mensagem é registrada pela Write to Operation script:

operação Square Create

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

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