referenceDefinition resource type

Namespace: microsoft.graph.industryData

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents an enumerated reference value. Each supported industry domain receives a distinct collection of default values and customers can further customize them by overriding default values or adding new values to the tenant. The referenceDefinition objects are used throughout the system, both for configuration and validating data during transformation.

Each referenceDefinition uses a composite identifier of {referenceType}-{code}. This provides a more natural developer experience as the vast majority of code values are defined by a standard body, which allows developers in specific industry domains to better recognize the format.

The following are examples of types:

  • refRole: Used when associating and validated during import
  • refOrgType: Used when associating and validated during import
  • userMatchTarget: Only used for configuration

Methods

Method Return type Description
List microsoft.graph.industryData.referenceDefinition collection Get a list of the referenceDefinition objects and their properties.
Get microsoft.graph.industryData.referenceDefinition Read the properties and relationships of a referenceDefinition object.
Create microsoft.graph.industryData.referenceDefinition Create a new referenceDefinition object.
Update microsoft.graph.industryData.referenceDefinition Update the properties of a referenceDefinition object.
Delete None Delete a referenceDefinition object.

Properties

Property Type Description
code String The code value for the definition that must be unique within the referenceType.
createdDateTime DateTimeOffset The date and time when the definition was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
displayName String A human-readable representation of the reference code value for display in a user interface.
isDisabled Boolean Indicates whether the definition is disabled.
lastModifiedDateTime DateTimeOffset The date and time when the definition was most recently changed. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
referenceType String The categorical type for a collection of enumerated values.
sortIndex Int32 The index that specifies the order in which to present the definition to the user. Must be unique within the referenceType.
source String The standards body or organization source which defined the code.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.industryData.referenceDefinition",
  "code": "String",
  "createdDateTime": "String (timestamp)",
  "displayName": "String",
  "isDisabled": "Boolean",
  "lastModifiedDateTime": "String (timestamp)",
  "referenceType": "String",
  "sortIndex": "Int32",
  "source": "String"
}