Bitte beachten: Dieser Artikel ist eine KI-generierte Übersetzung.
Zoom Nightshift automatisiert Aktionen in Zoom mithilfe von JSON-Skriptdateien in Kombination mit dem Windows Task Scheduler.
Mit Nightshift können Sie die folgenden Aktionen in BIMcollab automatisieren:
Modelle öffnen / Zum Projekt hinzufügen
Mit dem Projekt verbinden
Issues filtern
Issues aktualisieren
Alle Listen ausführen und teilen
Projekt synchronisieren
In diesem Artikel beschreiben wir, wie man ein Skript erstellt, das in Zoom Nightshift ausgeführt werden soll.
Für weitere Informationen zur Einrichtung einer Aufgabe im Windows Task Scheduler konsultieren Sie den Artikel Eine Aufgabe für Zoom Nightshift im Windows Task Scheduler konfigurieren.
📝 Hinweis: Ein JSON-Skript kann in jedem JSON-Skript-Editor eingerichtet werden. Ein Beispielskript finden Sie als Anhang zu diesem Artikel, um Ihnen den Einstieg zu erleichtern.
Das Skript beginnt mit dem Titel des Skripts und optional der Version, gefolgt von den Aktionen, die in BIMcollab ausgeführt werden sollen, wenn das Skript ausgeführt wird.
{
"title": "Example_Script",
"version": "0.1",
"actions": [
Die verschiedenen Aktionen, die dem Skript hinzugefügt werden können, damit BIMcollab sie während Nightshift ausführt, werden im Rest dieses Artikels erklärt.
Modelle öffnen / Zum Projekt hinzufügen
Das Erste, was Sie in Nightshift tun möchten, ist, eine Reihe von Modellen zu öffnen, auf denen die restlichen Aktionen ausgeführt werden können. Dafür gibt es zwei verschiedene Eingabeaufforderungen:
OPEN_MODELS: fügt ein Modell dem Navigator hinzu und lädt es, und schließt alle zuvor geladenen Modelle
ADD_TO_PROJECT: fügt ein Modell dem Navigator hinzu und lädt es, ohne bereits im Navigator vorhandene Modelle zu schließen
📝 Hinweis: Wenn Sie sich mit einem Projekt verbinden, in dem ein Projektordner aktiv ist, werden alle Modelle im Projektordner automatisch geladen, unabhängig von ihrem Ladezustand in Ihrem Projekt. Es ist keine zusätzliche Eingabe im Skript erforderlich, um diese Modelle zu öffnen.
Wenn Sie zusätzliche Modelle zum Projekt hinzufügen möchten, die sich nicht im Projektordner befinden, verwenden Sie die Eingabeaufforderung ADD_TO_PROJECT.
Skript
{
"type": "OPEN_MODELS",
"models": [
"C:/Users/userone/Desktop/1.ifc",
"C:/Users/userone/Desktop/2.ifc",
"C:/Users/userone/Desktop/3.bcp"
]
}
Erklärung
Ersetzen Sie "C:/Users/userone/Desktop/1.ifc" usw. durch die Pfade zu den Modellen, die Sie öffnen möchten, getrennt durch Kommas.
⚠️ Achtung: Verwenden Sie immer Schrägstriche "/" in der Pfaddefinition, keine Rückwärtsschrägstriche.
Mit dem Projekt verbinden
Um ein Update von Smart Issues durchzuführen und Listen zu teilen, müssen Sie mit einem Projekt auf BIMcollab verbunden sein.
Die Eingabeaufforderung hierfür ist CONNECT_TO_PROJECT
Skript
{
"type": "CONNECT_TO_PROJECT",
"space_name": "example.bimcollab.com",
"project_name": "Mein BIMcollab-Projekt"
}
Erklärung
Ersetzen Sie "example.bimcollab.com" durch die URL des WebRaums, mit dem Sie sich verbinden möchten.
Ersetzen Sie "Mein BIMcollab-Projekt" durch den Namen des Projekts, mit dem Sie sich verbinden möchten. Achten Sie auf die korrekte Schreibweise des Namens und der URL.
⚠️ Achtung: Es ist wichtig zu beachten, dass das Projekt, mit dem Sie sich verbinden möchten, Teil der Liste der letzten Projekte in BIMcollab ist und dass Ihre Anmeldedaten in BIMcollab gespeichert sind. Dies kann erreicht werden, indem Sie das Kontrollkästchen 'Angemeldet bleiben' aktivieren, wenn Sie sich manuell mit dem Projekt verbinden.
Stellen Sie außerdem sicher, dass das Format des "space_name"-Parameters genau dem Format entspricht, in dem der WebRaum-Name beim Verbinden mit dem Projekt eingegeben wurde.
Wenn Sie beispielsweise https://example.bimcollab.com/ oder example.bimcollab.com, eingegeben haben, muss dies im Skript genau übereinstimmen.
Issues filtern
Sobald Sie mit einem Projekt verbunden sind, werden alle für Sie sichtbaren Issues im Projekt in BIMcollab geladen.
Im nächsten Schritt können alle Smart Issues, die Teil dieser Liste sind, automatisch aktualisiert werden. Um nur eine Auswahl von Issues Ihrer Wahl zu aktualisieren, richten Sie zuerst den Issue-Filter ein.
Die Eingabeaufforderung ist FILTER_ISSUES.
Wenn diese Eingabeaufforderung im Skript weggelassen wird, wird der letzte aktive Filter verwendet.
Skript
{
"type": "FILTER_ISSUES",
"filter_type": "Issue",
"area": "Model",
"milestone": "Design phase",
"label": "Architecture",
"priority": "Normal",
"show_active": true,
"show_resolved": true,
"show_closed": false,
"hide_invisible": false,
"show_to_approve": false,
"assigned_to_user_email": "[email protected]",
"deadline": "01-01-2021",
"created_by_user_email": "[email protected]",
"custom1": "Value 1",
"custom2": "Value 2"
}
Erklärung
Hier sind einige Dinge, die Sie für diesen Teil des Skripts beachten sollten:
Wenn diese Eingabeaufforderung dem Skript hinzugefügt wird, wird der Issue-Filter in BIMcollab zuerst auf den Standardfilter zurückgesetzt und dann gemäß den Werten im Skript angepasst.
Nightshift nimmt, wann immer möglich, die Standardeinstellungen der Parameter an, sodass Sie nur Änderungen angeben müssen, die von den Standardeinstellungen abweichen. Alle Parameterzeilen in diesem Teil des Skripts, mit Ausnahme von "type": "FILTER_ISSUES" (obligatorische Aktionsdefinition) und der "priority", können aus dem Skript weggelassen werden. Wenn zum Beispiel der Parameter "label" weggelassen wird, behält Nightshift diese Parametereinstellung bei "All".
Achten Sie auf die Schreibweise der eingegebenen Werte. Sie müssen genau so sein, wie sie im Projekt sind.
💡 Tipp: Öffnen Sie das Issue-Filterfenster in BIMcollab neben dem JSON-Editor, um Tippfehler im Skript zu vermeiden.
Alle Zeilen in diesem Teil des Skripts repräsentieren eine der Eigenschaften im Issue-Filter:
"filter_type"
Ersetzen Sie "Issue" durch den Typ, den Sie filtern möchten. Der Standardwert ist "All" (oder der entsprechende Wert in der Sprache Ihres Projekts)."area"
Ersetzen Sie "Model" durch den Bereich, den Sie filtern möchten. Der Standardwert ist "All" (oder der entsprechende Wert in der Sprache Ihres Projekts)."milestone"
Ersetzen Sie "Design phase" durch den Meilenstein, den Sie filtern möchten. Der Standardwert ist "All" (oder der entsprechende Wert in der Sprache Ihres Projekts)."label"
Ersetzen Sie "Architecture" durch das Label, das Sie filtern möchten. Der Standardwert ist "All" (oder der entsprechende Wert in der Sprache Ihres Projekts)."priority"
Ersetzen Sie "Normal" durch die Priorität, die Sie filtern möchten. Der Standardwert ist "All" (oder der entsprechende Wert in der Sprache Ihres Projekts)."show_active"
Dies ist ein Kontrollkästchen, das bestimmt, ob die aktiven Issues des Projekts angezeigt werden sollen. Geben Sie 'true' ein, wenn das Kontrollkästchen aktiviert werden soll, oder 'false', wenn es deaktiviert werden soll. Der Standardwert ist true."show_resolved"
Dies ist ein Kontrollkästchen, das bestimmt, ob die gelösten Issues des Projekts angezeigt werden sollen. Geben Sie 'true' ein, wenn das Kontrollkästchen aktiviert werden soll, oder 'false', wenn es deaktiviert werden soll. Der Standardwert ist true."show_closed"
Dies ist ein Kontrollkästchen, das bestimmt, ob die geschlossenen Issues des Projekts angezeigt werden sollen. Geben Sie 'true' ein, wenn das Kontrollkästchen aktiviert werden soll, oder 'false', wenn es deaktiviert werden soll. Der Standardwert ist false."hide_invisible"
Dies ist ein Kontrollkästchen, das bestimmt, ob Issues, die nicht für alle Team-Mitglieder sichtbar sind, ausgeblendet werden sollen. Geben Sie 'true' ein, wenn das Kontrollkästchen aktiviert werden soll, oder 'false', wenn es deaktiviert werden soll. Der Standardwert ist false."show_to_approve"
Dies ist ein Kontrollkästchen, das bestimmt, ob die Issues, die Sie genehmigen müssen, angezeigt werden sollen. Geben Sie 'true' ein, wenn das Kontrollkästchen aktiviert werden soll, oder 'false', wenn es deaktiviert werden soll. Der Standardwert ist false."assigned_to_user_email"
Ersetzen Sie "[email protected]" durch die E-Mail-Adresse des zugewiesenen Benutzers, nicht nur durch deren Namen. Der Standardwert ist "" (Issues, die allen Benutzern zugewiesen sind, werden angezeigt)."deadline"
Ersetzen Sie "01-01-2021" durch die Deadline, nach der Sie filtern möchten, im Format dd-mm-yyyy. Der Standardwert ist "" (es wird keine Deadline berücksichtigt)."created_by_user_email"
Ersetzen Sie "[email protected]" durch die E-Mail-Adresse des Erstellers, nicht nur durch deren Namen. Der Standardwert ist "" (Issues, die von allen Benutzern erstellt wurden, werden angezeigt)."custom1"
Ersetzen Sie "Value 1" durch den Wert des benutzerdefinierten Listenfelds 1, den Sie filtern möchten. Die Skriptzeile sollte immer mit "custom1" beginnen, nicht mit dem tatsächlichen Namen des benutzerdefinierten Feldes. Der Standardwert ist "" (Alle Werte für dieses benutzerdefinierte Feld werden angezeigt)."custom2"
Ersetzen Sie "Value 2" durch den Wert des benutzerdefinierten Listenfelds 2, den Sie filtern möchten. Die Skriptzeile sollte immer mit "custom2" beginnen, nicht mit dem tatsächlichen Namen des benutzerdefinierten Feldes. Der Standardwert ist "" (Alle Werte für dieses benutzerdefinierte Feld werden angezeigt).
⚠️ Achtung: Wenn einer der Eingaben des Filters falsch ist, wird das Skript nicht weiter ausgeführt.
Issues aktualisieren
Alle Smart Issues, die im Issues-Tab von BIMcollab sichtbar sind, können automatisch entsprechend dem Status der Clashes in den geladenen Modellen aktualisiert werden.
Die Eingabeaufforderung ist UPDATE_ISSUES.
Skript
{
"type": "UPDATE_ISSUES",
"close_where_clashes_solved": true,
"reopen_previously_closed_issues": false,
"comment": "Updated with Nightshift"
}
Erklärung
Jede Zeile in diesem Teil des Skripts repräsentiert eine der Optionen im Fenster 'Smart Issues aktualisieren'. Beachten Sie, dass 'Nur ausgewählte Issues' nicht vorhanden ist, da keine Issues separat ausgewählt werden können, während das Skript ausgeführt wird. Die Aktion wird auf alle sichtbaren Issues im Issues-Tab angewendet.
"close_where_clashes_solved"
Dies ist ein Kontrollkästchen, das bestimmt, ob Issues, bei denen alle Clashes gelöst sind, mit dem Update geschlossen werden können. Geben Sie 'true' ein, wenn das Kontrollkästchen aktiviert werden soll, oder 'false', wenn es deaktiviert werden soll"reopen_previously_closed_issues"
Dies ist ein Kontrollkästchen, das bestimmt, ob geschlossene Issues, die noch aktive Clashes enthalten, mit dem Update wieder geöffnet werden können. Geben Sie 'true' ein, wenn das Kontrollkästchen aktiviert werden soll, oder 'false', wenn es deaktiviert werden soll"comment"
Ersetzen Sie "Updated with Nightshift" durch einen beliebigen Kommentar, den Sie den aktualisierten Issues hinzufügen möchten
Wenn eine der Optionen fehlt, wird ein Standardwert hinzugefügt, wie im Bild unten gezeigt.
Listen ausführen und teilen
Alle Listen, die sich unter 'Geteilt' im Listen-Tab befinden, können gleichzeitig ausgeführt und geteilt werden, sodass die aktuellsten Informationen für alle Team-Mitglieder in BIMcollab verfügbar sind.
Der Befehl für diese Aktion ist RUN_AND_SHARE_LISTS
Skript
{
"type": "RUN_AND_SHARE_LISTS",
"list_set-name" : "List set 3"
}
Erklärung
Der Parameter "list_set_name" ist optional. Wenn Sie ein bestimmtes Listenset ausführen möchten, ersetzen Sie "List set 3" durch den Namen des Listensets, das Sie ausführen möchten. Wenn der Parameter nicht vorhanden ist, werden alle Listen unter 'Geteilt' ausgeführt und geteilt.
Projekt synchronisieren
Sobald Issues aktualisiert und Listen ausgeführt und geteilt wurden, ist es wichtig, das Projekt immer mit BIMcollab zu synchronisieren, damit die Änderungen gespeichert und für den Rest des Teams sichtbar sind.
Fügen Sie diesen Befehl immer am Ende des Skripts hinzu.
Der Befehl ist SYNCHRONIZE_PROJECT.
Skript
{
"type": "SYNCHRONIZE_PROJECT"
}
Status der Aufgabe verfolgen
Sobald die Aufgabe ausgeführt wurde, können Sie im Nightshift-Protokoll überprüfen, ob alle Aktionen erfolgreich durchgeführt wurden. Die Datei gibt Rückmeldung über den Ausführungsstatus aller Aktionen in den Skripten und Fehlercodes, falls etwas schiefgelaufen ist.
Sie finden alle Protokolldateien unter C:\Users\\AppData\Roaming\KUBUS\BIMcollab Zoom\Nightshift.
Ersetzen Sie den Namen mit Ihrem eigenen Benutzerprofil in Windows.
Der AppData-Ordner ist standardmäßig ein versteckter Ordner. Blenden Sie die versteckten Ordner im Datei-Explorer ein, um zum richtigen Ort zu navigieren.