Plugins hinzufügen
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 of the HTML application>":[ |
{ |
"Container":"<Name of the Angular plugin library>", |
"Name":"<Name of the Angular module>" |
} |
] |
} |
-
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.
Fehlende Übersetzungen prüfen
Sie können HTML-Anwendungen mithilfe des ImxClient-Kommandozeilenprogramms auf fehlende Übersetzungen der Benutzeroberfläche überprüfen. Weitere Informationen zum ImxClient-Kommandozeilenprogramm finden Sie im One Identity Manager API-Entwicklungshandbuch.
TIPP: Übersetzbare Texte werden im Quelltext mit dem Prefix #LDS# gekennzeichnet.
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.
HTML-Anwendungen registrieren
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.
Angular-Projekt kompilieren und bereitstellen
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>
-
Wechseln Sie in das Verzeichnis mit dem Kompilat (üblicherweise dist/<Projektname>) und fügen Sie alle Dateien und Unterordner einer neuen ZIP-Datei mit dem Namen Html_<Projektname>.zip hinzu.
-
Kopieren Sie die ZIP-Datei in den Unterordner imxweb\custom Ihrer Arbeitsumgebung.
TIPP: Sollte der Ordner noch nicht existieren, erstellen Sie ihn.
-
Importieren Sie die ZIP-Datei mithilfe des Programms Software Loader in Ihre One Identity Manager-Datenbank und weisen Sie sie der Maschinenrolle Development and Testing zu. Weitere Informationen zum Importieren von Dateien mit dem Software Loader finden Sie im One Identity Manager Administrationshandbuch für betriebsunterstützende Aufgaben.
-
Kopieren Sie die ZIP-Datei in den Unterordner bin\imxweb\custom Ihrer IIS-Installation.
TIPP: Sollte der Ordner noch nicht existieren, erstellen Sie ihn.
-
Importieren Sie die ZIP-Datei mithilfe des Programms Software Loader in Ihre One Identity Manager-Datenbank und weisen Sie sie der Maschinenrolle Business API Server zu.
