ConnectionInfo - Escopo, Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 1 min. de leitura
  • . ConnectionInfo A API 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 no escopo global. Em scripts com escopo, use sn_cc identificador de namespace.

    Para obter mais informações sobre conexões e credenciais, consulte Credenciais e informações de conexão .

    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(nome da cadeia de caracteres)

    Retorna o valor de um ConnectionInfo atributo com o nome da propriedade especificado.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Nome de um ConnectionInfo propriedade do objeto.
    Tabela 2. Retornos
    Tipo Descrição
    Cadeia de caracteres Valor de um especificado ConnectionInfo propriedade.
      // get the same values using getAttribute
      gs.info(connectionInfo.getAttribute("name"));
      gs.info(connectionInfo.getAttribute("connection_url"));
    

    ConnectionInfo com escopo - getCredentialAttribute()

    Retorna o valor dos atributos de credencial para uma conexão especificada.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 4. Retorna
    Tipo Descrição
    Objeto Mapa de par de chave-valor de atributos de credencial.
     // get credential attributes
      gs.info(connectionInfo.getCredentialAttribute("user_name"));
      gs.info(connectionInfo.getCredentialAttribute("password")); 
    

    ConnectionInfo com escopo - getDataMap()

    Retorna os atributos de conexão como uma coleção de pares de chave-valor.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 6. Retorna
    Tipo Descrição
    Objeto Mapa de par de chave-valor de atributos de conexão.
     // get data map
      var datamap = connectionInfo.getDataMap();
      gs.info(datamap["name"]);
      gs.info(datamap["connection_url"]);
    

    ConnectionInfo com escopo - getExtendedAttributes()

    Retorna os atributos estendidos como uma coleção de pares de chave-valor.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 8. Retorna
    Tipo Descrição
    Objeto Mapa de par de chave-valor de atributos estendidos.
    // get extended attributes
      var extendedAttributes = connectionInfo.getExtendedAttributes();  
      gs.info(extendedAttributes["name1"]);
     }