Unify Metadata: Metadaten auf Konflikte analysieren

1. Öffnen Sie das Tool Unify Metadata, indem Sie an Ihre Serveradresse diesen Pfad anhängen:

   <Serveradresse>/roiwebui/roiwebui_module/tools/UnifyMetadata.jspCopy

2. Setzen Sie den Haken bei Simulate, um zuerst eine Simulation durchzuführen, die zeigt, ob und welche Konflikte es bei Metadaten gibt.
3. Klicken Sie auf Submit.
   
    
   

   Simulation durchführen
   
   
   Ergebnis:
   
   • Unter Conflicts stehen Metadaten, zu denen Konflikte existieren.
   • Unter Unified stehen Metadaten, die keiner Vereinheitlichung bedürfen.

Beispiel: keine Konflikte

Beispiel: Konflikte

Das System listet vorhandene Konflikte auf:

• Die Zahlen in den Klammern hinter den Typen zeigen an, wie viele Sätze von diesem Typ existieren (SENDER etwa gibt es 21007 Mal als STRING).
• Fahren Sie mit dem Mauszeiger auf eine Zahl, sehen Sie die ersten 5 Objekt-IDs, an denen das Metadatum dieses Typs gesetzt ist.
• Prüfen Sie mithilfe dieser Daten die vorliegenden Konflikte.

Konflikte beheben

---

Vorhandene Konflikte beheben Sie:

• durch manuelle Konvertierung
• über das JavaScript „UnifyMetadata.js“

Konflikte durch manuelle Konvertierung beheben

• Ein Metadatum ändern Sie manuell über die Liste per Klick auf den entsprechenden Typ oder / und über das JavaScript.
• Bestehen mehrere Konflikte, lösen Sie diese einzeln (nacheinander).
• Direkt rechts von den Metadaten stehen Optionen, um die Metadaten zu sehen und zu beheben. Hierüber können Sie einfache Konflikte beheben.
• Beheben Sie die Konflikte über das JavaScript „UnifyMetadata.js“, wenn Sie eine genauere Definition wünschen und wenn etwa mehrere Konflikte in einem Konflikt vorhanden sind (vererbt, nicht vererbt, falscher Name).
   

Hinweise zur Konvertierung

• Vererbte Metadaten sind grundsätzlich vom Typ String.
• Mischen Sie Attribute nicht.
• Ungültige Formate oder zusätzliche Zeichen führen zu Konflikten: 
  • Strings können nicht in ein Datum konvertiert werden, wenn sie nicht ISO 8601 entsprechen.
  • Strings können nicht in einen Zahlentyp konvertiert werden, wenn sie ungültige Zeichen enthalten (Komma statt Punkt, Fragezeichen).
• Sie können die Metadaten iterativ konvertieren.

Konflikte über das JavaScript „UnifyMetadata.js“ beheben

1. Öffnen Sie das Tool Unify Metadata, indem Sie an Ihre Serveradresse diesen Pfad anhängen:

   <Serveradresse>/roiwebui/roiwebui_module/tools/UnifyMetadata.jspCopy

   
   Ergebnis: Rechts neben dem Parameter Convert JavaScript (optional) finden Sie das JavaScript Unify Metadata.js.
   
   • Das JavaScript Unify Metadata.js dient als Vorlage. Es enthält alle möglichen Beispiele, um bekannte Probleme zu beheben.
   • Sie können eigene Definitionen erstellen und dort komplexere Konvertierungen vornehmen, etwa, wenn ein Metadatum mehr als 2 Datentypen hat.
   • Verändern Sie ein Metadatum im JavaScript, sehen Sie es nicht mehr unter Conflicts.
   • Die Konvertierung können Sie per JavaScript durchführen.

Fehlerquellen beheben

---

Falsche Datentypen

Falsche Datentypen können entstehen durch:

• docform-Dokumententypen
• Workflows
• eigene JavaScripte (etwa aus dem agorum core smart assistant, agocum core fileworkflow oder Aktive Ordner)
• Schnittstellen-Dateien (XML)
• Das Setzen von Metadaten über die agorum core-REST API.

Korrekte und neue Metadaten definieren

Prüfen Sie vor dem Ändern von Metadaten, wie falsche Metadaten zustande kommen und wie das neue Metadatum definiert sein soll. Dazu prüfen Sie in der export.yml und im Metadata Designer, ob und wie die bisherigen Metadaten definiert sind.

Beispiele falscher Metadaten

• Die beiden Metadaten MwStBetrag oder Nettobetrag besitzen etwa den Datentyp string oder integer (korrekt wäre der Datentyp double, da alle Beträge auch Nachkommastellen haben).
• Metadaten sind doppelt vorhanden und besitzen einmal den Datentyp double und einmal den Datentyp integer. Nach Stichproben fällt etwa auf, dass der Wert 12 als integer gespeichert wurde, da die 0 in der Zahl 12,0 ohne Typangabe automatisch weggekürzt wurde.
• Ist das Metadatum ein String, stellen Sie sicher, dass es auch ein konvertierbarer String ist, etwa der String 17.

Interne Attribute

• Interne Attribute können Sie nur manuell umbenennen, um einen Konflikt zu lösen. Den neuen Namen geben Sie links im nebenstehenden Textfeld ein.
• Nach dem Umbenennen können Sie das neue Metadatum definieren, um die bestehenden Konflikte aufzulösen.
• Ein alleiniges Umbenennen behebt nicht die Konflikte, sondern ermöglicht nur, mit diesem neu benannten Metadatum eine neue, korrekte Definition zu starten.
• Verwenden Sie grundsätzlich ein kundenspezifisches Präfix, das Sie mit einem Unterstrich vom eigentlichen Namen trennen, etwa kundenname_rechungs_betrag. Dadurch stellen Sie sicher, dass derartige Kollisionen unmöglich sind.

Metadaten nicht definiert

Definieren Sie stets alle oder die betroffenen Metadaten über den Metadaten Designer oder über die export.yml.

Die Migration analysieren

In diesem Abschnitt finden Sie eine (unvollständige) Liste mit möglichen Fehlerquellen bei der Migration. Verwenden Sie eines der Module oder die Funktion, stehen darunter die möglichen / üblichen Fehler, die entstehen können.

Fehlerquelle	Aktion / Beschreibung
docform	Metadaten, die verwendet werden, sind nicht vererbt. Auch vererbte Metadaten? Falls ja, passen Sie diese Metadaten an.
fileworkflow	Nur Ablage / Umbenennen, oder werden Metadaten verändert? Laufen Skripte? Falls ja, passen Sie diese Skripte an.
Allgemeine JavaScripte	Im agorum core smart assistant konfigurator, im agorum core fileworkflow, im Aktiven Ordner. Setzen Sie dort Metadaten per beans? Falls ja, passen Sie die Verwendung von metadata oder die Typisierung an.
Konfiguration	Aktionen prüfen. Ablagen prüfen.
Unify Simluation	Wenn nicht alle Metadaten betroffen sind: Unify Metadata Sind Attribute großgeschrieben, etwa TEXT (incompatible). Falls ja, passen Sie die internen Attribute an.
Sonderfälle	Erste Version des agorum core smart assistants im Einsatz?