Ir para o conteúdo

Atividade de Upsert VTEX

Introdução

Uma atividade VTEX Upsert, usando sua conexão VTEX, atualiza dados de objetos existentes ou cria novos dados de objetos no VTEX e tem como objetivo ser usado como um alvo para consumir dados em uma operação.

Limites de taxa

A API REST VTEX impõe um limite de taxa para objetos relacionados à API de preços. O limite de taxa imposto para objetos Pricing e Price Simulation em uma atividade Upsert é de 40 solicitações por segundo por conta. Para obter mais informações sobre o limite de taxa, consulte a documentação da VTEX Pricing API.

Criar uma atividade VTEX Upsert

Uma instância de uma atividade VTEX Upsert é criada a partir de uma conexão VTEX usando seu tipo de atividade Upsert.

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 VTEX Upsert existente pode ser editada nestes locais:

Configurar uma atividade VTEX Upsert

Siga estas etapas para configurar uma atividade VTEX Upsert:

Etapa 1: insira um nome e selecione um objeto

Nesta etapa, forneça um nome para a atividade e selecione um objeto. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Etapa 1 da configuração da atividade VTEX Upsert

Dica

Campos com um ícone de variável Ícone de variável suporte usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.

  • Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade VTEX Upsert e não deve conter barras / ou dois pontos :.

  • Selecione um objeto: Esta seção exibe os objetos disponíveis no endpoint VTEX.

    • Objeto selecionado: Depois que um objeto é selecionado, ele é listado aqui.

    • Pesquisar: Insira qualquer valor de coluna na caixa de pesquisa para filtrar a lista de objetos. A pesquisa não diferencia maiúsculas de minúsculas. Se os objetos já estiverem exibidos na tabela, os resultados da tabela serão filtrados em tempo real a cada pressionamento de tecla. Para recarregar objetos do endpoint ao pesquisar, insira os critérios de pesquisa e atualize, conforme descrito abaixo.

    • Atualizar: Clique no ícone de atualização Ícone de atualização ou a palavra Refresh para recarregar objetos do endpoint VTEX. Isso pode ser útil se objetos foram adicionados ao VTEX. Esta ação atualiza todos os metadados usados para construir a tabela de objetos exibida na configuração.

    • Selecionando um objeto: Dentro da tabela, clique em qualquer lugar em uma linha para selecionar um objeto. Apenas um objeto pode ser selecionado. As informações disponíveis para cada objeto são obtidas do endpoint VTEX:

      • Nome: O nome do objeto.

      • Descrição: A descrição do objeto.

    Dica

    Se a tabela não for preenchida com objetos disponíveis, a conexão VTEX pode não ser bem-sucedido. Certifique-se de que você está conectado reabrindo a conexão e testando novamente as credenciais.

  • Nome da conta: Insira um nome da conta para substituir o armazenamento especificado na configuração da conexão VTEX(opcional).

    Nota

    Este é um campo opcional que pode ser usado se você tiver mais de uma conta VTEX e quiser substituir o Nome da conta especificado na configuração da conexão VTEX. A conta deve ser compatível para uso com a Chave do aplicativo e o Token do aplicativo especificados na conexão.

  • 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á gravado no log de 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 para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 2: Selecione um subobjeto

Nesta etapa, selecione um subobjeto. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Etapa 2 da configuração da atividade VTEX Upsert

  • Selecione um subobjeto: Esta seção exibe os subobjetos disponíveis no endpoint VTEX.

    • Objeto selecionado: O objeto selecionado na etapa anterior é listado aqui.

    • Selecione um subobjeto: Depois que um subobjeto é selecionado, ele é listado aqui.

    • Pesquisar: Insira qualquer valor de coluna na caixa de pesquisa para filtrar a lista de subobjetos. A pesquisa não diferencia maiúsculas de minúsculas. Se os subobjetos já estiverem exibidos na tabela, os resultados da tabela serão filtrados em tempo real a cada pressionamento de tecla. Para recarregar subobjetos do endpoint ao pesquisar, insira os critérios de pesquisa e atualize, conforme descrito abaixo.

    • Atualizar: Clique no ícone de atualização Ícone de atualização ou a palavra Refresh para recarregar subobjetos do endpoint VTEX. Isso pode ser útil se subobjetos foram adicionados ao VTEX. Esta ação atualiza todos os metadados usados para construir a tabela de subobjetos exibida na configuração.

    • Selecionando um Subobjeto: Dentro da tabela, clique em qualquer lugar em uma linha para selecionar um subobjeto. Apenas um subobjeto pode ser selecionado. As informações disponíveis para cada subobjeto são obtidas do endpoint VTEX:

      • Nome: O nome do subobjeto.

      • Descrição: A descrição do subobjeto.

    Dica

    Se a tabela não for preenchida com subobjetos disponíveis, a conexão VTEX pode não ser bem-sucedido. Certifique-se de que você esteja conectado reabrindo a conexão e testando novamente as credenciais.

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

  • Próximo: Clique para armazenar temporariamente a configuração desta 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 para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 3: Selecione uma ação

