Partager via

Exemple d’opérations de base de l’API web

Cette collection d’exemples d’extraits de code montre comment effectuer des opérations CRUD de base (créer, récupérer, mettre à jour et supprimer) et associatifs à l’aide de l’API web Microsoft Dataverse. Ces versions spécifiques au langage implémentent les mêmes opérations :

Cet article décrit un ensemble commun d’opérations que chaque exemple d’extrait de code de ce groupe implémente. Il décrit les requêtes et réponses HTTP, ainsi que la sortie de texte que chaque exemple effectue sans les détails propres à la langue. Pour plus d’informations sur la façon dont ces opérations sont effectuées, consultez les descriptions spécifiques à la langue et les exemples individuels.

Montre ce qui suit

Cet exemple est divisé en sections suivantes. Chaque section contient des opérations d’API Web Dataverse décrites plus en détail dans les articles conceptuels associés spécifiés.

Section Code Articles conceptuels associés
Section 1 : Opérations de création et de mise à jour de base Création de base
Mise à jour de base
Section 2 : Créer avec association Associer des lignes de table lors de la création
Section 3 : Créer des lignes de tableau associées (insertion profonde) Créer des lignes de table associées en une seule opération
Section 4 : Associer et dissocier des lignes de table existantes Associer et dissocier des lignes de tables à l’aide de l’API Web
Section 5 : Supprimer des lignes de tableau (nettoyage d’échantillon) Suppression de base

Note

Par souci de concision, l’exemple omet moins les en-têtes HTTP pertinents. Les URL des enregistrements du tableau varient en fonction de l’adresse de l’organisation de base et de l’ID de la ligne attribué par votre serveur Dataverse.

Section 1 : Opérations de création et de mise à jour de base

Cette section crée un contact unique, puis effectue une série de mises à jour sur cette instance. L’en-tête de réponse OData-EntityId contient l’URL de cette ligne créée récemment, qui comprend entre parenthèses l’ID unique de cet enregistrement.

  1. Créez un contact, appelé Rafel Shillo.

    Requête :

    POST [Organization Uri]/api/data/v9.2/contacts HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

{
 "firstname": "Rafel",
 "lastname": "Shillo"
}

    Réponse :

    HTTP/1.1 204 NoContent
OData-Version: 4.0
OData-EntityId: [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)

    Sortie de la console :

    Contact URI: [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)
Contact relative Uri: contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)

    Les propriétés disponibles pour chaque type sont définies dans le document des métadonnées et sont également documentées pour chaque type dans la section Web API Entity Type Reference. Pour obtenir des informations générales, voir Types d’opérations de l’API Web.

  2. Mettez le contact à jour avec les valeurs du chiffre d’affaires annuel (80 000 USD) et la fonction (Développeur junior).

    Requête :

    PATCH [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee) HTTP/1.1
If-Match: *
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

{
 "annualincome": 80000,
 "jobtitle": "Junior Developer"
}

    Réponse :

    HTTP/1.1 204 NoContent
OData-Version: 4.0
OData-EntityId: [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)

    Sortie de la console :

    Contact 'Rafel Shillo' updated with jobtitle and annual income

  3. Récupérez le contact avec son ensemble de propriétés explicitement initialisées. La fullname est une propriété en lecture seule calculée à partir des propriétés firstname et lastname, que vous avez explicitement initialisées lors de la création de l’instance. En revanche, la propriété description n’a pas été explicitement initialisée, elle conserve sa valeur par défaut, une chaîne null.

    En plus des valeurs demandées et des en-têtes courants, la réponse renvoie également automatiquement les types suivants d’informations supplémentaires :

    • L’ID principal du type de table actuel, ici contactid.
    • Une valeur ETag, dénotée par la clé de @odata.etag, qui identifie la version spécifique de la ressource demandée. Pour plus d’informations, voir Effectuer les opérations conditionnelles à l’aide de l’API Web.
    • Le contexte des métadonnées, désigné par la clé @odata.context, permet de comparer les résultats des requêtes afin de déterminer s’ils provenaient de la même requête.
    • Une _transactioncurrencyid_value qui indique la devise société de la transaction monétaire.

    Requête :

    GET [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)?$select=fullname,annualincome,jobtitle,description HTTP/1.1
