dataStore.getInfo( )

4D v18

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

"4D": datastore principal, disponível através de ds
"4D Server": datastore remoto, aberto com Open datastore

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 ou 4D

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

 

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

  //{"type":"4D","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( )