Plugins sind Angular-Bibliotheken, die zur Laufzeit dynamisch geladen werden. Die Plugins werden vom API Server verwaltet. Plugins werden automatisch vom API Server erkannt, indem im Programmverzeichnis nach Dateien mit dem Namen imx-plugin-config.json gesucht wird.
Die folgende Beispieldatei legt fest, dass die Angular-Plugin-Bibliothek ccc in die qer-app-portal-Anwendung geladen werden soll. Der Name des Angular-Moduls, das instanziiert werden soll, ist CustomConfigModule.
{ |
"qer-app-portal":[ |
{ |
"Container":"ccc", |
"Name":"CustomConfigModule" |
} |
] |
} |
Um ein Plugin hinzuzufügen
-
Erstellen Sie auf dem API Server die Datei imxweb\<Name der Angular-Plugin-Bibliothek>\imx-plugin-config.json mit folgendem Inhalt:
{ |
"<Name der HTML-Anwendung>":[ |
{ |
"Container":"<Name der Angular-Plugin-Bibliothek>", |
"Name":"<Name des Angular-Moduls>" |
} |
] |
} |
-
Importieren Sie die Datei mithilfe des Software Loaders in Ihre One Identity Manager-Datenbank und weisen Sie sie der Maschinenrolle API Server zu. Weitere Informationen zum Importieren von Dateien mit dem Software Loader finden Sie im One Identity Manager Administrationshandbuch für betriebsunterstützende Aufgaben.
-
(Optional) Um zu prüfen, ob die HTML-Anwendung das Plugin richtig lädt, rufen Sie die URL <URL des API Servers>/imx/applications auf und prüfen Sie, dass an der HTML-Anwendung das entsprechende Plugin in der Liste erscheint.
Sie können HTML-Anwendungen mithilfe des ImxClient-Kommandozeilenprogramms auf fehlende Übersetzungen überprüfen. Weitere Informationen zum ImxClient-Kommandozeilenprogramm finden Sie im One Identity Manager API-Entwicklungshandbuch.
Um eine HTML-Anwendung auf fehlende Übersetzungen zu überprüfen
-
Starten Sie das ImxClient-Kommandozeilenprogramm.
-
Führen Sie im Ordner, den Sie auf fehlende Übersetzungen prüfen möchten, den Befehl check-translations aus.
Ein Bericht wird erstellt. Dieser Bericht zeigt Ihnen alle Dateien, in denen Texte gefunden wurden, die noch nicht oder nur teilweise übersetzt wurden.
-
(Optional) Um die Übersetzungsschlüssel und Übersetzungen anzulegen, verwenden Sie das Programm Designer. Weitere Informationen zu Übersetzungen finden Sie im One Identity Manager Konfigurationshandbuch.
Um neue HTML-Anwendungen für die Nutzung zur Verfügung zu stellen und somit auf der Startseite des API Servers anzuzeigen, müssen Sie die HTML-Anwendungen in der Datenbank anlegen.
Um eine HTML-Anwendung in der Datenbank anzulegen
-
Starten Sie das Programm Designer.
-
Verbinden Sie sich mit der entsprechenden Datenbank.
-
Klicken Sie in der Navigation die Kategorie Basisdaten > Sicherheitseinstellungen > HTML-Anwendungen.
-
In der Menüleiste klicken Sie 
(Ein neues Objekt erstellen).
-
In der Liste klicken Sie den neuen Eintrag.
-
Im Bereich Eigenschaften geben Sie in den entsprechenden Feldern die Daten der HTML-Anwendung an. Geben Sie mindestens die folgenden Informationen an:
-
Anzeigename: Geben Sie einen Namen für die HTML-Anwendung ein.
-
HTML-Anwendung: Geben Sie den Pfad CCC/<Name Ihrer HTML-Anwendung> ein.
-
Vorkompiliert: Setzen Sie den Wert auf True.
Um ein Angular-Projekt über den API Server zur Verfügung zu stellen, müssen Sie das Angular-Projekt kompilieren und das Paket als ZIP-Datei verfügbar machen.
Um ein Angular-Projekt zu kompilieren und bereitzustellen
-
Starten Sie ein Kommandozeilenprogramm.
-
Wechseln Sie in das Verzeichnis des Angular-Workspace.
-
Führen Sie den folgenden Befehl aus:
ng build <Projektname>
-
Komprimieren Sie den Inhalt des Verzeichnisses mit dem Kompilat (üblicherweise dist/<Projektname>) als ZIP-Datei mit dem Namen Html_<Projektname>.zip.
-
Kopieren Sie die ZIP-Datei in den Unterordner imxweb\custom Ihrer Arbeitsumgebung.
-
Importieren Sie die ZIP-Datei mithilfe des Software Loaders in Ihre One Identity Manager-Datenbank und weisen Sie sie der Maschinenrolle API Server zu. Weitere Informationen zum Importieren von Dateien mit dem Software Loader finden Sie im One Identity Manager Administrationshandbuch für betriebsunterstützende Aufgaben.
