bpmn-studio-alpha v5.10.0-feature-6072fa-k3hdfibf
BPMN Studio
BPMN Studio ist eine Web- und Desktop-Applikation zur Erstellung, Verwaltung, Ausführung und Auswertung von BPMN-Prozessen. Es setzt auf dem BPMN.io auf und den BPMN-Standard 2.x um.
Was sind die Ziele dieses Projekts?
BPMN Studio soll es dem Anwender so leicht wie möglich machen BPMN-Diagramme zu erstellen und zu pflegen. Des Weiteren kann BPMN Studio mit einer Workflow Engine verbunden werden, um diese Diagramme auszuführen.
Relevante URLs
Downloads für Windows, macOS und Docker
Es stehen Releases von BPMN Studio für Windows und macOS zum Download bereit.
Ein Docker-Image des kompletten Bundles (BPMN Studio & ProcessEngine Runtime) wird auf Docker Hub bereitgestellt.
Wie kann ich das Projekt aufsetzen?
Voraussetzungen
- Node active LTS
- Laufende ProcessEngine
Setup/Installation
TL;DR
npm install
npm run build
npm start
/npm run start_dev
Notizen:
Für
npm run electron-build-<OS>
gilt:Für den Platzhalter
<OS>
können folgende Werte eingesetzt werden:macos
für MacOSwindows
für Windows
Beispiel:
npm run electron-build-macos
TL;DR Tests
npm start
npm run electron-build-<OS>
npm test
Wie kann ich das Projekt benutzen?
Installation der Abhängigkeiten
Die Abhängigkeiten werden wie folgt installiert:
npm install
Benutzung
Zum bauen:
npm run build
Dieses Skript baut die Anwendung, das Ergebnis ist produktionsreif.
Zum starten:
npm start
Dieses Skript startet die statische Auslieferung der Anwendung auf Port 17290. Zuerst muss die Anwendung gebaut worden sein.
Es ist möglich einen anderen Port zu spezifizieren:
npm start -- --port 9000
Das startet das BPMN Studio auf Port 9000.
Anmerkung
Der Port muss aus technischen Gründen zwischen 1000 und 65535 liegen.
Erreichbarkeit
Es ist möglich eine andere IP-Adresse als 127.0.0.1 zu spezifizieren:
npm start -- --host 0.0.0.0
Damit ist das BPMN Studio auch von außen erreichbar.
Zum starten (Entwicklung)
npm run start_dev
Dieses Skript startet die Auslieferung der Anwendung für die Entwicklung. Bei Änderungen im Quelltext wird die Anwendung neugebaut und der Webbrowser automatisch neu geladen.
Electron Applikation
Zum bauen:
Mac:
npm run electron-build-macos
Nach dem Bauen kann man in dem dist/electron/mac
Ordner die fertige Applikation finden
und ausführen.
Windows:
Vor dem erstmaligen Builden müssen die windows-build-tools installiert werden:
npm install --global --production windows-build-tools
Danach kann gebuildet werden:
npm run electron-build-windows
Nach dem Bauen, kann man in dem dist/electron/
Ordner die Datei bpmn-studio-setup-
<VERSION>.exe
ausführen, um die Applikation zu installieren; <VERSION>
wird
durch die entsprechende Version ersetzt.
Beispiel:
dist/electron/bpmn-studio-setup-5.7.0.exe
Docker Image
Container bauen
Das Image lässt sich wie folgt bauen:
docker build --tag bpmn-studio:latest .
Container bauen mit optionalen Parametern
Es ist möglich, das base image, sowie die Paketversionen anzupassen:
node_version
: Base image version mit NodeJS und Alpine Linux
docker build --build-arg node_version=10-alpine \
--tag bpmn-studio:latest.
Container starten
Der Container lässt sich mit folgendem Befehl starten:
docker run -p 9000:9000 bpmn-studio:latest
Anschließend lässt sich das BPMN Studio unter URL http://localhost:17290
aufrufen.
Shortcut Skripte
Es sind Skripte in der package.json
vordefiniert, welche
sich durch npm run <script name>
ausführen lassen.
Die folgenden Skripte, werden in unserem Tooling verwendet:
build
Baut alles, was zum Ausführen der Webversion, der Electron-Dev App und der Tests notwendig ist.
reinstall
Entfernt die aktuell installierten Abhängigkeiten, installiert diese neu und baut die komplette Anwendung.
reset
Entfernt alle aktuell installierten Abhängigkeiten.
start
Startet die BPMN Studio Webanwendung.
start_dev
Startet die BPMN Studio Webanwendung und trackt die Quelldatein (geänderte Quelltextdatein werden neu transpiliert und die Webanwendung wird neu geladen).
electron-start-dev
Baut das Aurelia Bundle und startet die Electron Anwendung.
lint
Startet
eslint
für das gesamte Projekt.electron-build-macos
Baut die Electron-Anwendung für macOS.
electron-build-windows
Baut die Electron-Anwendung für Windows.
electron-rebuild
Baut alle nativen Abhängigkeiten.
test
Führt die Spectron Tests für das BPMN Studio in Electron aus.
test-electron
Baut die Tests und führt diese mit der gebauten BPMN Studio App aus.
test-electron-macos
Führt die Tests in der Electron Dev Variante auf macOS aus.
test-electron-windows
Führt die Tests in der Electron Dev Variante auf Windows aus.
Was muss ich sonst noch wissen?
Die Konfiguration liegt unter aurelia_project/environments/dev.ts
.
Wen kann ich auf das Projekt ansprechen?
Alexander Kasten Christian Werner René Föhring Steffen Knaup
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago