Freigeben über


Internet API-Typen und -Vorgänge

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Um Web API zu verwenden, müssen Sie Informationen zu dem suchen, was für Sie zur Nutzung verfügbar ist. Der Dienst beschreibt sich über Service- und Metadatendokumente, auf die Sie zugreifen können. Dieses Thema enthält wichtige Konzepte und beschreibt, wie Sie die von Ihnen benötigten Informationen mithilfe von Dokumentationen finden, die aus Service- und Metadatendokumenten sowie der Dokumentation der Systementitätstypen, Funktionen und Aktionen erstellt werden.

In diesem Thema

Terminologie

Servicedokumente

Entitätstypen

Eigenschaften

Navigationseigenschaften

Aktionen

Funktionen

Komplexe Typen

Enumerationstypen

Terminologie

Der Web API wird mithilfe des ODatas v4 Standards implementiert, der bstimmte Begriffe verwendet, mit denen Sie vertraut sein müssen.Entity Data Model (EDM) ist das abstrakte Datenmodell, das verwendet wird, um die Daten zu beschreiben, die von einem OData-Service verfügbar gemacht werden. Die folgende Tabelle enthält eine ausgewählte Terminologieliste definiert in OData-Version 4.0, Teil 1 Protokoll Plus Errata 02, das Sie verstehen sollten.

Begriff

Definition

Entitätstypen

Benannte strukturierte Typen mit einen Schlüssel. Sie definieren die benannten Eigenschaften und Beziehungen einer Entität. Entitätstypen können durch einzelne Vererbung von anderen Entitätstypen abgeleitet werden.

Entitäten

Instanzen von Entitätstypen (z. B. account, opportunity).

Entitätssätze

Benannte Sammlungen von Entitäten (z. B. accounts ist ein Entitätssatz der account Entitäten enthält). Ein Entitätsschlüssel, der die Entität in einem Entitätssatz eindeutig bezeichnet

Komplexe Typen

Schlüssellose benannte strukturierte Typen, die einen Satz von Eigenschaften enthalten. Komplexe Typen werden als Eigenschaftswerte in Modelentitäten oder als Parameter oder Rückgabewerte für Vorgänge verwendet.

Enumerationstypen oder Enumerationstypen

Primitive Typen, dessen Werte nach Konstanten mit zugrunde liegenden ganzzahligen Werten benannt sind.

Funktionen

Vorgänge, die keine Nebenwirkungen aufweisen und weitere Zusammensetzung unterstützen können, beispielsweise zusätzliche Filtervorgänge, Funktionen oder eine Aktion.

Aktionen

Vorgänge, die Nebenwirkungen, wie Datenänderung zulassen und nicht weiter zusammengesetzt werden können, um ein nicht deterministisches Verhalten zu vermeiden.

Servicedokumente

Es gibt zwei Servicedokumente, auf die Sie verweisen können, um mehr über den Web API zu erfahren.

Servicedokument

Die folgende, Abfrage, die in das Adressfeld des Browsers eingegeben wird, gibt das Service-Dokumenht zurück, eine vollständige Liste aller Entitätssätze, die für Ihre Organisation verfügbar sind. Beachten Sie, dass Organisation [URI] die URL für Ihre Organisation darstellt.


[Organisations-URI]/api/data/v8.2

Die Entitätssätze werden in Form eines JSON Arrays zurückgegeben. Jedes Element im Array besteht aus drei aufgelisteten Eigenschaften aufgelistet in diesr Tabelle.

Eigenschaft

Beschreibung

name

Dies ist der Name des Entitätssatzes. Diese Daten sind von der Eigenschaft EntityMetadata EntityTypeEntitySetName für die Entität.

kind

Für die WEB API weden nur Entitätssätze aufgelistet.

url

Dieser Wert ist identisch mit der name-Eigenschaft und zeigt den Teil des Ressourcenpfads, um die Daten für die Entität abzurufen.

Diese Information kann mithilfe der GET Anfrage abgerufen werden und kann hilfreich sein, um eine Liste aller verfügbaren Entitätssätze, die den Service nutzen, abzurufen.

