Créer externalItem
Article
07/18/2022
3 minutes de lecture
3 contributeurs
Commentaires
Dans cet article
Espace de noms : microsoft.graph.externalConnectors
Créez un objet externalItem .
Autorisations
L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations .
Type d’autorisation
Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire)
ExternalItem.ReadWrite.OwnedBy, ExternalItem.ReadWrite.All
Déléguée (compte Microsoft personnel)
Non pris en charge
Application
ExternalItem.ReadWrite.OwnedBy, ExternalItem.ReadWrite.All
Requête HTTP
PUT /external/connections/{connection-id}/items/{item-id}
Nom
Description
Autorisation
Porteur {token}. Obligatoire.
Content-Type
application/json. Obligatoire.
Corps de la demande
Dans le corps de la demande, fournissez une représentation JSON de l’objet externalItem .
Vous pouvez spécifier les propriétés suivantes lors de la création d’un externalItem .
Les propriétés d’un externalItem élément doivent utiliser des spécificateurs de type dans la charge utile dans les scénarios suivants :
Pour String les propriétés de type, si la valeur contient des caractères non ASCII.
"description@odata.type": "String",
"description": "Kandierte Äpfel"
Pour tous les types de collections.
"categories@odata.type": "Collection(String)"
"categories": [
"red",
"blue"
]
Important
Lorsque vous incluez une propriété de type Collection(DateTime), vous devez utiliser le spécificateur Collection(DateTimeOffset)de type.
Réponse
Si elle réussit, cette méthode renvoie un code de réponse 200 OK.
Exemples
Exemple : Créer un élément personnalisé
Demande
PUT https://graph.microsoft.com/v1.0/external/connections/contosohr/items/TSP228082938
Content-type: application/json
{
"acl": [
{
"type": "user",
"value": "e811976d-83df-4cbd-8b9b-5215b18aa874",
"accessType": "grant"
},
{
"type": "externalGroup",
"value": "14m1b9c38qe647f6a",
"accessType": "deny"
}
],
"properties": {
"title": "Error in the payment gateway",
"priority": 1,
"assignee": "john@contoso.com"
},
"content": {
"value": "Error in payment gateway...",
"type": "text"
}
}
GraphServiceClient graphClient = new GraphServiceClient( authProvider );
var externalItem = new Microsoft.Graph.ExternalConnectors.ExternalItem
{
Acl = new List<Microsoft.Graph.ExternalConnectors.Acl>()
{
new Microsoft.Graph.ExternalConnectors.Acl
{
Type = Microsoft.Graph.ExternalConnectors.AclType.User,
Value = "e811976d-83df-4cbd-8b9b-5215b18aa874",
AccessType = Microsoft.Graph.ExternalConnectors.AccessType.Grant
},
new Microsoft.Graph.ExternalConnectors.Acl
{
Type = Microsoft.Graph.ExternalConnectors.AclType.ExternalGroup,
Value = "14m1b9c38qe647f6a",
AccessType = Microsoft.Graph.ExternalConnectors.AccessType.Deny
}
},
Properties = new Microsoft.Graph.ExternalConnectors.Properties
{
AdditionalData = new Dictionary<string, object>()
{
{"title", "Error in the payment gateway"},
{"priority", "1"},
{"assignee", "john@contoso.com"}
}
},
Content = new Microsoft.Graph.ExternalConnectors.ExternalItemContent
{
Value = "Error in payment gateway...",
Type = Microsoft.Graph.ExternalConnectors.ExternalItemContentType.Text
}
};
await graphClient.External.Connections["{externalConnectors.externalConnection-id}"].Items["{externalConnectors.externalItem-id}"]
.Request()
.PutAsync(externalItem);
Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK ) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK .
const options = {
authProvider,
};
const client = Client.init(options);
const externalItem = {
acl: [
{
type: 'user',
value: 'e811976d-83df-4cbd-8b9b-5215b18aa874',
accessType: 'grant'
},
{
type: 'externalGroup',
value: '14m1b9c38qe647f6a',
accessType: 'deny'
}
],
properties: {
title: 'Error in the payment gateway',
priority: 1,
assignee: 'john@contoso.com'
},
content: {
value: 'Error in payment gateway...',
type: 'text'
}
};
await client.api('/external/connections/contosohr/items/TSP228082938')
.put(externalItem);
Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK ) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK .
MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];
NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/external/connections/contosohr/items/TSP228082938"]]];
[urlRequest setHTTPMethod:@"PUT"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
MSGraphExternalConnectorsExternalItem *externalItem = [[MSGraphExternalConnectorsExternalItem alloc] init];
NSMutableArray *aclList = [[NSMutableArray alloc] init];
MSGraphExternalConnectorsAcl *acl = [[MSGraphExternalConnectorsAcl alloc] init];
[acl setType: [MSGraphExternalConnectorsAclType user]];
[acl setValue:@"e811976d-83df-4cbd-8b9b-5215b18aa874"];
[acl setAccessType: [MSGraphExternalConnectorsAccessType grant]];
[aclList addObject: acl];
MSGraphExternalConnectorsAcl *acl = [[MSGraphExternalConnectorsAcl alloc] init];
[acl setType: [MSGraphExternalConnectorsAclType externalGroup]];
[acl setValue:@"14m1b9c38qe647f6a"];
[acl setAccessType: [MSGraphExternalConnectorsAccessType deny]];
[aclList addObject: acl];
[externalItem setAcl:aclList];
MSGraphExternalConnectorsProperties *properties = [[MSGraphExternalConnectorsProperties alloc] init];
[properties setTitle:@"Error in the payment gateway"];
[properties setPriority: 1];
[properties setAssignee:@"john@contoso.com"];
[externalItem setProperties:properties];
MSGraphExternalConnectorsExternalItemContent *content = [[MSGraphExternalConnectorsExternalItemContent alloc] init];
[content setValue:@"Error in payment gateway..."];
[content setType: [MSGraphExternalConnectorsExternalItemContentType text]];
[externalItem setContent:content];
NSError *error;
NSData *externalItemData = [externalItem getSerializedDataWithError:&error];
[urlRequest setHTTPBody:externalItemData];
MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest
completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {
//Request Completed
}];
[meDataTask execute];
Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK ) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK .
//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)
requestBody := msgraphsdk.New()
requestBody.SetAdditionalData(map[string]interface{}{
"acl": []Object {
}
}
externalConnectionId := "externalConnection-id"
externalItemId := "externalItem-id"
graphClient.External().ConnectionsById(&externalConnectionId).ItemsById(&externalItemId).Put(requestBody)
Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK ) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK .
Réponse
Voici un exemple de réponse.
HTTP/1.1 200 OK