dataStore.getInfo( )

4D v19

Descrição

O método dataStore.getInfo( ) devolve um objeto que oferece informação sobre a datastore. Este método é útil para configurar o código genérico.

Objeto devolvido

Propriedade

Tipo

Descrição

type

string

em ds com 4D monousuário: "4D"
em ds em cliente/servidor, quando chamado no servidor: "4D"
em ds em cliente/servidor, quando chamado em um 4D Remoto: "4D Server"
em uma datastore remota aberta com Open datastore: "4D Server"

networked

booleano

True: se alcança a datastore através de uma conexão de rede.
False: não se alcança a datastore através de uma conexão de rede (banco local)

localID

texto

ID da datastore na máquina. Corresponde à string localId dada com o comando Open datastore. String vazia ("") para a datastore de dados principal.

connection

objeto

Objeto que descreve a conexão remota a datastore (não se devolve para a datastore principal). Propriedades disponíveis:

Propriedade	Tipo	Descrição
hostname	texto	Endereço IP ou nome de armazem de dados remoto + ":" + número de porto
tls	booleano	True se for utilizada uma conexão segura com o armazem de dados remoto
idleTimeout	numéro	Timeout da sessão de inatividade (em minutos)
user	texto	Usuário autenticado no armazem de dados remoto

Se o método dataStore.getInfo( ) for executado em um servidor 4D ou em um monoposto 4D, a conexão em rede é False.
Se o método dataStore.getInfo( ) for executado em um 4D remoto, em rede é True.

Exemplo 1

 C_OBJECT($info)

 

 $info:=ds.getInfo() //Executado em 4D Server or 4D

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

 

 $info:=ds.getInfo() // Executado em 4D remoto

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

Exemplo 2

Em um um armazem de dados remoto:

 C_OBJECT($info;$connectTo;$remoteDS)

 

 $connectTo:=New object("hostname";"111.222.33.44:8044";"user";"marie";"password";"aaaa")

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

 $info:=$remoteDS.getInfo()

 

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

  //"localID":"students",

  //"networked":true,

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

Ver também

dataClass.getInfo( )