Nesta etapa, selecione uma ação para executar no subobjeto. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Etapa 3 da configuração da atividade VTEX Upsert

  • Selecione uma ação: Esta seção exibe as ações disponíveis no endpoint VTEX.

    • Subobjeto selecionado: O subobjeto selecionado na etapa anterior é listado aqui.

    • Selecionar ação: Depois que uma ação é selecionada, ela é listada aqui.

    • Pesquisar: Insira qualquer valor de coluna na caixa de pesquisa para filtrar a lista de ações. A pesquisa não diferencia maiúsculas de minúsculas. Se as ações já estiverem exibidas na tabela, os resultados da tabela serão filtrados em tempo real a cada pressionamento de tecla. Para recarregar ações do endpoint ao pesquisar, insira os critérios de pesquisa e atualize, conforme descrito abaixo.

    • Atualizar: Clique no ícone de atualização Ícone de atualização ou a palavra Refresh para recarregar ações do endpoint VTEX. Isso pode ser útil se ações foram adicionadas ao VTEX. Esta ação atualiza todos os metadados usados para construir a tabela de ações exibida na configuração.

    • Selecionando uma ação: Dentro da tabela, clique em qualquer lugar em uma linha para selecionar uma ação. Apenas uma ação pode ser selecionada. As informações disponíveis para cada ação são obtidas do endpoint VTEX:

      • Nome: O nome da ação.

      • Descrição: A descrição da ação.

    Dica

    Se a tabela não for preenchida com as ações disponíveis, a conexão VTEX pode não ser bem-sucedido. Certifique-se de que você esteja conectado reabrindo a conexão e testando novamente as credenciais.

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

  • Próximo: Clique para armazenar temporariamente a configuração desta 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 para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 4: Revise os esquemas de dados

Quaisquer esquemas de solicitação ou resposta são exibidos. Cada elemento de interface de usuário desta etapa é descrito abaixo.

Etapa 4 da configuração da atividade VTEX Upsert

  • Esquemas de dados: Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de transformação.

    Nota

    Os dados fornecidos em uma transformação têm precedência sobre a configuração da atividade.

    O conector VTEX usa a VTEX REST API. Consulte a documentação da API para obter informações sobre os nós e campos do esquema.

    Importante

    Na resposta, há uma schema_request campo (no error nó) que é retornado quando um código de status sem sucesso é retornado e Continuar em caso de erro está habilitado (na Etapa 1). O schema_request campo contém uma sequência da entrada fornecida na solicitação malsucedida.

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

  • Editar: Clique no ícone de edição Ícone de edição acima de cada esquema de dados para entrar no editor para esse esquema de dados. O editor permite que você adicione, exclua e reorganize nós e campos e altere seus tipos de dados. Todos os nós e campos recém-adicionados são definidos como [0, 1]cardinalidade. As alterações feitas nos esquemas de dados devem ser aceitáveis para o endpoint e devem ser feitas somente após consultar qualquer documentação disponível para o endpoint.

  • 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 para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Próximos passos

Após configurar uma atividade VTEX Upsert, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts 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 estejam no mesmo fluxo de trabalho ou em workflows diferentes.

As ações de menu para uma atividade são acessíveis a partir do painel do projeto e da quadro de design. Para obter detalhes, consulte menu de ações de atividade em Noções básicas do conector.

As atividades VTEX Upsert podem ser usadas como um alvo com esses padrões de operação:

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

Quando estiver pronto, implantar e executar a operação e validar o comportamento verificando os logs de operação.