Utilitaire de ligne de commande de création de modèle de Revit Server

Vous pouvez utiliser l'utilitaire de ligne de commande de création de modèle de Revit Server (RevitServerTool.exe) afin d'automatiser la création de modèles locaux et de faciliter le partage de projet. Vous pouvez placer les nouveaux modèles locaux directement sur les ordinateurs des membres de l'équipe ou dans des répertoires auxquels ils les membres ont accès.

RevitServerTool.exe est automatiquement installé sur toutes les machines où Revit ou Revit Server sont installés et où le rôle Host ou Accelerator est activé.

Sur l'ordinateur d'un utilisateur Revit, l'emplacement par défaut de l'outil est :%ProgramFiles%\Autodesk\<nom de produit et version>INSTALLDIR\RevitServerToolCommand\. Dans les instances Revit Server, l'emplacement par défaut de l'outil est :%ProgramFiles%\Autodesk\<nom de produit et version>\tools\RevitServerToolCommand.

Remarque : Pour utiliser cet utilitaire de ligne de commande, vous devez être familiarisé avec DOS et maîtriser la structure des lignes de commande. Notez également que l'utilitaire fonctionne uniquement dans la version correspondante de Revit Server. Par exemple, la version 2014 de RevitServerTool.exe ne peut fonctionner que dans la version 2014 de Revit Server.

Commandes et options

Commande	Résultat
l, createLocalRvt	Crée un modèle local à partir du modèle central basé sur un serveur spécifié.
RevitServerTool -?	Affiche l'aide relative à l'utilitaire ReverServerTool.

Options	Résultat
<chemin d'accès du modèle>	Chemin d'accès du modèle relatif au répertoire du projet Revit Server (par exemple : "Hospital \North Wing.rvt"). Il s'agit d'un argument requis.
-d, -destination	Chemin d'accès qui indique l'emplacement et le nom de fichier du nouveau modèle. Les chemins absolus, relatifs et UNC sont pris en charge. Par défaut, le nouveau modèle est créé dans le sous-dossier "RevitServerTool" sous le dossier Documents de l'utilisateur. Par exemple, C:\\Users\|<nomutilisateur>\Document\RevitServerTool\ <nommodèle>.rvt Remarque : Si le nom du nouveau modèle n'est pas spécifié dans le chemin de destination, par défaut, le nom du modèle central basé sur un serveur est utilisé par défaut.
-s, -server	Nom du serveur Revit Server Host sur lequel se trouve le modèle central. Il s'agit d'un argument requis.
-a, -accelerator	Nom du Revit Server Accelerator. Lorsque cet argument n'est pas fourni, l'utilitaire contrôle la variable d'environnement RSACCELERATOR2014 afin de déterminer si un serveur Accelerator est attribué et, le cas échéant, utilise la mémoire mise en cache sur cet Accelerator si elle est mise à jour. Si aucun serveur Accelerator n'est indiqué, l'utilitaire copie les données du modèle central directement depuis le serveur Revit Server Host. De même, si le nom d'Accelerator n'est pas valide ou si l'Accelerator est inactif, les données sont extraites directement à partir de l'hôte.
-o, -overwrite	Remplace le modèle de destination s'il existe déjà.

Utilisation :

RevitServerTool createLocalRVT <chemin d'accès du modèle> [-s | -server <nom de serveur>] [-a | -accelerator <nom d'Accelerator>] [-d|-destination <chemin>] [-o|-overwrite]

Utilisation	Résultat
RevitServerTool createLocalRVT <chemin d'accès du modèle> [-server <nom de serveur>]	Une copie locale du modèle central spécifié par le chemin d'accès du modèle sur le serveur Revit Server Host spécifié est créée dans le répertoire personnel de l'utilisateur à l'aide du nom d'utilisateur défini dans le système d'exploitation.
RevitServerTool createLocalRVT <chemin d'accès du modèle> [-server <nom de serveur>] [-destination <chemin>] [-overwrite]	Une copie locale du modèle central spécifié par le chemin d'accès du modèle sur le serveur Revit Server Host est créée à l'emplacement du chemin de destination et remplace toute version antérieure existante.
RevitServerTool createLocalRVT <chemin d'accès du modèle> [-server <nom de serveur>] [-destination <chemin>] [-accelerator <nom d'Accelerator>]	Une copie locale du modèle central spécifié par le chemin d'accès du modèle sur le serveur Revit Server Host spécifié est créée à partir de la mémoire cache du serveur Revit Server Accelerator à l'emplacement spécifié.

