ConnectionInfo : incluse dans le périmètre, globale

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 1 minute de lecture

    • L’API ConnectionInfo vous permet d’obtenir des informations d’attribut de connexion via l’alias de connexion et d’informations d’identification.

    Vous pouvez utiliser cette API dans des applications incluses dans le périmètre ou dans le périmètre global. Dans les scripts à portée, utilisez l’identificateur d’espace de noms sn_cc.

    Pour plus d’informations sur les connexions et les informations d’identification, consultez Informations d’identification et informations de connexion.

    Cette fonction récupère les informations d’attribut de connexion identifiées par l’alias de connexion et d’informations d’identification donné.

    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 incluse dans le champ d’application : getAttribute(nom de chaîne)

    Renvoie la valeur d’un attribut ConnectionInfo avec le nom de propriété spécifié.

    Tableau 1. Paramètres
    Nom Type Description
    nom Chaîne Nom d’une propriété d’objet ConnectionInfo .
    Tableau 2. Renvoie
    Type Description
    Chaîne Valeur d’une propriété ConnectionInfo spécifiée. 
      // get the same values using getAttribute
  gs.info(connectionInfo.getAttribute("name"));
  gs.info(connectionInfo.getAttribute("connection_url"));

    ConnectionInfo incluse dans le champ d’application : getCredentialAttribute()

    Renvoie la valeur des attributs d’informations d’identification pour une connexion spécifiée.

    Tableau 3. Paramètres
    Nom Type Description
    Néant
    Tableau 4. Renvoie
    Type Description
    Objet Carte de paires clé-valeur des attributs d’informations d’identification. 
     // get credential attributes
  gs.info(connectionInfo.getCredentialAttribute("user_name"));
  gs.info(connectionInfo.getCredentialAttribute("password"));

    ConnectionInfo incluse dans le champ d’application : getDataMap()

    Renvoie les attributs de connexion sous forme de collection de paires clé-valeur.

    Tableau 5. Paramètres
    Nom Type Description
    Néant
    Tableau 6. Renvoie
    Type Description
    Objet Carte de paires clé-valeur des attributs de connexion. 
     // get data map
  var datamap = connectionInfo.getDataMap();
  gs.info(datamap["name"]);
  gs.info(datamap["connection_url"]);

    ConnectionInfo incluse dans le champ d’application : getExtendedAttributes()

    Renvoie les attributs étendus sous forme de collection de paires clé-valeur.

    Tableau 7. Paramètres
    Nom Type Description
    Néant
    Tableau 8. Renvoie
    Type Description
    Objet Carte de paires clé-valeur des attributs étendus. 
    // get extended attributes
  var extendedAttributes = connectionInfo.getExtendedAttributes();  
  gs.info(extendedAttributes["name1"]);
 }