Versão: 20 R6 BETA

EntitySelection

Uma seleção de entidade é um objeto que contém uma ou mais referências a entidades pertencentes à mesma Dataclass. Uma seleção de entidades pode conter 0, 1 ou X entidades da dataclass -- onde X pode representar o número total de entidades contidas na dataclass.

As seleções de entidades podem ser criadas a partir de seleções existentes usando várias funções da classe DataClass, como .all() ou .query(), ou funções da própria classe EntityClass, como .and() ou orderBy(). Você também pode criar seleções de entidades em branco usando a função dataClass.newSelection() ou o comando Create new selection.

Resumo


[index] : 4D.Entity permite acessar entidades dentro da seleção de entidades usando a sintaxe de coleção padrão
.attributeName : Collection .attributeName : 4D.EntitySelection uma "projeção" de valores para o atributo na seleção de entidade
.add( entity : 4D.Entity ) : 4D.EntitySelection .add( entitySelection : 4D.EntitySelection ) : 4D.EntitySelection adiciona a entidade ou entitySelection especificada à seleção de entidade original e retorna a seleção de entidade modificada
.and( entity : 4D.Entity ) : 4D.EntitySelection .and( entitySelection : 4D.EntitySelection ) : 4D.EntitySelection combina a seleção de entidades com um parâmetro entity ou entitySelection usando o operador lógico AND
.at( index : Integer ) : 4D.Entity retorna a entidade na posição index, permitindo o uso de números inteiros positivos e negativos
.average( attributePath : Text ) : Real retorna a média aritmética (média) de todos os valores não nulos de attributePath na seleção de entidades
.clean() : 4D.EntitySelection retorna uma nova seleção de entidade com base na seleção de entidade original, mas sem as entidades excluídas, se houver
.contains( entity : 4D.Entity ) : Boolean retorna true se a referência da entidade pertencer à seleção de entidades
.copy( { option : Integer } ) : 4D.EntitySelection retorna uma cópia da entity selection original
.count( attributePath : Text ) : Real retorna o número de entidades na seleção de entidades com um valor não nulo em attributePath
.distinct( attributePath : Text { ; options : Integer } ) : Collection retorna uma coleção contendo apenas valores distintos (diferentes) do attributePath na seleção da entidade
.distinctPaths( attribute : Text ) : Collection retorna uma coleção de caminhos distintos encontrados no objeto indexado atributo para a seleção da entidade
.drop( { mode : Integer } ) : 4D.EntitySelection remove as entidades pertencentes à seleção de entidades da tabela relacionada à sua classe de dados no armazenamento de dados
.extract( attributePath : Text { ; option : Integer } ) : Collection .extract( attributePath { ; targetPath } { ; ...attributePathN : Text ; targetPathN : Text } ) : Collection retorna uma coleção contendo valores attributePath extraídos da seleção de entidades
.first() : 4D.Entity retorna uma referência à entidade na primeira posição da seleção de entidades
.getDataClass() : 4D.DataClass retorna a classe de dados da seleção da entidade
.getRemoteContextAttributes() : Text returns information about the optimization context used by the entity
.isAlterable() : Boolean retorna True se a seleção da entidade for alterável
.isOrdered() : Boolean retorna True se a seleção da entidade estiver ordenada
.last() : 4D.Entity retorna uma referência à entidade na última posição da seleção de entidades
.length : Integer retorna o número de entidades na seleção de entidades
.max( attributePath : Text ) : any retorna o valor mais alto (ou máximo) entre todos os valores de attributePath na seleção da entidade
.min( attributePath : Text ) : any retorna o valor mais baixo (ou mínimo) entre todos os valores de attributePath na seleção de entidades
.minus( entity : 4D.Entity { ; keepOrder : Integer } ) : 4D.EntitySelection .minus( entitySelection : 4D.EntitySelection { ; keepOrder : Integer } ) : 4D.EntitySelection exclui da seleção de entidades à qual é aplicada a entidade ou as entidades de entitySelection e retorna a seleção de entidades resultante
.or( entity : 4D.Entity ) : 4D.EntitySelection .or( entitySelection : 4D.EntitySelection ) : 4D.EntitySelection combina a seleção de entidades com o parâmetro entity ou entitySelection usando o operador lógico OR (não exclusivo)
.orderBy( pathString : Text ) : 4D.EntitySelection .orderBy( pathObjects : Collection ) : 4D.EntitySelection retorna uma nova seleção de entidade ordenada contendo todas as entidades da seleção de entidade na ordem especificada pelos critérios pathString ou pathObjects
.orderByFormula( formulaString : Text { ; sortOrder : Integer } { ; settings : Object} ) : 4D.EntitySelection .orderByFormula( formulaObj : Object { ; sortOrder : Integer } { ; settings : Object} ) : 4D.EntitySelection retorna uma nova seleção de entidades ordenada
.query( queryString : Text { ; ...value : any } { ; querySettings : Object } ) : 4D.EntitySelection .query( formula : Object { ; querySettings : Object } ) : 4D.EntitySelection busca entidades que atendam aos critérios de pesquisa especificados em queryString ou formula e (opcionalmente) value(s) entre todas as entidades na seleção de entidades
.queryPath : Text contém uma descrição detalhada da consulta conforme ela foi realmente executada pelo 4D
.queryPlan : Text contém uma descrição detalhada da consulta imediatamente antes de ser executada (ou seja, a consulta planejada)
.refresh() invalida imediatamente os dados de seleção de entidade no cache ORDA local
.selected( selectedEntities : 4D.EntitySelection ) : Object retorna um objeto que descreve a(s) posição(ões) de selectedEntities na seleção da entidade original
.slice( startFrom : Integer { ; end : Integer } ) : 4D.EntitySelection retorna uma parte de uma seleção de entidades em uma nova seleção de entidades
.sum( attributePath : Text ) : Real retorna a soma de todos os valores attributePath na seleção de entidades
.toCollection( { options : Integer { ; begin : Integer { ; howMany : Integer } } ) : Collection .toCollection( filterString : Text {; options : Integer { ; begin : Integer { ; howMany : Integer }}} ) : Collection .toCollection( filterCol : Collection {; options : Integer { ; begin : Integer { ; howMany : Integer }}} ) : Collection cria e retorna uma coleção em que cada elemento é um objeto que contém um conjunto de propriedades e valores

Criar uma seleção de entidades (entity selection)

Create entity selection ( dsTable : Table { ; settings : Object } ) : 4D.EntitySelection

Parâmetro	Tipo		Descrição
dsTable	Tabela	->	Tabela do banco de dados 4D cuja seleção atual se utilizará para construir a seleção de entidades
settings	Object	->	Opção de construção: context
Resultados	4D. EntitySelection	<-	Seleção de entidades que coincidem com a classe de dados relacionada com a tabela dada

Descrição

O comando Create entity selection cria e retorna uma nova seleção de entidade [alterável] (ORDA/entities.md#shareable-or-alterable-entity-selections) relacionada à classe de dados correspondente à dsTable fornecida, de acordo com a seleção atual dessa tabela.

Se a seleção atual for ordenada, uma entidade ordered é criada (a ordem da seleção atual é mantida). Se a seleção atual não for ordenada, se cria uma seleção de entidades não ordenada.

Se a dsTable não estiver exposta em ds, se devolve um erro. Esse comando não pode usado com uma datastore remota.

No parâmetro opcional settings, você pode passar um objeto que contenha a seguinte propriedade:

Propriedade	Tipo	Descrição
context	Text	Rótulo para o contexto de otimização aplicado à seleção de entidades.

Exemplo

var $employees : cs. EmployeeSelection ALL RECORDS([Employee])
$employees:=Create entity selection([Employee]) 
// A entity selection $employees agora contém um conjunto de referências
// em todas as entidades relacionadas com a classe de dados Employee

Veja também

dataClass.newSelection()

USE ENTITY SELECTION

USE ENTITY SELECTION (entitySelection)

Parâmetro	Tipo		Descrição
entitySelection	EntitySelection	->	Seleção de entidades

Descrição

O comando USE ENTITY SELECTION atualiza a seleção atual da tabela que corresponde à classe de dados do parâmetro entitySelection, de acordo com o conteúdo da seleção de entidade.

Este comando não pode ser utilizado com um Datastore remoto.

info

Esse comando foi projetado para fazer com que as seleções de corrente 4D se beneficiem do poder das consultas ORDA. Por motivos de desempenho, no 4D single-user e no 4D Server, o comando conecta diretamente entitySelection à seleção atual. Portanto, uma vez que a entitySelection tenha sido usada, ela não deve ser reutilizada ou alterada posteriormente.

nota

Após uma chamada para USE ENTITY SELECTION, o primeiro registro da seleção atual atualizada (se não estiver vazio) torna-se o registro atual, mas não é carregado na memória. Se precisar usar os valores dos campos no registro atual, use o comando LOAD RECORD após o comando USE ENTITY SELECTION.

Exemplo

var $entitySel : cs.EmployeeSelection

$entitySel:=ds.Employee.query("lastName = :1"; "M@") //$entitySel está relacionado à classe de dados Employee
REDUCE SELECTION([Employee];0)
USE ENTITY SELECTION($entitySel) //A seleção atual da tabela Employee é atualizada

&#91index&#93

História

Release	Mudanças
17	Adicionado

[index] : 4D.Entity

Descrição

A notação EntitySelection[index] permite acessar entidades dentro da seleção de entidades usando a sintaxe de coleção padrão: passe a posição da entidade que deseja obter no parâmetro index.

Lembre que a entidade correspondente é recarregada a partir da datastore.

index pode ser qualquer número entre 0 e .length-1.

Se index está fora do intervalo, se devolve um erro.
Se index corresponder a uma entidade descartada, um valor Null será retornado.

caution

EntitySelection[index] é uma expressão não atribuível, o que significa que não pode ser usada como uma referência editável da entidade com métodos como .lock() ou .save(). Para trabalhar com a entidade correspondente, é necessário atribuir a expressão devolvida a uma expressão atribuível, como uma variável. Exemplos:

 $sel:=ds. Employee.all() //criação da entity selection
  //declarações não válidas:
 $result:=$sel[0].lock() //NÃO funcionará
 $sel[0].lastName:="Smith" //NÃO funcionará
 $result:=$sel[0].save() //NÃO funcionará
  //valid code:
 $entity:=$sel[0]  //OK
 $entity.lastName:="Smith" //OK
 $entity.save() //OK

Exemplo

 var $employees : cs. EmployeeSelection
 var $employee : cs. EmployeeEntity
 $employees:=ds. Employee.query("lastName = :1";"H@")
 $employee:=$employees[2]  // A terceira entidade da seleção de entidades $employees se recarrega do banco de dados

.attributeName

História

Release	Mudanças
17	Adicionado

.attributeName : Collection
.attributeName : 4D.EntitySelection

Descrição

Qualquer atributo de classe de dados pode ser usado como uma propriedade de uma seleção de entidade para retornar uma "projeção" 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, dependendo do kind (storage ou relation) do atributo.

Se o tipo de attributeName for storage: .attributeName retorna uma coleção de valores do mesmo tipo que attributeName.
Se o tipo de attributeName for relatedEntity: .attributeName retorna uma nova seleção de entidade de valores relacionados do mesmo tipo que attributeName. Se eliminam os duplicados (se devolve uma seleção de entidades desordenada).
Se o tipo de attributeName for relatedEntities: .attributeName retorna uma nova seleção de entidade de valores relacionados do mesmo tipo que attributeName. Se eliminam os duplicados (se devolve uma seleção de entidades desordenada).

Quando se utiliza um atributo de relação como propriedade de uma seleção de entidades, o resultado é sempre outra seleção de entidades, mesmo que só se devolva uma entidade. If the original entity selection and the entitySelection parameter are empty, an empty entity selection is returned.

Se o atributo não existir na seleção de entidades, se devolve um erro.

Exemplo 1

Projeção de valores de armazenamento:

 var $firstNames : Collection
 $entitySelection:=ds. Employee.all()
 $firstNames:=$entitySelection.firstName // firstName é um string

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

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

Exemplo 2

Projeção da entidade relacionada:

 var $es; $entitySelection : cs. EmployeeSelection
 $entitySelection:=ds. Employee.all()
 $es:=$entitySelection.employer // employer é relacionada aum  Company dataClass

O objeto resultane é uma seleção de entidade da Empresa com duplicações removidas (se houver).

Exemplo 3

Projeção de entidades relacionadas:

 var $es : cs. EmployeeSelection
 $es:=ds. Employee.all().directReports // directReports é relacionada a dataclasse Funcionário

O objeto resultante é uma seleção de entidade da dataclasse Funcionario sem duplicatas (se houver).

.add()

História

Release	Mudanças
18 R6	Suporte do parâmetro entitySelection
18 R5	Compatível apenas com seleções de entidade alteráveis
17	Adicionado

.add( entity : 4D.Entity ) : 4D.EntitySelection
.add( entitySelection : 4D.EntitySelection ) : 4D.EntitySelection

Parâmetro	Tipo		Descrição
entity	4D. Entity	->	Entidade que deve ser adicinonada à entity selection
entitySelection	4D. EntitySelection	->	Seleção entidade paara ser adicionado a sellleção entidade originaal
Resultados	4D. EntitySelection	<-	Seleção de entidades, incluindo a entity ou entitySelection adicionada

Descrição

A função .add() adiciona a entidade ou entitySelection especificada à seleção de entidade original e retorna a seleção de entidade modificada.

Esta função não modifica a entity selection original.

aviso

A seleção da entidade deve ser alterável, ou seja, ter sido criada, por exemplo, por .newSelection() ou Create entity selection, caso contrário, .add() retornará um erro. As entity selections partilháveis não aceitam a adição de entidades. Para mais informações, por favor consulte a seção Seleções de entidades compartilháveis ou modificáveis.

Adicionar uma entidade

Se a seleção da entidade for ordenada, entidade será adicionada ao final da seleção. Se uma referência a mesma entidade já pertencer a seleção de entidades, se duplica e se adiciona uma nova referência.
Se a seleção da entidade não tiver ordem, entity é adicionada em qualquer lugar da seleção, sem uma ordem específica.

Adicionar uma seleção de entidades

Se a selecção de entidades estiver ordenada, a sua ordem é mantida e entitySelection é adicionado no final da selecção. Se as referências às mesmas entidades de entitySelection já pertencerem à seleção de entidades, elas serão duplicadas e novas referências serão adicionadas.
Se a seleção de entidade nãofor ordenada, ela fica ordenada.

Para mais informações, por favor consulte a seção Seleções de entidades ordenadas ou não ordenadas.

A entity selection modificada é devolvida pela função, de modo que as chamadas à função podem ser encadeados.

Ocorrerá um erro se a entidade e a seleção da entidade não estiverem relacionadas à mesma classe de dados. Se entity for Null, não se produz nenhum erro.

Exemplo 1

 var $employees : cs. EmployeeSelection
 var $employee : cs. EmployeeEntity
 $employees:=ds. Employee.query("lastName = :1";"S@")
 $employee:=ds. Employee.new()
 $employee.lastName:="Smith"
 $employee.save()
 $employees.add($employee) //A entidade $employee se adiciona a entity selection $employees

Exemplo 2

As chamadas à função podem ser encadeadas:

 var $sel : cs. ProductSelection
 var $p1;$p2;$p3 : cs. ProductEntity

 $p1:=ds. Product.get(10)
 $p2:=ds. Product.get(11)
 $p3:=ds. Product.get(12)
 $sel:=ds. Product.query("ID &gt; 50")
 $sel:=$sel.add($p1).add($p2).add($p3)

Exemplo 3

Em uma interface de usuário, temos duas listas. O usuário seleciona itens da lista 1 e as adiciona na lista 2.

$sellist2:=$sellist2.add($sellist1)

.and()

História

Release	Mudanças
17	Adicionado

.and( entity : 4D.Entity ) : 4D.EntitySelection
.and( entitySelection : 4D.EntitySelection ) : 4D.EntitySelection

Parâmetro	Tipo		Descrição
entity	4D. Entity	->	Entidade a intersectar
entitySelection	4D. EntitySelection	->	Entity selection a intersectar
Resultados	4D. EntitySelection	<-	Entity selection resultante da intersecção com o operador lógico AND

Descrição

A função .and() combina a seleção de entidades com um parâmetro entity ou entitySelection usando o operador lógico AND; ela retorna uma nova seleção de entidades não ordenada que contém apenas as entidades referenciadas na seleção de entidades e no parâmetro.

Se você passar entidade como parâmetro, você combina essa entidade com a seleção de entidade. Se a entidade pertencer à entity selection, se devolve uma nova entity selection que só contém a entidade. Senão, uma seleção de entidades vazia é retornada.
Se você passar entitySeletion como parâmetro, combinará as duas seleções da entidade. Uma nova seleção de entidade que contenha só as entidades que são referenciadas em ambas as seleções sejam retornadas. Senão, uma nova seleção de entidade contém a seleção de entidade original e a entidade é retornada.

Para mais informações, por favor consulte Seleções de entidades ordenadas vs não ordenadas. A seleção resultante é sempre desordenada.

Se a seleção de entidade original ou o parâmetro entitySelection estiver vazio, ou se a entidade for Null, uma seleção de entidade vazia é retornada.

Se a entity selection inicial e o parâmetro não forem relacionados com a mesma dataclass, se produz um erro.

Exemplo 1

 var $employees; $result : cs.ColaboradoreSeleção
 var $employee : cs.ColaboradoreEntity
 $employees:=ds.Empregado. uery("Último Nome = :1"; H@")   
  //A seleção da entidade $employees contém a entidade
  ///com chave primária 710 e outras entidades
  //for ex. "Colin Hetrick" / "Diabo de Grade" / "Sherlock Holmes" (chave primária 710)
 $employee:=ds. mployee.get(710) // Retorna "Sherlock Holmes"

 $result:=$employees. nd($employee) //$result é uma entidade que contém   
  //only a entidade com chave primária 710 ("Sherlock Holmes")

Exemplo 2

Se quisermos ter uma seleção de empregados chamados "Jones" que morem em Nova York:

 var $sel1; $sel2; $sel3 : cs.EmployeeSelection
 $sel1:=ds.Employee.query("name =:1";"Jones")
 $sel2:=ds.Employee.query("city=:1";"New York")
 $sel3:=$sel1.and($sel2)

.at()

História

Release	Mudanças
20	Adicionado

.at( index : Integer ) : 4D.Entity

Parâmetro	Tipo		Descrição
index	Integer	->	Índice da entidade a devolver
Resultados	4D. Entity	<-	A entidade nesse índice

Descrição

A função .at() retorna a entidade na posição index, permitindo o uso de números inteiros positivos e negativos.

Se index for negativo (de -1 a -n com n : comprimento da seleção de entidades), a entidade retornada será baseada na ordem inversa da seleção de entidades.

A função devolve Null se o index estiver para além dos limites de selecção de entidades.

Exemplo

var $employees : cs.EmployeeSelection
var $emp1; $emp2 : cs.EmployeeEntity
$employees:=ds.Employee.query("lastName = :1"; "H@")
$emp1:=$employees.at(2) //3ª entidade da seleção de entidades $employees
$emp2:=$employees.at(-3) //começando do final, 3ª entidade
	//da seleção de entidades $employees

.average()

História

Release	Mudanças
18 R6	Retorna indefinido se uma seleção de entidade for vazia
17	Adicionado

.average( attributePath : Text ) : Real

Parâmetro	Tipo		Descrição
attributePath	Text	->	Rota do atributo que se utilizará para o cálculo
Resultados	Real	<-	Media aritmética (média) dos valores das entidades para o atributo (Não se define para uma entity selection vazia)

Descrição

A função .average() retorna a média aritmética (média) de todos os valores não nulos de attributePath na seleção de entidades.

Passe no parâmetro attributePath a rota de atributo a avaliar.

Só são levados em consideração os valores numéricos para o cálculo. Entretanto, observe que, se o attributePath da seleção da entidade contiver tipos de valores mistos, .average() levará em conta todos os elementos escalares para calcular o valor médio.

Os valores de tipo Date são convertidos em valores numéricos (segundos) e são usados para calcular a média.

.average() retorna undefined se a seleção da entidade estiver vazia ou se attributePath não contiver valores numéricos.

Um erro é retornado se:

attributePath is a related attribute,
attributePath não se encontra na classe de dados da entity selection.

Exemplo

Se quisermos obter uma lista de funcionários cujo salário for superior ao salário médio:

 var $averageSalary : Real
 var $moreThanAv : cs.EmployeeSelection
 $averageSalary:=ds.Employee.all().average("salary")
 $moreThanAv:=ds.Employee.query("salary > :1";$averageSalary)

.clean()

História

Release	Mudanças
20 R6	Adicionado

.clean() : 4D.EntitySelection

Parâmetro	Tipo		Descrição
Resultados	4D. EntitySelection	<-	Nova seleção de entidades sem entidades excluídas

Descrição

A função .clean() retorna uma nova seleção de entidade com base na seleção de entidade original, mas sem as entidades excluídas, se houver.

Por padrão, quando uma entidade é descartada, sua(s) referência(s) na(s) seleção(ões) de entidade(s) existente(s) se torna(m) indefinida(s), mas não é(são) removida(s) do(s) objeto(s) de seleção de entidade. As entidades excluídas ainda estão incluídas na propriedade .length e são exibidas como linhas em branco se a seleção da entidade estiver vinculada a um objeto de interface, como uma lista. Nesse caso, chamar a função .clean() na seleção de entidades permite que você obtenha uma seleção de entidades nova e atualizada, que não contenha referências de entidades undefined.

The resulting entity selection keeps the same order criteria and the same alterable/shareable property as the original entity selection.

Exemplo

var $sel; $sel2 : cs.SpecialitySelection
var $status : Object

$sel:=ds.Speciality.query("ID <= 4")
$status:=ds.Speciality.get(2).drop() //exclui a entidade da classe de dados
  //$sel.length = 4

$sel2:=$sel.clean()
  //$sel2.length = 3

Veja também

.refresh()

.contains()

História

Release	Mudanças
17	Adicionado

.contains( entity : 4D.Entity ) : Boolean

Parâmetro	Tipo		Descrição
entity	4D. Entity	->	Entidade a ser avaliada
Resultados	Parâmetros	<-	Truse se a entidade pertencer à entity selection, senão False

Descrição

A função .contains() retorna true se a referência da entidade pertencer à seleção de entidades, e false caso contrário.

Em entity, especifique a entidade a ser pesquisada na seleção de entidades. Se a entidade for Null, a função devolverá false.

Se entity e a entity selection não pertencerem à mesma dataclass, se produz um erro.

Exemplo

 var $employees : cs. EmployeeSelection
 var $employee : cs. EmployeeEntity

 $employees:=ds.Employee.query("lastName=:1";"H@")
 $employee:=ds. Employee.get(610)

 If($employees.contains($employee))
    ALERT("A entidade com chave primaria 610 tem um sobrenome começando com H")
 Else
    ALERT("A entidade com chave primária 610 não tem um sobrenome começando com H")
 End if

.count()

História

Release	Mudanças
17	Adicionado

.count( attributePath : Text ) : Real

Parâmetro	Tipo		Descrição
attributePath	Text	->	Rota do atributo que se utilizará para o cálculo
Resultados	Real	<-	Número de valores de attributePath que não são null na entity selection

Descrição

A função .count() retorna o número de entidades na seleção de entidades com um valor não nulo em attributePath.

Só são levados em consideração os valores escalares. Os valores de tipo objeto ou coleção são considerados valores nulos.

Um erro é retornado se:

attributePath is a related attribute,
attributePath não se encontra na classe de dados da entity selection.

Exemplo

Se quisermos encontrar o número total de empregados para uma empresa sem contar aqueles cujos titulos de mprego não foram especificados:

 var $sel : cs.EmployeeSelection
 var $count : Real

 $sel:=ds.Employee.query("employer = :1";"Acme, Inc")
 $count:=$sel.count("jobtitle")

.copy()

História

Release	Mudanças
18 R5	Adicionado

.copy( { option : Integer } ) : 4D.EntitySelection

Parâmetro	Tipo		Descrição
option	Integer	->	`ck shared`: retorna uma seleção de entidade compartilhável
Resultados	4D. EntitySelection	<-	Cópia da entity selection

Descrição

A função .copy() retorna uma cópia da entity selection original.

Esta função não modifica a seleção de entidades original.

Como padrão, se o parâmetro option for omitido, a função retorna uma nova seleção de entidade modificável (mesmo que a função seja aplicada a uma seleção de entidade compartilhável). Passe a constante ck shared no parâmetro option se você quiser criar uma seleção de entidade compartilhável.

Para informações sobre a propriedade compartilhável das seleções de entidades, consulte a seção Seleções de entidades compartilháveis ou modificáveis.

Exemplo

Se criar uma nova seleção de entidade vazia de produtos quando o formulário for carregado:

 Case of
    :(Form event code=On Load)
       Form.products:=ds.Products.newSelection()
 End case

Então esta seleção de entidades é atualizada com produtos e se quiser compartilhar os produtos entre vários processos. Se copiar a seleçãod a entidade Form.products como compartilhável:

 ...
  // A seleção de entidades de Form.products se atualiza
 Form.products.add(Form.selectedProduct)

 Use(Storage)
    If(Storage.products=Null)
       Storage.products:=New shared object()
    End if

    Use(Storage.products)
       Storage.products:=Form.products.copy(ck shared)
    End use
 End use

.distinct()

História

Release	Mudanças
20	Suporte de `dk count values`
17	Adicionado

.distinct( attributePath : Text { ; options : Integer } ) : Collection

Parâmetro	Tipo		Descrição
attributePath	Text	->	Rota do atributo cujos valores quer obter
options	Integer	->	`dk diacritical`, `dk count values`
Resultados	Collection	<-	Coleção apenas com valores distintos

Descrição

A função .distinct() retorna uma coleção contendo apenas valores distintos (diferentes) do attributePath na seleção da entidade.

A coleção retornada é ordenada automaticamente. Os valores null não são devolvidos.

No parâmetro attributePath, passe o atributo de entidade cujos valores distintos você deseja obter. Só valores escalares (texto, número, booleano, ou data) podemser manejados. Se o attributePath levar a uma propriedade do objeto que contém valores de tipos diferentes, eles serão primeiro agrupados por tipo e, em seguida, classificados. Se attributePath levar a uma propriedade de objeto que conter valores de diferentes tipos, primeiro se agrupam por tipo e se ordenam depois.

booleans
strings
números
datas

Você pode usar a notação [] para designar uma coleção quando attributePath é um caminho dentro de um objeto (ver exemplos).

In the options parameter, you can pass one or a combination of the following constants:

Parâmetros	Valor	Comentário
`dk diacritical`	8	A avaliação é sensível a maiúsculas e minúsculas e diferencia os caracteres acentuados. Como padrão, uma avaliação não-diacrítica é realizada.
`dk count values`	32	Devolve a contagem de entidades para cada valor distinto. Quando essa opção é passada, `.distinct()` retorna uma coleção de objetos contendo um par de propriedades `{{"value":value; "count":count}`.

nota

A opção dk count values só está disponível com atributos de armazenamento do tipo booleano, string, número e data.

Um erro é retornado se:

attributePath is a related attribute,
attributePath não se encontra na classe de dados da entity selection.

Exemplos

Se quiser obter uma coleção que contenha um só elemento por nome de país:

var $countries : Collection
 $countries:=ds. Employee.all().distinct("address.country")

nicknames é uma coleção e extra é um atributo de objeto:

$values:=ds. Employee.all().distinct("extra.nicknames[].first")

Pretende obter o número de nomes de funções diferentes na empresa:

var $jobs : Collection
$jobs:=ds. Employee.all().distinct("jobName";dk count values)  
//$jobs[0]={"value":"Developer";"count":17}
//$jobs[1]={"value":"Office manager";"count":5}
//$jobs[2]={"value":"Accountant";"count":2}
//...

.distinctPaths()

História

Release	Mudanças
20	Adicionado

.distinctPaths( attribute : Text ) : Collection

Parâmetro	Tipo		Descrição
atributo	Text	->	Nome do atributo do objecto cujos caminhos pretende obter
Resultados	Collection	<-	Nova colecção com caminhos distintos

Descrição

A função .distinctPaths() retorna uma coleção de caminhos distintos encontrados no objeto indexado atributo para a seleção da entidade.

Se attribute não for um atributo de objeto indexado, será gerado um erro.

Depois da chamada, o tamanho da coleção retornada é igual ao número de caminhos distintos encontrados no atributo para a seleção da entidade. Os caminhos são devolvidos como cadeias de caracteres, incluindo atributos e colecções aninhados, por exemplo "info.address.number" ou "children[].birthdate". Entidades com um valor nulo no atributo não são consideradas.

Exemplo

Você deseja obter todos os caminhos armazenados em um atributo objeto fullData:

var $paths : Collection
$paths:=ds. Employee.all().distinctPaths("fullData")
//$paths[0]="age"
//$paths[1]="Children"
//$paths[2]="Children[].age"
//$paths[3]="Children[].name"
//$paths[4]="Children.length"
///...

nota

length é automaticamente adicionado como caminho para propriedades de coleções aninhadas.

.drop()

História

Release	Mudanças
17	Adicionado

.drop( { mode : Integer } ) : 4D.EntitySelection

Parâmetro	Tipo		Descrição
mode	Integer	->	`dk stop dropping on first error`: para a execução do método na primeira entidade não eliminável
Resultados	4D. EntitySelection	<-	Seleção de entidade vazia se bem-sucedida; caso contrário, seleção de entidade contendo entidades não descartáveis

Descrição

A função .drop() remove as entidades pertencentes à seleção de entidades da tabela relacionada à sua classe de dados no armazenamento de dados. A entity selection permanece na memória.

A eliminação de entidades é permanente e não pode ser desfeita. É recomendado chamar esta ação em uma transação para ter uma opção de recuperação.

Se encontrar uma entidade bloqueada durante a execução de .drop(), não é eliminado. Como padrão o método processa todas as entidades da seleção de entidades e retorna as entidades não elimináveis na entity selection. Se você deseja que o método pare a execução na primeira entidade não eliminável encontrada, passe a constante dk stop dropping on first error no parâmetro mode.

Exemplo

Exemplo sem a opção dk stop dropping on first error:

 var $employees; $notDropped : cs. EmployeeSelection
 $employees:=ds.Employee.query("firstName=:1";"S@")
 $notDropped:=$employees.drop() // $notDropped for uma entity selection que contém todas as entidades não suprimidas
 If($notDropped.length=0) //A ação de eliminação for exitosa, todas as entidades foram eliminadas
    ALERT("You have dropped "+String($employees.length)+" employees") //A seleção de entidades eliminada permanece na memoria
 Else
    ALERT("Problem during drop, try later")
 End if

Exemplo com a opção dk stop dropping on first error:

 var $employees; $notDropped : cs.EmployeeSelection
 $employees:=ds.Employee.query("firstName=:1";"S@")
 $notDropped:=$employees.drop(dk stop dropping on first error) // $notDropped uma entity selection a primeira entidade não descartada
 If($notDropped.length=0) //A ação de eliminação for exitosa, todas as entidades foram eliminadas
    ALERT("You have dropped "+String($employees.length)+" employees") //A seleção de entidades eliminada permanece na memoria
 Else
    ALERT("Problem during drop, try later")
 End if

.extract()

História

Release	Mudanças
18 R3	Adicionado

.extract( attributePath : Text { ; option : Integer } ) : Collection
.extract( attributePath { ; targetPath } { ; ...attributePathN : Text ; targetPathN : Text } ) : Collection

Parâmetro	Tipo		Descrição
attributePath	Text	->	Rota de atributo cujos valores serão extraídos para nova coleção
targetpath	Text	->	Rota ou nome do atributo objetivo
option	Integer	->	`ck keep null`: inclui atributos nulos na coleção retornada (ignorado por padrão)
Resultados	Collection	<-	Coleção contendo valores extraídos

Descrição

A função .extract() retorna uma coleção contendo valores attributePath extraídos da seleção de entidades.

attributePath pode se referir a:

um atributo escalar de dataclass,
entidade relacionada,
entidades relacionadas.

Se attributePath não for válido, se devolve uma coleção vazia.

Esta função aceita duas sintaxes.

.extract( attributePath : Text { ; option : Integer } ) : Collection

Com essa sintaxe, .extract() preenche a coleção retornada com os valores attributePath da seleção da entidade.

Como padrão, entidades para as quais attributePath for null ou undefined são ignoradas na coleção resultante. Você pode passar a constante ck keep null no parâmetro option para incluir esses valores como elementos nulos na coleção retornada.

Os atributos de classe de dados com .kind = "relatedEntity" são extraídos como uma coleção de entidades (as duplicações são mantidas).
Os atributos de classe de dados com .kind = "relatedEntities" são extraídos como uma coleção de seleções de entidades.

.extract ( attributePath ; targetPath { ; ...attributePathN ; ... targetPathN}) : Collection

Com essa sintaxe, .extract() preenche a coleção retornada com as propriedades attributePath da seleção da entidade. Cada elemento da coleção retornada é um objeto com propriedades targetPath preenchidas com as propriedades attributePath correspondentes. Os valores null são mantidos (o parâmetro option é ignorado com essa sintaxe).

Se vários attributePath forem fornecidos, um targetPath deverá ser fornecido para cada um deles. Somente pares válidos [attributePath, targetPath] são extraídos.

Os atributos dataclass com .kind = "relatedEntity" são extraídos como uma entidade.
Os atributos dataclass com .kind = "relatedEntities" são extraídos como uma seleção de entidade.

As entidades de uma colecção de entidades acedidas por [ ] não são recarregadas da base de dados.

Exemplo

Dada a seguinte tabela e relação:

 var $firstnames; $addresses; $mailing; $teachers : Collection
  //
  //
  //$firstnames é uma coleção de Strings


 $firstnames:=ds. Teachers.all().extract("firstname")
  //
  //$addresses é uma coleção de entities relacionadas ao dataclass Address
  //Valores Null para o endereço são extraídos
 $addresses:=ds. Teachers.all().extract("address";ck keep null)
  //
  //
  //$mailing é uma coleção de objetos com propriedades "who" e "to"
  //conteúdo propriedade "who" é do tipo String
  //conteudo propriedade "to" é do tipo entity (Address dataclass)
 $mailing:=ds. Teachers.all().extract("lastname";"who";"address";"to")
  //
  //
  //$mailing é uma coleção de objetos com propriedades "who" e "city"
  //conteúdo propriedade "who" é tipo String
  //conteúdo propriedade "city" é tipo String
 $mailing:=ds. Teachers.all().extract("lastname";"who";"address.city";"city")
  //
  //$teachers é uma coleção de objetos com propriedades "where" e "who"
  //conteúdo propriedade "where" é String
  //conteúdo propriedade "who" é uma entity selection (Teachers dataclass)
 $teachers:=ds. Address.all().extract("city";"where";"teachers";"who")
  //
  //$teachers é uma coleção de entity selections
 $teachers:=ds. Address.all().extract("teachers")

.first()

História

Release	Mudanças
17	Adicionado

.first() : 4D.Entity

Parâmetro	Tipo		Descrição
Resultados	4D. Entity	<-	Referência para a primeira entidade da seleção da entidade (Null se a seleção estiver vazia)

Descrição

A função .first() retorna uma referência à entidade na primeira posição da seleção de entidades.

O resultado desta função é similar a:

 $entity:=$entitySel[0]

Há, entretanto, uma diferença entre ambas as afirmações quando a seleção estiver vazia:

 var $entitySel : cs. EmpSelection
 var $entity : cs. EmpEntity
 $entitySel:=ds. Emp.query("lastName = :1";"Nonexistentname") //nenhuma entity correspondente
  //entity selection é esvaziada
 $entity:=$entitySel.first() //retorna Null
 $entity:=$entitySel[0]  //gera um erro

Exemplo

 var $entitySelection : cs.EmpSelection
 var $entity : cs.EmpEntity
 $entitySelection:=ds.Emp.query("salary > :1";100000)
 If($entitySelection.length#0)
    $entity:=$entitySelection.first()
 End if

.getDataClass()

História

Release	Mudanças
17 R5	Adicionado

.getDataClass() : 4D.DataClass

Parâmetro	Tipo		Descrição
Resultados	4D. DataClass	<-	Objeto dataclass ao qual a seleção de entidade pertence

Descrição

A função .getDataClass() retorna a classe de dados da seleção da entidade.

Esta função é principalmente útil no contexto do código genérico.

Exemplo

O seguinte código genérico duplica todas as entidades da entity selection:

  //duplicate_entities method
  //duplicate_entities($entity_selection)

 #DECLARE ( $entitySelection : 4D. EntitySelection )  
 var $dataClass : 4D. DataClass
 var $entity; $duplicate : 4D. Entity
 var $status : Object
 $dataClass:=$entitySelection.getDataClass()
 For each($entity;$entitySelection)
    $duplicate:=$dataClass.new()
    $duplicate.fromObject($entity.toObject())
    $duplicate[$dataClass.getInfo().primaryKey]:=Null //reset the primary key
    $status:=$duplicate.save()
 End for each

.getRemoteContextAttributes()

História

Release	Mudanças
19R5	Adicionado

.getRemoteContextAttributes() : Text

Parâmetro	Tipo		Descrição
resultado	Text	<-	Atributos de contexto conectados à seleção de entidade, separados por uma vírgula

Modo avançado: Essa função é destinada a desenvolvedores que precisam personalizar os recursos padrão do ORDA para configurações específicas. Na maioria dos casos, não necessitará de o utilizar.

Descrição

A função .getRemoteContextAttributes() retorna informações sobre o contexto de otimização usado pela seleção de entidades.

Se não houver [contexto de otimização] (../ORDA/remoteDatastores.md#clientserver-optimization) para a seleção da entidade, a função retornará um texto vazio.

Exemplo

var $ds : 4D. DataStoreImplementation
var $persons : cs. PersonsSelection
var $p : cs. PersonsEntity

var $info : Text
var $text : Text

$ds:=Open datastore(New object("hostname"; "www.myserver.com"); "myDS")

$persons:=$ds. Persons.all()
$text:="" For each ($p; $persons)
    $text:=$p.firstname+" lives in "+$p.address.city+" / " End for each

$info:=$persons.getRemoteContextAttributes()
//$info = "firstname,address,address.city"

Veja também

Entity.getRemoteContextAttributes()
.clearAllRemoteContexts()
.getRemoteContextInfo()
.getAllRemoteContexts()
.setRemoteContextInfo()

.isAlterable()

História

Release	Mudanças
18 R5	Adicionado

.isAlterable() : Boolean

Parâmetro	Tipo		Descrição
Resultados	Parâmetros	<-	True se a seleção de entidades for alterável, senão False

Descrição

A função .isAlterable() retorna True se a seleção da entidade for alterável e False se a seleção da entidade não for alterável.

Para obter mais informações, consulte [Seleções de entidades compartilháveis ou alteráveis] (ORDA/entities.md#shareable-or-alterable-entity-selections).

Exemplo

Você está prestes a exibir Form.products em uma [caixa de listagem] (FormObjects/listbox_overview.md) para permitir que o usuário adicione novos produtos. Se quiser ter certeza que é alterável para que o usuário possa adicionar novos produtos sem erro:

If (Not(Form.products.isAlterable()))
    Form.products:=Form.products.copy()
End if
...
Form.products.add(Form.product)

.isOrdered()

História

Release	Mudanças
17	Adicionado

.isOrdered() : Boolean

Parâmetro	Tipo		Descrição
Resultados	Parâmetros	<-	True se a seleção de entidade for ordenada, senão False

Descrição

A função .isOrdered() retorna True se a seleção da entidade estiver ordenada e False se não estiver ordenada.

Esta função devolve sempre True quando a selecção da entidade provém de um datastore remoto.

Para mais informações, por favor consulte Seleções de entidades ordenadas ou não ordenadas.

Exemplo

 var $employees : cs.EmployeeSelection
 var $employee : cs. mployeeEntity
 var $isOrdered : Boolean
 $employees:=ds.Employee.newSeletion(dk mantém ordem)
 $employee:=ds. Colaborador. et(714) // Obtém a entidade com chave primária 714

  //In uma entidade ordenada, podemos adicionar a mesma entidade várias vezes (duplicações são mantidas)
 $employees. dd($employee)
 $employees.add($employee)
 $employees.add($employee)

 $isOrdered:=$employees. sOrdered()
 If($isOrdered)
    ALERT("A seleção da entidade é ordenada e contém "+String($employees. engalar)+" funcionários")
 Final, se

.last()

História

Release	Mudanças
17	Adicionado

.last() : 4D.Entity

Parâmetro	Tipo		Descrição
Resultados	4D. Entity	<-	Referência à última entidade da seleção de entidades (Null se a seleção de entidades estiver vazia)

Descrição

A função .last() retorna uma referência à entidade na última posição da seleção de entidades.

O resultado desta função é similar a:

 $entity:=$entitySel[length-1]

Se a entity selection estiver vazia, a função devolve Null.

Exemplo

 var $entitySelection : cs.EmpSelection
 var $entity : cs.EmpEntity
 $entitySelection:=ds.Emp.query("salary < :1";50000)
 If($entitySelection.length#0)
    $entity:=$entitySelection.last()
 End if

.length

História

Release	Mudanças
17	Adicionado

.length : Integer

Descrição

A propriedade .length retorna o número de entidades na seleção de entidades. Se a entity selection estiver vazia, devolve 0.

As seleções de entidade sempre têm uma propriedade .length.

Para saber o número total de entidades em uma classe de dados, recomenda-se usar a função getCount(), que é mais otimizada do que a expressão ds.myClass.all().length.

Exemplo

 var $vSize : Integer
 $vSize:=ds.Employee.query("gender = :1";"male").length
 ALERT(String(vSize)+" male employees found.")

.max()

História

Release	Mudanças
17	Adicionado
18 R6	Retorna indefinido se uma seleção de entidade for vazia

.max( attributePath : Text ) : any

Parâmetro	Tipo		Descrição
attributePath	Text	->	Rota do atributo que se utilizará para o cálculo
Resultados	any	<-	Maior valor do atributo

Descrição

A função .max() retorna o valor mais alto (ou máximo) entre todos os valores de attributePath na seleção da entidade. Na verdade, ele retorna o valor da última entidade da seleção de entidades, pois ela seria classificada em ordem crescente usando a função .orderBy().

Se você passar em attributePath um caminho para uma propriedade de objeto que contenha diferentes tipos de valores, a função .max() retornará o valor máximo dentro do primeiro tipo escalar na ordem padrão da lista de tipos 4D (ver descrição de sort()).

.max() retorna undefined se a seleção da entidade estiver vazia ou se attributePath não for encontrado no atributo do objeto.

Um erro é retornado se:

attributePath is a related attribute,
attributePath não se encontra na classe de dados da entity selection.

Exemplo

Se quisermos encontrar o maior salário entre as funcionárias mulheres:

 var $sel : cs.EmpSelection
 var $maxSalary : Real
 $sel:=ds.Employee.query("gender = :1";"female")
 $maxSalary:=$sel.max("salary")

.min()

História

Release	Mudanças
17	Adicionado
18 R6	Retorna indefinido se uma seleção de entidade for vazia

.min( attributePath : Text ) : any

Parâmetro	Tipo		Descrição
attributePath	Text	->	Rota do atributo que se utilizará para o cálculo
Resultados	any	<-	Menor valor do atributo

Descrição

A função .min() retorna o valor mais baixo (ou mínimo) entre todos os valores de attributePath na seleção de entidades. Na verdade, ele retorna a primeira entidade da seleção de entidades, pois ela seria classificada em ordem crescente usando a função .orderBy() (excluindo valores null).

Se você passar em attributePath um caminho para uma propriedade de objeto que contenha diferentes tipos de valores, a função .min() retornará o valor mínimo dentro do primeiro tipo de valor escalar na ordem da lista de tipos (consulte a descrição de .sort()).

.min() retorna undefined se a seleção da entidade estiver vazia ou se attributePath não for encontrado no atributo do objeto.

Um erro é retornado se:

attributePath is a related attribute,
attributePath não se encontra na classe de dados da entity selection.

Exemplo

Neste exemplo, se quisermos encontrar o menor salário entre todos os funcionários mulheres:

 var $sel : cs.EmpSelection
 var $minSalary : Real
 $sel:=ds.Employee.query("gender = :1";"female")
 $minSalary:=$sel.min("salary")

.minus()

História

Release	Mudanças
18 R6	Suporte do parâmetro keepOrder
17	Adicionado

.minus( entity : 4D.Entity { ; keepOrder : Integer } ) : 4D.EntitySelection
.minus( entitySelection : 4D.EntitySelection { ; keepOrder : Integer } ) : 4D.EntitySelection

Parâmetro	Tipo		Descrição
entity	4D. Entity	->	Entidade a substrair
entitySelection	4D. EntitySelection	->	seleção de entidade a subtrair
keepOrder	Integer	->	`dk keep ordered` (inteiro) para manter a ordem inicial na seleção da entidade resultante
Resultados	4D. EntitySelection	<-	Nova seleção de entidade ou uma nova referência na seleção de entidade existente

Descrição

A função .minus() exclui da seleção de entidades à qual é aplicada a entidade ou as entidades de entitySelection e retorna a seleção de entidades resultante.

Se você passar entity como parâmetro, a função cria uma seleção de entidade sem entity (se entity pertencer à seleção de entidade). Se entity não foi incluída na seleção de entidade original, uma nova referência à seleção de entidade é retornada.
Se você passar entitySeletion como parâmetro, a função retorna uma seleção de uma entidade contendo as entidades pertencentes à seleção da entidade original sem as entidades pertencentes à entitySelection. Para mais informações, por favor consulte Seleções de entidades ordenadas vs não ordenadas.

Como padrão, se omitir o parâmetro keepOrder, a seleção de entidade resultado não é ordenada. Se quiser manter a ordem da seleção de entidade original (por exemplo se quiser reutilizar a seleção de entidade em uma interface de usuário), passe a constante dk keep ordered em keepOrder. Neste caso, o resultado é uma seleção de entidade ordenada e a ordem da seleção de entidade inicial é mantida

nota

Se você passar dk keep ordered em keepOrder e a entitySelection removida contiver entidades duplicadas na seleção de entidades original, todas as ocorrências das duplicatas serão removidas.

Se a seleção de entidade original ou a seleção de entidade original e o parâmetro entitySelection estiverem vazios, será retornada uma seleção de entidade vazia.

Se entitySelection estiver vazia ou se entity for Null, uma nova referência à seleção de entidade original é retornada.

Se a entity selection inicial e o parâmetro não forem relacionados com a mesma dataclass, se produz um erro.

Exemplo 1

 var $employees; $result : cs.EmployeeSelection
 var $employee : cs.EmployeeEntity

 $employees:=ds.Employee.query("lastName = :1";"H@")
  // A seleção de entidade $employees contém a entidade com chave primária 710 e outras entidades
  // por exemplo, "Colin Hetrick", "Grady Harness", "Sherlock Holmes" (chave primária 710)

 $employee:=ds.Employee.get(710) // Retorna "Sherlock Holmes"

 $result:=$employees.minus($employee) //$result contém "Colin Hetrick", "Grady Harness"

Exemplo 2

Se quisermos ter uma seleção de empregados mulheres que se chamam "Jones" que vivem em Nova York:

 var $sel1; $sel2; $sel3 : cs.EmployeeSelection
 $sel1:=ds.Employee.query("name =:1";"Jones")
 $sel2:=ds.Employee.query("city=:1";"New York")
 $sel3:=$sel1.and($sel2).minus(ds.Employee.query("gender='male'"))

Exemplo 3

Em uma interface de usuário se tivermos uma lista que exibe itens em uma ordem específica. Se o usuário selecionar itens na lista para remove-los, a ordem deve ser mantida quando refrescar a lista:

Employee.newSelection(dk keep ordered)
 $employee:=ds.

.or()

História

Release	Mudanças
17	Adicionado

.or( entity : 4D.Entity ) : 4D.EntitySelection
.or( entitySelection : 4D.EntitySelection ) : 4D.EntitySelection

Parâmetro	Tipo		Descrição
entity	4D. Entity	->	Entidade a intersectar
entitySelection	4D. EntitySelection	->	Entity selection a intersectar
Resultados	4D. EntitySelection	<-	Nova seleção de entidade ou nova referência à seleção de entidade original

Descrição

A função .or() combina a seleção de entidades com o parâmetro entity ou entitySelection usando o operador lógico OR (não exclusivo); ela retorna uma nova seleção de entidades não ordenada que contém todas as entidades da seleção de entidades e do parâmetro.

Se você passar entity como parâmetro, você compara essa entidade com a seleção de entidade. Se a entidade pertencer à selecção de entidades, é devolvida uma nova referência à selecção de entidades. Senão, uma nova seleção de entidade contém a seleção de entidade original e a entidade é retornada.
Se você passar entitySeletion como parâmetro, compare as entity selections. Uma nova seleção de entidades contendo as entidades pertencentes à seleção de entidade original ou entitySelection é retornada (ou não é exclusiva, as entidades referenciadas em ambas as seleções não são duplicadas na seleção resultante).

Para mais informações, por favor consulte Seleções de entidades ordenadas vs não ordenadas. A seleção resultante é sempre desordenada.

Se a seleção de entidade original e o parâmetro entitySelection estiverem vazios, uma seleção de entidade vazia é retornada. Se a seleção de entidade original estiver vazia, será retornada uma referência a entitySelection ou uma seleção de entidade contendo apenas entity.

Se entitySelection estiver vazia ou se entity for Null, uma nova referência à seleção de entidade original é retornada.

Se a entity selection inicial e o parâmetro não forem relacionados com a mesma dataclass, se produz um erro.

Exemplo 1

 var $employees1; $employees2; $result : cs.EmployeeSelection
 $employees1:=ds.Employee.query("lastName = :1"; "H@") //Retorna "Colin Hetrick", "Grady Harness"
 $employees2:=ds.Employee.query("firstName = :1"; "C@") //Retorna "Colin Hetrick", "Cath Kidston"
 $result:=$employees1.or($employees2) //$result contém "Colin Hetrick", "Grady Harness", "Cath Kidston"

Exemplo 2

 var $employees; $result : cs.EmployeeSelection
 var $employee : cs.EmployeeEntity
 $employees:=ds.Employee.query("lastName = :1"; "H@") // Retorna "Colin Hetrick", "Grady Harness", "Sherlock Holmes"
 $employee:=ds.Employee.get(686) //a entidade com chave primária 686 não pertence à seleção de entidades $employees
  //ela corresponde ao funcionário "Mary Smith"

 $result:=$employees.or($employee) //$result contém "Colin Hetrick", "Grady Harness", "Sherlock Holmes", "Mary Smith"

.orderBy()

História

Release	Mudanças
17	Adicionado

.orderBy( pathString : Text ) : 4D.EntitySelection
.orderBy( pathObjects : Collection ) : 4D.EntitySelection

Parâmetro	Tipo		Descrição
pathString	Text	->	Rota(s) de atributos e instruções de classificação para a entity selection
pathObjects	Collection	->	Coleção de objetos criterio
Resultados	4D. EntitySelection	<-	Nova entity selection na ordem especificada

Descrição

A função .orderBy() retorna uma nova seleção de entidade ordenada contendo todas as entidades da seleção de entidade na ordem especificada pelos critérios pathString ou pathObjects.

Este método não modifica a seleção de entidade original

Para obter mais informações sobre seleções de entidades ordenadas, consulte a seção Ordered or unordered entity selection.

Deve usar um parâmetro critério para definir como as entidades são ordenadas. Dois parâmetros diferentes são compatíveis:

pathString (Texto): esse parâmetro contém uma fórmula composta de 1 a x caminhos de atributos e (opcionalmente) ordens de classificação, separados por vírgulas. A sintaxe é:

"attributePath1 {desc or asc}, attributePath2 {desc or asc},..."

A ordem na qual os atributos forem passados determina a prioridade de ordenação das entidades. Como padrão, atributos são ordenados em ordem ascendente. Pode definir a ordem de clasificação de uma propriedade na string de critérios, separado da rota da propriedade por um só espaço: passe "asc" para ordenar em ordem ascendente ou "desc" em ordem descendente.

pathObjects (coleção): cada elemento da coleção contém um objeto estruturado da seguinte maneira:

{
    "propertyPath": string,
    "descending": boolean
}

Como padrão, atributos são ordenados em ordem ascendente ("descendente" é false)

Pode adicionar quantos objetos quiser nos critérios da coleção.

Valores null são avaliados como menor que outros valores.

Se você passar um caminho de atributo inválido em pathString ou pathObject, a função retornará uma seleção de entidade vazia.

Exemplo

// ordenar por fórmula
 $sortedEntitySelection:=$entitySelection.orderBy("firstName asc, salary desc")
 $sortedEntitySelection:=$entitySelection.orderBy("firstName")

  // ordenar por colecção com ou sem ordenação
 $orderColl:=New collection
 $orderColl.push(New object("propertyPath";"firstName";"descending";False))
 $orderColl.push(New object("propertyPath";"salary";"descending";True))
 $sortedEntitySelection:=$entitySelection.orderBy($orderColl)

 $orderColl:=New collection
 $orderColl.push(New object("propertyPath";"manager.lastName"))
 $orderColl.push(New object("propertyPath";"salary"))
 $sortedEntitySelection:=$entitySelection.orderBy($orderColl)

.orderByFormula()

História

Release	Mudanças
17 R6	Adicionado

.orderByFormula( formulaString : Text { ; sortOrder : Integer } { ; settings : Object} ) : 4D.EntitySelection
.orderByFormula( formulaObj : Object { ; sortOrder : Integer } { ; settings : Object} ) : 4D.EntitySelection

Parâmetro	Tipo		Descrição
formulaString	Text	->	Formula string
formulaObj	Object	->	Objecto fórmula
sortOrder	Integer	->	`dk ascending` (padrão) ou `dk descending`
settings	Object	->	Parâmetros da fórmula
Resultados	4D. EntitySelection	<-	Nova seleção de entidade ordenada

Descrição

A função .orderByFormula() retorna uma nova seleção de entidades ordenada contendo todas as entidades da seleção de entidades na ordem definida por meio dos parâmetros formulaString ou formulaObj e, opcionalmente, sortOrder e settings.

Esta função não modifica a seleção de entidades original.

Você pode usar um parâmetro formulaString ou formulaObj:

*formulaString: passa uma expressão 4D como "Year of(this.birthDate)".
formulaObj: passe um objeto de fórmula válido criado usando o comando Formula o Formula from string.

O formulaString ou formulaObj é executado para cada entidade da seleção de entidade e seu resultado é usado para definir a posição da entidade na seleção de entidade retornada. O resultado deve ser um tipo ordenavel (booleano, data, número, texto, hora, null).

Um resultado nullé sempre o menor valor.

Como padrão, se omitir o parâmetro sortOrder, a seleção de entidade resultado é ordenada de forma ascendente. Opcionalmente, você pode passar um dos seguintes valores no parâmetro sortOrder:

Parâmetros	Valor	Comentário
dk ascending	0	Ordem ascendente (padrão)
dk descending	1	Ordem descendente

Dentro da formulaString ou formulaObj, a entidade processada e, portanto, seus atributos estão disponíveis por meio do comando This (por exemplo, This.lastName).

Você pode passar parâmetro(s) para a fórmula usando a propriedade args (objeto) do parâmetro configurações: a fórmula recebe o objeto settings.args em $1.

Exemplo 1

Ordenar estudantes usando uma fórmula fornecida como texto:

 var $es1; $es2 : cs.StudentsSelection
 $es1:=ds.Students.query("nationality=:1"; "French")
 $es2:=$es1.orderByFormula("length(this.lastname)") //ascendente por padrão
 $es2:=$es1.orderByFormula("length(this.lastname)";dk descendente)

Mesma ordem mas usando objeto fórmula:

 var $es1; $es2 : cs.StudentsSelection
 var $formula : Object
 $es1:=ds.Students.query("nationality=:1"; "French")
 $formula:=Formula(Length(This.lastname))
 $es2:=$es1.orderByFormula($formula) // ascendente por padrão
 $es2:=$es1.orderByFormula($formula;dk descendente)

Exemplo 2

Uma fórmula é dada como um objeto de fórmula com parâmetros; o objeto settings.args é recebido como $1 no método computeAverage.

Neste exemplo, o campo de objeto "marks" na classe de dados Students contém as notas dos estudantes para cada matéria. Um objeto fórmula é usado para computar a média das notas dos estudantes com coeficientes diferentes para schoolA e schoolB

 var $es1; $es2 : cs.StudentsSelection
 var $formula; $schoolA; $schoolB : Object
 $es1:=ds.Students.query("nationality=:1"; "French")
 $formula:=Formula(computeAverage($1))

 $schoolA:=New object() // objeto de configurações
 $schoolA.args:=New object("english";1; "math";1; "history";1) // Coeficientes para calcular uma média

  //Ordenar os alunos de acordo com os critérios da escola A
 $es2:=$es1.entitySelection.orderByFormula($formula;$schoolA)

 $schoolB:=New object() //objeto settings 
 $schoolB.args:=New object("english";1; "math";2; "history";3) // Coeficientes para calcular uma média

  //Ordenar os alunos de acordo com os critérios da escola B
 $es2:=$es1.entitySelection.orderByFormula($formula;dk descending;$schoolB)

  //
  // método computeAverage
  // -----------------------------
 #DECLARE ($coefList : Object)  -> $result : Integer
 var $subject : Text
 var $average; $sum : Integer

 $average:=0
 $sum:=0

 For each($subject;$coefList)
    $sum:=$sum+$coefList[$subject]
 End for each

 For each($subject;This.marks)
    $average:=$average+(This.marks[$subject]*$coefList[$subject])
 End for each

 $result:=$average/$sum

.query()

História

Release	Mudanças
17 R6	Soporte dos Parâmetros Formula
17 R5	Suporte dos marcadores para os valores
17	Adicionado

.query( queryString : Text { ; ...value : any } { ; querySettings : Object } ) : 4D.EntitySelection
.query( formula : Object { ; querySettings : Object } ) : 4D.EntitySelection

Parâmetro	Tipo		Descrição
queryString	Text	->	Criterios de pesquisa como string
formula	Object	->	Criterios de pesquisa como objeto fórmula
value	any	->	Valores a usar para placeholders indexados
querySettings	Object	->	Opções de pesquisa: parâmetros, atributos, args, allowFormulas, contexto, queryPath,queryPlan
Resultados	4D. EntitySelection	<-	Nova seleção de entidade composta de entidades da seleção de entidades que atendem aos critérios de pesquisa especificados em queryString ou formula

Descrição

A função .query() busca entidades que atendam aos critérios de pesquisa especificados em queryString ou formula e (opcionalmente) value(s) entre todas as entidades na seleção de entidades, e retorna um novo objeto do tipo EntitySelection contendo todas as entidades encontradas. Se aplica carregamento diferido/lazy loading.

Esta função não modifica a seleção de entidades original.

Se nenhuma entidade correspondente for encontrada, uma EntitySelection vazia é retornada.

Para obter informações detalhadas sobre como criar uma consulta usando os parâmetros queryString, value e querySettings, consulte a descrição da função DataClass .query().

Por padrão, se você omitir a instrução order by na queryString, a seleção da entidade retornada não está ordenada. Note entretanto que em modo Cliente Servidor funciona como uma seleção de entidade ordenada (entidades são adicionadas no final da seleção)

Exemplo 1

 var $entitySelectionTemp : cs.EmployeeSelection
 $entitySelectionTemp:=ds.Employee.query("lastName = :1";"M@")
 Form.emps:=$entitySelectionTemp.query("manager.lastName = :1";"S@")

Exemplo 2

Mais exemplos de consultas podem ser encontrados na página DataClass .query().

Veja também

.query() para dataclass

.queryPath

História

Release	Mudanças
17	Adicionado

.queryPath : Text

Descrição

A propriedade .queryPath contém uma descrição detalhada da consulta conforme ela foi realmente executada pelo 4D. Esta propriedade é disponível para objetos EntitySelection gerados através de pesquisas se a propriedade "queryPlan":true for passada no parâmetro querySettings da função .query().

Para mais informações, consulte o parágrafo do parâmetro querySettings na página da função Dataclass.query().

.queryPlan

História

Release	Mudanças
17	Adicionado

.queryPlan : Text

Descrição

A propriedade .queryPlan contém uma descrição detalhada da consulta imediatamente antes de ser executada (ou seja, a consulta planejada). Esta propriedade está disponível para objectos EntitySelection gerados através de consultas se a propriedade "queryPath":true tiver sido passada no parâmetro querySettings da função .query().

Para mais informações, consulte o parágrafo do parâmetro querySettings na página da função Dataclass.query().

.refresh()

História

Release	Mudanças
18 R3	Adicionado

.refresh()

Parâmetro	Tipo		Descrição
			Não exige nenhum parâmetro

Descrição

Essa função só funciona com um datastore remoto (conexão cliente/servidor ou Open datastore).

A função .refresh() invalida imediatamente os dados de seleção de entidade no cache ORDA local, para que da próxima vez que o 4D precisar da seleção de entidade, ela seja recarregada do banco de dados.

Como padrão, a cache ORDA local é invaidade depois de 30 segundos. No contexto de aplicações cliente/servidor usando ORDA e a linguagem clássica, este método permite assegurar que a aplicação remota vai sempre funcionar com os últimos dados.

Exemplo 1

Neste exemplo, clássico e ORDA modifica os mesmos dados simultaneamente.

 //On a 4D remote

 var $selection : cs. StudentsSelection
 var $student : cs. StudentsEntity

 $selection:=ds. Students.query("lastname=:1";"Collins")
  //A primeira entidade é carregada na cache ORDA
 $student:=$selection.first()

  //Atualizar com clássico 4D, ORDA cache não está se
 QUERY([Students];[Students]lastname="Collins")
 [Students]lastname:="Colin"
 SAVE RECORD([Students])

  //para obter a última versão a cache ORDA deve ser invalidada
 $selection.refresh()
  // Mesmo se cache não for expirada, a primeira entidade é carregada do disco
 $student:=$selection.first()

  //$student.lastname contains "Colin"

Exemplo 2

Uma list box exibe a seleção de entidade Form.students e vários clientes trabalham nele.

// Método de formulário:
 Case of
    :(Form event code=On Load)
       Form.students:=ds. Students.all()
 End case
  //
  //
  // Em client #1, o usuário carrega atualiza e salva a primeira entidade
  // Em client #2, o usuário carrega atualiza e salva a mesma entidade
  //
  //
  // Em client #1:
 Form.students.refresh() // Invalida a cache ORDA para a seleção de entidade Form.students
  // O conteúdo list box é atualizado na database com atuaização feita pelo  client #2

Veja também

.clean()
dataClass.clearRemoteCache()

.selected()

História

Release	Mudanças
19 R3	Adicionado

.selected( selectedEntities : 4D.EntitySelection ) : Object

Parâmetro	Tipo		Descrição
Parâmetros	4D. EntitySelection	->	Seleção de entidade com entidades para qual saber o ranking da seleção de entidade
Resultados	Object	<-	Intervalos da seleção de entidade da seleção de entidade

Descrição

A função .selected() retorna um objeto que descreve a(s) posição(ões) de selectedEntities na seleção da entidade original.

Esta função não modifica a seleção de entidades original.

Passe o parâmetro selectedEntities uma seleção de entidade contendo entidades para qual quiser saber a posição na seleção de entidade original. selectedEntities deve ser uma seleção de entidade pertencente ao mesmo dataclass que a entidade original, caso contrário um erro 1587 - "A seleção da entidade vem de uma base de dados incompatível" é gerada.

Resultados

O objeto retornado contém as propriedades abaixo:

Propriedade	Tipo	Descrição
ranges	Collection	Coleção de objetos intervalos
ranges[].start	Integer	Primeiro indice de entidade do intervalo
ranges[].end	Integer	Último indice de entidade no intervalo.

Se uma propriedade ranges contém uma única entidade, start = end. Indice começa em 0

A função retorna uma coleção vazia na propriedade ranges se a seleção de entidade original ou a seleção de entidade selectedEntities estiver vazia.

Exemplo

var $invoices; $cashSel; $creditSel : cs.Invoices
var $result1; $result2 : Object

$invoices:=ds.Invoices.all()

$cashSelection:=ds.Invoices.query("payment = :1"; "Cash")
$creditSel:=ds.Invoices.query("payment IN :1"; New collection("Cash"; "Credit Card"))

$result1:=$invoices.selected($cashSelection)
$result2:=$invoices.selected($creditSel)

//$result1 = {ranges:[{start:0;end:0},{start:3;end:3},{start:6;end:6}]}
//$result2 = {ranges:[{start:0;end:1},{start:3;end:4},{start:6;end:7}]}

.slice()

História

Release	Mudanças
17	Adicionado

.slice( startFrom : Integer { ; end : Integer } ) : 4D.EntitySelection

Parâmetro	Tipo		Descrição
startFrom	Integer	->	Indice para iniciar a operação em (incluido)
end	Integer	->	Final do índice (não incluído)
Resultados	4D. EntitySelection	<-	Nova seleção de entidade contendo entidades fatiadas (cópia superficial)

Descrição

A função .slice() retorna uma parte de uma seleção de entidades em uma nova seleção de entidades, selecionada a partir do índice startFrom até o índice end (end não está incluído) ou até a última entidade da seleção de entidades. Este método devolve uma cópia superficial da selecção de entidades (utiliza as mesmas referências de entidades).

Esta função não modifica a seleção de entidades original.

A seleção de entidade retornada contém as entidades especificadas por startFrom e todas as entidades subsequentes até, mas não incluindo, a entidade especificada por end. Se apenas o parâmetro startFrom for especificado, a seleção de entidades retornada contém todas as entidades desde startFrom até a última entidade da seleção de entidades original.

Se startFrom < 0, ele será recalculado como startFrom:=startFrom+length (ele é considerado como o deslocamento do final da seleção da entidade). If the calculated value < 0, startFrom is set to 0.
Se startFrom >= length, a função retorna uma seleção vazia de entidade.
Se end < 0, ele será recalculado como end:=end+length.
If end < startFrom (passed or calculated values), the method does nothing.

Se a seleção de entidade contém entidades que foram abandonadas, também serão retornadas.

Exemplo 1

Se quiser obter uma seleção das primeiras 9 entidades da seleção de entidade:

var $sel; $sliced : cs.EmployeeSelection
$sel:=ds.Employee.query("salary > :1";50000)
$sliced:=$sel.slice(0;9) //

Exemplo 2

Assuming we have ds. Employee.all().length = 10

var $slice : cs.EmployeeSelection

$slice:=ds.Employee.all().slice(-1;-2) //tenta retornar entidades do índice 9 a 8, mas como 9 > 8, retorna uma seleção de entidade vazia

.sum()

História

Release	Mudanças
17	Adicionado

.sum( attributePath : Text ) : Real

Parâmetro	Tipo		Descrição
attributePath	Text	->	Rota do atributo que se utilizará para o cálculo
Resultados	Real	<-	Soma dos valores da seleção de entidade

Descrição

A função .sum() retorna a soma de todos os valores attributePath na seleção de entidades.

.sum() devolve 0 se a entity selection estiver vazia.

A soma só pode ser feita em valores do tipo de número. Se o attributePath for uma propriedade do objeto, apenas valores numéricos são considerados para o cálculo (outros tipos de valores são ignorados). Neste caso, se attributePath levar a uma propriedade que não existe no objeto ou não contém nenhum valor numérico, .sum() retorna 0.

Um erro é retornado se:

attributePath não é um atributo numérico ou de objeto,
attributePath is a related attribute,
attributePath não se encontra na classe de dados da entity selection.

Exemplo

var $sel : cs.EmployeeSelection
var $sum : Real

$sel:=ds.Employee.query("salary < :1";20000)
$sum:=$sel.sum("salary")

.toCollection()

História

Release	Mudanças
17	Adicionado

.toCollection( { options : Integer { ; begin : Integer { ; howMany : Integer } } ) : Collection
.toCollection( filterString : Text {; options : Integer { ; begin : Integer { ; howMany : Integer }}} ) : Collection
.toCollection( filterCol : Collection {; options : Integer { ; begin : Integer { ; howMany : Integer }}} ) : Collection

Parâmetro	Tipo		Descrição
filterString	Text	->	String com caminho(s) de atributo(s) de entidade a extrair
filterCol	Collection	->	Coleção de caminho(s) de atributo(s) de entidade a extrair
options	Integer	->	`dk with primary key`: adiciona a chave primária `dk with stamp`: adiciona o marcador
begin	Integer	->	Designa o índice inicial
howMany	Integer	->	Número de entidades a extrair
Resultados	Collection	<-	Colecção de objectos contendo atributos e valores de selecção de entidades

Descrição

A função .toCollection() cria e retorna uma coleção em que cada elemento é um objeto que contém um conjunto de propriedades e valores correspondentes aos nomes e valores dos atributos da seleção da entidade.

Se nenhum parâmetro de filtro for passado ou se o primeiro parâmetro contiver uma cadeia vazia ou "*", todos os atributos são extraídos. Atributos com propriedade kind como "relatedEntity" são extraídos com a forma simples: um objeto com a propriedade __KEY (chave primária). Atributos com propriedade tipo como "Entidades relacionadas" não são extraídos.

Ou, pode designar os atributos da entidade a extrair utilizando um parâmetro de filtro. Pode usar um destes dois filtros:

*filterString - uma string com caminhos de propriedade separados por vírgulas: "propertyPath1, propertyPath2, ...".
filterCol - uma coleção de strings contendo caminhos de propriedade: ["propertyPath1", "propertyPath2",...]

Se um filtro for especificado para um atributo do tipo relatedEntity:

propertyPath = "relatedEntity" -> é extraído de forma simples
propertyPath = "relatedEntity.*" -> todas as propriedades são extraídas
propertyPath = "relatedEntity.propertyName1, relatedEntity.propertyName2, ..." -> só se extraem essas propriedades

Se um filtro for especificado para um atributo do tipo relatedEntities:

propertyPath = "relatedEntities.*" -> all the properties are extracted
propertyPath = "relatedEntities.propertyName1, relatedEntities.propertyName2, ..." -> só se extraem essas propriedades

No parâmetro options, você pode passar o(s) seletor(es) dk with primary key e/ou dk with stamp para adicionar as chaves primárias e/ou os selos da entidade nos objetos extraídos.

Aviso

Se utilizar outro atributo que não a chave primária como o atributo Um numa relação, o valor deste atributo será escrito na propriedade "__KEY". Lembre-se de que é recomendável usar a chave primária como um atributo em suas relações, especialmente quando você usar as funções .toCollection() e .fromCollection().

O parâmetro begin permite que você indique o índice inicial das entidades a extrair. Pode passar qualquer valor entre 0 e o comprimento-1 da selecção da entidade.

O parâmetro howMany permite especificar o número de entidades a extrair, começando com o especificado em begin. As entidades abandonadas não são devolvidas, mas são tidas em conta de acordo com howMany. Por exemplo, se howMany= 3 e houver 1 entidade abandonada, apenas 2 entidades são extraídas.

Se howMany > comprimento da seleção da entidade, o método retorna (comprimento - begin) objetos.

Uma colecção vazia é devolvida se:

a selecção da entidade está vazia, ou
begin é maior do que a duração da selecção da entidade.

Exemplo 1

A estrutura abaixo será usada nos exemplos desta seção:

Exemplo sem filtro ou parâmetro de opções:

 var $employeesCollection : Collection
 var $employees : cs.EmployeeSelection

 $employeesCollection:=New collection
 $employees:=ds.Employee.all()
 $employeesCollection:=$employees.toCollection()

Retorna:

[
    {
        "ID": 416,
        "firstName": "Gregg",
        "lastName": "Wahl",
        "salary": 79100,
        "birthDate": "1963-02-01T00:00:00.000Z",
        "woman": false,
        "managerID": 412,
        "employerID": 20,
        "photo": "[object Picture]",
        "extra": null,
        "employer": {
            "__KEY": 20
        },
        "manager": {
            "__KEY": 412
        }
    },
    {
        "ID": 417,
        "firstName": "Irma",
        "lastName": "Durham",
        "salary": 47000,
        "birthDate": "1992-06-16T00:00:00.000Z",
        "woman": true,
        "managerID": 412,
        "employerID": 20,
        "photo": "[object Picture]",
        "extra": null,
        "employer": {
            "__KEY": 20
        },
        "manager": {
            "__KEY": 412
        }
    }
]

Exemplo 2

Exemplo com opções:

var $employeesCollection : Collection
var $employees : cs. EmployeeSelection

$employeesCollection:=New collection
$employees:=ds. Employee.all()
$employeesCollection:=$employees.toCollection("";dk with primary key+dk with stamp)

Retorna:

[
    {
        "__KEY": 416,
        "__STAMP": 1,
        "ID": 416,
        "firstName": "Gregg",
        "lastName": "Wahl",
        "salary": 79100,
        "birthDate": "1963-02-01T00:00:00.000Z",
        "woman": false,
        "managerID": 412,
        "employerID": 20,
        "photo": "[object Picture]",
        "extra": null,
        "employer": {
            "__KEY": 20
        },
        "manager": {
            "__KEY": 412
        }
    },
    {
        "__KEY": 417,
        "__STAMP": 1,
        "ID": 417,
        "firstName": "Irma",
        "lastName": "Durham",
        "salary": 47000,
        "birthDate": "1992-06-16T00:00:00.000Z",
        "woman": true,
        "managerID": 412,
        "employerID": 20,
        "photo": "[object Picture]",
        "extra": null,
        "employer": {
            "__KEY": 20
        },
        "manager": {
            "__KEY": 412
        }
    }]

Exemplo 3

Exemplo com fatiagem e filtragem nas propriedades:

var $employeesCollection; $filter : Collection
var $employees : cs. EmployeeSelection

$employeesCollection:=New collection
$filter:=New collection
$filter.push("firstName")
$filter.push("lastName")

$employees:=ds. Employee.all()
$employeesCollection:=$employees.toCollection($filter;0;0;2)

Retorna:

[
    {
        "firstName": "Gregg",
        "lastName": "Wahl"
    },
    {
        "firstName": "Irma",
        "lastName": "Durham"
    }
]

Exemplo

Exemplo com o tipo 'relatedEntity' com uma forma simples:

var $employeesCollection : Collection
$employeesCollection:=New collection
$employeesCollection:=$employees.toCollection("firstName,lastName,employer")

retorna:

[
    {
        "firstName": "Gregg",
        "lastName": "Wahl",
        "employer": {
            "__KEY": 20
        }
    },
    {
        "firstName": "Irma",
        "lastName": "Durham",
        "employer": {
            "__KEY": 20
        }
    },
    {
        "firstName": "Lorena",
        "lastName": "Boothe",
        "employer": {
            "__KEY": 20
        }
    }
   ]

Exemplo 2

Exemplo com o parâmetro filterCol:

var $employeesCollection; $coll : Collection
$employeesCollection:=New collection
$coll:=New collection("firstName";"lastName")
$employeesCollection:=$employees.toCollection($coll)

Retorna:

[
    {
        "firstName": "Joanna",
        "lastName": "Cabrera"
    },
    {
        "firstName": "Alexandra",
        "lastName": "Coleman"
    }
]

Exemplo 6

Exemplo com extracção de todas as propriedades de relatedEntity:

var $employeesCollection; $coll : Collection
$employeesCollection:=New collection
$coll:=New collection
$coll.push("firstName")
$coll.push("lastName")
$coll.push("employer.*")
$employeesCollection:=$employees.toCollection($coll)

Retorna:

[
    {
        "firstName": "Gregg",
        "lastName": "Wahl",
        "employer": {
            "ID": 20,
            "name": "Irma",
        "lastName": "Durham",
        "employer": {
            "ID": 20,
            "name": "Lorena",
        "lastName": "Boothe",
        "employer": {
            "ID": 20,
            "name": "India Astral Secretary",
            "creationDate": "1984-08-25T00:00:00.000Z",
            "revenues": 12000000,
            "extra": null
        }
    }
  ]

Exemplo 3

Exemplo com extracção de algumas propriedades de uma relatedEntity:

var $employeesCollection : Collection
$employeesCollection:=New collection
$employeesCollection:=$employees.toCollection("firstName, lastName, employer.name")

[
    {
        "firstName": "Gregg",
        "lastName": "Wahl",

        "employer": {
            "name": "Irma",
        "lastName": "Durham",
        "employer": {
            "name": "Lorena",
        "lastName": "Boothe",
        "employer": {
            "name": "India Astral Secretary"
        }
    }]

Exemplo 8

Exemplo com extracção de algumas propriedades de relatedEntities:

 var $employeesCollection : Collection
 $employeesCollection:=New collection
 $employeesCollection:=$employees.toCollection("firstName, lastName, directReports.firstName")

Retorna:

[
    {
        "firstName": "Gregg",
        "lastName": "Wahl",
        "directReports": []
    },
    {
        "firstName": "Mike",
        "lastName": "Phan",
        "directReports": [
            {
                "firstName": "Gary"
            },
            {
                "firstName": "Sadie"
            },
            {
                "firstName": "Christie"
            }
        ]
    },
    {
        "firstName": "Gary",

        "lastName": "Reichert",
        "directReports": [
            {
                "firstName": "Rex"
            },
            {
                "firstName": "Jenny"
            },
            {
                "firstName": "Lowell"
            }
        ]
    }]

Exemplo 9

Exemplo com extração de todas as propriedades de relatedEntities:

var $employeesCollection : Collection
$employeesCollection:=New collection
$employeesCollection:=$employees.toCollection("firstName, lastName, directReports.*")

[
    {
        "firstName": "Gregg",
        "lastName": "Wahl",
        "directReports": []
    },    
    {
        "firstName": "Mike",
        "lastName": "Phan",
        "directReports": [
            {
                "ID": 425,
                "firstName": "Gary",
                "lastName": "Reichert",
                "salary": 65800,
                "birthDate": "1957-12-23T00:00:00.000Z",
                "woman": false,
                "managerID": 424,
                "employerID": 21,
                "photo": "[object Picture]",
                "extra": null,
                "employer": {
                    "__KEY": 21
                },
                "manager": {
                    "__KEY": 424
                }
            },
            {
                "ID": 426,
                "firstName": "Sadie",
                "lastName": "Gallant",
                "salary": 35200,
                "birthDate": "2022-01-03T00:00:00.000Z",
                "woman": true,
                "managerID": 424,
                "employerID": 21,
                "photo": "[object Picture]",
                "extra": null,
                "employer": {
                    "__KEY": 21
                },
                "manager": {
                    "__KEY": 424
                }
            }
                   ]
    },
    {
        "firstName": "Gary",
        "lastName": "Reichert",
        "directReports": [
            {
                "ID": 428,
                "firstName": "Rex",
                "lastName": "Chance",
                "salary": 71600,
                "birthDate": "1968-08-09T00:00:00.000Z",
                "woman": false,

                "managerID": 425,
                "employerID": 21,
                "photo": "[object Picture]",
                "extra": null,
                "employer": {
                    "__KEY": 21
                },
                "manager": {
                    "__KEY": 425
                }
            },
            {
                "ID": 429,
                "firstName": "Jenny",
                "lastName":

Resumo​

Criar uma seleção de entidades (entity selection)​

Descrição​

Exemplo​

Veja também​

USE ENTITY SELECTION​

Descrição​

Exemplo​

&#91index&#93​

Descrição​

Exemplo​

.attributeName​

Descrição​

Exemplo 1​

Exemplo 2​

Exemplo 3​

.add()​

Descrição​

Exemplo 1​

Exemplo 2​

Exemplo 3​

.and()​

Descrição​

Exemplo 1​

Exemplo 2​

.at()​

Descrição​

Exemplo​

.average()​

Descrição​

Exemplo​

.clean()​

Descrição​

Exemplo​

Veja também​

.contains()​

Descrição​

Exemplo​

.count()​

Descrição​

Exemplo​

.copy()​

Descrição​

Exemplo​

.distinct()​

Descrição​

Exemplos​

.distinctPaths()​

Descrição​

Exemplo​

.drop()​

Descrição​

Exemplo​

.extract()​

Descrição​

Exemplo​

.first()​

Descrição​

Exemplo​

.getDataClass()​

Descrição​

Exemplo​

.getRemoteContextAttributes()​

Descrição​

Exemplo​

Veja também​

.isAlterable()​

Descrição​

Exemplo​

.isOrdered()​

Descrição​

Exemplo​

.last()​

Descrição​

Exemplo​

.length​

Descrição​

Exemplo​

.max()​

Descrição​

Resumo

Criar uma seleção de entidades (entity selection)

Descrição

Exemplo

Veja também

USE ENTITY SELECTION

Descrição

Exemplo

&#91index&#93

Descrição

Exemplo

.attributeName

Descrição

Exemplo 1

Exemplo 2

Exemplo 3

.add()

Descrição

Exemplo 1

Exemplo 2

Exemplo 3

.and()

Descrição

Exemplo 1

Exemplo 2

.at()

Descrição

Exemplo

.average()

Descrição

Exemplo

.clean()

Descrição

Exemplo

Veja também

.contains()

Descrição

Exemplo

.count()

Descrição

Exemplo

.copy()

Descrição

Exemplo

.distinct()

Descrição

Exemplos

.distinctPaths()

Descrição

Exemplo

.drop()

Descrição

Exemplo

.extract()

Descrição

Exemplo

.first()

Descrição

Exemplo

.getDataClass()

Descrição

Exemplo

.getRemoteContextAttributes()

Descrição

Exemplo

Veja também

.isAlterable()

Descrição

Exemplo

.isOrdered()

Descrição

Exemplo

.last()

Descrição

Exemplo

.length

Descrição

Exemplo

.max()

Descrição