Conexão Shopify¶

Introdução¶

Uma conexão do Shopify, criada usando o conector do Shopify, estabelece acesso ao Shopify. Depois que uma conexão for configurada, você poderá criar instâncias de atividades do Shopify associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Crie Ou Edite uma Conexão do Shopify¶

Uma nova conexão do Shopify é criada usando o conector do Shopify em um destes locais:

• A aba Conexões da paleta de componentes de design (consulte Paleta de Componentes de Design).
• A página Conexões globais (consulte Criar uma conexão global em Conexões Globais).

Uma conexão existente do Shopify pode ser editada nestes locais:

• A aba Conexões da paleta de componentes de design (consulte Paleta de Componentes de Design).
• A aba Componentes do painel do projeto (consulte Menu Ações do componente em Guia Componentes do painel do projeto).
• A página Conexões globais (consulte Editar uma conexão global em Conexões Globais).

Configurar uma Conexão do Shopify¶

Cada elemento da interface do usuário da tela de configuração de conexão do Shopify é descrito abaixo.

• Nome da conexão: Insira um nome a ser usado para identificar a conexão. O nome deve ser exclusivo para cada conexão do Shopify e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint do Shopify, que se refere tanto a uma conexão específica quanto a suas atividades.

• Nome da loja: Insira o nome da loja Shopify.

• Tipo de autenticação: Selecione o tipo de autenticação, entre Autenticação Básica ou Token de acesso do Shopify. Se você estiver usando um aplicativo privado, selecione Autenticação Básica. Se você estiver usando um app personalizado criado no admin da Shopify, selecione Shopify Access Token.

• Chave API: Se Autenticação Básica foi selecionado como Tipo de Autenticação, insira a chave API para a instância do Shopify.

• Senha: Se Autenticação Básica foi selecionado como Tipo de Autenticação, insira a senha para a instância do Shopify.

• Token de acesso à API: Se Token de acesso do Shopify foi selecionado como o Tipo de autenticação, insira o token de acesso à API para a instância do Shopify.

• Usar configurações de proxy (somente Agente Privado): Ao usar um Agente Privado, esta configuração pode ser selecionada para usar configurações de proxy do Agente Privado.

• Configurações opcionais: Clique para expandir as configurações adicionais:

  • Versão da API: Selecione API REST Admin do Shopify, uma de 2022-04 (padrão), 2023-01, 2023-04, 2023-07, 2023-10 ou 2024-01. Dependendo dos endpoints de API suportados pela Shopify na versão da API usada, os objetos e subobjetos que estão disponíveis para seleção durante a configuração da atividade podem variar. Se estiver alterando a versão da API para uma conexão que já possui atividades configuradas, consulte considerações adicionais em Alterar a versão da API abaixo.

    Importante

    O Shopify redireciona automaticamente as chamadas de versões de API não suportadas para a próxima versão mais antiga compatível. Observe que o Shopify descontinuou determinados endpoints da API Fulfillment com a versão 2022-07, conforme descrito em Suspensão de uso da API Fulfillment da Shopify.

• Teste: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelos agentes no grupo de agentes associado ao ambiente atual. Este conector oferece suporte à suspensão do download da versão mais recente do conector usando a Desativar atualização automática do conector política da organização.

• Salvar alterações: Clique para salvar e fechar a configuração da conexão.

• Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem solicita que você confirme que deseja descartar as alterações.

• Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências, exclusão e remoção de componentes). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Alterar a Versão da API¶

Se uma conexão do Shopify tiver atividades configuradas, há considerações adicionais a serem levadas em consideração ao alterar a versão da API selecionada. Isso ocorre porque os objetos e subobjetos disponíveis para seleção na configuração da atividade dependem dos endpoints da API suportados pela Shopify na versão da API que está sendo usada. Se a configuração de atividade existente usar endpoints de API que não são suportados na versão de API para a qual você está mudando, essas atividades falharão, a menos que sejam reconfiguradas.

Para evitar que isso ocorra, siga estas etapas:

1. Altere a Versão da API na conexão do Shopify.

2. Abra cada tela de configuração de atividade onde um objeto ou subobjeto está selecionado e clique em Atualizar. Na atualização, as listas de seleção atuais de objetos e subobjetos serão recuperadas usando a versão da API selecionada na conexão do Shopify. Observe que o Shopify redireciona automaticamente as chamadas de versões de API não suportadas para a próxima versão suportada mais antiga.

   Importante

   Se o objeto ou subobjeto selecionado não for compatível com a versão da API que está sendo chamada, a seleção poderá mudar na atualização. Preste muita atenção para garantir que todas as seleções alteradas sejam conforme o esperado.

3. Selecione o objeto e subobjeto apropriados suportados pela versão da API que está sendo chamada.

4. Reimplantar operações usando a conexão e as atividades.

Próximos Passos¶

Após a criação de uma conexão do Shopify, você coloca um tipo de atividade na quadro de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

As ações de menu para uma conexão e seus tipos de atividade podem ser acessados no painel do projeto e na paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

Estes tipos de atividades estão disponíveis:

• Ler: Recupera dados de objetos do Shopify e deve ser usado como fonte em uma operação.

• Consulta: Consulta dados de objetos do Shopify e destina-se a ser usado como fonte em uma operação.

• Criar: Cria dados de objeto no Shopify e deve ser usado como destino em uma operação.

• Atualizar: Atualiza os dados do objeto no Shopify e deve ser usado como destino em uma operação.

• Excluir: Exclui dados de objetos do Shopify e deve ser usado como destino em uma operação.