CSDL-Metadatendokument

Eine GET Anfrage für die folgende URL gibt ein eher grosses (mehr als 3.5 MB) Common Schema Definition Language (CSDL) -Dokument oder Metadaten-Dokument zurück, das die Daten und den Ablauf des Service darstellt.


[Organisations-URI]/api/data/v8.2/$metadata

Dieses Dokument kann als Datenquelle verwendet werde, um Klassen zu erstellen, die stark typisierte Objekte für den Service bereitstellen. Aber, wenn Sie keine generierten Klassen verwenden, sollten Sie die Dokumentation, die aus diesen Informationen generiert wurden, überprüfen.Web API Reference verwendet primär Informationen in diesem Dokument, die einem nicht benutzerdefinierten System entnommen wurden.

Sie erfahren mehr über dieses Dokument unter OData-Version 4.0 Teil 3: Common Schema Definition Language (CSDL) Plus Errata 02.

Tipp

Vor dem Lesen lädt der Rest dieses Themas, das CSDL für Ihre Organisation " heruntergeladen und birgt einen Blick, wie auf die Datensatztypen, Funktionen und die Aktionen im beschriebenen CSDL und die Begleitunterlagen enthalten sind.

Entitätstypen

Web API EntityType Reference führt alle Systementitätstypen auf, die durch die Web API verfügbar sind, die Geschäftsdaten speichert. Ein Entitätstyp ist ein benannter strukturierter Typ von einen Schlüssel. Sie definieren die benannten Eigenschaften und Beziehungen einer Entität. Entitätstypen können durch einzelne Vererbung von anderen Entitätstypen abgeleitet werden.Web API Metadata EntityType Reference fürht die Entitätstypen auf, die verwendet werden, um die Systemmetadaten zu verwalten. Beides sind Entuitätstypen, aber die Art, wie Sie mit ihnen arbeiten, ist unterschiedlich. Siehe Verwenden der Web-API mit Dynamics 365-Metadaten für Informationen zur Verwendung von Modellentitäten. Jeder Entitätstyp ist in einem EntityType-Element im CSDL enthalten. Im Folgenden finden Sie die Definition des account EntityType vom CSDL mit entfernten Eigenschaften und Navigationseigenschaften.

<EntityType Name="account" BaseType="mscrm.crmbaseentity">
  <Key>
    <PropertyRef Name="accountid" />
  </Key>
  <!--Properties and navigation properties removed for brevity-->
  <Annotation Term="Org.OData.Core.V1.Description" String="Business that represents a customer or potential customer. The company that is billed in business transactions." />
</EntityType>

Jede EntityType Referenzseite in der SDK-Dokumentation verwendet Informationen im CSDL oder Metadaten, um die folgenden Informationen anzuzeigen, falls verfügbar.

Informationen

Beschreibung

Beschreibung

Eine Beschreibung der Entität.

Die EntityMetadata EntityType Description Eigenschaftsinformation ist im EntityType Element, das das Annotation Element mit dem Term Attributwert Org.OData.Core.V1.Description verwendet, eingeschlossen.

URL-Sammlung

Die URL, mit der Sie auf jeden Typ in de Sammlung zugreifen können.

Die EntityMetadata EntityType EntitySetName Eigenschaftsinformation, die das CSDL EntityContainer-Element verwendet, ist eingeschlossen. Das Name-Attribut jedes EntitySet-Elements steuert, wie auf die Daten über die URL zugeriffen wird.

Basistyp

Hierbei handelt es sich um den Entitätstyp, von dem der Entitätstyp abstimmt.

Das BaseType-Attribut vom EntityType-Element enthält den Namen des Entitätstyps. Dieser Name wird dem Alias für den Microsoft.Dynamics.CRM-Namespace verwendet: mscrm.Weitere Informationen:Typvererbung

Anzeigename

Diese Informationen sind nicht im CSDL sondern werden von EntityMetadata EntityTypeDisplayName Eigenschaft abgerufen.

Primärschlüssel

Der Eigenschaftswert, die den eindeutigen Bezeichner enthält, der auf eine Instanz einer Entität verweist.

Der EntityMetadata EntityType PrimaryIdAttribute Eigenschaftswert ist im EntityType Key Element eingeschlossen. Jede Entität kann nur einen Primärschlüssel haben.

Alternativschlüssel sind hier nicht aufgeführt.Weitere Informationen:Alternativschlüssel

Primäres Attribut

Viele Entitäten verlangen, dass ein primärer Attributwert festgelegt wird, deshalb wird dieser hier eingeschlossen.

Diese Informationen sind nicht im CSDL sondern werden von der EntityMetadata EntityTypePrimaryNameAttribute Metadateneigenschaft abgerufen.

Eigenschaften

Siehe Eigenschaften.

Einzelwertige Navigationseigenschaften

Siehe Einzelwertige Navigationseigenschaften.

Gemeinsam bewertete Navigationseigenschaften

Siehe Gemeinsam bewertete Navigationseigenschaften.

An den Entitätstyp gebundene Vorgänge

Wenn ein Vorgang an einen bestimmten Entitätstyp gebunden ist, ist er der Einfachheit halber aufgelistet.

Vorgänge, die den Entitätstyp verwenden

Diese Liste enthält alle Vorgänge, die möglicherweise den Entitätstyp verwenden. Dieser wird berechnet, indem Verweise auf alle Vorgänge abgerufen werden, die sich auf den aktuellen Typ im Parameter beziehen oder als Rückgabewert gelten.

Entitätstypen, die vom Entitätstyp erben

Diese Liste beinhaltet sämtliche Entitätstypen, die direkt vom ausgewählten Entitätstyp erben. Weitere Informationen finden Sie unter Typvererbung.

Ändern des Namens eines Entitätssets

Standardmäßig entspricht der Entitätssetname dem EntityMetadata EntityTypeLogicalCollectionName (EntityMetadataLogicalCollectionName) Eigenschaftswert. Wenn Sie eine benutzerdefinierte Entität haben, die mit einem anderen Entitätsnamen ansprechen möchten, können Sie den EntityMetadata EntityTypeEntitySetName (EntityMetadata.EntitySetName) Eigenschaftswert aktualisieren, um einen anderen Entitätsnamen zu verwenden.

Alternativschlüssel

Obwohl Microsoft Dynamics 365 die Erstellung von Alternativschlüsseln zulässt, findet man nur den Primärschlüssel in der Microsoft Dynamics 365 SDK Dokumentation.

Keine dieser Systementitäten hat definierte Alternativschlüssel. Wenn Sie Alternativschlüssel für eine Entität definieren, können sie im Element CSDL EntityType als Annotation beispielsweise folgende enthalten:

<Annotation Term="OData.Community.Keys.V1.AlternateKeys">
  <Collection>
    <Record Type="OData.Community.Keys.V1.AlternateKey">
      <PropertyValue Property="Key">
        <Collection>
          <Record Type="OData.Community.Keys.V1.PropertyRef">
            <PropertyValue Property="Alias" String="key name" />
            <PropertyValue Property="Name" PropertyPath="key name" />
          </Record>
        </Collection>
      </PropertyValue>
    </Record>
  </Collection>
</Annotation>

Informationen zu Alternativschlüssel können auch aus den Metadaten mithilfe der EntityMetadata EntityType Keys sammlungswertigen Navigationseigenschaft mithilfe des Web APO oder der EntityMetadata.Keys Eigenschaft mithilfe des Organisationsservices aberufen werden.

Typvererbung

Vererbung ist das Freigeben von allgemeinen Eigenschaften und die Kategorisieren von Entitätstypen in Gruppen. Alle Entitätstypen im Web API erben von den zwei folgenden Entitätstypen. Alle Geschäftsentitätstypen erben unter crmbaseentity EntityType und alle Modellentitäten erben von crmmodelbaseentity EntityType

Basisentität

Beschreibung

crmbaseentity EntityType

Alle Geschäftsentitäten erben aus dieser Entität. Sie hat keine Eigenschaften. Sie dient nur als abstrakte Basisentität.