Prefer: odata.include-annotations="*"
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

    Réponse :

    HTTP/1.1 200 OK
ETag: W/"72935648"
OData-Version: 4.0
Preference-Applied: odata.include-annotations="*"

{
 "@odata.context": "[Organization Uri]/api/data/v9.2/$metadata#contacts(fullname,annualincome,jobtitle,description)/$entity",
 "@odata.etag": "W/\"72935648\"",
 "fullname": "Rafel Shillo",
 "annualincome@OData.Community.Display.V1.FormattedValue": "$80,000.00",
 "annualincome": 80000.0,
 "jobtitle": "Junior Developer",
 "description": null,
 "_transactioncurrencyid_value@OData.Community.Display.V1.FormattedValue": "US Dollar",
 "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.associatednavigationproperty": "transactioncurrencyid",
 "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.lookuplogicalname": "transactioncurrency",
 "_transactioncurrencyid_value": "228f42f8-e646-e111-8eb7-78e7d162ced1",
 "contactid": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee"
}

    Sortie de la console :

    Contact 'Rafel Shillo' retrieved:
       Annual income: $80,000.00
       Job title: Junior Developer
       Description:

    Important

    Utilisez toujours la sélection et le filtrage dans les opérations de récupération pour optimiser les performances. Pour plus d’informations, voir Interroger les données à l’aide de l’API Web.

  4. Mettez à jour l’instance de contact en fournissant de nouvelles valeurs à ces mêmes propriétés.

    Requête :

    PATCH [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee) HTTP/1.1
If-Match: *
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

{
 "jobtitle": "Senior Developer",
 "annualincome": 95000,
 "description": "Assignment to-be-determined"
}

    Réponse :

    HTTP/1.1 204 NoContent
OData-Version: 4.0
OData-EntityId: [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)

    Sortie de la console :

    Contact 'Rafel Shillo' updated:
       Job title: Senior Developer
       Annual income: 95000
       Description: Assignment to-be-determined

    Important

    Envoyez uniquement les propriétés modifiées dans les demandes de mise à jour. Pour plus d’informations, voir Mise à jour de base.

  5. Définissez explicitement une propriété unique, le numéro de téléphone principal. Cet exemple utilise une PUT requête et la clé JSON nommée value lors de l’exécution d’opérations sur des propriétés individuelles.

    Requête :

    PUT [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)/telephone1 HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

{
 "value": "555-0105"
}

    Réponse :

    HTTP/1.1 204 NoContent
OData-Version: 4.0

    Sortie de la console :

    Contact 'Rafel Shillo' phone number updated.

  6. Récupérez la même propriété unique, le numéro de téléphone principal. Là encore, utilisez la clé nommée value.

    Requête :

    GET [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)/telephone1 HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

    Réponse :

    HTTP/1.1 200 OK
OData-Version: 4.0

{
 "@odata.context": "[Organization Uri]/api/data/v9.2/$metadata#contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)/telephone1",
 "value": "555-0105"
}

    Sortie de la console :

    Contact's telephone # is: 555-0105.

Section 2 : Créer avec association

Cette section crée un enregistrement de compte nommé Contoso, Ltd. et l’associe à un contact existant, Rafel Shilloque vous avez créé dans la section 1. Vous effectuez cette création et cette association dans une seule opération POST.

  1. Créez le compte Contoso, Ltd. et définissez son attribut de contact principal sur le contact existant Rafel Shillo. L’annotation @odata.bind indique que vous créez une association. Dans ce cas, il lie la primarycontactid propriété de navigation à valeur unique à un contact existant, Rafel Shillo.

    Requête :

    POST [Organization Uri]/api/data/v9.2/accounts HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

{
 "name": "Contoso Ltd",
 "telephone1": "555-5555",
 "primarycontactid@odata.bind": "contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)"
}

    Réponse :

    HTTP/1.1 204 NoContent
