ds

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

Parâmetro	Tipo		Descrição
localID	Text	→	ID local del armazém de dados remoto a devolver
Resultados	cs. DataStore	←	Referencia ao armazém de dados

Descrição

O comando ds retorna uma referência ao datastore que corresponde ao banco de dados 4D atual ou ao banco de dados designado por localID.

Se omitir o parâmetro localID (ou se passa uma string vazia ""), o comando devolve uma referência ao armazém de dados que coincide com a base de dados local de 4D (ou a base de datos de 4D Server em caso de abrir uma base de dados remota em 4D Server). O repositório de dados é aberto automaticamente e está disponível diretamente por meio do ds.

Você também pode obter uma referência em um datastore remoto aberto passando seu ID local no parâmetro localID. O datastore deve ter sido aberto anteriormente com o comando Open datastore pelo banco de dados atual (host ou componente). A identificação local se define quando se utilizar este comando.

O escopo do id local do banco de dados no qual o armazen de dados foi aberto.

Se nenhum datastore localID for encontrado, o comando retornará Null.

Os objetos disponíveis no cs.Datastore são mapeados a partir do banco de dados de destino conforme as regras gerais do ORDA.

Exemplo 1

Usar a datastore principal do banco de dados 4D:

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

Exemplo 2

 var $connectTo; $firstFrench; $firstForeign : Object

 var $frenchStudents; $foreignStudents : 4D.DataStoreImplementation

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

Veja também

Open datastore

Propriedades

Número de comando	1482
Thread safe	✓