API-Änderungen für Drittentwickler

In Fortsetzung der Initiative, die mit der Version Trados GroupShare 2020 SR1 CU8 gestartet wurde, fügen wir weitere Endpunkte für Trados Studio und Integrationen von Dritten hinzu.

Änderungen am TM-Dienst

Neuer Endpunkt zur Validierung und Änderung von Metadatenfeldern des Systems

Benutzer mit Administratorberechtigungen können nun den Endpunkt /api/tmservice/tms/{translationMemoryId}/tus/{sourceLanguage}/{targetLanguage} verwenden, um personenbezogene Informationen wie Benutzername (oder Name) aus Systemfeldern in GroupShare TMs zu entfernen oder zu anonymisieren. Dies ist nützlich für Sicherheitsrichtlinien und DSGVO-konforme Szenarien.

Leerer Haupttext-Endpunkt

POST-Anfragen an den TM-Service ohne Haupttext erfordern jetzt eine Inhaltstyp-Kopfzeile (in der Regel mit dem Wert „application/json“). Hier sind einige Beispiele:
  • POST /api/tmservice/tms/{tmid}/export
  • POST /api/tmservice/tms/{tmid}/fuzzyindex/reindex
  • POST /api/tmservice/tms/{tmid}/fuzzyindex/recomputestatistics

Neuer Antwort-Code, wenn Ressource nicht mehr vorhanden ist

Diese Version ändert auch HTTP-Antwortstatuscodes, wenn mit nicht vorhandenen TM-Ressourcen interagiert wird. Der HTTP 404-Statuscode (Nicht gefunden) wird jetzt anstelle von HTTP 401 (Nicht autorisiert) oder HTTP 403 (Verboten) angezeigt:
  • HTTP GET api/tmservice/tms/{tmId} mit einer ungültigen tmId
  • HTTP GET api/tmservice/tms/{tmId}/language-directions/{languageDirectionId} mit einer ungültigen "tmId oder languageDirectionId
  • HTTP DELETE api/tmservice/tms/{tmId}/ mit einer ungültigen tmId
  • HTTP GET api/language-resource-service/templates/{templateId:guid} mit einer ungültigen templateId
  • HTTP GET api/fieldservice/templates/{templateId} mit einer ungültigen templateId

Änderungen in der Swagger-Dokumentation

Sie können nun auf die TM-Dokumentation über die GroupShare Swagger-Benutzeroberfläche-Seite unter /documentation/api/indexzugreifen. Befolgen Sie die Anweisungen dort, um die Endpunkte aus /RESSOURCEN/TmServiceRestApiDocumentation.jsonzu laden.

Neue REST-Endpunkte

Server-Projektinformation abrufen

Die neue GetServerProjectInformation REST-Programmierschnittstelle ruft alle relevanten Informationen zu einer Liste von GroupShare-Projekten ab und verwendet das folgende Format: GET server/api/projectserver/v2/projects/publishingInformation?projectIds={projectId,projectId_1,projectId_2}

Veröffentlichen Sie Pakete

Der PublishPackage-Endpunkt lädt GroupShare-Pakete Block für Block hoch, was die Leistung beim Hochladen größerer Pakete verbessert. Die Endpunkte PublishPackage, PublishPackageinBlocks und FileUpload bieten Unterstützung für CancellationToken.

Excel-Berichte exportieren

ExportExcel erstellt und exportiert vordefinierte Berichte im Excel-Format. Dieser wurde im Berichtsdienst erstellt und generiert drei Berichte: Vordefinierte Projekte, Vordefinierte Aufgaben und Vordefinierte TM-Nutzung.

Änderungen in der Struktur der Gesundheitsantwort des Verifizierungsdienstes

Die JSON-Antwortstruktur des Verifizierungsdienst-Integritätsendpunkts {server}:41262/api/verification/health extrahiert nun das „Details“-Array der abhängigen Dienste als Eigenschaften.

SPN erforderlich für Windows-Authentifizierung

Die Einrichtung von SPN (Service Principal Name) auf dem GroupShare-Server ist jetzt obligatorisch, wenn die Windows-Authentifizierung von Trados Studio aus verwendet wird. Das ist das Ergebnis der Migration von WCF-Endpunkten zu REST-Programmierschnittstelle.

Information zur Konfiguration von SPN finden Sie unter HTTPS://GATEWAY.SDL.html.