activitypointer EntityType

Alle aktiven Entitäten erben aus dieser Entität. Definieren Sie die allgemein Eigenschafts- und die Navigationseigenschaften für Aktivitätsentitäten.

principal EntityType

Die systemuser EntityType und team EntityType erben eine gemeinsame ownerid Eigenschaft von dieser Entität.

crmmodelbaseentity EntityType

Nur MetadataBase EntityType erbt direkt aus dieser Entität. Sie hat keine Eigenschaften. Sie dient nur als abstrakte Basisentität.

MetadataBase EntityType

Alle Modellentitäten erben aus dieser Entität. Sie enthält MetadataId und HasChanged Eigenschaften für alle Modellentitäten.

AttributeMetadata EntityType

Alle Modellentitäten, die unterschiedliche Attributtypen darstellen, erben aus dieser Entität.

EnumAttributeMetadata EntityType

Die Modellentitäten, die Attribute anzeigen, die einen Satz von Optionen aus dieser Entität erben.

OptionSetMetadataBase EntityType

Dieser Modellentitättyp bietet einen allgemeinen Satz von Eigenschaften, die von denBooleanOptionSetMetadata EntityType und OptionSetMetadata EntityType Modellentitättypen verwendet werden, die davon erben.

RelationshipMetadataBase EntityType

Dieser Entitätstyp bietet einen allgemeinen Satz von Eigenschaften, die von denManyToManyRelationshipMetadata EntityType und OneToManyRelationshipMetadata EntityType Modellentitättypen verwendet werden, die davon erben.

Eigenschaften

Jeder Entitätstpy kann Eigenschaften haben, die den Attributen entsprechen. Im Web API EntityType Reference und Web API Metadata EntityType Reference Inhalt werden Eigenschaften, die von einem Basisentitätstyp vererbt werden, in der Liste der deklarierten Eigenschaften für jeden Entitätstyp kombiniert. Die Vererbung wird in der Beschreibung für jede ausgerufen Eigenschaft definiert.

In den CSDL EntityType Elementen ist jede Eigenschaft in einem Property-Element mit einem Name Attributwert eingeschlossen, der den Eigenschaften entspricht, die die Sie im Code festlegen. Der Type Attributwert definiert den Datentyp der Eoigenschaft. Eigenschaften für Geschäftsentitätstypen verwenden im Allgemeinen OData primitive Typen.

Nachfolgend finden Sie ein Beispiel der account EntityTypename Eigenschaft in CSDL.

<Property Name="name" Type="Edm.String" Unicode="false">
  <Annotation Term="Org.OData.Core.V1.Description" String="Type the company or business name." />
</Property>

Die Beschreibung der Eigenschaft ist in einer Annotation-Element mit der Term-Attributeigenschaft von Org.OData.Core.V1.Descriptionverfügbar. Diese Beschreibung wird vom Eigenschaftswert AttributeMetadata EntityType Description weitergeleitet. Nicht alle aufgelisteten Eigenschaften haben eine Beschreibung.

Jede Eigenschaft kann berechnet werden. Das bedeutet, dass der Wert möglicherweise vom System festgelegt ist. Dies wird in einem Annotation-Element mit dem Term Attributwert von Org.OData.Core.V1.Computedangegeben.

Jede Eigenschaft kann auch Beschränkungen haben, ob sie aktualisiert wird. Dies wird in einem Annotation-Element mit dem Term Attributwert von Org.OData.Core.V1.Permissionsangegeben. Die einzige Option dafür ist Org.OData.Core.V1.PermissionType/Read, der angibt, dass die Eigenschaft schreibgeschützt ist.

Primitive Typen

OData unterstützt eine Vielzahl von Datentypen, jedoch nicht alle Microsoft Dynamics 365 werden verwendet. Die folgende Tabelle enthält eine Beschreibung, wie Dynamics 365 Organisationsservicetypen zu OData primitiven Typen zugeordnet werden.

Organisationsservicetype

Web API Typ

Beschreibung

BigInt

Edm.Int64

64-Bit-Ganzzahl

Boolean

Boolesch

