Voraussetzungen
Sie benötigen eine ZIP-Datei , die den gewünschten Javascript-Bibliothekscode (.js oder .min.js) enthält [z. B. tesseractJS-2_1_4].
Schritt 1 – Laden Sie den JS-Code der Bibliothek hoch
Klicken Sie im Simplifier-Dashboard auf
“Anwendungen” und wählen Sie die Option
Registerkarte “Bibliotheken” :
Klicken Sie auf “+”, um Ihren Bibliothekscode hochzuladen :
Geben Sie die Details “name” und “version” ein und laden Sie die ZIP-Datei hoch:
Schritt 2 – Integrationscode
Geben Sie das Feld
Code-Snippet , das zur Integration des Javascript-Codes der Bibliothek verwendet werden soll:
In diesem Fall verwenden wir die Methode ‘addScript’ für die Integration.
Der erste Parameter ist der relative Pfad zur Javascript-Datei in Ihrem Zip-Ordner (.js oder .min.js).
Der zweite Parameter definiert einen Namen , mit dem Abhängigkeiten zwischen dieser Bibliothek und möglichen anderen, die ebenfalls über ‘addScript’ in diesen Codeblock eingebunden werden, festgelegt werden können (vgl. Beispiel – Simplifier Documentation).
Weitere verfügbare Integrationsmethoden (z.B. für die Integration .css Stilen) finden Sie in der Simplifier-Dokumentation.
Klicken Sie auf “Speichern”, um den Upload- und Integrationsschritt abzuschließen.
Schritt 3 – Bibliothek zur Simplifier App hinzufügen
Gehen Sie nun zu Ihrer Simplifier-App, in der Sie die Bibliothek verwenden möchten.
Öffnen Sie die Registerkarte “Bibliotheken” im Anwendungseditor:
Klicken Sie auf “+”, verwenden Sie die Suchleiste, um Ihre Bibliothek zu finden, und wählen Sie sie aus :
Nun wird die Bibliothek zur Liste der verfügbaren Bibliotheken hinzugefügt:
Schritt 4 – Verwenden Sie die Bibliothek in der Simplifier App
Die Bibliothek kann nun in
Skripte im Prozess-Designer:
Schritt 5 – Bibliotheken mit Abhängigkeiten
Einige JavaScript-Bibliotheken haben Abhängigkeiten zu anderen JavaScript-Bibliotheken.
In diesen Fällen ist es wichtig sicherzustellen, dass die abhängige Bibliothek nach der Bibliothek geladen wird, von der sie abhängig ist.
Zum Beispiel gibt es ein Plugin für die ChartJS-Bibliothek namens chartjs-plugin-datalabels.
Um diese Bibliothek in Simplifier zu verwenden, müssen Sie zuerst ChartJS hochladen:
Laden Sie dann die abhängige Plugin-Bibliothek für ChartJS hoch:
Fügen Sie schließlich ChartJS als Abhängigkeit im Abschnitt “Abhängigkeiten” sowie im JavaScript-Integrationscode hinzu.
Fügen Sie dazu den Bibliotheksnamen als dritten Parameter zum ‘addScript’-Code hinzu, mit der folgenden Syntax: addScript('dependent_lib_minjs_file', 'dependent_lib_name', ['dependency_name']);
In unserem Fall: addScript('chartjs-plugin-datalabels.min.js', 'datalabelsjs', ['chartjs']);
Wenn nun die abhängige Bibliothek in einer Anwendung oder einem Widget verwendet wird, werden alle Bibliotheken in der Abhängigkeitsliste vorher geladen, um die Funktionalität sicherzustellen.