Ein JSON-Skript kann in jedem JSON-Skript-Editor erstellt werden.

Im Anhang zu diesem Artikel finden Sie ein Beispielskript, das Ihnen den Einstieg erleichtern soll.

Das Skript beginnt mit dem Titel des Skripts und optional der Version, gefolgt von den Aktionen, die in Zoom ausgeführt werden sollen, wenn das Skript ausgeführt wird.

{

"title": "Example_Script",
"version": "0.1",

"actions": [

Modelle öffnen / Dem Projekt hinzufügen Hinzufügen zu Projekten

1. OPEN_MODELS: fügt ein Modell zum Navigator hinzu, lädt es und schließt alle zuvor geladenen Modelle
2. ADD_TO_PROJECT: fügt ein Modell zum Navigator hinzu und lädt es, ohne die Modelle zu schließen, die bereits im Navigator vorhanden sind

Hinweis: Wenn Sie eine Verbindung zu einem Projekt herstellen, in dem ein Projektordner aktiv ist, werden alle Modelle im Projektordner automatisch geladen, unabhängig von ihrem Ladestatus in Ihrem Zoom-Projekt. Es sind keine zusätzlichen Eingaben im Skript erforderlich, um diese Modelle zu öffnen.
Wenn Sie dem Projekt weitere Modelle 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"

]

}

Erläuterung

Verwenden Sie in der Pfaddefinition immer Schrägstriche "/", keine Backslashes.

Mit Projekt verbinden

{

"type": "CONNECT_TO_PROJECT",

"space_name": "example.bimcollab.com",

"project_name": "My BIMcollab Project"

}

Erläuterung

1. Ersetzen Sie "example.bimcollab.com" durch die URL des WebRaums, mit dem Sie sich verbinden möchten.
2. Ersetzen Sie "My BIMcollab Project" durch den Namen des Projekts, mit dem Sie sich verbinden möchten. Achten Sie auf die korrekte Schreibweise des Namens und der URL.

Es ist wichtig, dass das Projekt, mit dem Sie sich verbinden möchten, in der Liste der letzten Projekte in BIMcollab Zoom enthalten ist und dass Ihre Anmeldedaten in BIMcollab Zoom gespeichert sind. Dies können Sie erreichen, indem Sie das Kontrollkästchen “Merken der Anmeldeinformationen" markieren, wenn Sie sich manuell mit dem Projekt verbinden.

Stellen Sie außerdem sicher, dass das Format des Parameters "space_name" genau dem Format entspricht, in dem der Raumname bei der Verbindung mit dem Projekt eingegeben wurde.

Wenn Sie z. B. https://example.bimcollab.com/ oder example.bimcollab.com eingegeben haben, muss dies im Skript genau übereinstimmen.

{

"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": "example@bimcollab.com",

"deadline": "01-01-2021",

"created_by_user_email": "example@bimcollab.com",

"custom1": "Value 1",

"custom2": "Value 2"

}

Erläuterung

1. Wenn diese Aufforderung zum Skript hinzugefügt wird, wird der Issue-Filter in BIMcollab Zoom zunächst auf den Standardfilter zurückgesetzt und dann entsprechend den Werten im Skript angepasst.
2. Nightshift übernimmt, wann immer möglich, die Standardeinstellungen der Parameter, so dass Sie nur die Ä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 "Priorität", können im Skript weggelassen werden. Wird z. B. der Parameter "label" weggelassen, behält Nightshift diesen Parameter auf "All".
3. Achten Sie auf die Schreibweise der eingegebenen Werte. Sie müssen genau so geschrieben werden, wie sie im Projekt stehen.
   
   

   Tipp: Öffnen Sie das Issue-Filterfenster in BIMcollab Zoom neben dem JSON-Editor, um Tippfehler im Skript zu vermeiden.

1. "filter_type"
   Ersetzen Sie "Issue" durch den Typ, den Sie filtern möchten. Der Standardwert ist "Alle" (oder der entsprechende Wert in der Sprache Ihres Projekts).
2. "area"
   Ersetzen Sie "Model" durch den Bereich, den Sie filtern möchten. Der Standardwert ist "Alle" (oder der entsprechende Wert in der Sprache Ihres Projekts).
3. "milestone"
   Ersetzen Sie "Design phase" durch den Meilenstein, den Sie filtern möchten. Der Standardwert ist "Alle" (oder der entsprechende Wert in der Sprache Ihres Projekts).
4. "label"
   Ersetzen Sie "Architecture" durch das Etikett, das Sie filtern möchten. Der Standardwert ist "Alle" (oder der entsprechende Wert in der Sprache Ihres Projekts).
5. "priority"
   Ersetzen Sie "Normal" durch die Priorität, die Sie filtern möchten. Der Standardwert ist "Alle" (oder der entsprechende Wert in der Sprache Ihres Projekts).
