Métodos de conector KeyValuePair

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 5 min. de leitura

    • Os métodos de conector de par chave-valor executam várias ações em pares de chave-valor. Em um fluxo de automação, os métodos são conectados a outros métodos e componentes. Para usar os métodos, você deve primeiro expô-los.

    Adicionar

    Adiciona um par chave-valor.

    Para fornecer entradas para os parâmetros, consulte Configurar propriedades da porta.

    Tabela 1. Adicionar parâmetros de método
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Chave Nome da chave. Dados em Cadeia de caracteres Nenhum Sim
    valor Valor da chave. Dados em Object Nenhum Sim
    Ignorar Duplicatas Se o valor for Verdadeiro, o método ignorará uma chave duplicada. Caso contrário, se o valor for falso, o método retornará uma mensagem de erro. Dados em Booleano Nenhum Não

    Limpar

    Limpa todos os pares de chave-valor.

    ContainsKey

    Retorna Verdadeiro se a chave especificada existir, caso contrário, retorna Falso.

    Para fornecer entradas para os parâmetros, consulte Configurar propriedades da porta.

    Tabela 2. Parâmetros do método containsKey
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Chave Nome da chave. Dados em Cadeia de caracteres Nenhum Sim
    Retornar Retorna Verdadeiro se a chave especificada existir, caso contrário, retorna Falso. Dados esgotados Booleano Não aplicável Não aplicável

    ContémValor

    Retorna Verdadeiro se o valor de chave especificado existir, caso contrário, retorna Falso.

    Para fornecer entradas para os parâmetros, consulte Configurar propriedades da porta.

    Tabela 3. Parâmetros do método containsValue
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    valor Nome do valor da chave. Dados em Cadeia de caracteres Nenhum Sim
    Retornar Retorna Verdadeiro se o valor de chave especificado existir, caso contrário, retorna Falso. Dados esgotados Booleano Não aplicável Não aplicável

    Contagem

    Retorna a contagem total de pares de chave-valor.

    Tabela 4. Parâmetros do método de contagem
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Retornar Retorna a contagem total de pares de chave-valor. Dados esgotados Inteiro Não aplicável Não aplicável

    Excluir

    Remove a chave especificada.

    Para fornecer entradas para os parâmetros, consulte Configurar propriedades da porta.

    Tabela 5. Excluir parâmetros do método
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Chave Nome da chave. Dados em Cadeia de caracteres Nenhum Sim

    Obter item

    Retorna o valor da chave especificada.

    Para fornecer entradas para os parâmetros, consulte Configurar propriedades da porta.

    Tabela 6. Parâmetros do método GetItem
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Chave Nome da chave. Dados em Cadeia de caracteres Nenhum Sim
    Retornar Retorna o valor da chave. Dados esgotados Object Não aplicável Não aplicável

    Obter itens

    Retorna os valores de várias chaves. Você deve primeiro configurar as chaves no método.

    Para configurar, siga estas etapas.
    1. Clique no ícone de configurações do método (ícone de configurações do método).
    2. Clique no ícone adicionar chaves (ícone Adicionar chaves).
    3. Insira o nome da chave.
    4. Atualize o tipo de dados da chave na lista.
    5. Repita as etapas para definir vários nomes de chave.
    6. Clique em OK.

      Uma porta de saída de dados é criada com cada nome de chave definido.

    Tabela 7. Parâmetros do método GetItems
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Chave Retorna o valor da chave. Dados esgotados Object Não aplicável Não aplicável

    GetItemsByIndex

    Retorna os valores de chave com base em seu índice. Você deve primeiro configurar os índices no método.

    Para configurar, siga estas etapas.
    1. Clique no ícone de configurações do método (ícone de configurações do método).
    2. Clique no ícone adicionar índices (ícone Adicionar chaves).
    3. Insira o índice de chave.
    4. Atualize o tipo de dados da chave na lista.
    5. Repita as etapas para definir vários índices de chave.
    6. Clique em OK.

      Uma porta de saída de dados é criada com cada índice de chave definido.

    Tabela 8. Parâmetros do método GetItemsByIndex
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Índice de chave Retorna o valor da chave. Dados esgotados Object Não aplicável Não aplicável

    Analisar de texto

    Analisa o texto especificado em pares de chave-valor. Ele pode criar vários pares de chave-valor.

    Para fornecer entradas para os parâmetros, consulte Configurar propriedades da porta.

    Tabela 9. Parâmetros do método ParseFromText
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Texto Texto que compreende as chaves e os valores que o método analisa. Dados em Cadeia de caracteres Nenhum Sim
    ItemSeparator Separador entre dois pares de chave-valor. Dados em Cadeia de caracteres Nenhum Sim
    KeyValueSeparator Separador entre a chave e seu valor. Dados em Cadeia de caracteres Nenhum Sim
    Limpar antes de analisar Se verdadeiro, limpa qualquer par de chave-valor existente antes da análise. Dados em Booleano Nenhum Não

    Reverter

    Reverte os índices de chave.
    Dica:
    Depois de executar o método, você pode ver a saída executando o método GetItemsByIndex.

    DefinirDados

    Precisa de informações.

    Definir item

    Atualiza o valor de uma chave.

    Para fornecer entradas para os parâmetros, consulte Configurar propriedades da porta.

    Tabela 10. Parâmetros do método SetItem
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Chave Nome da chave. Dados em Cadeia de caracteres Nenhum Sim
    valor Valor atualizado da chave. Dados em Object Nenhum Sim
    Dica:
    Teste o valor atualizado executando o método GetItemsByIndex.

    Definir itens

    Atualiza os valores das chaves especificadas. Você deve primeiro configurar as chaves no método.

    Para configurar as chaves, siga estas etapas.
    1. Clique no ícone de configurações do método (ícone de configurações do método).
    2. Clique no ícone adicionar chaves (ícone Adicionar chaves).
    3. Insira o nome da chave.
    4. Atualize o tipo de dados da chave na lista.
    5. Repita as etapas para definir vários nomes de chave.
    6. Clique em OK.

      Um Data na porta é criado com cada nome de chave definido.

    Para fornecer entradas para os parâmetros, consulte Configurar propriedades da porta.

    Tabela 11. Parâmetros do método SetItems
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Chave Valor atualizado da chave. Dados em Object Nenhum Sim
    Dica:
    Teste o valor atualizado executando o método GetItemsByIndex.

    Definir itens por índice

    Atualiza os valores das chaves com base nos índices especificados. Você deve primeiro configurar os índices no método.

    Para configurar os índices, siga estas etapas.
    1. Clique no ícone de configurações do método (ícone de configurações do método).
    2. Clique no ícone adicionar índices (ícone Adicionar chaves).
    3. Insira o índice de chave.
    4. Atualize o tipo de dados da chave na lista.
    5. Repita as etapas para definir vários índices de chave.
    6. Clique em OK.

      Um dado na porta é criado com cada índice de chave definido.

    Tabela 12. Parâmetros do método SetItemsByIndex
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Índice de chave Índice da chave. Dados em Object Nenhum Sim
    Dica:
    Teste o valor atualizado executando o método GetItemsByIndex.

    ParaJSON

    Renderiza os pares de chave-valor para o formato JSON.

    ParaTexto

    Renderiza os pares de chave-valor no formato de texto.

    Para fornecer entradas para os parâmetros, consulte Configurar propriedades da porta.

    Tabela 13. Parâmetros do método ToText
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Somente valores Se for verdadeiro, o método renderizará somente os valores das chaves, caso contrário, renderizará o par chave-valor. Dados em Booleano Nenhum Não
    Retornar Retorna o par chave-valor para o formato de texto. Dados esgotados Cadeia de caracteres Não aplicável Não aplicável