---
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


---

# ConnectionInfo - com escopo, global

# ConnectionInfo - com escopo, global {#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 ConnectionInfo permite que você obtenha informações de atributo de conexão por meio do alias de conexão e credencial.

Você pode usar esta API em aplicações com escopo ou dentro do escopo global. Em scripts com escopo, use o identificador de namespace `sn_cc`.

Para obter mais informações sobre conexões e credenciais, consulte [Credenciais e informações de conexão](https://www.servicenow.com/docs/access?context=r-credentials&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US).

Esta função recupera informações de atributo de conexão identificadas pelo alias de conexão e credencial fornecido.  

    var provider = new sn_cc.ConnectionInfoProvider();

    // get a jdbc connection in the current domain with the alias ID
    //     "6219afbf9f03320021dd7501942e70fc"
    var connectionInfo = provider.getConnectionInfo("6219afbf9f03320021dd7501942e70fc");
    if (connectionInfo != null) {
      // get data map
      var datamap = connectionInfo.getDataMap();
      gs.info(datamap["name"]);
      gs.info(datamap["connection_url"]);

      // get the same values using getAttribute
      gs.info(connectionInfo.getAttribute("name"));
      gs.info(connectionInfo.getAttribute("connection_url"));

      // get credential attributes
      gs.info(connectionInfo.getCredentialAttribute("user_name"));
      gs.info(connectionInfo.getCredentialAttribute("password")); 

      // get extended attributes
      var extendedAttributes = connectionInfo.getExtendedAttributes();  
      gs.info(extendedAttributes["name1"]);
     }

     // get a jdbc connection in the ACME domain with the alias ID
     //      "cd5923ff9f03320021dd7501942e70bb"
     connectionInfo = provider.getConnectionInfoByDomain("cd5923ff9f03320021dd7501942e70bb",
            "c90d4b084a362312013398f051272c0d");
     if (connectionInfo != null) {
       // get data map
       var datamap = connectionInfo.getDataMap();
       gs.info(datamap["name"]);
     }

## ConnectionInfo com escopo - getAttribute(String name) {#ariaid-title2}

Retorna o valor de um atributo ConnectionInfo com o nome de propriedade especificado.
{#CI-getAttribute_S__table_ext_cx2_qbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome de uma propriedade do objeto ConnectionInfo. |
[Tabela 1. Parâmetros]

{#CI-getAttribute_S__table_ext_cx2_qbb} {#CI-getAttribute_S__table_fxt_cx2_qbb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor de uma propriedade ConnectionInfo especificada. |
[Tabela 2. Retorna]

{#CI-getAttribute_S__table_fxt_cx2_qbb}  

      // get the same values using getAttribute
      gs.info(connectionInfo.getAttribute("name"));
      gs.info(connectionInfo.getAttribute("connection_url"));

## ConnectionInfo com escopo - getCredentialAttribute() {#ariaid-title3}

Retorna o valor dos atributos de credencial de uma conexão especificada.
{#CI-getCredentialAttribute_S__table_ext_cx2_qbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 3. Parâmetros]

{#CI-getCredentialAttribute_S__table_ext_cx2_qbb} {#CI-getCredentialAttribute_S__table_fxt_cx2_qbb__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | Mapa de par de chave-valor de atributos de credencial. |
[Tabela 4. Retorna]

{#CI-getCredentialAttribute_S__table_fxt_cx2_qbb}  

     // get credential attributes
      gs.info(connectionInfo.getCredentialAttribute("user_name"));
      gs.info(connectionInfo.getCredentialAttribute("password")); 

## ConnectionInfo com escopo - getDataMap() {#ariaid-title4}

Retorna os atributos de conexão como uma coleção de pares de chave-valor.
{#CI-getDataMap_S__table_ext_cx2_qbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 5. Parâmetros]

{#CI-getDataMap_S__table_ext_cx2_qbb} {#CI-getDataMap_S__table_fxt_cx2_qbb__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | Mapa de par de chave-valor de atributos de conexão. |
[Tabela 6. Retorna]

{#CI-getDataMap_S__table_fxt_cx2_qbb}  

     // get data map
      var datamap = connectionInfo.getDataMap();
      gs.info(datamap["name"]);
      gs.info(datamap["connection_url"]);

## ConnectionInfo com escopo - getExtendedAttributes() {#ariaid-title5}

Retorna os atributos estendidos como uma coleção de pares de chave-valor.
{#CI-getExtendedAttributes_S__table_ext_cx2_qbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 7. Parâmetros]

{#CI-getExtendedAttributes_S__table_ext_cx2_qbb} {#CI-getExtendedAttributes_S__table_fxt_cx2_qbb__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | Mapa de par de chave-valor de atributos estendidos. |
[Tabela 8. Retorna]

{#CI-getExtendedAttributes_S__table_fxt_cx2_qbb}  

    // get extended attributes
      var extendedAttributes = connectionInfo.getExtendedAttributes();  
      gs.info(extendedAttributes["name1"]);
     }