Saltar para o conteúdo principal
Versão: Próximo

dataClass

Os nomes de dataclass podem ser utilizados diretamente nos pedidos REST para trabalhar com entidades e selecções de entidades, ou funções de classe da dataclass.

Sintaxe disponível​

SintaxeExemploDescrição
{dataClass}/EmployeeRetorna todos os dados (como padrão as primeiras 100 entidades) para a dataclass
{dataClass}[{key}]/Employee[22]Retorna os dados para a entidade especifica definida pela chave primária da classe de dados
{dataClass}:{attribute}(value)/Employee:firstName(John)Retorna os dados para uma entidade na qual os valores de atributo são definidas
{dataClass}/{DataClassClassFunction}/City/getCityExecuta uma função de classe de uma dataclass
{dataClass}/{EntitySelectionClassFunction}/City/getPopulation/?$filter="ID<3"Executa uma função de classe de uma seleção de entidade
{dataClass}[{key}]/{EntityClassFunction}City[2]/getPopulationExecuta uma função de classe de uma entidade

Las llamadas a las funciones se detallan en la sección Llamar las funciones de la clase ORDA.

{dataClass}​

Devuelve todos los datos (por defecto las 100 primeras entidades) para una clase de datos específica (por ejemplo, Company)

Descrição​

When you call this parameter in your REST request, the first 100 entities are returned unless you have specified a value using $top/$limit.

Aqui está uma descrição dos dados retornados:

PropriedadeTipoDescrição
__entityModelStringNome da dataclass.
__COUNTNumberNúmero de entidades na classe de dados.
__SENTNumberNúmero de entidades enviadas pela petição REST. Este número puede ser el número total de entidades si es menor que el valor definido por $top/$limit.
__FIRSTNumberNúmero de entidade em que a seleção vai começar. O bien 0 por defecto o el valor definido por $skip.
__ENTITIESCollectionEsta coleção de objetos contém um objeto para cada entidade com todos seus atributos. Todos os atributos relacionais são retornados como objetos com uma URI para obter informação sobre o objeto pai.

Cada entidade contém as propriedades abaixo:

PropriedadeTipoDescrição
__KEYStringValor da chave primária definida para a classe de dados.
__TIMESTAMPDateRegistro de hora da última modificação da entidade
__STAMPNumberSello interno que se necesita cuando se modifica alguno de los valores de la entidad al utilizar $method=update.

Si quiere especificar qué atributos quiere devolver, defínalos utilizando la siguiente sintaxis {attribute1, attribute2, ...}. Por exemplo:

GET /rest/Company/name,address

Exemplo​

Retorna todas as datas para uma classe de dados específica.

GET /rest/Company

Resultado:

{
    "__entityModel": "Company",
    "__GlobalStamp": 51,
    "__COUNT": 250,
    "__SENT": 100,
    "__FIRST": 0,
    "__ENTITIES": [
        {
            "__KEY": "1",
            "__TIMESTAMP": "2020-04-10T10:44:49.927Z",
            "__STAMP": 1,
            "ID": 1,
            "name": "Adobe",
            "address": null,
            "city": "San Jose",
            "country": "USA",
            "revenues": 500000,
            "staff": {
                "__deferred": {
                    "uri": "http://127.0.0.1:8081/rest/Company(1)/staff?$expand=staff"
                }
            }
        },
        {
            "__KEY": "2",
            "__TIMESTAMP": "2018-04-25T14:42:18.351Z",
            "__STAMP": 1,
            "ID": 2,
            "name": "Apple",
            "address": null,
            "city": "Cupertino",
            "country": "USA",
            "revenues": 890000,
            "staff": {
                "__deferred": {
                    "uri": "http://127.0.0.1:8081/rest/Company(2)/staff?$expand=staff"
                }
            }
        },
        {
            "__KEY": "3",
            "__TIMESTAMP": "2018-04-23T09:03:49.021Z",
            "__STAMP": 2,
            "ID": 3,
            "name": "4D",
            "address": null,
            "city": "Clichy",
            "country": "France",
            "revenues": 700000,
            "staff": {
                "__deferred": {
                    "uri": "http://127.0.0.1:8081/rest/Company(3)/staff?$expand=staff"
                }
            }
        },
        {
            "__KEY": "4",
            "__TIMESTAMP": "2018-03-28T14:38:07.430Z",
            "__STAMP": 1,
            "ID": 4,
            "name": "Microsoft",
            "address": null,
            "city": "Seattle",
            "country": "USA",
            "revenues": 650000,
            "staff": {
                "__deferred": {
                    "uri": "http://127.0.0.1:8081/rest/Company(4)/staff?$expand=staff"
                }
            }
        }
.....//more entities here 
    ]
}

{dataClass}[{key}]​

Devuelve los datos de la entidad específica definida por la llave primaria de la clase de datos, por ejemplo, Company[22] o Company[IT0911AB2200]

Descrição​

Passando a classe de dados e uma chave, pode recuperar toda a informação pública para a entidade. Passando a classe de dados e uma chave, pode recuperar toda a informação pública para a entidade. Para más información sobre la definición de una llave primaria, consulte la sección Modifying the Primary Key en el Editor del modelo de datos.

For more information about the data returned, refer to {dataClass}.

Si quiere especificar qué atributos quiere devolver, defínalos utilizando la siguiente sintaxis {attribute1, attribute2, ...}. Por exemplo:

GET /rest/Company[1]/name,address

Si desea expandir un atributo de relación utilizando $expand, lo hará especificándolo como se muestra a continuación:

GET /rest/Company[1]/name,address,staff?$expand=staff

Exemplo​

A petição abaixo retorna todos os dados públicos na dataclass Company cuja chave é 1.

GET /rest/Company[1]

Resultado:

{
    "__entityModel": "Company",
    "__KEY": "1",
    "__TIMESTAMP": "2020-04-10T10:44:49.927Z",
    "__STAMP": 2,
    "ID": 1,
    "name": "Apple",
    "address": Infinite Loop,
    "city": "Cupertino",
    "country": "USA",
    "url": http://www.apple.com,
    "revenues": 500000,
    "staff": {
        "__deferred": {
            "uri": "http://127.0.0.1:8081/rest/Company(1)/staff?$expand=staff"
        }
    }
}

{dataClass}:{attribute}(value)​

Retorna os dados para uma entidade na qual os valores de atributo são definidas

Descrição​

Pasando la clase de datos y un atributo junto con un valor, se puede recuperar toda la información pública de esa entidad. O valor é um valor único para o atributo, mas não é a chave primária.

GET /rest/Company:companyCode(Acme001)

Si quiere especificar qué atributos quiere devolver, defínalos utilizando la siguiente sintaxis {attribute1, attribute2, ...}. Por exemplo:

GET /rest/Company:companyCode(Acme001)/name,address

Si desea utilizar un atributo relacional utilizando $attributes.md">, lo hará especificándolo como se muestra a continuación:

GET /rest/Company:companyCode(Acme001)?$attributes=name,address,staff.name

Exemplo​

A petição abaixo retorna todos os dados públicos do funcionário chamado "Jones".

GET /rest/Employee:lastname(Jones)