6. "show_active"
   Dies ist ein Ankreuzfeld, das bestimmt, ob die aktiven Issues des Projekts angezeigt werden sollen. Geben Sie "true" ein, wenn das Feld aktiviert sein soll, oder "false", wenn es deaktiviert sein soll. Der Standardwert ist "true".
7. "show_resolved"
   Dies ist ein Ankreuzfeld, das bestimmt, ob die gelösten Issues des Projekts angezeigt werden sollen. Geben Sie "true" ein, wenn das Feld aktiviert sein soll, oder "false", wenn es deaktiviert sein soll. Der Standardwert ist "true".
8. "show_closed"
   Dies ist ein Ankreuzfeld, das bestimmt, ob die geschlossenen Issues des Projekts angezeigt werden sollen. Geben Sie "true" ein, wenn das Feld aktiviert sein soll, oder "false", wenn es deaktiviert sein soll. Der Standardwert ist "false".
9. "hide_invisible"
   Dies ist ein Ankreuzfeld, das festlegt, ob Issues, die nicht für alle Teammitglieder sichtbar sind, ausgeblendet werden sollen. Geben Sie "true" ein, wenn das Feld aktiviert sein soll, oder "false", wenn es deaktiviert sein soll. Der Standardwert ist "false".
10. "show_to_approve"
    Dies ist ein Ankreuzfeld, das bestimmt, ob die von Ihnen zu genehmigenden Issues angezeigt werden sollen. Geben Sie "true" ein, wenn das Feld aktiviert sein soll, oder "false", wenn es deaktiviert sein soll. Der Standardwert ist "false".
11. "assigned_to_user_email"
    Ersetzen Sie "example@bimcollab.com" durch die E-Mail-Adresse des zugewiesenen Nutzers, nicht nur durch dessen Namen. Der Standardwert ist "" (Issues, die allen Nutzern zugewiesen sind, werden angezeigt).
12. "deadline"
    Ersetzen Sie "01-01-2021" durch die Frist, nach der Sie filtern möchten, im Format tt-mm-jjjj. Der Standardwert ist "" (es wird kein Termin berücksichtigt).
13. "created_by_user_email"
    Ersetzen Sie "example@bimcollab.com" durch die E-Mail-Adresse des Erstellers, nicht nur durch dessen Namen. Der Standardwert ist "" (von allen Nutzern erstellte Issues werden angezeigt).
14. "custom1"
    Ersetzen Sie "Value 1" durch den Wert des kundenspezifischen Listenfeldes 1, das Sie filtern möchten. Die Scriptzeile sollte immer mit "custom1" beginnen, nicht mit dem tatsächlichen Namen des kundenspezifischen Feldes. Der Standardwert ist "" (alle Werte für dieses kundenspezifische Feld werden angezeigt).
15. "custom2"
    Ersetzen Sie "Value 2" durch den Wert des kundenspezifischen Listenfeldes 2, das Sie filtern möchten. Die Scriptzeile sollte immer mit "custom2" beginnen, nicht mit dem tatsächlichen Namen des kundenspezifischen Feldes. Der Standardwert ist "" (alle Werte für dieses kundenspezifische Feld werden angezeigt).

Wenn eine der Eingaben des Filters falsch ist, wird das Skript nicht weiter ausgeführt.

Issues aktualisieren

{

"type": "UPDATE_ISSUES",
"close_where_clashes_solved": true,
"reopen_previously_closed_issues": false,
"comment": "Updated with Nightshift"
}

Wenn eine der Optionen fehlt, wird ein Standardwert hinzugefügt, wie in der folgenden Abbildung gezeigt.

Listen ausführen und teilen

Alle Listen, die sich auf der Registerkarte "Listen" unter "Geteilt" befinden, können gleichzeitig ausgeführt und geteilt werden, sodass die neuesten Informationen für alle Teammitglieder in BIMcollab Nexus verfügbar sind.

Die Aufforderung für diese Aktion lautet RUN_AND_SHARE_LISTS

Skript

{

"type": "RUN_AND_SHARE_LISTS",

"list_set-name" : "List set 3"

}

{

"type": "SYNCHRONIZE_PROJECT"

}

Nachverfolgung des Status der Aufgabe

Nachdem die Aufgabe ausgeführt wurde, können Sie in der Nightshift-Logdatei überprüfen, ob alle Aktionen erfolgreich durchgeführt wurden. Die Datei gibt Rückmeldung über den Ausführungsstatus aller Aktionen in den Skripten sowie über Fehlercodes, wenn etwas schief gelaufen ist.

Sie finden alle Logdateien unter C:\Benutzer\\AppData\Roaming\KUBUS\BIMcollab Zoom\Nightshift.

Ersetzen Sie durch den Namen Ihres eigenen Nutzerprofils in Windows.

Der Ordner "AppData" ist standardmäßig ein versteckter Ordner. Zeigen Sie die versteckten Ordner im Datei-Explorer an, um zum richtigen Speicherort zu navigieren.