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 des opérations associatives à l’aide de l’API Web Microsoft Dataverse.

Ce sujet décrit un ensemble commun d’opérations implémentées par chaque échantillon d’extrait de ce groupe. Ce sujet décrit les requêtes et réponses HTTP et la sortie de texte que chaque échantillon exécutera sans les détails spécifiques à la langue. Affichez les descriptions spécifiques à la langue et les exemples individuels pour plus d’informations sur la façon dont ces opérations sont effectuées.

Montre ce qui suit

Cet exemple est composé des principales sections suivantes, qui contiennent les opérations de données de requête de l’API Web Dataverse qui sont décrites plus en détail dans les rubriques conceptuelles associées spécifiées.

Section Code Rubriques conceptuelles associées
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

Notes

Par souci de concision, des en-têtes HTTP moins pertinents ont été omis. 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. Notez que l’en-tête de réponse OData-EntityId contient l’URL de cet ligne créé récemment, qui comprend entre parenthèses l’ID unique de cet enregistrement.

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

    Demande :

    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(0928bcb4-bb27-ed11-9db1-002248274ada)
    

    Sortie de la console :

    Contact URI: [Organization Uri]/api/data/v9.2/contacts(0928bcb4-bb27-ed11-9db1-002248274ada)
    Contact relative Uri: contacts(0928bcb4-bb27-ed11-9db1-002248274ada)
    

    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 de chiffre d’affaires annuel (80 000 USD) et la fonction (Développeur junior).

    Demande :

    PATCH [Organization Uri]/api/data/v9.2/contacts(0928bcb4-bb27-ed11-9db1-002248274ada) 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(0928bcb4-bb27-ed11-9db1-002248274ada)
    

    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. Le fullname est une propriété en lecture seule qui est calculée avec les propriétés firstname et lastname, qui ont été explicitement initialisées lorsque l’instance a été créée. En revanche, la propriété description n’a pas été explicitement lancée, elle conserve sa valeur par défaut, une chaîne null.

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

    • L’ID principal du type de table actuel, ici contactid.
    • Une valeur de l’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énoté 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 locale de la transaction monétaire.

    Demande :

    GET [Organization Uri]/api/data/v9.2/contacts(0928bcb4-bb27-ed11-9db1-002248274ada)?$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": "0928bcb4-bb27-ed11-9db1-002248274ada"
    }
    

    Sortie de la console :

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

    Important

    Vous devez toujours utiliser 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.

    Demande :

    PATCH [Organization Uri]/api/data/v9.2/contacts(0928bcb4-bb27-ed11-9db1-002248274ada) 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(0928bcb4-bb27-ed11-9db1-002248274ada)
    

    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. Notez qu’il s’agit d’une demande PUT et que la clé JSON appelée value est utilisée lors de l’exécution d’opérations sur différentes propriétés.

    Demande :

    PUT [Organization Uri]/api/data/v9.2/contacts(0928bcb4-bb27-ed11-9db1-002248274ada)/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. Notez de nouveau l’utilisation d’une clé nommée value.

    Demande :

    GET [Organization Uri]/api/data/v9.2/contacts(0928bcb4-bb27-ed11-9db1-002248274ada)/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(0928bcb4-bb27-ed11-9db1-002248274ada)/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 Shillo, qui a été créé à la Section 1. Cette création et cette association sont effectuées en 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 qu’une association est créée, associant ici la propriété de navigation à valeur unique primarycontactid à un contact existant, Rafel Shillo.

    Demande :

    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(0928bcb4-bb27-ed11-9db1-002248274ada)"
    }
    

    Réponse :

    HTTP/1.1 204 NoContent
    OData-Version: 4.0
    OData-EntityId: [Organization Uri]/api/data/v9.2/accounts(2728bcb4-bb27-ed11-9db1-002248274ada)
    

    Sortie de la console :

    Account 'Contoso Ltd' created.
    Account URI: accounts(2728bcb4-bb27-ed11-9db1-002248274ada)
    
  2. Récupérez le contact principal du compte Contoso, Ltd., de nouveau à l’aide de $expand avec la propriété de navigation à valeur unique primarycontactid pour accéder à l’enregistrement contact EntityType associé.

    Demande :

    GET [Organization Uri]/api/data/v9.2/accounts(2728bcb4-bb27-ed11-9db1-002248274ada)?$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": "2728bcb4-bb27-ed11-9db1-002248274ada",
     "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": "0928bcb4-bb27-ed11-9db1-002248274ada"
     }
    }
    

    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 seule requête POST. En utilisant cette méthode, toutes les lignes sont nouvellement créées ; il n’y a pas de lignes existantes à associer. Cette approche a deux avantages. Elle est plus efficace, en remplaçant plusieurs opérations de création et d’association plus simples par une opération combinée. En outre, elle est atomique, car soit l’opération entière aboutit et tous les objets associés sont créés, soit 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.

    Demande :

    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(2e28bcb4-bb27-ed11-9db1-002248274ada)
    

    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.

    Demande :

    GET [Organization Uri]/api/data/v9.2/accounts(2e28bcb4-bb27-ed11-9db1-002248274ada)?$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": "2e28bcb4-bb27-ed11-9db1-002248274ada",
     "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.

    Demande :

    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 des lignes de table existantes. Former une association nécessite l’utilisation d’une URI de référence et d’un objet de relation, qui sont ensuite envoyés dans une demande POST. Dissocier nécessite d’envoyer une demande DELETE à l’URI de référence pour cette association. Une association un-à-plusieurs est d’abord formée entre un contact et un compte. Puis une association plusieurs à plusieurs est formée 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é.

    Demande :

    POST [Organization Uri]/api/data/v9.2/accounts(2e28bcb4-bb27-ed11-9db1-002248274ada)/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(0928bcb4-bb27-ed11-9db1-002248274ada)"
    }
    

    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.

    Demande :

    GET [Organization Uri]/api/data/v9.2/accounts(2e28bcb4-bb27-ed11-9db1-002248274ada)/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": "0928bcb4-bb27-ed11-9db1-002248274ada"
       }
     ]
    }
    

    Sortie de la console :

    Contact list for account 'Fourth Coffee':
           Name: Rafel Shillo, Job title: Senior Developer  
    
  3. Supprimez l’association qui vient d’être créée entre le compte Fourth Coffee et le contact Rafel Shillo.

    Demande :

    DELETE [Organization Uri]/api/data/v9.2/accounts(2e28bcb4-bb27-ed11-9db1-002248274ada)/contact_customer_accounts(0928bcb4-bb27-ed11-9db1-002248274ada)/$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.

    Demande :

    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(e359feba-bb27-ed11-9db1-002248274ada)
    
  5. Associez le nouveau rôle de sécurité à votre enregistrement systemuser.

    Demande :

    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(e359feba-bb27-ed11-9db1-002248274ada)"
    }
    

    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 rôle de sécurité en utilisant la relation plusieurs à plusieurs systemuserroles_association :

    Demande :

    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": "e359feba-bb27-ed11-9db1-002248274ada"
       }
     ]
    }
    

    Sortie de la console :

    Retrieved role: Example Security Role
    
  7. Dissociez le rôle de sécurité de votre fiche utilisateur. Notez à nouveau, qu’il s’agit de la même syntaxe générale que pour supprimer une association un-à-plusieurs.

    Demande :

    DELETE [Organization Uri]/api/data/v9.2/systemusers(4026be43-6b69-e111-8f65-78e7d1620f5e)/systemuserroles_association(e359feba-bb27-ed11-9db1-002248274ada)/$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. Chaque élément de la collection d’URL de ligne est supprimé. Le premier est un enregistrement de contact pour Rafel Shillo.

    Demande :

    DELETE [Organization Uri]/api/data/v9.2/contacts(0928bcb4-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 204 NoContent
    OData-Version: 4.0
    
  2. Les itérations suivantes dans la collection suppriment les enregistrements restants.

    Demande :

    DELETE [Organization Uri]/api/data/v9.2/accounts(2728bcb4-bb27-ed11-9db1-002248274ada) HTTP/1.1
    . . .  
    
    DELETE [Organization Uri]/api/data/v9.2/accounts(2e28bcb4-bb27-ed11-9db1-002248274ada) 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(e359feba-bb27-ed11-9db1-002248274ada) 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#)

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).