dataClass.get( )

4D v19.8

dataClass.get( )


dataClass.get ( chavePrimaria {; settings} ) -> Resultado

Parâmetro	Tipo	Descrição
chavePrimaria	Inteiro longo, Texto	Valor da chave primária da entidade a recuperar
settings	Objeto	Opção de construção: contexto
Resultado	Entity	Entidade correspondente à chave primária designada

Descrição

O método dataClass.get( ) busca a dataclass para recuperar a entidade que coincide com o parãmetro chavePrimária.

Em chavePrimaria, passe o valor da chave primária da entidade a recuperar. O tipo de valor deve coincidir com o tipo de chave primária estabelecida na datastore (inteiro longo ou texto). Também é possível ter certeza de que o valor da chave primária sempre seja retornada como texto utilizando o método entity.getKey( ) com o parâmetro dk key as string.

Se não for encontrada nenhuma entidade com chavePrimária, se devolve uma entidade Null.

Se aplica carga diferida, o que significa que os dados relacionados são carregados desde o disco apenas quando for necessário.

settings

No parâmetro opcional settings, você pode passar um objeto contendo opções adicionais. A seguinte propriedade é suportada:

Propriedade	Tipo	Descrição
context	Texto	Rótulo para o contexto de otimização aplicado à seleção de entidade. Esse contexto será usado pelo código que manipula a seleção de entidade para que possa se beneficiar da otimização. Esse recurso é projetado para processamento de cliente / servidor ORDA; Para mais informações, consulte a seção Client/server optimization.

Exemplo 1

 C_OBJECT($entity)

 $entity:=ds.Employee.get(167) // retorna a entidade cujo valor de chave primária for 167

 $entity:=ds.Invoice.get("DGGX20030") // retorna a entidade cujo valor de chave primária for "DGGX20030"

Exemplo 2

Este exemplo ilustra o uso da propriedade de contexto:

 C_OBJECT($e1;$e2;$e3;$e4;$settings;$settings2)

 

 $settings:=New object("context";"detail")

 $settings2:=New object("context";"summary")

 

 $e1:=ds.Employee.get(1;$settings)

 completeAllData($e1) //  No método completeAllData, uma otimização é acionada e associada ao contexto "detail"

 

 $e2:=ds.Employee.get(2;$settings)

 completeAllData($e2) // No método completeAllData, a otimização associada ao contexto "detail" é aplicada

 

 $e3:=ds.Employee.get(3;$settings2)

 completeSummary($e3) // No método completeSummary, uma otimização é acionada e associada ao contexto "summary"

 

 $e4:=ds.Employee.get(4;$settings2)

 completeSummary($e4) // No método completeSummary, a otimização associada ao contexto "summary" é aplicada

Ver também

entity.getKey( )
Find in field
QUERY