...

Em vários momentos da personalização lidamos com o que chamamos de mapa. Mapa nada mais é que um conjunto de itens com chave/valor.

No Rhino, existem duas formas de trabalhar com mapas, de forma nativa ou na forma do java. A forma nativa, nada mais é que o um objeto simples do javascript, já na forma Java é utilizando as classes Java que implementam a interface O java possui a classe java.util.Map para trabalhar com itens "chave/valor". É muito usado para armazenar dados quando a estrutura dos dados não é bem definida ou não tão previsível.

Um exemplo são os dados de um formulário. Como o formulário é criado pelos desenvolvedores e podem conter uma variedade imprevisível de nomes, internamente trabalhamos sempre com Map para lidar com essas informações. 

como o java.util.HashMap. 

Recomendamos usar sempre da forma Java por ter uma maior compatibilidade com os nossos métodos, exceto quando a documentação permitir o uso da forma nativa, o que deixara o código mais legível.

Exemplo de um Mapa Nativo

...

Bloco de código
language javajs linenumbers true
Map<String, Object>var dados = { new HashMap<>(); dados.put("nome",: "João"); dados.put(, "idade",: 42); dados.put(, "salario",: 2500.98); } Systemconsole.out.printlnlog("O salário de " + dados.get("nome") + " (" + dados.get("idade") + " anos) é de R$ " + dados.get("salario")); //imprime: O salário de João (42 anos) é de R$ 2500.98

Criando um HashMap na personalização

Você pode usar o HashMap do Java, desde que referenciando corretamente a classe (inserir link aqui)

Isso é importante porque alguns dos nossos métodos, como os que recebem os já citados dados de formulário, recebem como parâmetro um objeto do tipo Map

Exemplo de um Mapa Java

var dados = new java.util.HashMap();
dados.put("nome", "João");
dados.put("idade", 42);
dados.put("salario", 2500.98);

hAPIconsole.startProcess(..., dados, ...);log("O salário de " + dados.get("nome") + " (" + dados.get("idade") + " anos) é de R$ " + dados.get("salario"));
//imprime: O salário de João (42 anos) é de R$ 2500.98