Comment sélectionner une version de projet au démarrage

Les arguments en ligne de commande du logiciel PcVue vous permettent de sélectionner une version particulière d'un projet ou des bibliothèques au démarrage sur une machine donnée de votre système. Ces arguments en ligne de commande sont utilisés avec la gestion centrale de projet, qui est un outil qui vous aide à créer et à maintenir la version de votre projet PcVue. Pour utiliser les arguments en ligne de commande au démarrage, vous devez configurer la gestion centrale de projet. Reportez-vous à la rubrique Comment gérer les versions de projets et de bibliothèques pour en savoir plus.

 PcVue exécute toujours une copie locale du projet. Lorsque c'est nécessaire, le projet ou les bibliothèques sont copiés du répertoire central vers le système de fichiers local au démarrage.

Lors de l'utilisation de la gestion centrale de projet, il est essentiel de s'assurer de la synchronisation des horloges systèmes sur tous les postes impliqués.

Les arguments de ligne de commande suivants peuvent être utilisés pour contrôler la version du projet au démarrage :

Argument

Description

-r ou -r_delta

Démarre en utilisant la version REF.

-preref

Démarre en utilisant la version PREREF.

-x

Autorise l'utilisateur interactif à sélectionner n'importe quelle version OPE ou REF au démarrage.

Comme l'utilisation de -x nécessite une interaction de l'utilisateur au démarrage, il ne doit pas être utilisé lorsque le logiciel PcVue s'exécute sous forme de Service Windows avec la Gestion centrale de projet.

-d

Autorise l'utilisateur interactif à sélectionner n'importe quelle version au démarrage. Exemple : [InstallDir]\bin\sv32.exe -d

Comme l'utilisation de -d nécessite une interaction de l'utilisateur au démarrage, il ne doit pas être utilisé lorsque le logiciel PcVue s'exécute sous forme de Service Windows avec la Gestion centrale de projet.

-d "proj=x.y.z, lib=x.y.z"

Démarre la version spécifiée d'un projet ou de bibliothèques.

-d "tag_proj=myProjTag [tag lib=myLibTag]"

-d "tag_lib=myLibTag [tag_proj=myProjTag]"

Démarre la version du projet et des bibliothèques spécifiées par les tags associés.

Si tag_lib ou tag_proj est omis, le projet ou les bibliothèques déjà en local sont utilisés.

Dans le cas où le tag spécifié n'est associé à aucune version de projet ou de bibliothèques, un message est enregistré dans l'Observateur d'événements.

Dans tous les cas, si la version correspondant à l'argument en ligne de commande ou au choix de l'utilisateur n'est pas disponible localement, elle est d'abord téléchargée depuis le répertoire central avant de procéder au démarrage proprement dit du projet.

Utilisation des arguments en ligne de commande -r et -r_delta

L'utilisation des arguments en ligne de commande -r ou -r_delta force un démarrage avec la version de référence (REF) du projet et des bibliothèques (le cas échéant). Il est conçu pour être utilisé sur les postes d'exploitation en production.

Aucune boîte de dialogue n'est affichée. Au démarrage, le numéro de version et l'heure de création du projet local sont comparés à ceux du projet de référence dans le répertoire central des versions. Les actions suivantes sont alors possibles :

  • Si les versions locales et de référence sont différentes, c'est-à-dire si les informations de version dans le fichier INFOS.DAT local sont différentes de celles du projet de référence dans le répertoire de versions centrales :
  • Si utilisation de l'option -r, la totalité du projet de référence est copié à partir du répertoire de stockage central vers le poste local.
  • Si utilisation de l'option -r_delta, seuls les fichiers modifiés sont copiés à partir du répertoire de stockage central vers le poste local. Ceci peut prendre un certain temps, car les fichiers sont comparés un par un.
  • Si les versions locale et de référence sont identiques, la version locale est utilisée.
  • S'il n'y a pas de version de référence, la version locale est utilisée.

Le fichier central INFOS.DAT est uniquement mis à jour lors de l'utilisation de la boîte de dialogue Gestion centrale de projet pour créer une nouvelle version ou mettre à jour une version existante. Il n'est mis à jour dans aucune autre circonstance. La modification du projet local sans utiliser la boîte de dialogue Gestion centrale de projet ne met pas à jour le fichier local INFOS.DAT.

Utilisation de l'argument en ligne de commande -preref

L'argument en ligne de commande -preref force un démarrage avec la version pré-référence (PREREF) du projet et des bibliothèques (le cas échéant). Il est conçu pour être utilisé sur les postes de validation avant son déploiement en production.

