Conector Square no Jitterbit Studio

Resumo

O conector Square fornece uma interface para inserir dados fornecidos pelo usuário, como credenciais, para criar uma conexão Square autenticada. Essa conexão fornece a base para configurar atividades do conector Square associadas que interagem com a conexão. Em conjunto, uma conexão Square específica e suas atividades são chamadas de endpoint Square.

Pré-requisitos e versões de API suportadas

Este conector pode ser usado com agentes na nuvem e agentes privados.

Os agentes baixam automaticamente a versão mais recente deste conector quando necessário. Em agentes privados, você pode suspender essas atualizações com a política organizacional Disable Auto Connector Update.

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

Visão geral do conector

Este conector é usado primeiro para configurar uma conexão Square, estabelecendo acesso ao Square, e depois para configurar uma ou mais atividades do Square associadas a essa conexão como origem ou destino em uma operação:

• Atividade de Consulta: Recupera clientes de uma conexão Square e é usada como origem em uma operação.

• Atividade de Criação: Cria novos clientes em uma conexão Square e é usada como destino em uma operação.

• Atividade de Atualização: Atualiza clientes existentes em uma conexão Square e é usada como destino em uma operação.

• Atividade de Exclusão: Exclui clientes existentes de uma conexão Square e é usada como destino em uma operação.

Em conjunto, uma conexão Square específica e suas atividades são chamadas de endpoint Square. Após configurar uma conexão, as atividades associadas ao endpoint ficam disponíveis no filtro Endpoints:

Os endpoints criados com este conector estão incluídos em relatórios de uso de endpoints e contam para sua licença.

Registro no Square

Como a conexão será um aplicativo que faz interface com o Square, você precisará de um Personal Access Token para acessar o servidor Square. Consulte Registro no Square para obter detalhes.

Acessando o conector

O conector Square é acessado na guia Project endpoints and connectors da paleta de componentes de design (consulte Paleta de componentes de design).

Solução de problemas

Se você enfrentar problemas com o conector Square, recomenda-se seguir estas etapas de solução de problemas:

1. Clique no botão Testar na configuração de conexão para garantir que a conexão seja bem-sucedida e para garantir que a versão mais recente do conector seja baixada no agente (a menos que esteja usando a política de organização Desabilitar Atualização Automática do Conector).

2. Verifique os logs de operação para qualquer informação registrada durante a execução da operação.

3. Ative o log de depuração de operação (para agentes em nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

4. Se estiver usando agentes privados, você pode ativar o log detalhado do conector para este conector adicionando esta entrada de configuração de logger ao arquivo logback.xml do seu agente privado:

   <logger name="org.jitterbit.connector.verbose.logging.square" level="DEBUG"/>
   

   Para mais informações sobre log detalhado do conector, consulte Log detalhado para conectores usando agentes privados Jitterbit.

5. Se estiver usando agentes privados, você pode verificar os logs do agente para mais informações.

6. Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.