Métodos do conector KeyValuePair

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 6 min. de leitura

    • Os métodos do conector de par de 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 de valores-chave.

    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?
    Chave Nome da chave. Dados em Cadeia de caracteres Nenhum(a) Sim
    Valor Valor da chave. Dados em Objeto Nenhum(a) Sim
    Ignorarduplicatas 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 Booliano Nenhum(a) Não

    Limpar

    Limpa todos os pares de chave-valor.

    Contém chave

    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?
    Chave Nome da chave. Dados em Cadeia de caracteres Nenhum(a) Sim
    Retornar Retorna verdadeiro se a chave especificada existir, caso contrário, retorna falso. Saída de dados Booliano 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?
    Valor Nome do valor da chave. Dados em Cadeia de caracteres Nenhum(a) Sim
    Retornar Retorna verdadeiro se o valor de chave especificado existir, caso contrário, retorna falso. Saída de dados Booliano 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?
    Retornar Retorna a contagem total de pares de chave-valor. Saída de dados 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?
    Chave Nome da chave. Dados em Cadeia de caracteres Nenhum(a) 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?
    Chave Nome da chave. Dados em Cadeia de caracteres Nenhum(a) Sim
    Retornar Retorna o valor da chave. Saída de dados Objeto 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 de método (ícone de configurações de método).
    2. Clique no ícone para adicionar chaves (ícone para 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?
    Chave Retorna o valor da chave. Saída de dados Objeto 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 de método (ícone de configurações de método).
    2. Clique no ícone para adicionar índices (ícone para 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?
    Índice de chave Retorna o valor da chave. Saída de dados Objeto Não aplicável Não aplicável

    Analisar de texto

    Analisa o texto especificado em pares de valores de chave. 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 AnalisarDeTexto
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Texto Texto que contém as chaves e os valores que o método analisa. Dados em Cadeia de caracteres Nenhum(a) Sim
    ItemSeparator Separador entre dois pares de chave-valor. Dados em Cadeia de caracteres Nenhum(a) Sim
    KeyValueSeparator Separador entre a chave e seu valor. Dados em Cadeia de caracteres Nenhum(a) Sim
    Limpar antes de analisar Se verdadeiro, limpa qualquer par de chave-valor existente antes da análise. Dados em Booliano Nenhum(a) 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?
    Chave Nome da chave. Dados em Cadeia de caracteres Nenhum(a) Sim
    Valor Valor atualizado da chave. Dados em Objeto Nenhum(a) 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 de método (ícone de configurações de método).
    2. Clique no ícone para adicionar chaves (ícone para 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 entrada de dados é criada 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?
    Chave Valor atualizado da chave. Dados em Objeto Nenhum(a) Sim
    Dica:
    Teste o valor atualizado executando o método GetItemsByIndex.

    SetItemsByIndex

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

    Para configurar os índices, execute as etapas a seguir.
    1. Clique no ícone de configurações de método (ícone de configurações de método).
    2. Clique no ícone para adicionar índices (ícone para 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 entrada de dados é criada 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?
    Índice de chave Índice da chave. Dados em Objeto Nenhum(a) Sim
    Dica:
    Teste o valor atualizado executando o método GetItemsByIndex.

    Para JSON

    Renderiza os pares de chave-valor no formato JSON.

    Para texto

    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?
    ValoresSomente Se for verdadeiro, o método renderizará somente os valores das chaves, caso contrário, renderizará o par chave-valor. Dados em Booliano Nenhum(a) Não
    Retornar Retorna o par de valores-chave para o formato de texto. Saída de dados Cadeia de caracteres Não aplicável Não aplicável