Objekte über das CLI verwalten

Sie können Tags setzen und verschieben.

Sie können Workflows, Module, Prozesse und Tags löschen.

Sie können Workflows, Module und Metadaten umbenennen.

Workflow/Modul über das CLI löschen

Aufruf

  • Interaktiver Modus

    startcli [-u <Benutzerkennung>] [-p <Passwort>]
...
delete <option> <arg>
    bash

  • Skriptmodus

    startcli --execCommand "delete <option> <arg>"
    bash

Kommandooptionen

Option Bedeutung

-h,--help

Hilfe anzeigen

--deleteModule <arg>

Löschen des Moduls mit dem angegebenen Namen

--deleteWorkflow <arg>

Löschen des Workflows mit dem angegebenen Namen

Beispiel

  • Interaktiver Modus

    delete --deleteWorkflow 'Invoice Supplier A'
    bash

  • Skriptmodus

    startcli -u jh -p inubit --execCommand "delete --deleteWorkflow 'Invoice Supplier A'"
    bash

Objekte über das CLI umbenennen

Aufruf

  • Interaktiver Modus

    startcli [-u <Benutzerkennung>] [-p <Passwort>]
...
rename <option> <arg> --renameTo <arg>
    bash

  • Skriptmodus

    startcli --execCommand "rename <option> <arg> --renameTo <arg>"
    bash

Nur Zeichen von a bis Z, von 0 bis 9, -, _, . und Leerzeichen sind sowohl für den alten als auch den neuen Namen erlaubt.

Kommandooptionen

Option Bedeutung

-h,--help

Hilfe anzeigen

--renameMetadata <arg>

Metadatum umbenennen

--renameModule <arg>

Modul umbenennen

--renameTo <arg>

Neuer Name

Wenn Sie ein Repository-Verzeichnis oder eine Repository-Datei umbenennen, darf der neue Name keine Pfadangaben enthalten.

--renameWorkflow <arg>

Workflow umbenennen

--renameDirectory <fullPath>

Repository-Verzeichnis umbenennen

--renameFile <fullPath>

Repository-Datei umbenennen

Beispiel

  • Interaktiver Modus

    rename --renameWorkflow Orders_DRAFT --renameTo Orders
rename --renameDirectory /Root/jh/IBIS-17024 --renameTo IBIS-17024_new
    bash

  • Skriptmodus

    startcli --execCommand "rename --renameWorkflow Orders_DRAFT --renameTo Orders"
startcli --execCommand "rename --renameDirectory /Root/jh/IBIS-17024 --renameTo
IBIS-17024_new"
    bash

Queue Manager-Einträge im Status Error starten

Aufruf

  • Interaktiver Modus

    startcli [-u <Benutzername>] [-p <Passwort>]
...
processErrorStart <processId>
    bash

  • Skriptmodus

    startcli [-u <Benutzername>] [-p <Passwort>] --execCommand "processErrorStart
<processId>"
    bash

Kommandooptionen

Option Bedeutung

-h,--help

Hilfe anzeigen

processErrorStart <processId>

Starten eines fehlgeschlagenen Prozesses mit der angegebenen Prozess-ID aus dem Queue Manager

Derzeit werden nur Prozesse im Status Error unterstützt. Wenn Sie einen Prozess in einem anderen Status starten, wird eine Fehlermeldung angezeigt.

Beispiel

  • Interaktiver Modus

    processErrorStart 10007

  • Skriptmodus

    startcli -u miller --execCommand "processErrorStart 10007"
    bash

Prozess über das CLI löschen

Aufruf

  • Interaktiver Modus

    startcli [-u <Benutzerkennung>] [-p <Passwort>]
...
kill <processID>
    bash

  • Skriptmodus

    startcli --execCommand "kill <processID>"
    bash

Beispiel

  • Interaktiver Modus

    kill 123

  • Skriptmodus

    startcli --execCommand "kill 123"
    bash

Prozess im Status Error über das CLI löschen

Verwendung

Zum Löschen von Prozessen im Status error

Prozesse mit anderen Status können nicht mit diesem Kommando gelöscht werden. Eine Fehlermeldung wird angezeigt.

Aufruf

  • Interaktiver Modus

    startcli - u <username> -p <password>
...
processdelete <status>
    bash

  • Skriptmodus

    startcli --execCommand "processdelete <status>"
    bash

Beispiel

  • Interaktiver Modus

    processdelete error

  • Skriptmodus

    startcli --execCommand "processdelete error"
    bash

Tag über das CLI setzen, verschieben und löschen

Aufruf

  • Interaktiver Modus

    startcli [-u <Benutzerkennung>] [-p <Passwort>]
...
tag <option> <arg> --tagUser {<Benutzer>|<Gruppe>|<Obergruppe>}
    bash

  • Skriptmodus

    startcli --execCommand "tag <option> <arg> --tagUser {<Benutzer>|<Gruppe>|<Obergruppe>}"
    bash