Binärdbewertete Logik

CalendarRules

Einzelwertige Navigationseigenschaften

Bestimmte einzelwertige Navigationseigenschaften zu calendarrule EntityType.

Kunde

Einzelwertige Navigationseigenschaften

Der Kunde einer Entität mit dem Typ der Eigenschaft kann eine einzelwertige Navigationseigenschaft sein, die entweder in account oder contact Entitätstyp mithilfe der entsprechenden einzelwertigen Navigationseigenschaften festgelegt ist. Wenn eine der einzelwertigen entsprechenden Sammlungseigenschaften festgelegt ist, wird die andere gelöscht.

DateTime

Edm.DateTimeOffset

Datum und Uhrzeit in einem Zeitzonenoffset, ohne Schaltsekunden
. Es gibt keinen Daten-Zeit-Typ in OData.

Decimal

Edm.Decimal

Numerische Werte mit fester Genauigkeit und Skala

Doppelt

Edm.Double

IEEE 754 binary64 Gleitkommazahl (15-17 Dezimalstellen)

EntityName

Edm.String

Reihenfolge von UTF-8-Zeichen

Bild

Edm.Binary

Binärdaten

Ganze Zahl

Edm.Int32

32-Bit-Ganzzahl

Suchfeld

einzelwertige Navigationseigenschaften

Ein Verweis auf eine bestimmte Entität

ManagedProperty

Nicht verfügbar

Nur zur internen Verwendung.

Memo

Edm.String

Reihenfolge von UTF-8-Zeichen

Money

Edm.Decimal

Numerische Werte mit fester Genauigkeit und Skala

Besitzer

einzelwertige Navigationseigenschaften

Ein Verweis auf principal EntityType.systemuser und team Entitättypen erben ihre ownerid Eigenschaft vom prinicipal Entitättyp.

PartyList

Sammlung-bewertete Navigationseigenschaft zum activityparty Entitätstyp.

Die activitypartyparticipationtypemask Eigenschaft enthält einen Wert, um die Rolle des Teilnehmers anzuzeigen. Weitere Informationen finden Sie unter Aktivitätsparteitypen.

Bei Auswahllistenattributen ist keine Texteingabe möglich.

Edm.Int32

32-Bit-Ganzzahl

Status

Edm.Int32

32-Bit-Ganzzahl

Status

Edm.Int32

32-Bit-Ganzzahl

Zeichenfolge

Edm.String

Reihenfolge von UTF-8-Zeichen

Uniqueidentifier

Edm.Guid

eindeutiger Bezeichner des 16-Bytes (128-Bit)

Such-Eigenschaften

Für die meisten einzelwertigen Navigationseigenschaften finden Sie eine berechnete, schreibgeschützte Eigenschaft, die die folgende Namenskonvention verwendet: _<name>_value wo <name> dem Namen der einzelwertigen Navigationseigenschaft entspricht. Ausnahmen zu diesem Muster bildet ein Suchattribut einer Entität, das mehrere Typen von Entitätsverweisen annehmen kann. Ein allgemeines Beispiel dafür ist dasincidentcustomeridEntitätsattribut, das als Referenz gesetzt werden kann und entweder eine contact oder account Entität ist. Im incident EntityTypeSingle-valued navigation properties finden Sie unter customerid_account und customerid_contact als separate einzelwertige Navigationseigenschaften, um den Kunden zu berücksichtigen, die der Verkaufschance zugeordnet ist. Wenn diese einzelwertige Navigationseigenschaften festgelegt ist, wird die andere auf Null gesetzt, weil sie an das customerid-Attribut gebunden sind. Im incident EntityTypeProperties finden Sie eine _customerid_value Sucheneigenschaft, die denselben Wert enthält, der für die einzelwertigen Navigationseigenschaften festgelegt ist, die einen Wert enthält.

Im Allgemeinen sollten Sie keine Sucheigenschaften verwenden und stattdessen die entsprechenden einzelwertigen Navigationseigenschaften verwenden. Diese Eigenschaften sind eingeschlossen, weil sie möglicherweise für bestimmte Integrationsszenarien hilfreich sein können. Diese Eigenschaften sind schreibgeschützt und berechnet, weil sie einfach die Änderungen wiedergeben, die mithilfe der entsprechenden einzelwertigen Navigationseigenschaft angewendet werden.

