Veuillez noter : Cet article est une traduction générée par IA.
Zoom Nightshift automatise les actions dans Zoom en utilisant des fichiers de script JSON en combinaison avec le Planificateur de tâches Windows.
Avec Nightshift, vous pouvez automatiser les actions suivantes dans BIMcollab :
Ouvrir des modèles / Ajouter au projet
Connecter au projet
Filtrer les problèmes
Mettre à jour les problèmes
Exécuter et partager toutes les listes
Synchroniser le projet
Dans cet article, nous décrivons comment créer un script à exécuter dans Zoom Nightshift.
Pour plus d'informations sur la configuration d'une tâche dans le Planificateur de tâches Windows, consultez l'article Configurer une tâche pour Zoom Nightshift dans le Planificateur de tâches Windows.
📝 Note : Un script JSON peut être configuré dans n'importe quel éditeur de script JSON. Vous pouvez trouver un exemple de script en pièce jointe à cet article pour vous aider à démarrer.
Le script commence par le titre du script et éventuellement la version, suivi des actions à effectuer dans BIMcollab lorsque le script est exécuté.
{
"title": "Example_Script",
"version": "0.1",
"actions": [
Les différentes actions qui peuvent être ajoutées au script, pour que BIMcollab les exécute pendant Nightshift, sont expliquées dans le reste de cet article.
Ouvrir des modèles / Ajouter au projet
La première chose à faire dans Nightshift est d'ouvrir un ensemble de modèles sur lesquels les autres actions peuvent être effectuées. Pour cela, il existe deux invites possibles :
OPEN_MODELS : ajoute et charge un modèle dans le Navigateur et ferme tous les modèles précédemment chargés
ADD_TO_PROJECT : ajoute et charge un modèle dans le Navigateur sans fermer les modèles déjà présents dans le Navigateur
📝 Note : Lorsque vous vous connectez à un projet où un dossier de projet est actif, tous les modèles du dossier de projet seront automatiquement chargés, quel que soit leur statut de chargement dans votre projet. Aucune entrée supplémentaire dans le script n'est nécessaire pour ouvrir ces modèles.
Si vous souhaitez ajouter des modèles supplémentaires au projet qui ne se trouvent pas dans le dossier de projet, utilisez l'invite ADD_TO_PROJECT.
Script
{
"type": "OPEN_MODELS",
"models": [
"C:/Users/userone/Desktop/1.ifc",
"C:/Users/userone/Desktop/2.ifc",
"C:/Users/userone/Desktop/3.bcp"
]
}
Explication
Remplacez "C:/Users/userone/Desktop/1.ifc", etc., par les chemins vers les modèles que vous souhaitez ouvrir, séparés par des virgules.
⚠️ Attention : Utilisez toujours des barres obliques "/" dans la définition du chemin, pas de barres obliques inverses.
Connecter au projet
Pour effectuer une mise à jour des Smart Issues et partager des listes, vous devez être connecté à un projet sur BIMcollab.
L'invite pour cela est CONNECT_TO_PROJECT
Script
{
"type": "CONNECT_TO_PROJECT",
"space_name": "example.bimcollab.com",
"project_name": "Mon projet BIMcollab"
}
Explication
Remplacez "example.bimcollab.com" par l'URL de l'espace auquel vous souhaitez vous connecter.
Remplacez "Mon projet BIMcollab" par le nom du projet auquel vous souhaitez vous connecter. Faites attention à l'orthographe correcte du nom et de l'URL.
⚠️ Attention : Il est important de noter que le projet auquel vous souhaitez vous connecter fait partie de la liste des projets récents dans BIMcollab et que vos identifiants sont enregistrés dans BIMcollab. Cela peut être réalisé en cochant la case 'Se souvenir de moi' lors de la connexion manuelle au projet.
Assurez-vous également que le format du paramètre "space_name" correspond précisément au format dans lequel le nom de l'espace a été saisi lors de la connexion au projet.
Si, par exemple, vous avez saisi https://example.bimcollab.com/ ou example.bimcollab.com, cela doit être exactement reproduit dans le script.
Filtrer les problèmes
Une fois que vous êtes connecté à un projet, tous les problèmes qui vous sont visibles dans le projet seront chargés dans BIMcollab.
À l'étape suivante, tous les Smart Issues qui font partie de cette liste peuvent être automatiquement mis à jour. Pour ne mettre à jour qu'une sélection de problèmes de votre choix, configurez d'abord le filtre de problèmes.
L'invite est FILTER_ISSUES.
Si cette invite est omise du script, le dernier filtre actif sera utilisé.
Script
{
"type": "FILTER_ISSUES",
"filter_type": "Issue",
"area": "Modèle",
"milestone": "Phase de conception",
"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": "Valeur 1",
"custom2": "Valeur 2"
}
Explication
Voici quelques éléments à prendre en compte pour cette partie du script :
Lorsque cette invite est ajoutée au script, le filtre de problème dans BIMcollab est d'abord réinitialisé au filtre par défaut, puis ajusté selon les valeurs du script.
Nightshift suppose les paramètres par défaut chaque fois que possible, vous n'avez donc besoin de spécifier que les modifications apportées aux paramètres par défaut. Toutes les lignes de paramètres dans cette partie du script, à l'exception de "type": "FILTER_ISSUES" (définition d'action obligatoire) et de "priority", peuvent être omises du script. Si, par exemple, le paramètre "label" est omis, Nightshift conservera ce paramètre à "All".
Faites attention à l'orthographe des valeurs saisies. Elles doivent être exactement les mêmes que dans le projet.
💡 Astuce : Ouvrez la fenêtre de filtre de problème dans BIMcollab à côté de l'éditeur JSON pour éviter les fautes de frappe dans le script.
Toutes les lignes de cette partie du script représentent l'une des propriétés du filtre de problème :
"filter_type"
Remplacez "Issue" par le type que vous souhaitez filtrer. La valeur par défaut est "All" (ou la valeur correspondante dans la langue de votre projet)."area"
Remplacez "Modèle" par la zone que vous souhaitez filtrer. La valeur par défaut est "All" (ou la valeur correspondante dans la langue de votre projet)."milestone"
Remplacez "Phase de conception" par le jalon que vous souhaitez filtrer. La valeur par défaut est "All" (ou la valeur correspondante dans la langue de votre projet)."label"
Remplacez "Architecture" par le label que vous souhaitez filtrer. La valeur par défaut est "All" (ou la valeur correspondante dans la langue de votre projet)."priority"
Remplacez "Normal" par la priorité que vous souhaitez filtrer. La valeur par défaut est "All" (ou la valeur correspondante dans la langue de votre projet)."show_active"
C'est une case à cocher déterminant si les problèmes actifs du projet doivent être affichés. Entrez 'true' si la case doit être activée ou 'false' si elle doit être désactivée. La valeur par défaut est true."show_resolved"
C'est une case à cocher déterminant si les problèmes résolus du projet doivent être affichés. Entrez 'true' si la case doit être activée ou 'false' si elle doit être désactivée. La valeur par défaut est true."show_closed"
C'est une case à cocher déterminant si les problèmes fermés du projet doivent être affichés. Entrez 'true' si la case doit être activée ou 'false' si elle doit être désactivée. La valeur par défaut est false."hide_invisible"
C'est une case à cocher déterminant si les problèmes qui ne sont pas visibles pour tous les membres de l'équipe doivent être masqués. Entrez 'true' si la case doit être activée ou 'false' si elle doit être désactivée. La valeur par défaut est false."show_to_approve"
C'est une case à cocher déterminant si les problèmes que vous devez approuver doivent être affichés. Entrez 'true' si la case doit être activée ou 'false' si elle doit être désactivée. La valeur par défaut est false."assigned_to_user_email"
Remplacez "[email protected]" par l'adresse e-mail de l'utilisateur assigné, pas seulement par son nom. La valeur par défaut est "" (les problèmes assignés à tous les utilisateurs sont affichés)."deadline"
Remplacez "01-01-2021" par la date limite à laquelle vous souhaitez filtrer, au format jj-mm-aaaa. La valeur par défaut est "" (aucune date limite n'est prise en compte)."created_by_user_email"
Remplacez "[email protected]" par l'adresse e-mail du créateur, pas seulement par son nom. La valeur par défaut est "" (les problèmes créés par tous les utilisateurs sont affichés)."custom1"
Remplacez "Valeur 1" par la valeur du champ de liste personnalisée 1 que vous souhaitez filtrer. La ligne de script doit toujours commencer par "custom1", et non par le nom réel du champ personnalisé. La valeur par défaut est "" (toutes les valeurs pour ce champ personnalisé sont affichées)."custom2"
Remplacez "Valeur 2" par la valeur du champ de liste personnalisée 2 que vous souhaitez filtrer. La ligne de script doit toujours commencer par "custom2", et non par le nom réel du champ personnalisé. La valeur par défaut est "" (toutes les valeurs pour ce champ personnalisé sont affichées).
⚠️ Attention : Si l'une des entrées du filtre est incorrecte, le script ne sera pas exécuté plus loin.
Mettre à jour les problèmes
Tous les Smart Issues visibles dans l'onglet Problèmes de BIMcollab peuvent être automatiquement mis à jour selon le statut des clashes dans les modèles chargés.
L'invite est UPDATE_ISSUES.
Script
{
"type": "UPDATE_ISSUES",
"close_where_clashes_solved": true,
"reopen_previously_closed_issues": false,
"comment": "Mis à jour avec Nightshift"
}
Explication
Chaque ligne de cette partie du script représente l'une des options dans la fenêtre 'Mettre à jour les Smart Issues'. Notez que 'Problèmes sélectionnés uniquement' n'est pas présent, car aucun problème ne peut être sélectionné séparément lors de l'exécution du script. L'action sera effectuée sur tous les problèmes visibles dans l'onglet des problèmes.
"close_where_clashes_solved"
C'est une case à cocher déterminant si les problèmes où tous les clashes sont résolus peuvent être fermés avec la mise à jour. Entrez 'true' si la case doit être activée ou 'false' si elle doit être désactivée"reopen_previously_closed_issues"
C'est une case à cocher déterminant si les problèmes fermés qui contiennent encore des clashes actifs peuvent être rouverts avec la mise à jour. Entrez 'true' si la case doit être activée ou 'false' si elle doit être désactivée"comment"
Remplacez "Mis à jour avec Nightshift" par tout commentaire que vous souhaitez ajouter aux problèmes mis à jour
Si l'une des options est manquante, une valeur par défaut sera ajoutée, comme montré dans l'image ci-dessous.
Exécuter et partager des listes
Toutes les listes situées dans 'Partagé' dans l'onglet Listes peuvent être exécutées et partagées en même temps, afin que les informations les plus récentes soient disponibles pour tous les membres de l'équipe dans BIMcollab.
L'invite pour cette action est RUN_AND_SHARE_LISTS
Script
{
"type": "RUN_AND_SHARE_LISTS",
"list_set-name" : "List set 3"
}
Explication
Le paramètre "list_set_name" est optionnel. Si vous souhaitez exécuter un ensemble de listes particulier, remplacez "List set 3" par le nom de l'ensemble de listes que vous souhaitez exécuter. Si le paramètre n'est pas présent, toutes les listes dans 'Partagé' seront exécutées et partagées.
Synchroniser le projet
Une fois que les problèmes sont mis à jour et que les listes sont exécutées et partagées, il est important de toujours synchroniser le projet avec BIMcollab, afin que les modifications soient enregistrées et visibles pour le reste de l'équipe.
Ajoutez toujours cette invite à la fin du script.
L'invite est SYNCHRONIZE_PROJECT.
Script
{
"type": "SYNCHRONIZE_PROJECT"
}
Suivre l'état de la tâche
Une fois la tâche exécutée, vous pouvez vérifier si toutes les actions ont été effectuées avec succès dans le fichier journal Nightshift. Le fichier fournit un retour d'information sur l'état d'exécution de toutes les actions dans les scripts, et des codes d'erreur si quelque chose a mal tourné.
Vous pouvez trouver tous les fichiers journaux à C:\Users\\AppData\Roaming\KUBUS\BIMcollab Zoom\Nightshift.
Remplacez par le nom de votre propre profil utilisateur dans Windows.
Le dossier AppData est un dossier caché par défaut. Affichez les dossiers cachés dans l'Explorateur de fichiers pour naviguer vers l'emplacement correct.