---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# i18N - Cliente

# i18N - Cliente {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

A API i18N fornece métodos para obter e formatar mensagens traduzidas.

Os métodos i18N são acessados usando o objeto global `g_i18n`.

## i18N - format (cadeia de caracteres de mensagem, mapa de objetos) {#ariaid-title2}

Formata uma cadeia de caracteres que contém tokens nomeados com valores de um mapa.
{#r_i18NV3-format_S_O__table_bqg_ngc_mv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| message | Cadeia de caracteres | A mensagem para que os tokens sejam adicionados. |
| mapa | Objeto | O mapa de pares de nome/valor a serem substituídos na mensagem. |
[Tabela 1. Parâmetros]

{#r_i18NV3-format_S_O__table_bqg_ngc_mv} {#r_i18NV3-format_S_O__table_cqg_ngc_mv__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | A cadeia de caracteres formatada |
[Tabela 2. Retorna]

{#r_i18NV3-format_S_O__table_cqg_ngc_mv}  

    // Returns: "The rich young ruler was very very rich"
    nowapi.g_i18n.format("The {p1} {p2} {p3} was very very {p1}",{p1: "rich", p2: "young", p3: "ruler"});

## i18N - getMessage (cadeia de caracteres msgKey, retorno de chamada de função) {#ariaid-title3}

Recupera uma mensagem traduzida.
Se a cadeia de caracteres especificada existir no banco de dados para o idioma atual, a mensagem traduzida será retornada. Se a cadeia de caracteres especificada não existir para o idioma atual, a versão em inglês da cadeia de caracteres será retornada. Se a cadeia de caracteres não existir no banco de dados, o próprio ID será retornado.
{#r_i18NV3-getMessage_S_F__table_kvv_52c_mv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| msgKey | Cadeia de caracteres | A mensagem a ser recuperada. |
| retorno de chamada | Função | A função a ser chamada quando a mensagem for recuperada. A função de retorno de chamada tem um argumento, uma cadeia de caracteres que é a mensagem traduzida. |
[Tabela 3. Parâmetros]

{#r_i18NV3-getMessage_S_F__table_kvv_52c_mv} {#r_i18NV3-getMessage_S_F__table_lvv_52c_mv__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 4. Retorna]

{#r_i18NV3-getMessage_S_F__table_lvv_52c_mv}

## i18N - getMessages (msgKeys de matriz, retorno de chamada de função) {#ariaid-title4}

Recupera um conjunto de mensagens.
Se a cadeia de caracteres especificada existir no banco de dados para o idioma atual, a mensagem traduzida será retornada. Se a cadeia de caracteres especificada não existir para o idioma atual, a versão em inglês da cadeia de caracteres será retornada. Se a cadeia de caracteres não existir no banco de dados, o próprio ID será retornado.
{#r_i18NV3-getMessages_A_F__table_mqm_3hc_mv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| msgKeys | Matriz | Uma matriz de chaves que especifica as mensagens a serem recuperadas. |
| retorno de chamada | Função | A função a ser chamada quando as mensagens forem recuperadas. A função de retorno de chamada tem um argumento, um objeto que contém pares de chave-valor, em que chave é a chave da mensagem solicitada e o valor é a cadeia de caracteres traduzida. |
[Tabela 5. Parâmetros]

{#r_i18NV3-getMessages_A_F__table_mqm_3hc_mv} {#r_i18NV3-getMessages_A_F__table_nqm_3hc_mv__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 6. Retorna]

{#r_i18NV3-getMessages_A_F__table_nqm_3hc_mv}