Modifications apportées à l'API pour les développeurs tiers

Dans la continuité de l'initiative démarrée dans la version CU8 de Trados GroupShare 2020 SR1, nous ajoutons de nouveaux points de terminaison pour les intégrations Trados Studio et tiers.

Modifications apportées au service de mémoire de traduction

Nouveau point de terminaison pour la validation et la modification des champs de métadonnées du système

Les utilisateurs disposant d'autorisations administratives peuvent désormais utiliser le point de terminaison /api/tmservice/tms/{translationMemoryId}/tus/{sourceLanguage} /{targetLanguage} pour supprimer ou rendre anonymes les informations personnelles identifiables (PII) telles que le nom d'utilisateur (ou le nom) des champs système des mémoires de traduction GroupShare. Ceci est utile pour les politiques de sécurité et les scénarios de conformité au RGPD.

Point de terminaison des corps de requête vides

Les requêtes POST au service de mémoire de traduction sans corps de demande nécessitent désormais un en-tête Type de contenu (généralement avec la valeur « application/json »). Voici quelques exemples :
  • POST /api/tmservice/tms/{tmid}/export
  • POST /api/tmservice/tms/{tmid}/fuzzyindex/reindex
  • POST /api/tmservice/tms/{tmid}/fuzzyindex/recomputestatistics

Nouveau code de réponse lorsque la ressource n'existe plus

Cette version modifie également les codes de statut de réponse HTTP lors de l'interaction avec des ressources de MT non existantes. Le code de statut HTTP 404 (introuvable) est maintenant affiché à la place de HTTP 401 (non autorisé) ou HTTP 403 (interdit) :
  • HTTP GET api/tmservice/tms/{tmId} avec une valeur non valide tmId
  • HTTP GET api/tmservice/tms/{tmId}/language-directions/{languageDirectionId} avec une valeur non valide « tmId ou languageDirectionId
  • HTTP DELETE api/tmservice/tms/{tmId}/ avec une valeur non valide tmId
  • HTTP GET api/language-resource-service/templates/{templateId:guid} avec une valeur non valide templateId
  • HTTP GET api/fieldservice/templates/{templateId} avec une valeur non valide templateId

Modifications de la documentation Swagger

Vous pouvez désormais accéder à la documentation du service de mémoire de traduction à partir de la page d'interface utilisateur GroupShare Swagger à l'adresse /documentation/api/index. Suivez les instructions là-bas pour charger les points de terminaison à partir de /resources/TmServiceRestApiDocumentation.json.

Nouveaux points de terminaison REST

Obtenir des informations sur le projet du serveur

La nouvelle GetServerProjectInformation REST API récupère toutes les informations pertinentes sur une Liste de projets GroupShare et utilise le format suivant : GET server/api/projectserver/v2/projects/publishingInformation?projectIds={projectId,projectId_1,projectId_2}

Publier des packages

Le point de terminaison PublishPackage charge les packages GroupShare bloc par bloc, ce qui améliore les performances lors du chargement de packages plus volumineux. Les points de terminaison PublishPackage, PublishPackageinBlocks et FileUpload bénéficient de l'assistance de CancellationToken.

Exporter des rapports Excel

ExportExcel crée et réalise l'exportation de rapports prédéfinis au format Excel. Créé dans le service de création de rapports, il génère trois rapports : Projets prédéfinis, Tâches prédéfinies et Récupération MT prédéfinie.

Modifications apportées à la structure de réponse du service de vérification

La structure de réponse JSON du point de terminaison d'intégrité du service de vérification {server}:41262/api/verification/health extrait maintenant le tableau « Détails » des services dépendants en tant que propriétés.

SPN requis pour l'authentification Windows

La configuration du SPN (Service Principal Name) sur le serveur GroupShare est désormais obligatoire lors de l'utilisation de l'authentification Windows à partir de Trados Studio. C'est le résultat de la migration des points de terminaison WCF vers l'interface de programmation d'application REST.

Pour plus d'information sur la configuration du SPN, reportez-vous à la section HTTPS://GATEWAY.SDL.html.