Wenn Sie Sucheneigenschaften in einer Abfrage mit einschließen, können Sie verlangen, dass Anmerkungen, die zusätzliche Informationen zu den Daten enthalten, eingeschlossen werden und für diese zugrunde liegenden Attribute, die nicht von einer einzelwertige Navigationseigenschaft vertreten werden, angezeigt werden.Weitere Informationen:Abrufen von Daten zu Sucheigenschaften

In OData erlauben Navigationseigenschaften, dass Sie auf Daten zugreifen können, die sich auf die aktuelle Entität beziehen. Wenn Sie eine Entität abrufen, können Sie festlegen, das Navigationseigenschaften zu erweitern, um die zugehörigen Daten einzuschliessen. Es gibt zwei Arten von Navigationseigenschaften: einzelwertige und sammlungswertige.

Einzelwertige Navigationseigenschaften

Diese Einzelwertigen Navigationseigenschaften entsprechen Suchattributen, die viel-zu-ein-Beziehungen unterstützen und eine Referenz auf eine andere Entität einstellen dürfen. Im CSDL EntityType-Element werden diese als NavigationProperty-Element mit einem Type Attributsatz definiert, das als einzelnen Typ festgelegt ist. Nachfolgend finden Sie ein Beispiel der account EntityTypecreatedby einzelwertigen Navigationseigenschaft in CSDL:

<NavigationProperty Name="createdby" Type="mscrm.systemuser" Nullable="false" Partner="lk_accountbase_createdby">
 <ReferentialConstraint Property="_createdby_value" ReferencedProperty="systemuserid" />
</NavigationProperty>

Jede Navigationseigenschaft, die eine einzewertige Navigationseigenschaft darstellt, hat eine entsprechende sammlungswertige Navigationseigenschaft, die vomPartner Attributswert angegeben ist. Jede einzelwertige Navigationseigenschaft ist auch ein ReferentialConstraint-Element mit Property Attributwert, der die berechnete, schreibgeschützte Sucheneigenschaft darstellt, die verwendet werden kann, um entsprechende GUID-Wert der verknüpften Entität abzurufen.Weitere Informationen:Such-Eigenschaften

Gemeinsam bewertete Navigationseigenschaften

Diese Eigenschaften entsprechen ein-zu-vielen oder viel-zu-vielen Verhältnissen. Im CSDL EntityType-Element werden diese als NavigationProperty-Element mit einem Type Attributsatz definiert, das als einzelnen Typ festgelegt ist. Im Folgenden wird die account EntityTypeAccount_Tasks sammlungswertige Navigationseigenschaft dargestellt, die eine ein-zu-vielen Beziehung darstellt.

<NavigationProperty Name="Account_Tasks" Type="Collection(mscrm.task)" Partner="regardingobjectid_account_task" />

Wenn die sammlungswertige Navigationseigenschaft eine n: n-Beziehung darstellt, sind der Name der Navigationseigenschaft und der Name des Partners identisch. Im Folgenden wird die account EntityTypeaccountleads_association sammlungswertige Navigationseigenschaft dargestellt, die eine n:n-Beziehung darstellt.

<NavigationProperty Name="accountleads_association" Type="Collection(mscrm.lead)" Partner="accountleads_association" />

Der Unterschied zwischen 1:n- und n:n-Beziehungen ist wichtig, wenn Web API verwendet wird. Die Art, wie Sie Entitäten zuordnen, ist immmer gleich, unabhängig vom Typ der Beziehung. Die n: n-Beziehungen verwenden weiterhin überschneidende Entitäten im Hintergrund, nur einige spezielle Systgementitäten sind imWeb API EntityType Reference enthalten. Beispielsweise ist campaignactivityitem EntityType technisch eine überschneidende Entität, aber ist eingeschlossen, weil sie mehr Eigenschaften hat als eine gewöhnliche überschneidende Entität.

