1 Themenübersicht
Das Tool „rgymgr“ (registry migration) überträgt die Daten aus den so genannten „Registry“-Java-Klassen in neue Entwicklungsobjekte anhand der Laufzeitdaten. Verwenden Sie das Tool zur Migration der Registrierungen in Java-Klassen. Beispielweise für Registraturen zum Datenaustausch, die in der der Java-Klasse „com.cisag.app.bi.Registry“ verfügbar gemacht wurden oder für die Migration der Registrierungen der organisationstypspezifisch angezeigten Anwendungen in der Java-Klasse „com.cisag.app.multiorg.log.ApplicationRegistry“.
2 Zielgruppe
Anwendungsentwickler
3 Beschreibung
Das Tool „rgymgr“ dient zur Übertragung der Registrierungen, die früher in so genannten „Registry“-Java-Klassen erfasst wurden, in die Entwicklungsobjekte. Folgende Entwicklungsobjekte sind betroffen:
- Das Entwicklungsobjekt „Anwendung“ – Es werden die Organisationsbezüge aus der Java-Klasse „com.cisag.app.multiorg.log.ApplicationRegistry“ übernommen.
- Das Entwicklungsobjekt „Funktion“ – Es werden die Organisationsbezüge aus der Java-Klasse „com.cisag.app.customizing.log.FunctionRegistry“ übernommen.
- Das Entwicklungsobjekt „Java-Klasse“ – Es werden die Klassenersetzungen aus der Java-Klasse „com.cisag.app.Replacements“ übernommen.
- Das Entwicklungsobjekt „Business-Object-Registry“ – Es werden die Registrierungen, die für Datenaustausch relevant sind und in der Java-Klasse „com.cisag.app.bi.Registry“ erfasst sind, und die Registrierungen der Filter für die Kontextmenü-Einträge aus der Java-Klasse „com.cisag.app.general.log.CisInitializerImpl“ zusammengefasst und ein neues Entwicklungsobjekt „Business-Object-Registry“ angelegt.
Die Voraussetzung dabei ist, dass eine Entwicklungsaufgabe angelegt wurde. Während das Tool läuft, werden die Laufzeitdaten analysiert und anhand der Daten die betroffenen Entwicklungsobjekte in die Entwicklungsaufgabe gesperrt.
Hinweis: Falls ein schon migriertes Entwicklungsobjekt in einer der „Registry“-Java-Klassen noch vorkommt, wird dieses Entwicklungsobjekt übersprungen.
3.1 Befehl
Nachfolgend finden Sie den Befehl inklusive aller möglichen Parameter.
| rgymgr | [-j:<text>] [-t:<vs-1> … -t:<vs-n>] [-p:<str-1> … -p:<str-n>] [-o:<str-1> … -o:<str-n>] [-noAppend] [-verbose] |
3.2 Parameter
Die Parameter des Befehls werden in der folgenden Tabelle erläutert. Die in eckigen Klammern gesetzten Parameter sind optional, die anderen hingegen sind Pflichtparameter. Für einige Parameter kann ein Stern (*) als Platzhalter angegeben werden, um damit alle möglichen Werte ausgeben zu können. Nicht alle Parameter können mehrfach genannt werden, nur die, die folgenden Zusatz an den Parametervariablen aufweisen, sind für die Mehrfachnennung zugelassen: „<str-1> … <str–n>“.
| Parameter | Erläuterung |
| [-j:<str>] | Identifikation der zu benutzenden Entwicklungsaufgabe. |
| [-t:<vs-1> … -t:<vs-n>] | Entwicklungsobjekttyp. Mögliche Werte:
· Anwendung · Funktion · Java-Klasse · Business-Object-Registry |
| [-p:<str-1> … -p:<str-n>] | Einschränkung des Namensraums. |
| [-o:<text-1> … -o:<text-n>*] | Einschränkung auf Entwicklungsobjektnamen. Ohne Namensraum. |
| [-noAppend] | Wenn Sie den Parameter angeben, werden die Einträge aus der aktuellen „Registry“-Java-Klasse „com.cisag.app.bi.Registry“ nicht zu den bestehenden Business-Object-Registries hinzugefügt bzw. ersetzt.
Hinweis: Der Parameter ist relevant für die Einträge, die nicht dem CISAG-Namensraum zugeordnet sind. |
| [-verbose] | Erlaubt die Ausgabe in der Toolshell. |
3.3 Vorgehensweise beim Release-Wechsel
Wenn Sie den Release-Wechsel zu Semiramis 5.0 durchführen, müssen Sie das Folgende beim Aufruf von dem Tool „rgymgr“ beachten:
Die Änderungen, die bei der „Registry“-Java-Klasse „com.cisag.app.bi.Registry“ im Semiramis 5.0 durchgeführt wurden, dürfen nicht vor dem Aufruf vom Tool übernommen werden. Sonst werden die Änderungen, die bei dieser „Registry“-Java-Klasse vor dem Release-Wechsel gemacht wurden, verloren gehen.
Der Aufruf von dem Tool muss auf dem Semiramis-Application-Server stattfinden, der im Klassen-Pfad die „Registry“-Java-Klassen hat, die den Zustand vor dem Release-Wechsel haben. In diesem Fall werden diese Java-Klassen als die Quelle für die Migration genommen.
Falls eine Business-Object-Registry schon existiert, wird den Eintrag in der die „Registry“-Java-Klasse (außer „com.cisag.app.bi.Registry“) ignoriert.
Die Einträge aus der Java-Klasse „com.cisag.app.bi.Registry“ werden standardmäßig zu der bestehenden Business-Object-Registry hinzugefügt (Z.B. eine zusätzliche OQL-Suche) bzw. die existierenden Elemente (Z.B. ImportController) in diesem Entwicklungsobjekt ersetzt.
Der Parameter „-noAppend“ sollte nicht verwendet werden, sonst werden die Änderungen, die bei dieser „Registry“-Java-Klasse vor dem Release-Wechsel gemacht wurden, nicht in die bestehenden Business-Object-Registries übernommen.