Métodos do conector KeyValuePair

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 ).
2. Clique no ícone para adicionar chaves (ícone para ).
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 ).
2. Clique no ícone para adicionar índices (ícone para ).
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 ).
2. Clique no ícone para adicionar chaves (ícone para ).
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 ).
2. Clique no ícone para adicionar índices (ícone para ).
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