Export (0) Print
Expand All

1.1 Glossary

The following terms are defined in [MS-GLOS]:

.NET Framework
binary large object (BLOB)
XML Namespace

The following terms are defined in [MC-CSDL]:

conceptual schema definition language (CSDL)
conceptual schema definition language (CSDL) document
declared property
dynamic property
Entity Data Model (EDM)

The following terms are specific to this document:

AtomPub collection: A set of resources that can be retrieved in whole or in part.

Atom Publishing Protocol (AtomPub): An application-level protocol for publishing and editing web resources, as specified in [RFC5023].

bind: To associate two EntityType instances. An EntityType ([MC-CSDL] section 2.1.2) instance in a data service (described by using Entity Data Model (EDM) constructs) may be related to one or more other conceptual schema definition language (CSDL) instances. This relationship is represented by using an association in an EDM. The cardinality of a relationship can be determined by inspecting the EDM that describes the data service. The act of associating two EntityType instances is known as "binding" and of disassociating two instances is known as "unbinding". If two EntityType instances are already associated, they are considered to be "bound".

change set: A logical group of one or more of the following request types:

All requests within a change set must be successfully processed. If any request in the change set fails, none of the requests within the change set should be processed.

create retrieve update delete (CRUD): The four basic functions of persistent storage. The "C" stands for create, the "R" for retrieve, the "U" for update, and the "D" for delete. CRUD is used to denote these conceptual actions and does not imply the associated meaning in a particular technology area (such as in databases, file systems, and so on) unless that associated meaning is explicitly stated.

collection property: An EntityType property that represents a non-nullable, unordered, homogenous set of type EDMSimpleType or ComplexType, as specified in [MC-CSDL].

customizable feed: A property mapping that is used to define a mapping from the properties of an EntityType to elements or attributes in any namespace (including the Atom namespace) in an AtomPub document. When a property is mapped to an element or an attribute of an element, the value for the property is equal to the value of the specified element or attribute in the AtomPub document.

data service: A server-side application that implements the OData protocol for the purpose of enabling clients to publish and edit resources. The resources exposed by data services are described by using the EDM, as specified in [MC-CSDL].

default EntityContainer: A single EntityContainer [MC-CSDL] (section 2.1.14) within a CSDL document, as specified in [MC-CSDL]. Entities in the default container may be identified in a data serviceURI without specifying the container name, as described in URI Format: Resource Addressing Rules (section 2.2.3).

Entity Data Model Extensions (EDMX): An XML-based file format that serves as the packaging format for the service metadata of a data service, as specified in [MC-EDMX].

Internationalized Resource Identifier (IRI): A resource identifier that conforms to the rules for Internationalized Resource Identifiers, as defined in [RFC3987].

JavaScript Object Notation (JSON): A set of formatting rules for the portable representation of structured data, as specified in [RFC4627].

link: A link is similar to an association, as specified in [MC-CSDL], but describes a unidirectional relationship between entity types instead of a bidirectional one. A link can be:

  • A unidirectional relationship that occurs when two entity types are related via an association and only one of the entity types defines a NavigationProperty that is bound to the association.

  • A reference to one direction of a bidirectional association between two entity types, as specified in [MC-CSDL].

named resource stream: A property of an EntityType that is of type Edm.Stream.

named resource stream instance: A named resource stream for a particular entity. Each named resource stream instance has a content type, a self-link URI for retrieving the stream, an edit-link URI for updating the stream, and an ETag to facilitate concurrency control.

primitive property: A property of type EDMSimpleType ([MC-CSDL] section 2.2.1) that is defined on an EntityType.

property: An EntityType or ComplexType can have one or more properties of the specified EDMSimpleType or ComplexType. A property of an EntityType may be a declared property or a dynamic property, as specified in [MC-CSDL]. A property of ComplexType must be a declared property.

Note  In CSDL ([MC-CSDL]), dynamic properties are only defined for use with OpenEntityType ([MC-CSDL]) instances.

query operation: A logical construct that must consist of a single retrieve request type (section or an invoke request (section that uses the HTTP GET method.

resource: A network-accessible data object or service that is identified by an IRI, as defined in [RFC2616].

resource path: The path of a data serviceURI, starting immediately after the service root and continuing to the end of the URI's path, as described in Resource Path (section

service operation: An operation that is exposed by the data service. A service operation is represented as a FunctionImport, as specified in [MC-CSDL] (section 2.1.15). A service operation accepts only input parameters.

service root: A URI that represents the root of a data service, as specified in Service Root (section

unbind: To disassociate two EntityType instances. See also the definition for bind.

MAY, SHOULD, MUST, SHOULD NOT, MUST NOT: These terms (in all caps) are used as described in [RFC2119]. All statements of optional behavior use either MAY, SHOULD, or SHOULD NOT.

© 2015 Microsoft