Modelldaten über das CLI exportieren und importieren

Sie können Diagramme, Metadaten und Repositorydaten exportieren.

Diagramme über das CLI exportieren

Aufruf

  • Interaktiver Modus

    startcli [-u <Benutzerkennung>] [-p <Passwort>]
    ...
    export --exportWorkflowGroup [<Diagrammgruppe>] --exportWorkflowUser <Besitzer der
    Diagrammgruppe> --exportWorkflowType <Workflowtyp> --exportFile <Dateipfad zum ZIP-
    Archiv> [--exportWorkflowGroupExclude <Ausschlussliste>] [--exportTag <Tag>]
  • Skriptmodus

    startcli [-u <Benutzerkennung>] [-p <Passwort>] --execCommand "export --
    exportWorkflowGroup [<Diagrammgruppe>] --exportWorkflowUser <Besitzer der
    Diagrammgruppe> --exportWorkflowType <Workflowtyp> --exportFile <Dateipfad zum ZIP-
    Archiv>"

Kommandooptionen

Option Beschreibung

-h,--help

Anzeigen der Hilfe

--exportFile <arg>

Absoluter Pfad zur Exportausgabedatei (ZIP-Archiv)

--exportTag <arg>

Optional: Tag, der exportiert werden soll. Ist kein Tag angegeben, wird HEAD exportiert.

--exportWorkflowGroup <arg>

Name der zu exportierenden Workflowgruppe(n).
Mehrere Workflowgruppen geben Sie kommasepariert und in Hochkommas eingeschlossen an.
Mit der Option --exportWorkflowGroup '' werden alle Workflowgruppen exportiert.

--exportWorkflowGroupExclude <arg>

Optional: Workflowgruppe(n), die nicht exportiert werden soll(en).
Mehrere Workflowgruppen geben Sie kommasepariert und in Hochkommas eingeschlossen an.

--exportWorkflowType <arg>

Typ(en) der zu exportierenden Diagramme.

Mehrere Diagrammtypen geben Sie kommasepariert und in Hochkommas eingeschlossen an.

Um alle Diagrammtypen zu exportieren, geben sie 'all' als Argument an.

  • technical: Technical Workflows

  • organigram: Organigramme

  • systemdiagram: Systemdiagramme

  • constraintsdiagram: Business Object Diagramme

  • bpd: Business Process Diagramme

  • processmap: Prozesslandkarten

--exportWorkflowUser <arg>

Benutzer, Benutzergruppe oder Benutzerobergruppe der/die Besitzer der angegebenen Workflowgruppe(n) ist

--includeHistory

Optional: Um die Versionshistorie aller exportierten Diagramme und Module zu erhalten. Ist diese Option gesetzt, wird die Datei versionHistory.xml erzeugt und in dem mit exportFile angegebenen Pfad abgelegt.

Beispiel

Exportieren aller BPDs des Benutzers jh mit Ausnahme der Diagrammgruppen HR processes und iS60SP3 in das ZIP-Archiv c:\temp\export_inubit_2014_09_10.zip.

  • Interaktiver Modus

    export --exportWorkflowUser jh --exportFile c:\temp\export_inubit_2014_09_10.zip --exportWorkflowType bpd --exportWorkflowGroup '' --exportWorkflowGroupExclude 'HRprocesses, iS60SP3'
  • Skriptmodus

    startcli -u jh -p inubit --execCommand "export --exportWorkflowUser jh --exportFile
    c:\temp\export_inubit_2014_09_10.zip --exportWorkflowType bpd --exportWorkflowGroup ''
    --exportWorkflowGroupExclude 'HR processes, iS60SP3'"

    Der Benutzer, dessen Diagramme exportiert werden sollen, muss sich über das CLI an der Process Engine anmelden, d.h., jeder Benutzer darf nur die eigenen Diagramme exportieren.

Metadaten über das CLI exportieren

Aufruf

  • Interaktiver Modus

    startcli [-u <Benutzerkennung>] [-p <Passwort>]
    ...
    export --exportMetadata --exportMetadataNames '<Metadatenname(n)>' --exportFile
    <Dateipfad zum ZIP-Archiv>
  • Skriptmodus

    startcli [-u <Benutzerkennung>] [-p <Passwort>] --execCommand "export --exportMetadata
    --exportMetadataNames '<Metadatenname(n)>' --exportFile <Dateipfad zum ZIP-Archiv>"