OData-Version: 4.0
OData-EntityId: [Organization Uri]/api/data/v9.2/accounts(11bb11bb-cc22-dd33-ee44-55ff55ff55ff)

    Sortie de la console :

    Account 'Contoso Ltd' created.
Account URI: accounts(11bb11bb-cc22-dd33-ee44-55ff55ff55ff)

  2. Récupérez le contact principal pour le compte Contoso, Ltd. De nouveau, utilisez $expand à l'aide de la propriété primarycontactid de navigation à valeur unique afin d'accéder à l’enregistrement EntityType de contact associé.

    Requête :

    GET [Organization Uri]/api/data/v9.2/accounts(11bb11bb-cc22-dd33-ee44-55ff55ff55ff)?$select=name,&$expand=primarycontactid($select=fullname,jobtitle,annualincome) HTTP/1.1
Prefer: odata.include-annotations="*"
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

    Réponse :

    HTTP/1.1 200 OK
ETag: W/"72935670"
OData-Version: 4.0
Preference-Applied: odata.include-annotations="*"

{
 "@odata.context": "[Organization Uri]/api/data/v9.2/$metadata#accounts(name,primarycontactid(fullname,jobtitle,annualincome))/$entity",
 "@odata.etag": "W/\"72935670\"",
 "name": "Contoso Ltd",
 "accountid": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff",
 "primarycontactid": {
   "@odata.etag": "W/\"72935663\"",
   "fullname": "Rafel Shillo",
   "jobtitle": "Senior Developer",
   "annualincome@OData.Community.Display.V1.FormattedValue": "$95,000.00",
   "annualincome": 95000.0,
   "_transactioncurrencyid_value@OData.Community.Display.V1.FormattedValue": "US Dollar",
   "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.associatednavigationproperty": "transactioncurrencyid",
   "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.lookuplogicalname": "transactioncurrency",
   "_transactioncurrencyid_value": "228f42f8-e646-e111-8eb7-78e7d162ced1",
   "contactid": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee"
 }
}

    Sortie de la console :

    Account 'Contoso Ltd' has primary contact 'Rafel Shillo':
       Job title: Senior Developer
       Annual income: $95,000.00

Cette section montre comment créer une ligne de table et une ligne associée dans une requête POST unique. Lorsque vous utilisez cette méthode, vous créez toutes les lignes de nouveau, vous ne les associez pas aux lignes existantes. Cette approche a deux avantages. Il est plus efficace, car il remplace plusieurs opérations de création et d’association plus simples par une opération combinée. En outre, il est atomique, donc l’opération entière réussit et tous les objets associés sont créés, ou l’opération échoue et aucun n’est créé.

Cette section crée un compte, son contact principal, et un ensemble de tâches pour ce contact en une requête.

  1. Créez le compte Fourth Coffee et son contact principal Susie Curtis et ses trois tâches associées en une opération. Notez l’utilisation de la propriété à valeur unique primarycontactid et la propriété de navigation à valeur de collection Contact_Tasks pour définir cette relation, respectivement. Les propriétés de navigation à valeur unique prennent la valeur d’un objet, alors que les propriétés de navigation à valeur de collection prennent la valeur d’un tableau.

    Requête :

    POST [Organization Uri]/api/data/v9.2/accounts HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

{
 "name": "Fourth Coffee",
 "primarycontactid": {
   "firstname": "Susie",
   "lastname": "Curtis",
   "jobtitle": "Coffee Master",
   "annualincome": 48000,
   "Contact_Tasks": [
     {
       "subject": "Sign invoice",
       "description": "Invoice #12321",
       "scheduledstart": "2023-04-19T03:00:00+07:00",
       "scheduledend": "2023-04-19T04:00:00+07:00",
       "scheduleddurationminutes": 60
     },
     {
       "subject": "Setup new display",
       "description": "Theme is - Spring is in the air",
       "scheduledstart": "2023-04-20T03:00:00+07:00",
       "scheduledend": "2023-04-20T04:00:00+07:00",
       "scheduleddurationminutes": 60
     },
     {
       "subject": "Conduct training",
       "description": "Train team on making our new blended coffee",
       "scheduledstart": "2023-04-21T03:00:00+07:00",
       "scheduledend": "2023-04-21T04:00:00+07:00",
       "scheduleddurationminutes": 60
     }
   ]
 }
}

    Réponse :

    HTTP/1.1 204 NoContent