Ein normale überschneidene Entität hat nur die folgenden vier grundlegenden Eigenschaften, um n: n-Beziehung zu verwalten. Wenn Sie eine angepasste n: n-Beziehung zwischen Entitäten erstellen, wird eine normale überschneidende Entität erstellt, um die Beziehung zu unterstützen. Da Sie Navigationseigenschaften verwenden sollen, um Vorgänge auszuführen, die n: n-Beziehungen einbeziehen, sind normale überschneidende Entitäten nicht vollständig dokumentiert können aber weiterhin mithilfe vom Web API zur verfügung stehen. Auf diese überschneidenden Entitätstypen kann über einen festgelegten Entitätsnamen zugegriffen werden, der folgende Namenskonvention verwendet: <intersect entity logical name>" + 'collection'. Beispielsweise können Sie Informationen vom contactleads überschneidenden Entitätstyp mithilfe von [Organisations-URI]/api/data/v8.2/contactleadscollection abrufen. Sie sollten diese normalen überschneidenden Entitäten nur verwenden, wenn Sie Änderungen nachverfolgen möchten.

Aktionen

Aktionen sind Vorgänge, die Nebenwirkungen, wie Datenänderung zulassen und nicht weiter zusammengesetzt werden können, um ein nicht deterministisches Verhalten zu vermeiden.

Das Web API Action Reference Thema enthält jede der verfügbaren Systemmaßnahmen.Weitere Informationen:Nutzen von Web-API-Aktionen.

Funktionen

Funktionen sind Vorgänge, die keine Nebenwirkungen aufweisen und weitere Zusammensetzung unterstützen können, beispielsweise zusätzliche Filtervorgänge, Funktionen oder eine Aktion.

Es gibt zwei Arten von Funktionen im Web API:

Weitere Informationen:Nutzen von Web-API-Funktionen

Komplexe Typen

Komplexe Typen sind schlüssellose benannte strukturierte Typen, die einen Satz von Eigenschaften enthalten. Komplexe Typen werden als Eigenschaftswerte in Modelentitäten oder als Parameter oder Rückgabewerte für Vorgänge verwendet.

Web API ComplexType Reference enthält alle systemkomplexen Typen.Komplexe Typen sind schlüssellose benannte strukturierte Typen, die einen Satz von Eigenschaften enthalten. Sie werden allgemein als Eigenschaftswerte in Modelentitäten oder als Parameter oder Rückgabewerte für Vorgänge verwendet. Nachfolgend finden Sie die WhoAmIResponse ComplexType der CSDL.

<ComplexType Name="WhoAmIResponse">
  <Property Name="BusinessUnitId" Type="Edm.Guid" Nullable="false" />
  <Property Name="UserId" Type="Edm.Guid" Nullable="false" />
  <Property Name="OrganizationId" Type="Edm.Guid" Nullable="false" />
</ComplexType>

Enumerationstypen

Enumerationstypen oder EnumTypen weden primitive Typen genannt, deren Werte Konstanten mit zugrunde liegenden ganzzahligen Werten benannt sind.

Web API EnumType Reference enthält alle Enumerationstypen.Enumerationstypen nennt man primitive Typen, deren Werte Konstanten mit zugrunde liegenden ganzzahligen Werten lauten. Nachfolgend finden Sie die AccessRights EnumType der CSDL.

<EnumType Name="AccessRights">
  <Member Name="None" Value="0" />
  <Member Name="ReadAccess" Value="1" />
  <Member Name="WriteAccess" Value="2" />
  <Member Name="AppendAccess" Value="4" />
  <Member Name="AppendToAccess" Value="16" />
  <Member Name="CreateAccess" Value="32" />
  <Member Name="DeleteAccess" Value="65536" />
  <Member Name="ShareAccess" Value="262144" />
  <Member Name="AssignAccess" Value="524288" />
</EnumType>

Siehe auch

Verwenden der Microsoft Dynamics 365-Web-API
Authentifizieren von Microsoft Dynamics 365 mit der Web-API
Vorgänge mithilfe der Web-API ausführen

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright