ConnectionInfo : champ d’application, global

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 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 inclus dans le périmètre, 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 périmètre : 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 l’étendue : getCredentialAttribute()

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

    Tableau 3. Paramètres
    Nom Type Description
    Aucun
    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 l’étendue : getDataMap()

    Renvoie les attributs de connexion sous la forme d’une collection de paires clé-valeur.

    Tableau 5. Paramètres
    Nom Type Description
    Aucun
    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 périmètre : getExtendedAttributes()

    Renvoie les attributs étendus sous la forme d’une collection de paires clé-valeur.

    Tableau 7. Paramètres
    Nom Type Description
    Aucun
    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"]);
 }