Das Tool „rgzusrfav“ (reorganize user favourites) dient zum Reorganisieren von Favoriten. Das kann nach dem Löschen von Benutzern, Entwicklungsobjekten oder anderen Objekten hilfreich sein, um ungültige Einträge zu löschen. Auch nach einem Releasewechsel oder dem Kopieren eines Systems können so ungültig gewordene Daten bereinigt werden bzw. für neue Datenbanken angepasst werden, damit sie wieder verwendbar sind. Hierzu wird in allen Einträgen die Datenbankidentifizierung des alten Systems durch die Datenbankidentifizierung des neuen Systems ersetzt.
1 Zielgruppe
- System-Administratoren
- Technische Berater
2 Begriffsbestimmung
Benutzer
Die Bezeichnung „Benutzer“ trifft zu auf eine Person, die ein Semiramis-System benutzt, und ein System, das mit einem Semiramis-System kommuniziert. Mit der Anlage eines Benutzers in einem beliebigen Semiramis-System, wird ihm ein Zugang zum System ermöglicht. Dieser Zugang erfolgt z. B. aufgrund eines Zertifikates, welches die Echtheit eines Benutzers überprüft. Die Benutzerdaten werden in der Konfigurations-Datenbank gespeichert, und sind für alle Semiramis-Systeme gültig, die mit dieser Konfigurations-Datenbank arbeiten. Nachdem ein Benutzer angelegt wurde, ist ihm eine Berechtigungsrolle zuzuweisen, über die er Berechtigungen erhält.
Entwicklungsobjekt
Ein Entwicklungsobjekt ist ein in Semiramis definiertes Objekt, mit welchem Anwendungsentwickler andere Objekte entwickeln. Alle Entwicklungsobjekte werden in der Repository-Datenbank archiviert. Sie können in Semiramis mit der Anwendung “Entwicklungsobjekte” angelegt, geändert und gelöscht werden. Bei einer Bearbeitung eines Entwicklungsobjektes wird ein Sperrmechanismus angewandt, um gleichzeitige Änderungen am selben Entwicklungsobjekt auszuschließen. Nach der Bearbeitung unterliegt jedes Entwicklungsobjekt der in Semiramis integrierten Versionierung.
Favorit
Die Favoriten in Semiramis sind vergleichbar mit den Favoriten des Internet Explorers. In Semiramis sind Favoriten individuelle Verknüpfungen zu Business Entitys, zu Anwendungen oder Adressen, die außerhalb von Semiramis liegen, den so genannten Hyperlinks. Die Favoriten können zusätzlich gegliedert werden in anwendungsbezogene Favoriten und Favoriten. Anwendungsbezogene Favoriten sind von einer Anwendung abhängig. Sie werden nur dann sichtbar, wenn die Anwendung geöffnet ist und aktuell betrachtet wird. Andere Favoriten sind stets sichtbar und bleiben unabhängig von einzelnen Anwendungen.
3 Beschreibung
Das Tool „rgzusrfav“ (reorganize user favourites) dient zum Reorganisieren von Favoriten.
3.1 Befehl
Nachfolgend finden Sie den Befehl inklusive aller möglichen Parameter.
| rgzusrfav | [-withoutUser] [-withoutTarget] [-setSystem:<str>] [-setDatabase:<str>] [-toSystem:<str>] [-toDatabase:<str>] |
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 |
| [-withoutUser] | Löscht alle Einträge ohne gültigen Benutzer. |
| [-withoutTarget] | Löscht alle Einträge, zu denen kein gültiges Zielobjekt mehr besteht. |
| [-setSystem:<str>] | System-Name für die zu ersetzende Datenbank, wenn diese nicht mithilfe der GUID angegeben wurde.
Standard ist das aktuelle System. |
| [-setDatabase:<str>] | Name oder GUID der Datenbank, die ersetzt werden soll. |
| [-toSystem:<str>] | System-Name für die neu zu setzende Datenbank, wenn diese nicht mithilfe der GUID angegeben wurde.
Standard ist das aktuelle System. |
| [-toDatabase:<str>] | Name oder GUID der neu zu setzenden Datenbank. |
4 Berechtigungen
Das Berechtigungskonzept sowie die generellen anwendungsbezogenen und Entity-bezogenen Berechtigungen können Sie in der Technischen Dokumentation im Dokument Berechtigungen nachlesen.
Für den Befehl „rgzusrfav“ und seine Parameter gelten besondere Berechtigungen, die nachfolgend aufgelistet sind.
- cisag.sys.preferences.ChangeOtherUsersFavorites
Favoriten anderer Benutzer ändern
- cisag.sys.preferences.DeleteOtherUsersFavorites
Favoriten anderer Benutzer löschen
5 Vorgehensweisen
Nach dem Kopieren eines Systems sind alle Favoriten, die auf die Inhalte der Datenbanken des alten Systems verweisen, zunächst nicht verwendbar und ungültig.
Um das neue System in einen konsistenten Zustand zu bringen, können Sie alle Daten, die erhalten werden können, umsetzen und anschließend alle verbleibenden ungültigen Einträge löschen. Da das Umsetzen sich auch auf evtl. nicht mehr vorhandene oder in einer anderen Konfigurations-Datenbank definierte System oder Datenbanken bezieht, sind für diesen Schritt die GUIDs der alten und neuen Systeme bzw. Datenbanken erforderlich. Diese erhalten Sie in der Anwendung „Systemcockpit“ auf dem jeweiligen System.
- rgzusrfav –setSystem:<oldSystemGuid> -toSystem:<newSystemGuid>
- rgzusrfav –setDatabase:<oldDatabaseGuid>
-toSystem:<newDatabaseGuid> - rgzusrfav –withoutUser –withoutTarget