4D v18
dataClass.get( )
dataClass.get( )
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.
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. |
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"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
Produto: 4D
Tema: ORDA - DataClass
Manual de linguagem 4D ( 4D v18)
