Créer une demande de classification de fichiers

Article
04/08/2023

Crée une demande pour classifier un ou plusieurs fichiers à l’aide d’un modèle formé de compréhension de document. (Pour plus d’informations, voir l’exemple.)

Le service REST de SharePoint Online (et SharePoint 2016 et versions ultérieures sur site) prend en charge la combinaison de plusieurs requêtes. Les demandes sont regroupées en un seul appel vers le service en utilisant l’option de requête OData $batch. Vous pouvez utiliser cette méthode pour placer en file d’attente des éléments de travail de classification pour des centaines de documents à la fois.

Requête HTTP

POST /_api/machinelearning/workItems HTTP/1.1

Paramètres d’URI

Aucun

En-têtes de demande

En-tête	Valeur
Accepter	application/json;odata=verbose
Content-Type	application/json;odata=verbose;charset=utf-8
x-requestdigest	Résumé approprié pour le site actuel

Corps de la demande

Nom	Type	Description
_métadonnées	chaîne	Définissez l’objet méta sur le SPO. Utilisez toujours la valeur : {"type": "Microsoft.Office.Server.ContentCenter.SPMachineLearningWorkItemEntityData"}.
TargetSiteId	guid	L’ID du site dans lequel se trouve le fichier à classifier. Cela peut être omis lorsque TargetSiteUrl a une valeur.
TargetSiteUrl	chaîne	L'URL complète du site où se trouve le fichier à classer. Cela peut être omis lorsque TargeSiteId a une valeur.
TargetWebId	guid	L’ID du web dans lequel se trouve le fichier à classifier. Cela peut être omis lorsque TargetWebServerRelativeUrl a une valeur.
TargetWebServerRelativeUrl	chaîne	L'URL relative du serveur du web où se trouve le fichier à classifier. Ceci peut être omis lorsque TargetWebId a une valeur.
TargetUniqueId	guid	ID du dossier à classer Cela peut être omis lorsque TargetServerRelativeUrl a une valeur.
TargetServerRelativeUrl	chaîne	L’URL relative du serveur du fichier à classer se trouve. Cela peut être omis lorsque TargetUniqueId a une valeur.

Réponses

Nom	Type	Description
201 est créé		La réponse est personnalisée. En cas d’échec, il peut toujours renvoyer 201 Created. L’appelant doit vérifier davantage le corps de la réponse pour déterminer le résultat exact.

Exemples

Placer en file d’attente une demande pour classifier un fichier avec l’ID « e6cff8b7-c90c-4564-b5b8-033449090932 »

Exemple de demande

{
    "__metadata": {
        "type": "Microsoft.Office.Server.ContentCenter.SPMachineLearningWorkItemEntityData"
    },
    "TargetSiteId": "f686e63b-aba7-48e5-97c7-68c4c1df292f",
    "TargetWebId": "66d6b64d-6f88-4dd9-b3db-47e6f00c53e8",
    "TargetUniqueId": "e6cff8b7-c90c-4564-b5b8-033449090932"
}

Exemple de réponse

Code d'état : 201

{
    "ErrorMessage":  null,
    "StatusCode":  201
}

{
    "ErrorMessage":  null,
    "StatusCode":  201
}

Voir aussi

API REST du modèle de compréhension de document Syntex

Partager via