OData-Version: 4.0
OData-EntityId: [Organization Uri]/api/data/v9.2/accounts(22cc22cc-dd33-ee44-ff55-66aa66aa66aa)

    Sortie de la console :

    Account 'Fourth Coffee  created.

  2. Récupérez de manière sélective le compte nouvellement créé Fourth Coffee et son contact principal. Une extension est exécutée sur la propriété de navigation à valeur unique primarycontactid.

    Requête :

    GET [Organization Uri]/api/data/v9.2/accounts(22cc22cc-dd33-ee44-ff55-66aa66aa66aa)?$select=name&$expand=primarycontactid($select=fullname,jobtitle,annualincome) HTTP/1.1
Prefer: odata.include-annotations="*"
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

    Réponse :

    HTTP/1.1 200 OK
ETag: W/"72935710"
OData-Version: 4.0
Preference-Applied: odata.include-annotations="*"

{
 "@odata.context": "[Organization Uri]/api/data/v9.2/$metadata#accounts(name,primarycontactid(fullname,jobtitle,annualincome))/$entity",
 "@odata.etag": "W/\"72935710\"",
 "name": "Fourth Coffee",
 "accountid": "22cc22cc-dd33-ee44-ff55-66aa66aa66aa",
 "primarycontactid": {
   "@odata.etag": "W/\"72935689\"",
   "fullname": "Susie Curtis",
   "jobtitle": "Coffee Master",
   "annualincome@OData.Community.Display.V1.FormattedValue": "$48,000.00",
   "annualincome": 48000.0,
   "_transactioncurrencyid_value@OData.Community.Display.V1.FormattedValue": "US Dollar",
   "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.associatednavigationproperty": "transactioncurrencyid",
   "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.lookuplogicalname": "transactioncurrency",
   "_transactioncurrencyid_value": "228f42f8-e646-e111-8eb7-78e7d162ced1",
   "contactid": "2f28bcb4-bb27-ed11-9db1-002248274ada"
 }
}

    Sortie de la console :

    Account 'Fourth Coffee' has primary contact 'Susie Curtis':
       Job title: Coffee Master
       Annual income: $48,000.00

  3. Extrayez de manière sélective les tâches associées au contact principal récupéré dans l’opération précédente. Une extension est exécutée sur la propriété de navigation à valeur de collection Contact_Tasks.

    Requête :

    GET [Organization Uri]/api/data/v9.2/contacts(2f28bcb4-bb27-ed11-9db1-002248274ada)?$select=fullname&$expand=Contact_Tasks($select=subject,description,scheduledstart,scheduledend) HTTP/1.1
Prefer: odata.include-annotations="*"
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

    Réponse :

    HTTP/1.1 200 OK
ETag: W/"72935689"
OData-Version: 4.0
Preference-Applied: odata.include-annotations="*"

{
 "@odata.context": "[Organization Uri]/api/data/v9.2/$metadata#contacts(fullname,Contact_Tasks(subject,description,scheduledstart,scheduledend))/$entity",
 "@odata.etag": "W/\"72935689\"",
 "fullname": "Susie Curtis",
 "contactid": "2f28bcb4-bb27-ed11-9db1-002248274ada",
 "Contact_Tasks": [
   {
     "@odata.etag": "W/\"72935719\"",
     "subject": "Sign invoice",
     "description": "Invoice #12321",
     "scheduledstart@OData.Community.Display.V1.FormattedValue": "4/18/2023 1:00 PM",
     "scheduledstart": "2023-04-18T20:00:00Z",
     "scheduledend@OData.Community.Display.V1.FormattedValue": "4/18/2023 2:00 PM",
     "scheduledend": "2023-04-18T21:00:00Z",
     "activityid": "3028bcb4-bb27-ed11-9db1-002248274ada"
   },
   {
     "@odata.etag": "W/\"72935723\"",
     "subject": "Setup new display",
     "description": "Theme is - Spring is in the air",
     "scheduledstart@OData.Community.Display.V1.FormattedValue": "4/19/2023 1:00 PM",
     "scheduledstart": "2023-04-19T20:00:00Z",
     "scheduledend@OData.Community.Display.V1.FormattedValue": "4/19/2023 2:00 PM",
     "scheduledend": "2023-04-19T21:00:00Z",
     "activityid": "3128bcb4-bb27-ed11-9db1-002248274ada"
   },
   {
     "@odata.etag": "W/\"72935727\"",
     "subject": "Conduct training",
     "description": "Train team on making our new blended coffee",
     "scheduledstart@OData.Community.Display.V1.FormattedValue": "4/20/2023 1:00 PM",
     "scheduledstart": "2023-04-20T20:00:00Z",
     "scheduledend@OData.Community.Display.V1.FormattedValue": "4/20/2023 2:00 PM",
     "scheduledend": "2023-04-20T21:00:00Z",
     "activityid": "3228bcb4-bb27-ed11-9db1-002248274ada"
   }
 ]
}

    Sortie de la console :

    Contact 'Susie Curtis' has the following assigned tasks:
Subject: Sign invoice,
       Description: Invoice #12321
       Start: 4/18/2023 1:00 PM
       End: 4/18/2023 2:00 PM

Subject: Setup new display,
       Description: Theme is - Spring is in the air
       Start: 4/19/2023 1:00 PM
       End: 4/19/2023 2:00 PM

Subject: Conduct training,
       Description: Train team on making our new blended coffee
       Start: 4/20/2023 1:00 PM
       End: 4/20/2023 2:00 PM

Section 4 : Associer et dissocier des entités existantes

Cette section montre comment associer et dissocier les lignes de table existantes. Pour former une association, utilisez un URI de référence et un objet de relation, puis envoyez-les dans une requête POST. Pour dissocier, envoyez une requête DELETE à l’URI de référence de cette association. Tout d’abord, créez une association un-à-plusieurs entre un contact et un compte. Puis créez une association plusieurs à plusieurs entre un concurrent et une ou plusieurs opportunités.

  1. Ajoutez Rafel Shillo en tant que contact du compte Fourth Coffee à l’aide de la propriété de navigation à valeur de collection contact_customer_accounts. Notez l’utilisation d’une clé spéciale @odata.id pour spécifier l’enregistrement associé.

    Requête :

    POST [Organization Uri]/api/data/v9.2/accounts(22cc22cc-dd33-ee44-ff55-66aa66aa66aa)/contact_customer_accounts/$ref HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

{
 "@odata.id": "[Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)"
}

    Réponse :

    HTTP/1.1 204 NoContent
OData-Version: 4.0

  2. Confirmez l’opération précédente en récupérant la collection de contacts pour le compte Fourth Coffee. La réponse contient le tableau avec un élément unique, le contact récemment affecté Rafel Shillo.

    Requête :

    GET [Organization Uri]/api/data/v9.2/accounts(22cc22cc-dd33-ee44-ff55-66aa66aa66aa)/contact_customer_accounts?$select=fullname,jobtitle HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

    Réponse :

    HTTP/1.1 200 OK
OData-Version: 4.0

{
 "@odata.context": "[Organization Uri]/api/data/v9.2/$metadata#contacts(fullname,jobtitle)",
 "value": [
   {
     "@odata.etag": "W/\"72935741\"",
     "fullname": "Rafel Shillo",
     "jobtitle": "Senior Developer",
     "contactid": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee"
   }
 ]
}

    Sortie de la console :

    Contact list for account 'Fourth Coffee':
       Name: Rafel Shillo, Job title: Senior Developer

  3. Supprimez l’association que vous avez créée entre le compte Fourth Coffee et contactez Rafel Shillo.

    Requête :

    DELETE [Organization Uri]/api/data/v9.2/accounts(22cc22cc-dd33-ee44-ff55-66aa66aa66aa)/contact_customer_accounts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)/$ref HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

    Réponse :

    HTTP/1.1 204 NoContent
OData-Version: 4.0

  4. Créez un rôle de sécurité intitulé Example Security Role.

    Requête :

    POST [Organization Uri]/api/data/v9.2/roles HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

