entitySelection.{attributeName}

4D v19.8


entitySelection.{attributeName} -> entitySelection.{attributeName}

Parâmetro	Tipo	Descrição
entitySelection.{attributeName}	Collection, EntitySelection	Projeção de valores de atributo para seleção de entidade

Descrição

Todo atributo de classe de dados pode ser usado como uma propriedade de uma seleção de entidade para devolver uma "projeçãpo" de valores para o atributo na seleção de entidade. Os valores projetados podem ser uma coleção ou uma nova seleção de entidade, segundo o tipo (armazenamento ou relação) do atributo.

Se a classe de nomAtributo for storage:
entitySelection.attributeName devolve uma coleção de valores do mesmo tipo que nomAtributo.

Se a classe de nomAtributo for relatedEntity:
entitySelection.attributeName devolve uma nova seleção de entidade de valores relacionados do mesmo tipo que nomAtributo. Os duplicados são eliminados ( uma seleção de entidade desordenada é devolvida).

Se a classe de nomAtributo for relatedEntities:
entitySelection.attributeName devolve uma nova seleção de entidade de valores relacionados do mesmo tipo que nomAtributo. Os duplicados são eliminados (uma seleção de entidade desordenada é devolvida).

Quando um atributo de relação for usado como uma propriedade de uma seleção de entidade, o resultado é sempre outra seleção de entidade, mesmo se só for devolvida uma entidade. Nesse caso, se não forem devolvidas entidades, o resultado é uma seleção de entidade vazia.

Nota: para mais informação sobre o tipo de atributo, consulte a descrição da propriedade dataClassAttribute.kind.

Se um atributo não existir na seleção de entidades, um erro é retornado

Exemplo 1

Projeção de valores de armazenamento:

 C_COLLECTION(firstNames)

 $entitySelection:=ds.Employee.all()

 firstNames:=$entitySelection.firstName // o tipo de firstName é string

A coleção resultante é uma coleção de strings, por exemplo:

[
    "Joanna",
    "Alexandra",
    "Rick"
]

Exemplo 2

Projeção de entidade relacionada:

 C_OBJECT($es;$entitySelection)

 $entitySelection:=ds.Employee.all()

 $es:=$entitySelection.employer // empregados está relacionada a Company dataClass

O objeto resultante é uma coleção de entidade de Company com duplicatas removidas (se houver).

Exemplo 3

Projeção de entidades relacionadas:

 C_OBJECT($es)

 $es:=ds.Employee.all().directReports // directReports <span id="result_box" lang="es"><span>está relacionado com</span></span> Employee dataclass

O objeto resultante é uma seleção de entidade de Employee com duplicados eliminados (se houver).

Ver também

entity.{attributeName}