Aller au contenu principal
Version: 20 R7

ds

ds { ( localID : Text ) } : cs.DataStore

ParamètresTypeDescription
localIDTextIdentifiant local du datastore distant
Résultatcs.DataStoreNouvelle référence de datastore

Description

La commande ds retourne une référence vers le datastore correspondant à la base de données 4D courante ou à la base de données désignée par localID.

Si vous omettez le paramètre localID (ou si vous passez une chaîne vide ""), la commande renvoie une référence au datastore correspondant à la base de données 4D locale (ou à la base 4D Server en cas d'ouverture d'une base de données distante sur 4D Ser Le datastore est ouvert automatiquement et est disponible directement via ds.

Vous pouvez également obtenir une référence sur un datastore distant ouvert en passant son identifiant local dans le paramètre localID. Vous pouvez également obtenir une référence sur un datastore distant ouvert en passant son identifiant local dans le paramètre localID. L'identifiant local est défini lors de l'utilisation de cette commande.

La portée de l'identifiant local est la base de données dans laquelle le datastore a été ouvert.

Si aucun datastore nommé localID n'est trouvé, la commande renvoie Null.

Les objets disponibles dans le cs.Datastore sont mappés à partir de la base de données cible en respectant les règles générales de correspondance d'ORDA.

Exemple 1

Utilisation du datastore principal de la base 4D :

var $result : cs.EmployeeSelection
$result:=ds.Employee.query("firstName = :1";"S@")

Exemple 2

 var $connectTo; $firstFrench; $firstForeign : Object

var $frenchStudents; $foreignStudents : cs.DataStore

$connectTo:=New object("type";"4D Server";"hostname";"192.168.18.11:8044")
$frenchStudents:=Open datastore($connectTo;"french")

$connectTo.hostname:="192.168.18.11:8050"
$foreignStudents:=Open datastore($connectTo;"foreign")
//...
//...
$firstFrench:=getFirst("french";"Students")
$firstForeign:=getFirst("foreign";"Students")
  //getFirst method
//getFirst(localID;dataclass) -> entity
#DECLARE( $localId : Text; $dataClassName : Text ) -> $entity : 4D.Entity

$entity:=ds($localId)[$dataClassName].all().first()

Voir également

Open datastore

Propriétés

Numéro de commande1482
Thread safe✓