{
 "businessunitid@odata.bind": "businessunits(38e0dbe4-131b-e111-ba7e-78e7d1620f5e)",
 "name": "Example Security Role"
}

    Réponse :

    HTTP/1.1 204 NoContent
OData-Version: 4.0
OData-EntityId: [Organization Uri]/api/data/v9.2/roles(33dd33dd-ee44-ff55-aa66-77bb77bb77bb)

  5. Associez le nouveau rôle de sécurité à votre enregistrement systemuser.

    Requête :

    POST [Organization Uri]/api/data/v9.2/systemusers(4026be43-6b69-e111-8f65-78e7d1620f5e)/systemuserroles_association/$ref HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

{
 "@odata.id": "[Organization Uri]/api/data/v9.2/roles(33dd33dd-ee44-ff55-aa66-77bb77bb77bb)"
}

    Réponse :

    HTTP/1.1 204 NoContent
OData-Version: 4.0

    Sortie de la console :

    Security Role 'Example Security Role' associated with to your user account.

  6. Récupérez l’exemple de rôle de sécurité à l’aide de la systemuserroles_association relation plusieurs-à-plusieurs :

    Requête :

    GET [Organization Uri]/api/data/v9.2/systemusers(4026be43-6b69-e111-8f65-78e7d1620f5e)/systemuserroles_association?$select=name&$filter=roleid%20eq%20e359feba-bb27-ed11-9db1-002248274ada HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

    Réponse :

    HTTP/1.1 200 OK
OData-Version: 4.0

{
 "@odata.context": "[Organization Uri]/api/data/v9.2/$metadata#roles(name)",
 "value": [
   {
     "@odata.etag": "W/\"72935763\"",
     "name": "Example Security Role",
     "roleid": "33dd33dd-ee44-ff55-aa66-77bb77bb77bb"
   }
 ]
}

    Sortie de la console :

    Retrieved role: Example Security Role

  7. Dissociez le rôle de sécurité de votre enregistrement utilisateur. Cette étape utilise la même syntaxe générale que la suppression d’une association un-à-plusieurs.

    Requête :

    DELETE [Organization Uri]/api/data/v9.2/systemusers(4026be43-6b69-e111-8f65-78e7d1620f5e)/systemuserroles_association(33dd33dd-ee44-ff55-aa66-77bb77bb77bb)/$ref HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

    Réponse :

    HTTP/1.1 204 NoContent
OData-Version: 4.0

Section 5 : Supprimer des lignes de tableau

  1. Supprimez chaque élément de la collection d’URL de ligne. Le premier élément est un enregistrement de contact pour Rafel Shillo.

    Requête :

    DELETE [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee) HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

    Réponse :

    HTTP/1.1 204 NoContent
OData-Version: 4.0

  2. Supprimez les enregistrements restants lors des itérations suivantes à travers la collection.

    Requête :

    DELETE [Organization Uri]/api/data/v9.2/accounts(11bb11bb-cc22-dd33-ee44-55ff55ff55ff) HTTP/1.1
. . .  

DELETE [Organization Uri]/api/data/v9.2/accounts(22cc22cc-dd33-ee44-ff55-66aa66aa66aa) HTTP/1.1 
. . .  

DELETE [Organization Uri]/api/data/v9.2/contacts(2f28bcb4-bb27-ed11-9db1-002248274ada) HTTP/1.1
. . .  

DELETE [Organization Uri]/api/data/v9.2/roles(33dd33dd-ee44-ff55-aa66-77bb77bb77bb) HTTP/1.1

Voir aussi

Utilisation de l'API Web Dataverse
Créer une ligne de table à l’aide de l’API Web
Récupérer une ligne de table à l’aide de l’API Web
Mettre à jour et supprimer des lignes de table à l’aide de l’API web
Associer et dissocier des lignes de tables à l’aide de l’API Web
Exemple d’opérations de base de l’API Web (C#)
Exemple d’opérations de base de l’API Web (PowerShell)
Exemple d′opérations de base de l′API Web (Javascript côté client)

  • Last updated on