Kommandooptionen

Option Description

-h,--help

Hilfe anzeigen

--tagDiagram <arg>

Name des Diagramms, für das das Tag gesetzt werden soll

--tagDelete <arg>

entfernt das angegebene Tag aus Workflows, Modulen und dem Repository

--tagMove <arg>

angegebenes Tag setzen/verschieben

--tagRemove <arg>

entfernt das angegebene Tag nur aus dem Repository

--tagRemoveActive

Aktives Tag für den mit ‑‑tagUser gesetzten Benutzer, die Benutzergruppe oder Obergruppe entfernen

--tagRepositoryPath <arg>

Repositorypfad, für den das Tag gesetzt werden soll

--tagSetActive <arg>

Aktives Tag für den mit ‑‑tagUser gesetzten Benutzer, die Benutzergruppe oder Obergruppe setzen

--tagUser <arg>

Benutzer, Benutzergruppe oder Obergruppe für die betreffende Operation

--tagWorkflowGroup <arg>

Name(n) der Diagramm-/Workflowgruppe(n), für das/die das Tag gesetzt werden soll .
Mehrere Diagrammgruppen müssen mit Kommas abgetrennt und in einfache Anführungszeichen eingeschlossen werden.
Um alle Diagrammgruppen das Tag zuzuweisen, nutzen Sie die Option ‑‑tagWorkflowGroup ''.

--tagWorkflowGroupExclude <arg>

Diagrammgruppe(n), der/denen das Tag nicht zugewiesen werden soll

--tagWorkflowType <arg>

Name(n) der Diagramm-Typen, für die das Tag gesetzt werden soll.

Mehrere Diagramm-Typen müssen durch Kommas getrennt und in Hochkommas angegeben werden.

Um alle Diagramm-Typen zu exportieren, verwenden Sie all als Argument.

  • technical: Technical Workflows

  • organigram: Organigramm

  • systemdiagram: Systemdiagramm

  • constraintsdiagram: Business Object Diagramm

  • bpd: Business Process Diagramm

  • processmap: Prozesslandkarten

Beispiele

  • Interaktiver Modus

    • tag --tagMove 3.2 --tagWorkflowType technical --tagWorkflowGroup OrdersIn --tagUser inubit

    • tag --tagDelete 1.1 --tagUser root

    • tag --tagRemove 1.1 --tagRepositoryPath /Root/root/abc

  • Skriptmodus

    startcli --execCommand "tag --tagMove 3.2 --tagDiagram sample --tagWorkflowType
technical --tagWorkflowGroup OrdersIn --tagUser inubit"
    bash

Automatisiertes Deployment

Ablauf des Deployments

Für das automatisierte Deployment werden die Export-/Importfunktionalitäten der INUBIT Process Engine genutzt:

  1. Zuerst exportieren Sie mit den passenden StartCLI-Befehlen alle zu deployenden Artefakte (Diagramme und Repositorydateien) aus dem Quellsystem. Dann lassen Sie die Propertys der Artefakte extrahieren und zu einer neuen XML-Datei zusammenfassen.

  2. Die Werte der Propertys passen Sie z.B. mit Shell-Befehlen oder XSLT an. Auf Basis der angepassten Propertys-Datei erzeugen Sie mit einem StartCLI-Befehl ein neues zip-Archiv.

  3. Sie lassen das zip-Archiv mit weiteren StartCLI-Befehlen in das Zielsystem importieren.

Wenn zwischen Quell- und Zielserver keine direkte Netzverbindung besteht, benötigen Sie für den Export und den Import jeweils ein eigenes Skript.

Aufruf

startcli[.sh|.bat] <Optionen> <Server-URL>
bash

Exportieren:

startcli --execCommand "export <Exportkommandos> [<Option>] [<Argument>] [<Option>] [<Argument>] ...]" <Server-URL>
bash

Modifizieren:

startcli --execCommand "deploy <Deploykommandos> [<Option>] [<Argument>] [<Option>] [<Argument>]" <Server-URL>
bash

Importieren:

startcli -u root --execCommand "import --importUser <Benutzergruppe> --importFile <Dateiname>.zip"
bash

Siehe Modelldaten über das CLI exportieren und importieren.

Server-URL

URL der Process Engine, auf der das CLI ausgeführt wird, zum Beispiel:

https://<server>:<port>/ibis/servlet/IBISSoapServlet

Die folgende Tabelle erläutert detailliert den Ablauf des Deployments und die nötigen Befehle für das Kommandozeilentool StartCLI:

Nr. Ablauf StartCLI-Befehl und Erläuterung

1.

StartCLI aufrufen

