ds

4D v19.8

ds


ds {( localID )} -> Resultado

Parámetro	Tipo	Descripción
localID	Texto	Local ID del almacén de datos remoto a devolver
Resultado	DataStore	Nueva referencia del almacén de datos

Descripción

El comando ds devuelve una nueva referencia al almacén de datos que coincide con la base de datos 4D actual o la base designada por localID

Si omite el parámetro localID (o pasa una cadena vacía ""), el comando devuelve una referencia al datastore que coincide con la base 4D local (o la base 4D Server en caso de abrir una base remota en 4D Server). El almacén de datos se abre automáticamente y está disponible directamente a través de ds.

También puede abrir cualquier almacén de datos local o remoto al pasar su identificación local en el parámetro localID. El almacén de datos debe haberse abierto previamente con el comando Open datastore por la base actual (host o componente). La identificación local se define al usar este comando.

Nota: el alcance del id local es la base donde se abrió el almacén de datos.

Si no se encuentra el almacén de datos localID, el comando devuelve Null.

El uso de ds requiere que su base cumpla con ORDA como se especifica en la sección Prerequisitos ORDA. Se aplican las siguientes reglas:

Un almacén de datos solo hace referencia a las tablas con una sola llave principal. Las tablas sin llave primaria o con llaves primarias compuestas no se referencian.
Los atributos de tipo BLOB no se gestionan en el almacén de datos.

Para más información sobre la implementación del almacén de datos, consulte la sección Datastores.

Ejemplo 1

Uso del almacén de datos actual de la base 4D :

$result:=ds.Employees.query("nom = :1";"S@")

Ejemplo 2

 C_OBJECT($connectTo;$frenchStudents;$foreignStudents;$firstFrench;$firstForeign)

 

 $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")

  //Método getFirst

  //getFirst(localID;dataclass) -> entity

  // ---------------------

 C_TEXT($dataClassName;$2;$localId;$1)

 C_OBJECT($0)

 

 $localId:=$1

 $dataClassName:=$2

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

Ver también

Entorno 4D
Open datastore