Atribui um novo conteúdo ao valor de um item em uma estrutura do tipo mapa através do uso da chave associada.
![](/download/attachments/234662707/blocoDefineValorNoMapaPorChave.png?version=1&modificationDate=1671813186000&api=v2)
Figura 1 - Bloco Definir valor no Mapa por Chave
Compatibilidade
- Bloco cliente: cronapi.map.setMapValueByKey()
Retorno
Bloco sem retorno.
Parâmetros
Mapa
Objeto mapa.
- Posição: 1
- Inglês: Map
- Tipo: Mapa / Map
- Exemplo: "map"
Chave
Chave do item a ter o valor definido.
- Posição: 2
- Inglês: Key
- Tipo: Texto / String
- Exemplo: "chave1"
Valor
Conteúdo a ser definido no valor do item.
- Posição: 3
- Inglês: Value
- Tipo: Texto / String
- Exemplo: "novo valor"
Exemplo
A função abaixo atualiza o valor do parâmetro chave1 para “novo valor”, dentro do objeto map.
![](/download/attachments/234662707/blocoDefineValorNoMapaPorChaveExemplo.png?version=1&modificationDate=1671813697000&api=v2)
Figura 2 - Exemplo de uso do bloco Definir valor no Mapa por Chave
![](/download/attachments/234662707/blocoDefinirValorNoMapaPorChaveResultado.png?version=3&modificationDate=1672234060000&api=v2)
Figura 2.1 - Resultado exibido a partir das configurações da Figura 2