StartCLI beendet sich nach jedem Aufruf, d.h. Sie müssen StartCLI bei jedem folgenden Schritt mit dem jeweiligen Befehl aufrufen.

  • Im Client-Verzeichnis: <inubit-installdir>client/bin

  • Im Verzeichnis der Process Engine, falls keine INUBIT Workbench installiert wurde: <inubit-installdir>server/process_engine/bin

startcli.sh bzw. *.bat -u <Benutzername> -p <Passwort> <Server-URL>

2.

Workflows aus dem Quellsystem exportieren

--exportWorkflowUser <Benutzer|Gruppe|Obergruppe>
--exportTag <Tagname> (optional, wenn nichts angegeben, wird die Headversion exportiert)

--exportWorkflowGroup <Diagrammgruppe> (mehrere Gruppen mit Kommas trennen). Ist mit dem Argument "" keine Gruppe angegeben, werden alle Gruppen exportiert.

Mit der Option ‑‑exportWorkflowGroupExclude können einzelne Gruppen aus dem Export ausgeschlossen werden. --exportWorkflowGroupExclude Kommaseparierte Ausschlussliste. Keine der aufgeführten Gruppen wird exportiert.

--exportWorkflowType <technical|constraintsdiagram|bpd|processmap> (Pro Export ist nur ein Diagrammtyp möglich, bei unterschiedlichen Diagrammtypen sind mehrere Exports nötig.)

--exportFile <AbsoluterPfad_NameExportDatei>.zip (Die Exportdatei ist immer eine *.zip-Datei), Beispiel: --exportFile /home/MyUser/tmp/auto-deploy/src_workflows.zip

--includeHistory (optional): Fügen Sie diese Option hinzu, um für alle Diagramme und Module, die exportiert werden, die Versionshistorie zu erhalten. Wird diese Option genutzt, wird eine neue Datei versionHistory.xml erzeugt und dem gleichen Dateipfad wie dem Pfad für die exportFile Option hinzugefügt. Sie enthält für jede Version die Metadaten wie Nutzer oder Zeitpunkt, aber nicht die Inhalte.

3.

Repository-Dateien aus dem Quellsystem exportieren

--exportRepositoryPath <Repositorypfad>, z.B. /Root/INUBIT

--exportTag <Tagname> (optional, wenn nichts angegeben, wird die Headversion exportiert)

--exportFile <AbsoluterPfad_NameExportDatei>.zip <URL_inubit Process Engine> (Die Exportdatei ist immer eine *.zip-Datei)

4.

Property-XML aus Quell-Workflows extrahieren

--deployWorkflowArchive
<AbsoluterPfad_NameExportDatei>.zip

--deploySystemName (Beliebiger Bezeichner, der in die Property-XML geschrieben wird, z.B. Hostname. Macht bei verschiedenen Property-XMLs kenntlich, woher die Propertys stammen.)

--deployConfiguration <AbsoluterPfad+DeploymentKonfigDatei>, z.B. /tmp/ibis_deploy.xml

--deployCreateProperties
<AbsoluterPfad_NamePropertysDatei> (Name und Speicherort der zu erzeugenden neuen Propertys-Datei)

5.

Property-XML für das Zielsystem auf Basis der eben erzeugten Quell-Property-XML anpassen

Keine StartCLI-Befehle nutzbar.
Verwenden Sie z.B. Shell-Befehle oder XSLT.

6.

Workflows für das Zielsystem generieren auf Basis der Quell-Workflows und der Ziel-Property-XML

--deployWorkflowArchive
<AbsoluterPfad_NameDesExportiertenZipArchivs>.zip

--deployMergedProperties
<AbsoluterPfad_NameDerNeuenPropertysDatei>

--deployMergedArchive
<AbsoluterPfad_NameFuerNeuesImportArchiv>.zip (Workflowarchiv mit angepassten Propertys)

7.

Repository-Dateien in das Zielsystem importieren

--importRepositoryPath <Repositorypfad> (Ziel des Imports)

--importFile <AbsoluterPfad_NameExportDatei>.zip
<URL_Ziel-inubit Process Engine>

8.

Workflows in das Zielsystem importieren

--importWorkflowActive oder --importWorkflow (einer der beiden Befehle muss angegeben werden, bei importWorkflowActive werden die Workflows nach dem Import aktiviert, bei importWorkflow nicht)

--importFile <AbsoluterPfad_NameImportArchiv>.zip
(Workflowarchiv mit angepassten Propertys)

--importUser <Benutzer|Gruppe|Obergruppe> <URL_Ziel-inubit Process Engine>

9.

Aktives Tag in Zielsystem setzen

--tagSetActive <Tagname>

--tagUser <Benutzer|Gruppe|Obergruppe> <URL_Ziel-inubit Process Engine>
Press Esc to exit full screen
Modal image placeholder
Press Esc to exit full screen