Kommandooptionen

Option Beschreibung

-h,--help

Anzeigen der Hilfe

--exportFile <arg>

Absoluter Pfad zur Exportausgabedatei (ZIP-Archiv)

--exportMetadata

Metadaten exportieren

--exportMetadataNames <arg>

Name(n) der zu exportierenden Metadaten. Mehrere Metadaten geben Sie kommasepariert und in Hochkommas eingeschlossen an.

Beispiel

Exportieren der Metadaten Duration und Costs in das ZIP-Archiv c:\temp\export_metadata_2014_09_10.zip.

  • Interaktiver Modus

    export --exportMetadata --exportMetadataNames 'Duration, Costs' --exportFile c:\temp\export_metadata_2014_09_10.zip
  • Skriptmodus

    startcli -u jh -p inubit --execCommand "export --exportMetadata --exportMetadataNames
    'Duration, Costs' --exportFile c:\temp\export_metadata_2014_09_10.zip"

Repositorydaten über das CLI exportieren

Aufruf

  • Interaktiver Modus

    startcli [-u <Benutzerkennung>] [-p <Passwort>]
    ...
    export --exportRepositoryPath <Repository-Pfad> --exportFile <Dateipfad zum ZIP-Archiv>
  • Skriptmodus

    startcli [-u <user account>] [-p <password>] --execCommand "export --exportRepositoryPath <Repository-Pfad> --exportFile <Dateipfad zum ZIP-Archiv>"

Kommandooptionen

Option Beschreibung

-h,--help

Anzeigen der Hilfe

--exportFile <arg>

Absoluter Pfad zur Exportausgabedatei (ZIP-Archiv)

--exportRepositoryPath

Repositorypfad dessen Daten exportiert werden sollen

--exportTag <arg>

Optional: zu exportierendes Tag. Wenn kein Tag angegeben ist, wird HEAD exportiert.

Beispiel

Exportieren des Repositorypfads /Root/jh/BPM Rules in das ZIP-Archiv c:\temp\export_jh_repository.zip.

  • Interaktiver Modus

    export --exportRepositoryPath '/Root/jh/BPM Rules'
    --exportFile c:\temp\export_jh_repository.zip
  • Skriptmodus

    startcli -u jh -p inubit --execCommand "export --exportRepositoryPath '/Root/jh/BPM Rules' --exportFile c:\temp\export_jh_repository.zip"

Daten über das CLI importieren

Verwendung

Importieren beliebiger Daten (Workflows, Repositorydateien, Benutzer, Benutzergruppen und Metadaten) in die Process Engine

Die Optionen ‑‑importUser, ‑‑importUserGroup, ‑‑importWorkflow können sowohl primäre Option als auch sekundäre Option sein. Die primäre Option bestimmt dabei, welche Daten importiert werden.

Aufruf

startcli -u<Benutzer> [-p<Passwort>]
...
import <Option> [<arg>]

Kommandooptionen

Option Beschreibung

-h,--help:

Anzeigen der Hilfe

--importFile <arg>

Dateipfad zum Archiv, das importiert werden soll (Pflichtparameter für das Importieren von Benutzern, Repositorydaten, Metadaten und Workflows)

--importWorkflow

Ist diese Option gesetzt, ist der Workflowmodus aktiv.

--importWorkflowActive

Im Workflowmodus können Sie mit dieser Option die importierten Workflows nach dem Import automatisch aktivieren.
Ist diese Option nicht gesetzt, müssen Sie die importierten Workflows anschließend über die Workbench aktivieren.

--importUser <arg>

Im Benutzermodus (nur diese Option ist angegeben) spezifiziert das Argument den Namen der Benutzergruppe, in die der Benutzer importiert werden soll. Im Workflow-Modus (Option --importWorkflow ist zusätzlich angegeben) spezifiziert das Argument den Benutzer, in den die Workflows importiert werden sollen.

--importUserGroup <arg>

Im Benutzergruppenmodus (nur Option ist angegeben) spezifiziert das Argument den Namen der Obergruppe.

--overwriteUserRoles <arg>

