Ir para o conteúdo

Atividade de Leitura de Stripe

Introdução

Uma atividade Stripe Read, usando sua conexão Stripe, recupera dados do objeto do Stripe usando o ID do objeto e deve ser usado como fonte para fornecer dados em uma operação.

Crie uma Atividade de Leitura Stripe

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

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 Stripe Read existente pode ser editada nestes locais:

Configurar uma Atividade de Leitura Stripe

Siga estas etapas para configurar uma atividade Stripe Read:

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 de leitura do Stripe

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

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

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

    • Pesquisar: Insira qualquer parte do nome do objeto na caixa de pesquisa para filtrar a lista de objetos. A busca 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 durante a pesquisa, 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 Stripe. Isso pode ser útil se objetos tiverem sido adicionados ao Stripe. Esta ação atualiza todos os metadados usados para construir a tabela de objetos exibidos na configuração.

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

      • 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 Stripe pode não ter sucesso. Certifique-se de estar conectado reabrindo a conexão e testando novamente as credenciais.

  • Continuar em caso de erro: Selecione para continuar a execução da atividade se for encontrado um erro 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 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 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 as 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 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 de leitura do Stripe

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

    • Objeto Selecionado: O objeto selecionado na etapa anterior está listado aqui.

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

    • Pesquisar: Insira qualquer parte do nome do subobjeto na caixa de pesquisa para filtrar a lista de subobjetos. A busca 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 durante a pesquisa, 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 Stripe. Isso pode ser útil se subobjetos tiverem sido adicionados ao Stripe. Esta ação atualiza todos os metadados utilizados para construir a tabela de subobjetos exibidos na configuração.

    • Selecionando um subobjeto: Na tabela, clique em qualquer lugar de uma linha para selecionar um subobjeto. Somente um subobjeto pode ser selecionado. As informações disponíveis para cada subobjeto são buscadas no endpoint Stripe:

      • 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 Stripe connection pode não ter sucesso. Certifique-se de estar 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 as 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. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Etapa 3 da configuração da atividade de leitura do Stripe

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

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

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

    • Pesquisar: Insira qualquer parte do nome da ação na caixa de pesquisa para filtrar a lista de ações. A busca 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 durante a pesquisa, 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 Stripe. Isso pode ser útil se ações foram adicionadas ao Stripe. Esta ação atualiza todos os metadados usados para construir a tabela de ações exibida na configuração.

    • Selecionando uma ação: Na tabela, clique em qualquer lugar de 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 no endpoint Stripe:

      • Nome: O nome da ação.

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

    Dica

    Se a tabela não for preenchida com ações disponíveis, a opção Conexão Stripe pode não ter sucesso. Certifique-se de estar 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 as 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 gerados a partir do endpoint serão exibidos. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Etapa 4 da configuração da atividade de leitura do Stripe

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

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

  • Editar: Clique no ícone de edição Ícone de edição acima do esquema de dados de resposta para entrar no modo de edição do esquema de resposta. O editor permite adicionar, excluir e reorganizar nós e campos e alterar seus tipos de dados. Todas as ocorrências de nós e campos são definidas 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.

    Nota

    Se sua instância Stripe usa campos personalizados, você deve editar o esquema de resposta para incluir um metadata nó contendo quaisquer campos personalizados. Caso contrário, você receberá um Success with Warning status da operação. Para obter mais informações sobre como usar o metadata nó, consulte a documentação da API Stripe.

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

Próximos Passos

Depois de configurar uma atividade Stripe Read, 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 definir as configurações de 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 de uma atividade podem ser acessadas no painel do projeto e na quadro de design. Para obter detalhes, consulte Menu Ações da atividade em Noções básicas do conector.

Atividades Stripe Read podem ser usadas como fonte com estes 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 execute a operação e validar o comportamento verificando os logs de operação.