...
Neben diesem Plugin, welches zahlungspflichtig für translate5 aktiviert werden kann, werden für korrekte Ausführbarkeit der Verbindung noch translate5-interne Konfigurationen benötigt. Siehe dazu Kapitel Installation und Konfiguration der Anpassung in translate5.
Installation und Konfiguration
...
in Plunet
Installation des JS Injection-Loaders
...
Das translate5-PlunetConnector-Plugin wird, wenn es in translate5 einen Benutzer anlegt, keine Registrierungsnachricht an den Nutzer versenden. Daher ist es zwingend notwendig, dass die Partner über Plunet auf eine neue Aufgabe in translate5 hingewiesen werden. Dazu sollten die Job-E-Mail-Templates dahingehend angepasst werden, dass Sie dem Nutzer bei translate5-Jobs direkt die URL des translate5-Systems, sowie Instruktionen zum erstmaligen Login bereitstellen.
...
Installation des Plugins in translate5
Prüfen Sie, ob das Plugin für Ihre translate5-Instanz installiert und aktiviert ist:
Das PlunetConnector-Plugin wird nicht standardmäßg als Public Plugin mit translate5 ausgeliefert, sondern ist ein sogenanntes Private Plugin. Gehen Sie daher wie folgt vor, um das Plugin in translate5 zu installieren und zu aktivieren. Die nachfolgenden Schritte müssen in einer Kommandozeile ausgeführt werden, mit der Sie sich bereits mit Ihrer translate5 Instanz verbunden haben:
Kopieren Sie den Plugin-Ordner PlunetConnector aus dem Auslieferungsarchiv in den Pfad application/modules/editor/PrivatePlugins Ihrer translate5-Instanz.
Erstellen Sie den Ordner PrivatePlugins, sollte er unter dem angegebenen Pfad noch nicht existieren.Navigieren Sie nun in das Verzeichnis application/modules/editor/Plugins
Erzeugen Sie in diesem Verzeichnis eine Verknüpfung, die auf den Ordner PlunetConnector im PrivatePlugins-Verzeichnis verweist. So kann translate5 das Plugin erkennen, obwohl es im privaten Ordner abgelegt ist.
Unter Linux können Sie nachfolgenden Befehl verwenden, um aus dem Plugins-Verzeichnis eine Verknüpfung in das PrivatePlugins-Verzeichnis zu erstellen:
ln -rs ../PrivatePlugins/PlunetConnectorNavigieren Sie zurück in das Installationsverzeichnis von translate5.
Das Plugin integriert eigene Datenbankmigrationen, die zur Installation ausgeführt werden müssen.
Linux-Kommando: ./translate5.sh database:update
Windows-Kommando: translate5.bat database:update
Das Skript wird ihnen eine Auswahl an erkannten, noch nicht migrierten Datenbankmigrationsdateien anzeigen und Sie bitten zu bestätigen, dass diese migriert werden sollen.
Bestätigen Sie mit Yes, sodass das Skript die notwendigen Migrationen ausführt.Aktivieren Sie das Plugin.
Linux-Kommando: ./translate5.sh plugin:enable PlunetConnector
Windows-Kommando: translate5.bat plugin:enable PlunetConnector
Der Dialog wird Ihnen die erfolgreiche Aktivierung bestätigen.Öffnen Sie die translate5-Anwendung nun im Webbrowser und loggen Sie sich mit einem Administratorbenutzer ein.
Navigieren Sie in das Menü Einstellungen -> Systemkonfiguration und stellen Sie sicher, dass die Plugin-spezifischen Einstellungsmöglichkeiten unter dem Stichwort PlunetConnector vorhanden sind.
Für Zugriffe, die aus Plunet heraus gestartet werden, wird außerdem noch ein API-Token benötigt.
Loggen Sie sich als Administrator-User in translate5 ein.
Navigieren Sie in das Menü Benutzer und klicken Sie auf Benutzer hinzufügen, um einen neuen Benutzer anzulegen, welcher für den Zugriff aus Plunet verwendet werden soll. Achten Sie dabei darauf, dem User mindestens die Systemrolle „API“ zu konfigurieren.
Navigieren Sie nun zu Einstellungen -> APP Tokens.
Klicken Sie auf Hinzufügen, um den Token-Erstellen-Dialog zu öffnen.
Geben Sie eine Beschreibung (1) ein, wählen Sie den Benutzernamen des zuvor angelegten Benutzers aus (2) und konfigurieren Sie optional ein Verfallsdatum (3) (Hinweis: Sollten Sie ein Verfallsdatum definieren, müssen Sie das Token regelmäßig in translate5 erneuern und auch in Plunet aktualisieren).
Sichern Sie das nachfolgend angezeigte APP-Token für die Konfiguration in translate5.
Konfiguration des Plugins in translate5
Prüfen Sie, ob das Plugin für Ihre translate5-Instanz installiert und aktiviert ist:
Navigieren Sie in das Menü Einstellungen -> Systemkonfiguration und stellen Sie sicher, dass die Plugin-spezifischen Einstellungsmöglichkeiten unter dem Stichwort PlunetConnector vorhanden sind.
...
Damit das Plugin mit Plunet kommunizieren und die Informationen korrekt auswerten kann, werden einige Einstellungen auf Systemebene benötigt:
| Bitte stellen Sie sicher, dass Sie URLs immer ohne den schließenden / (Slash) konfigurieren, da die Konfiguration sonst ungültig wird. |
...
Name der Config | Hinweise zur Konfiguration |
|---|---|
Fallback Customer ID | Gebe Sie hier auf Instanz-Ebene den translate5-Kunden an, dem diejenigen Projekte aus Plunet zugewiesen werden, für die keine Zuordnung Plunet-translate5-Kunde auf Kundenebene erfolgt ist. Erstellen Sie z. B. einen Kunden "Leere TMs" mit leeren Translation Memories, den Sie für Neukundenanfragen verwenden. |
Finish translate5 task job name | Spezifizieren Sie hier das Kürzel des Jobs, der den translate5-Aufgabenabschluss auslöst. |
Job to WorkflowStep mapping | Spezifizieren Sie hier, wie Plunet-Jobs (durch Ihr Plunet Kürzel dargestellt) in translate5 als Workflow-Schritte (durch den gesamten Namen spezifiert) abgebildet werden soll. Die verfügbaren Workflow-Schritte hängen vom eingestellten Workflow ab. Die genauen Bezeichnungen der Schritte entnehmen Sie bitte Ihrer translate5 Datenbank oder kontaktieren hierzu ihren translate5 Administrator. Z. B. für die Schritte des Standardworkflows in translate5 "Übersetzung" und "Lektorat" wie folgt:
Hinweis: Der Wert dieser Konfiguration ist ein JSON-Objekt. Bitte achten Sie darauf, dass Sie die vorgegebene Struktur korrekt einhalten. |
Language Mapping | Spezifizieren Sie hier, welche Projektsprache aus Plunet welcher Projektsprache in translate5 entspricht. Plunet-Sprachen werden mit ihrem vollen Namen in englischer Lokalisierung angegeben, während translate5-Sprachen anhand ihrer RFC-5646-Codes genannt werden. Diese Eigenschaft ist schon von Werk her vorausgefüllt. Da die Sprachen in Plunet allerdings frei konfigurierbar sind, sollten Sie sicherstellen, dass tatsächlich alle relevanten Zuordnungen enthalten und korrekt sind. Hinweis: Der Wert dieser Konfiguration ist ein JSON-Objekt. Bitte achten Sie darauf, dass Sie die vorgegebene Struktur korrekt einhalten. |
Plunet API Password | Passwort des API-Users aus Plunet |
Plunet API Username | Benutzername des API-Users aus Plunet. |
Plunet Customer ID | Hier sollte ausschließlich auf Kundenebene beim zu verwendenden trasnlate5-Kunden die Plunet Customer ID des zu verknüpfenden Plunetkunden eingegeben werden. |
Plunet URL | URL Ihres Plunet-Systems. Bitte beachten Sie die oben aufgeführten Hinweise zur Konfiguration von URLs. |
SOAP Callback Authentication Token | Für die Callbacks aus Plunet ist es notwendig, eine gesonderte Absicherung zu erzeugen. Erstellen Sie eine sichere Passphrase, welche als Authentifizierungsmerkmal für die Callbacks in Plunet registriert wird und tragen Sie sie hier ein. Wenden Sie sich bei Fragen bitte an Ihren translate5 Administrator. |
translate5 API Token | Tragen Sie hier das APP Token für translate5 ein, dass das sie zuvor für den neu angelegten translate5-Benutzer erzeugt haben. |
Workflow Name | Konfigurieren Sie hier den in translate5 zu verwendenden Workflow. Bitte beachten Sie, dass diese Auswahl Auswirkungen auf die verfügbaren Workflow-Schritte hat und bei einer Änderung auch die Eigenschaft Job to WorkflowStep mapping passend aktualisiert werden muss. |
...