IDU.cardo.MLExchange

IDU.cardo.MLExchange ist eine Konsolenanwendung zum Übersetzen von cardo und cardoMap Ebenentiteln/-beschreibungen. Mit dem Start der Anwendung erfolgt ein Export von ausgewählten Datentypen in eine Excel Tabelle. Dort können Änderungen an den Übersetzungen vorgenommen werden. Nach erfolgter Änderung/Übersetzung kann die Excel Tabelle wieder ins cardo zurückgespielt werden. (mlexchange)

Voraussetzung

Zum Start der Anwendung ist eine vollständige .NET Framework 4 Umgebung sowie eine Excelinstallation notwendig.

Der Aufrufer muss der Gruppe SU im cardo angehören!

Start der Anwendung

Starten Sie die Anwendung IDU.cardo.MLExchange.exe.

Parameter

op: <import : export>: diese Angabe ist dringend erforderlich. Entweder import oder export.

xlsFile: Name der Excel Datei, für den Export wird die Datei angelegt, für den Import muss diese Datei bereits vorhanden sein

Iscm3: <true : false> : diese Angabe ist dringend erforderlich und beschreibt, ob die Daten aus cardo oder zusätzlich aus cardoMap exportiert oder importiert werden ("Is cardoMap3?" für cardo Daten wird der Parameter false angegeben!)

types: <all : t1, t2>: die zu behandelten Datentypen aus cardo. Folgende Typen stehen zur Verfügung:

  • AdditionalNodeAndLayerExtension (Ebenen die eine Beschreibung in den Zusatzeigenschaften/HTML Vorlage besitzen werden hier aufgeführt)
  • KmiAdminTreeNode (alle Knoten des administrativen Baumes)
  • KmiView  (alle Views)
  • KmiViewNode (alle Knoten der Views)

(Dieser Parameter muss auch für cardoMap notiert werden!)

cm3types: <all : t1, t2> : die zu behandelnden Datentypen aus cardoMap. Folgende Typen stehen dem Nutzer zur Verfügung

Die cardoMap Typen werden immer zusätzlich zu den cardo Typen ausgegeben!

username: optionale Eingabe des Benutzernamens, bei keiner Eingabe wird die NT Kennung genutzt (Bitte überprüfen Sie gegebenenfalls die Benutzerauthentifizierung!)

password: Eingabe nur, wenn der Benutzername angegeben wurde

cardoUrl: Url des cardo Servers (http://IhrCardo oder http://IhrCardo/CardoMap3 (Prüfen Sie gegebenenfalls im Internetinformationsdienste-Manager ihre korrekte cardoMap Url!)

Export

Für den Export geben Sie bspw. folgende Parameterzeile ein:

cardo:

IDU.cardo.MLExchange.exe  op:export xlsFile:c:\test.xls Iscm3:false types:all cardoUrl:http://schulungscardo1

cardoMap:

IDU.cardo.MLExchange.exe  op:export xlsFile:c:\test.xls Iscm3:true types:all cm3types:all cardoUrl:http://schulungscardo1/cardoMap3

Bearbeitung im Excel

Wurde der Export erfolgreich durchgeführt, können Sie ihre Excel Tabelle öffnen und mit der Bearbeitung beginnen. Die primäre Sprache ist deutsch. Weitere Sprachen sind Englisch, Polnisch, Russisch und Tschechisch.

Die Ebenentitel/-beschreibungen finden Sie im jeweiligen, nach den Datentypen beschrifteten, Tab:

Folgende Dinge sollten Sie beachten:

  • Ändern Sie auf keinen Fall die ID!
  • Ändern Sie auf keinen Fall die Tabbeschriftungen oder Überschriften der Tabelle!
  • Fügen Sie keine Leerzeilen ein! Der Import wird sonst nur bis zu dieser Zeile durchgeführt und alle nachfolgenden Zeilen werden ignoriert!
  • Achtung: Löschen Sie eine Zeile, so wird diese beim Import ignoriert! Die Ebene bleibt auf cardo oder cardoMap erhalten!
  • Falls Sie ihre Tabelle sortieren, achten Sie darauf, dass beim Abspeichern die Überschriften wieder oben stehen! Sonst erhalten Sie folgende Fehlermeldung: Der angegebene Schlüssel war nicht im Wörterbuch angegeben!

Beispiel: Eingabe der Sprachen englisch, polnisch, russisch und tschechisch für die Ebene Stadtgrenze

Hinweise zum KmiViewNode:

Achtung: Wurde ein neuer Ordner für einen View/Ebenenbaum errichtet und die Ebene durch Drag and Drop auf den Ordner gezogen, so wird der Titel automatisch aus dem administrativen Baum übernommen, in der Excel Tabelle sind diese Ebenen allerdings ohne Titel zu finden!

Geben Sie hier keine Übersetzungen ein (diese werden beim Import ignoriert), sondern wechseln auf den Tab KmiAdminTreeNode und geben Sie hier die Übersetzungen an der Ebene ein!

Beachten Sie, dass die IDs je nach Datentyp verschieden sind. Die ID Information erhalten Sie als Mauszeigerinfo im cardo, wenn Sie mit der Maus über die entsprechende Ebene fahren. 

Import

Für den Import geben Sie bspw. folgende Parameter ein:

cardo:

IDU.cardo.MLExchange.exe  op:import xlsFile:c:\test.xls Iscm3:false types:all cardoUrl:http://schulungscardo1

cardoMap:

IDU.cardo.MLExchange.exe  op:import xlsFile:c:\test.xls Iscm3:true types:all cm3types:all cardoUrl:http://schulungscardo1/cardoMap3

Löschen Sie gegebenenfalls den Cache im cardo.

Hinweis: Löschen Sie vor dem Import keine Ebenen im cardo oder cardoMap3. Wurde eine Ebene gelöscht und der Import gestartet erhalten Sie folgende Fehlermeldung: ...System.Exception: Ein Objekt mit der ID xx vom Typ XX ist nicht vorhanden.

 Beispiel: Ebene Stadtgrenze (s. Bearbeitung in Excel)

Nach dem Import sind unter dem Eintrag alle zuvor im Excel eingetragenen Übersetzungen vorhanden.