Exemples d'utilisation de ligne de commande

Remarque : L'utilisation de guillemets dans les exemples ci-dessous est nécessaire afin de traiter correctement les arguments contenant des espaces.

Pour créer un modèle local à partir d'un modèle central appelé As-Built complex.rvt dans le répertoire 2011 Hospital Project sur le serveur Revit Server Host nommé SERVER01

RevitServerTool createLocalRvt "2011 Hospital Project\As-Built complex.rvt" -s SERVER01 -o

RevitServerTool L "2011 Hospital Project\As-Built complex.rvt" -s SERVER01 -o

Pour créer un modèle local à partir de ce même modèle central, nommez-le As-Built complex myLocal.rvt et enregistrez-le dans le dossier C:\local files

RevitServerTool createLocalRvt "2011 Hospital Project\As-Built complex.rvt" -s SERVER01 -d "c:\local files\As-Built complex_myLocal.rvt" -o

RevitServerTool L "2011 Hospital Project\As-Built complex.rvt" -s SERVER01 -d "c:\local files\As-Built complex_myLocal.rvt" - o

Remarques sur l'utilisation

L'ordre dans lequel l'utilisateur définit les options n'a pas d'importance.
L'utilitaire prend en charge à la fois la barre oblique inversée et la barre oblique dans les chemins d'accès. L'outil accepte également la saisie de barres obliques de début ou de fin.
En règle générale, l'utilitaire effectue une nouvelle tentative dès qu'il rencontre des conditions exceptionnelles.
Si l'accélérateur est bloqué au cours d'une opération, l'utilitaire échoue avant d'effectuer une nouvelle tentative.
Si vous ne spécifiez pas de fichier ".rvt " pour la valeur de destination, les règles suivantes sont appliquées :
- Si la valeur de destination se termine par \ ou /, le nom du fichier de sortie doit être identique au nom de fichier source et il sera créé dans le répertoire spécifié par la valeur de l'option de destination.
- Si la valeur de destination ne termine pas par \ ou /, le nom de fichier de sortie sera constitué de tout ce qui suit le symbole \ ou / final dans la valeur de l'option de destination et son extension sera ".rvt ".
- Si la valeur de destination n'encode aucun chemin (c'est-à-dire qu'aucun symbole \ ou / n'est utilisé), le nom de fichier de sortie lui-même constitue la valeur et son extension est ".rvt ".

Conditions des erreurs et réponses de l'utilitaire

Condition : l'utilisateur spécifie un chemin d'accès du modèle mais ne spécifie pas l'argument de serveur requis

Réponse : l'argument, le serveur requis est manquant dans la commande.

Condition : le chemin d'accès du modèle spécifié n'existe pas sur le serveur.

Réponse : impossible de créer le modèle local car le modèle "<chemin d'accès du modèle>" n'existe pas sur le serveur Revit Server "<serveur>".

Condition : le chemin de destination spécifié n'existe pas. Si l'utilisateur dispose des autorisations, le nouveau chemin sera créé et le nouveau modèle sera placé sous cet emplacement.

Réponse : le modèle local "<chemin de destination>" a été créé.

Condition : le chemin de destination (nouveau modèle) existe déjà et l'utilisateur n'a pas utilisé l'option [-overwrite].

Réponse : impossible de créer le modèle local, car le modèle "<chemin d'accès du modèle>" existe déjà.

Condition : le serveur spécifié n'est pas accessible ou le réseau est interrompu.

Réponse : impossible de créer le modèle local car le serveur Revit server est actuellement indisponible.

Condition :le modèle sur le serveur est en cours d'utilisation.

Réponse : impossible de créer le modèle local car le modèle "<chemin d'accès du modèle>" est en cours d'utilisation.

Condition :

l'exécution a échoué pour des raisons inconnues ou pour les motifs suivants : le modèle est corrompu, l'utilisateur n'a pas accès au chemin de destination, la longueur totale du chemin de destination est supérieure à 255 ou l'utilisateur n'a pas spécifié de chemin de destination, toutefois, le chemin n'a pas pu être créé.

Réponse : impossible de créer le modèle local à l'emplacement "<chemin de destination>".