OData

O OData é tratado como um protocolo de pleno direito, e não como HTTP que cada um decora à sua maneira: o Restorm conhece as suas opções de sistema, as suas operações e o seu formato de lote.

Clique com o botão direito na árvore ▸ Adicionar ▸ Pedido OData.

Configuração

Campo	Função
URL	O endpoint do serviço, incluindo o conjunto de entidades
Versão OData	v2, v3, v4 ou v4.01
Tipo de operação	entity-set, function, action ou batch
Cabeçalhos / Parâmetros	Como num pedido HTTP

Opções de consulta

Cada opção de sistema tem o seu próprio campo:

$filter · $select · $top · $skip · $count · $expand · $orderby · $search · $format (json, xml, atom) · $apply (agregação, v4.01).

O campo $filter beneficia de uma conclusão automática alimentada pelos metadados importados: os nomes das propriedades e os operadores são sugeridos.

Funções e ações

Para function e action, está disponível uma lista de parâmetros de operação tipados — nome, tipo CSDL qualificado, aceitação de nulos, indicador de ligação — e, no caso de uma ação, um corpo JSON dedicado.

Pedidos $batch

O modo batch contém uma lista de subpedidos, cada um com o seu método, o seu URL, os seus cabeçalhos, o seu corpo e, eventualmente, o seu grupo de atomicidade (change set). Duas opções:

• Formato: multipart (por predefinição) ou json;
• Permitir GET num change set: desativado por predefinição; ativá-lo desencadeia um aviso, porque o OData não o prevê.

Importar os metadados

Importe um $metadata ou um .edmx: o Restorm cria uma pasta por conjunto de entidades com os respetivos pedidos CRUD, mais pastas Actions e Functions. Os pedidos chegam previamente preenchidos com o tipo de entidade, as propriedades, as propriedades de navegação e as opções de consulta. Consulte Importar OData.

Modo servidor

O Restorm sabe alojar um serviço OData v4 de simulação: fornece o documento CSDL de metadados (servido tal como está) e os dados por conjunto de entidades. As opções de sistema são aplicadas aos dados servidos. Consulte Simular um serviço OData.