Ir para o conteúdo

Atividade de Consulta Square

Introdução

Uma atividade Square Query recupera clientes de uma conexão Square e deve ser usada como uma fonte para fornecer dados para uma operação. Depois de configurar uma conexão do Square, você pode configurar quantas atividades do Square desejar. 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 componentes.

Uma atividade existente pode ser editada nestes locais:

Configurar uma Atividade de Consulta Square

Siga estas etapas para configurar uma atividade Square Query:

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

aba Conexões

Dica

Campos com ícone de variável Ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece a digitar um colchete aberto [ no campo ou clique no ícone da variável para exibir as variáveis existentes para escolher.

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

  • Classificação de campo: Especifique a classificação de campo a ser usada, entre DEFAULT ou CREATED_AT.

  • Ordem de classificação: Especifique a ordem de classificação a ser usada, DESC (decrescente) ou ASC (crescente).

  • Número de registros a serem retornados: O número máximo de resultados a serem retornados em uma única página. Uma entrada válida é vazio ou um valor de 0 a 1000. Deixe o campo vazio (o padrão) para retornar todos os registros.

  • Salvar e Sair: Se ativado, clique para salvar a configuração desta etapa e feche a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e prosseguir para a próxima etapa. O 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 alterações feitas em qualquer etapa. Uma mensagem solicitará que você confirme que deseja descartar as alterações.

Etapa 2: Revise os Esquemas de Dados

aba Conexões

  • Esquema de dados: O esquema de dados de resposta do Square será exibido. Se a operação usar uma transformação, os esquemas de dados serão exibidos novamente posteriormente durante o processo de mapeamento da transformação, onde você poderá mapear para campos de destino usando objetos de origem, scripts, variáveis, valores personalizados e muito mais.

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

    • Resposta:

      Campo/nó do esquema de resposta Notas
      mensagem de erro A mensagem de erro
      clientes Nó dos clientes
      identificação ID do cliente
      criadoEm Data de criação
      atualizadoEm Data de atualização
      dadoNome Nome (primeiro) do cliente
      famíliaNome Nome (sobrenome) de família do cliente
      nomedaempresa A empresa do cliente
      apelido O apelido do cliente
      endereço de email O endereço email do cliente
      número de telefone O número de telefone do cliente

  • Atualizar: Clique no ícone de atualização Ícone de atualização ou a palavra Atualizar para regenerar esquemas do endpoint. Esta ação também regenera o esquema em outros locais em todo o 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.

  • Descartar alterações: Após fazer alterações, clique em Descartar alterações 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 Query, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas de operação. Você também pode configurar a operação de uma operação configurações, que incluem a capacidade de encadear operações que estão no mesmo fluxo de trabalho ou em workflows diferentes.

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 Ações de Atividade para detalhes.

As atividades do Square Query podem ser usadas como fonte com estes padrões de operação:

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

Para usar a atividade com funções de script, grave os dados em um local temporário e use esse local temporário 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.