Aucune boîte de dialogue n'est affichée. Au démarrage, le numéro de version et l'heure de création du projet local sont comparés à ceux du projet pré-référence dans le répertoire des versions centrales. Les actions suivantes sont alors possibles :

  • Si les versions locale et pré-référence sont différentes, c'est-à-dire si les informations de version dans le fichier INFOS.DAT local sont différentes de celles du projet pré-référence dans le répertoire central, la version est copiée dans le dossier projet local.
  • Si les versions locale et pré-référence sont identiques, la version locale est utilisée.
  • S'il n'y a pas de version pré-référence, la version locale est utilisée.

Lorsqu'une version est copiée à partir du dossier de projet central vers le dossier du projet local, les dossiers du projet sélectionné sont copiés dans un dossier temporaire local puis les dossiers requis sont copiés dans le dossier du projet du poste local, écrasant le précédent s'il y en a un. Si la copie n'a pas fonctionné, un message d'erreur s'affiche.

Si le système de fichiers est endommagé ou si l'espace de stockage est plein, un message d'erreur s'affiche. Toutes les copies effectuées sont supprimées, les répertoires précédents sont restaurés, les copies avec l'extension '.OLD' sont supprimées et le projet original est démarré.

Si le message est ignoré, le démarrage peut continuer avec une version du projet autre que celle attendue.

Utilisation de l'argument en ligne de commande -x

L'utilisation de l'argument en ligne de commande -x entraîne l'affichage de deux sélecteurs de versions qui s'ouvrent successivement au démarrage, un pour le choix de la version du projet et un pour la version des bibliothèques. Ces boîtes de dialogue affichent des informations au sujet de la version courante disponible dans le répertoire du projet local plus une liste des versions opérationnelles (OPE) et de référence (REF) disponibles dans le répertoire central.

  1. La boîte de dialogue Sélecteur pour version de projet s'affiche en premier. Vous pouvez vérifier les détails de la version du projet local dans la partie haute du panneau.
  2. Sélectionnez une version dans la liste et cliquez sur le bouton Télécharger. La version est copiée vers le répertoire projet local.
  3. Cliquez sur Suivant pour copier les bibliothèques ou sur Démarrer pour passer cette étape et démarrer sans sélectionner de version des bibliothèques.
  4. Si vous avez cliqué sur Suivant, la boîte de dialogue Sélecteur de version de bibliothèques s'affiche. Vous pouvez vérifier la version locale des bibliothèques dans le panneau du haut.
  5. Sélectionnez la version voulue dans la liste et cliquez sur le bouton Télécharger. La version est copiée vers le répertoire local. Un barre-graphe affiche la progression de la copie.
  6. Cliquez sur le bouton Démarrer. Le démarrage continue avec la version sélectionnée du projet et/ou des bibliothèques.

Pour utiliser la version locale existante du projet et des bibliothèques, cliquez sur le bouton Démarrer dans la boîte de dialogue de sélection. Le démarrage continue à utiliser la version locale du projet et des bibliothèques.

Utilisation de l'argument en ligne de commande -d

L'utilisation de l'argument en ligne de commande -d, sans inclure une version particulière, se comporte de la même manière que l'argument -x à ceci près que les versions de développement (DEV) et la version de pré-référence (PREREF) du projet et des bibliothèques peuvent être sélectionnées en plus des versions opérationnelles ou de référence.

L'utilisation de l'argument -d en ligne de commande avec une version spécifique, par exemple -d "proj = 1.0.0, lib = 1.0.0", entraîne la copie de cette version dans le répertoire du projet local et le démarrage sans aucun affichage de boîte de dialogue.

Lorsque vous utilisez l'argument -d dans la ligne de commande, vous pouvez omettre le paramètre de projet proj ou de bibliothèque lib. Par exemple, vous pouvez utiliser l'argument -d "proj = 2.3.1" pour démarrer le projet version 2.3.1 avec les bibliothèques déjà disponibles localement, ou l'argument -d "lib = 1.2.5" pour démarrer le projet déjà disponible localement avec les bibliothèques version 1.2.5.

Vous pouvez utiliser l'argument -d en ligne de commande avec des tags au lieu d'un Id de version spécifique. Les tags sont des étiquettes que vous pouvez associer à une version et ajouter à l'argument en ligne de commande -d lorsque vous démarrez un projet. PcVue va démarrer la version qui possède un tag correspondant à celui que vous mettez sur la ligne de commande.