Im Benutzermodus und Benutzergruppen-Modus können Sie mit dieser Option die Rechte der bereits in der Process Engine zugewiesenen Rollen durch die Rechte der zu importierenden Rollen ersetzen. Ist die Option nicht gesetzt, werden die Rechte der Rollen im Import-Archiv ignoriert und die Rechte in der Process Engine gesetzten Rollen verwendet.

--importMetadata

Metadaten importieren

--importRepositoryPath <arg>

Repositorydaten importieren. Als Argument müssen Sie den Zielpfad zum Benutzer angeben, in dessen Verzeichnis die Daten importiert werden sollen, z.B.: /Root/admin

--importLDAPDetails --importFile
<file path>

Liefert LDAP-Informationen in der beigefügten LDAP_CLI_Sync_Template.xml (siehe unten) XML-Datei, um Details für die LDAP Server-Konfiguration zu importieren. Gleiches XML kann im Pfad als Argument angegeben werden. Diese Server-Konfiguration wird anschließend für die Synchronisation der Benutzer-Details verwendet. Im XML muss der User das Mapping zwischen den zu synchronisierenden Feldern aus dem LDAP-System und INUBIT angeben.

Der Benutzer muss explizit Role, UserGroup und UserDefaultPassword auf den neu importierten Benutzer umstellen. Die Properties Host, Port, LoginDN und Password sind genauso wie die korrekte SearchDN obligatorisch.

--syncLDAPUsers

Mit diesem Befehl werden die bereits aus dem LDAP-System importierten INUBIT Benutzer-Details aktualisiert bzw. ein neuer Benutzer aus dem LDAP-System nach INUBIT importiert.

Wird dieser Befehl ausgeführt, werden die Mapping-Details aktualisiert bzw. der neue Benutzer zusammen mit den aktualisierten Details INUBIT hinzugefügt.

Bei bereits bestehenden Benutzern werden Benutzerrolle, Benutzergruppe und Standard-Passwort nicht aktualisiert.

--returnProtocol

Wird diese Option während des Imports von Workflows, Benutzern oder Benutzergruppen gesetzt, wird das Import-Log als Protokoll zurückgeliefert.

Beispiel

Mit der Option ‑‑importWorkflow importieren Sie Workflows. Mit der zusätzlichen Option ‑‑importUser INUBIT spezifizieren Sie den Benutzer inubit, in den die Workflows importiert werden sollen.

startcli -u root --execCommand "import --importWorkflow --importUser inubit
--importFile "C:\inubit\ExportImport\inubit.diagramgroup_2014_09_16.zip""

Mit den Optionen ‑‑importUser und --importFile importieren Sie ein Benutzerarchiv in die angegebene Benutzergruppe.

startcli -u root --execCommand "import --importUser inubit_group
--importFile C:\inubit\ExportImport\inubit.user_2014_09_16.zip"

LDAP_CLI_Sync_Template.xml

<?xml version='1.0' encoding='UTF-8'?>
<Property name="LDAPProperties" type="Map">
  <Property name="AutoSynchronization" type="Boolean">false</Property>
  <Property name="LoginCaching" type="Boolean">false</Property>
  <Property name="UpdateInterval" type="TimePeriod">5400</Property>
  <Property name="Host">0.0.0.0</Property>
  <Property name="Port" type="Integer">389</Property>
  <Property name="EnableEncryption" type="Boolean">false</Property>
  <Property name="ServerAuth" type="Boolean">false</Property>
  <Property name="ServerCertPath"></Property>
  <Property name="LoginDN">cn=user,dc=company,dc=com</Property>
  <Property name="Password" type="Password" encrypted="false"></Property>
  <Property name="SearchDN">dc=company,dc=com</Property>
  <Property name="Filter">(objectclass=*)</Property>
  <Property name="Group" type="Boolean">false</Property>
  <Property name="GroupFilter">(objectclass=*)</Property>
  <Property name="GroupAttribute">member</Property>
  <Property name="Role">Business Analyst</Property>
  <Property name="UserGroup">admin</Property>
  <Property name="UserDefaultPassword" type="Password" encrypted="false"></Property>
  <Property name="LDAPAttributes" type="Map">
    <Property name="Email">mail</Property>
    <Property name="UserName">uid</Property>
    <Property name="FirstName">givenName</Property>
    <Property name="LastName">sn</Property>
  </Property>
</Property>