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 exibi-los.

Adicionar

Adiciona um par de valor-chave.

Para fornecer entradas para os parâmetros, consulte Configure as 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
IgnoreDuplicatas	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 valor-chave.

ContainsKey

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

Para fornecer entradas para os parâmetros, consulte Configure as 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, retornará Falso.	Saída de dados	Booliano	Não aplicável	Não aplicável

ContainsValue

Retorna Verdadeiro se o valor da chave especificado existir, caso contrário, retornará Falso.

Para fornecer entradas para os parâmetros, consulte Configure as 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 da chave especificado existir, caso contrário, retornará Falso.	Saída de dados	Booliano	Não aplicável	Não aplicável

Contagem

Retorna a contagem total de pares de valor-chave.

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 valor-chave.	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 Configure as propriedades da porta.

Tabela 5. Excluir 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

GetItem

Retorna o valor da chave especificada.

Para fornecer entradas para os parâmetros, consulte Configure as 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

GetItems

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

Para configurar, execute as etapas a seguir.

1. Clique no ícone Configurações de método ( ).
2. Clique no ícone adicionar chaves ( ).
3. Insira o nome da chave.
4. Atualize o tipo de dados de 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. Primeiro, você deve configurar os índices no método.

Para configurar, execute as etapas a seguir.

1. Clique no ícone Configurações de método ( ).
2. Clique no ícone adicionar índices ( ).
3. Insira o índice de chave.
4. Atualize o tipo de dados de 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

ParseFromText

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

Para fornecer entradas para os parâmetros, consulte Configure as 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?
Texto	Texto que compreende as chaves e os valores que o método analisa.	Dados em	Cadeia de caracteres	Nenhum(a)	Sim
ItemSeparator	Separador entre dois pares de valor-chave.	Dados em	Cadeia de caracteres	Nenhum(a)	Sim
KeyValueSeparator	Separador entre a chave e seu valor.	Dados em	Cadeia de caracteres	Nenhum(a)	Sim
ClearBeforeParse	Se verdadeiro, limpa qualquer par de valor-chave existente antes de analisar.	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.

SetData

Informações necessárias.

SetItem

Atualiza o valor de uma chave.

Para fornecer entradas para os parâmetros, consulte Configure as 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.

SetItems

Atualiza os valores das chaves especificadas. Primeiro você deve configurar as chaves no método .

Para configurar as chaves, execute as etapas a seguir.

1. Clique no ícone Configurações de método ( ).
2. Clique no ícone adicionar chaves ( ).
3. Insira o nome da chave.
4. Atualize o tipo de dados de 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 Configure as 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. Primeiro, você deve configurar os índices no método.

Para configurar os índices, execute as etapas a seguir.

1. Clique no ícone Configurações de método ( ).
2. Clique no ícone adicionar índices ( ).
3. Insira o índice de chave.
4. Atualize o tipo de dados de 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.

ToJSON

Renderiza os pares de keyvalue para o formato JSON.

ToText

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

Para fornecer entradas para os parâmetros, consulte Configure as 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?
ValuesOnly	Se verdadeiro, o método renderiza somente os valores das chaves, caso contrário, renderiza o par de keyvalue.	Dados em	Booliano	Nenhum(a)	Não
Retornar	Retorna o par de valor-chave para o formato de texto.	Saída de dados	Cadeia de caracteres	Não aplicável	Não aplicável