dataStore.getInfo( )

4D v19

Description

La méthode dataStore.getInfo( ) retourne un objet qui fournit des informations sur le datastore. Cette méthode est utile pour créer du code générique.

Objet retourné

Propriété

Type

Description

type

chaîne

sur ds avec 4D monoposte : "4D"
sur ds en client/serveur, lorsqu'elle est appelée sur le serveur : "4D"
sur ds en client/serveur, lorsqu'elle est appelée sur un 4D distant : "4D Server"
sur un datastore distant ouvert avec Ouvrir datastore : "4D Server"

networked

booléen

Vrai : le datastore est accessible via une connexion réseau.
Faux : le datastore n'est pas accessible via une connexion réseau (base locale)

localID

chaîne

ID du datastore sur la machine. Correspond à la chaîne localId donnée avec la commande Ouvrir datastore. Chaîne vide ("") for le datastore principal.

connection

objet

Objet décrivant la connexion au datastore distant (non retourné par le datastore principal). Propriétés disponibles :

Propriété	Type	Description
hostname	texte	Adresse IP ou nom du datastore distant + ":" + numéro de port
tls	booléen	Vrai si la connexion sécurisée est utilisée avec le datastore distant
idleTimeout	numérique	Timeout de la session d'inactivité (en minutes)
user	texte	Utilisateur authentifié sur le datastore distant

Si la méthode dataStore.getInfo( ) est exécutée sur un 4D Server ou un 4D monoposte, networked est mis à Faux.
Si la méthode dataStore.getInfo( ) est exécutée sur un 4D distant, networked est mis à Vrai.

Exemple 1

 C_OBJET($info)

 

 $info:=ds.getInfo() //Exécutée sur 4D Server ou 4D

  //{"type":"4D","networked":faux,"localID":""}

 

 $info:=ds.getInfo() // /Exécutée sur 4D distant

  //{"type":"4D Server","networked":vrai,localID":""}

Exemple 2

Sur un datastore distant :

 C_OBJET($info;$connectTo;$remoteDS)

 

 $connectTo:=Creer objet("hostname";"111.222.33.44:8044";"user";"marie";"password";"aaaa")

 $remoteDS:=Ouvrir datastore($connectTo;"students")

 $info:=$remoteDS.getInfo()

 

  //{"type":"4D Server",

  //"localID":"students",

  //"networked":vrai,

  //"connection":{hostname:"111.222.33.44:8044","tls":faux,"idleTimeout":2880,"user":"marie"}}

Voir aussi

dataClass.getInfo( )