LabVIEW inclut des opérations de ligne de commande prédéfinies pour permettre l'automatisation de tâches telles que la compilation de fichiers, la création d'applications et l'exécution de VIs.

Tableau 24. Opérations LabVIEWCLI prédéfinies
Commande Description
MassCompile Recompile les fichiers du répertoire spécifié.
ExecuteBuildSpec Construit une application ou une bibliothèque en utilisant les paramètres des spécifications de construction spécifiées et renvoie le chemin des fichiers résultants.
RunVI Exécute un VI avec l'interface de connecteurs prédéfinie et renvoie le résultat ou des informations sur l'erreur.
CloseLabVIEW Ferme LabVIEW sans invite.
CreateComparisonReport Génère un rapport de comparaison de VI pour deux VI spécifiés.
RunVIAnalyzer Pour le toolkit Analyseur de VIs. Exécute la tâche d'Analyseur de VIs spécifiée dans le toolkit LabVIEW VI Analyzer et enregistre le rapport du test à l'emplacement spécifié.
RunUnitTests Pour Unit Test Framework Toolkit. Exécute les tests sur les fichiers spécifiés dans le toolkit LabVIEW Unit Test Framework et enregistre le fichier JUnit dans l'emplacement spécifié.

Vous pouvez aussi créer des opérations de ligne de commande personnalisées à exécuter dans LabVIEW.

MassCompile

Recompile les fichiers du répertoire spécifié.

Tableau 25. Arguments MassCompile répertorie les arguments disponibles pour cette opération.

Tableau 25. Arguments MassCompile
Argument Obligatoire ou facultatif Description Par défaut
-DirectoryToCompile Nécessaire Emplacement des VIs à compiler.
-MassCompileLogFile Optionnelle Chemin du fichier journal des résultats. Chemin de l'emplacement temporaire.
-AppendToMassCompileLog Optionnelle Booléen qui spécifie s'il faut ajouter les résultats au fichier journal. faux : si le fichier journal que vous spécifiez existe déjà, LabVIEW écrase le fichier journal existant.
-NumOfVIsToCache Optionnelle Nombre de VIs qui peuvent être mis en mémoire lors de la recompilation.
Remarque Mettre des VIs en mémoire cache permet diminuer considérablement le temps d'exécution d'une recompilation car LabVIEW n'a pas besoin de charger les VIs en mémoire cache lorsque vous compilez un VI de niveau principal. Toutefois, mettre des VIs en mémoire cache consomme davantage de mémoire système. Si vous recompilez un dossier qui contient des VIs du même nom dans différents sous-dossiers et que ces VIs n'appartiennent pas à une bibliothèque, la mise en cache des VIs risque de produire des références croisées.
0
-ReloadLVSBs Optionnelle Booléen qui spécifie s'il faut ignorer les CIN dans les VIs et autoriser l'application à les rechercher.

Cet argument est utile lorsqu'un grand nombre de CIN ont été recompilés et doivent être rechargés.

faux

Pour exécuter MassCompile dans la CLI pour LabVIEW, exécutez une commande en utilisant la syntaxe suivante :

LabVIEWCLI -OperationName MassCompile -DirectoryToCompile <directory of file(s)> -MassCompileLogFile <path to log file> -AppendToMassCompileLog <true or false> -NumOfVIsToCache <number of VIs to cache> -ReloadLVSBs <true or false>

Par exemple :

LabVIEWCLI -OperationName MassCompile -DirectoryToCompile "C:\temp" -MassCompileLogFile "C:\temp\log.txt" -AppendToMassCompileLog true -NumOfVIsToCache 0 -ReloadLVSBs false

ExecuteBuildSpec

Construit une application ou une bibliothèque en utilisant les paramètres des spécifications de construction spécifiées et renvoie le chemin des fichiers résultants.

Tableau 26. Arguments de ExecuteBuildSpec répertorie les arguments disponibles pour cette opération.

Tableau 26. Arguments de ExecuteBuildSpec
Argument Obligatoire ou facultatif Description Par défaut
-ProjectPath Nécessaire Chemin du projet LabVIEW .lvproj qui contient la spécification de construction.
-TargetName Optionnelle Cible qui contient la spécification de construction. Poste de travail
-BuildSpecName Optionnelle Nom de la spécification de construction qui apparaît sous Spécifications de construction dans la fenêtre Explorateur de projet. Chaîne vide : La CLI pour LabVIEW construit toutes les spécifications de construction sous la cible spécifiée.
-BuildDirectory Optionnelle Chemin du répertoire où les fichiers de sortie de construction sont placés. Lorsqu'elle est spécifiée, la sortie de construction est dirigée vers cet emplacement au lieu de la destination définie dans la spécification de construction. Requiert que -TargetName et -BuildSpecName soient spécifiés. Le chemin de destination défini dans la spécification de construction.

Pour exécuter cette opération dans la CLI pour LabVIEW, exécutez une commande en utilisant la syntaxe suivante :

LabVIEWCLI -OperationName ExecuteBuildSpec -ProjectPath <path to project> -TargetName <name of target> -BuildSpecName <name of build specification> -BuildDirectory <path to output directory>

Par exemple :

LabVIEWCLI -OperationName ExecuteBuildSpec -ProjectPath "C:\temp\test.lvproj" -TargetName "My Computer" -BuildSpecName "My DLL" -BuildDirectory "C:\builds\output"
Tenez compte des éléments suivants lorsque vous utilisez l'argument -BuildDirectory :
  • L'utilisation de l'argument -BuildDirectory ne modifie pas définitivement votre spécification de construction lorsque vous changez la destination de construction de votre application ou bibliothèque.
  • Vous devez spécifier -TargetName et -BuildSpecName pour utiliser -BuildDirectory. Si l'un des arguments est manquant, LabVIEWCLI renvoie une erreur.
  • L'argument -BuildDirectory remplace seulement les chemins du répertoire de destination et du répertoire support. L'utilisation de -BuildDirectory n'affecte pas les répertoires personnalisés définis dans la spécification de construction. Ces répertoires restent à leurs emplacements configurés d'origine.
  • L'argument -BuildDirectory s'applique aux spécifications de construction Application (EXE), DLL, Distribution de code source, Assembly Interop .NET, Bibliothèque de projet empaquetée, ZIP, Installeur et Paquet (NIPKG/IPK).
  • L'argument -BuildDirectory ne supporte pas les spécifications de construction FPGA.

RunVI

Exécute un VI avec l'interface de connecteur suivante et renvoie le résultat ou des informations ou l'erreur.

Connecteur de VI LabVIEW à trois terminaux.

Terminal Type de données Description

Appel du premier terminal du connecteur du VI LabVIEW.

Commande chaîne

Terminal de commande LabVIEW représentant un type de données chaîne.

Arguments de la ligne de commande pour le VI.

Appel du deuxième terminal du connecteur du VI LabVIEW.

Indicateur signé 32 bits

Terminal de commande LabVIEW représentant un type de données numérique entier signé 32 bits.

Le code de sortie de la CLI pour LabVIEW renvoyé par le VI.

Appel du troisième terminal du connecteur du VI LabVIEW.

Indicateur chaîne

Terminal de commande LabVIEW représentant un type de données chaîne.

Sortie ou informations sur l'erreur à inclure dans la console de la CLI pour LabVIEW ou dans le fichier journal.

Tableau 27. Arguments de RunVI répertorie les arguments disponibles pour cette opération.

Tableau 27. Arguments de RunVI
Argument Obligatoire ou facultatif Description Par défaut
-VIPath Nécessaire Chemin du VI à exécuter dans LabVIEW. Si le connecteur du VI ne correspond pas à l'interface prédéfinie, la CLI pour LabVIEW renvoie une erreur.
<Arguments de la ligne de commande pour le VI> Optionnelle Éléments du tableau en entrée du VI. Utilisez des espaces pour séparer les éléments.

Pour exécuter cette opération dans la CLI pour LabVIEW, exécutez une commande en utilisant la syntaxe suivante :

LabVIEWCLI -OperationName RunVI -VIPath <VI path> <first element of array> <second element of array>...

Par exemple :

LabVIEWCLI -OperationName RunVI -VIPath "C:\Users\inlabview.APAC\Documents\DemoProject\RunVI.vi" 101 202

CloseLabVIEW

Ferme LabVIEW sans invite.

Remarque Si un VI est ouvert lorsque vous exécutez cette opération, ses modifications non enregistrées seront perdues. Prenez soin d'enregistrer les modifications avant de lancer cette opération.

Cette opération n'a pas d'argument.

Pour lancer cette opération dans la CLI pour LabVIEW, exécutez la commande suivante :

LabVIEWCLI -OperationName CloseLabVIEW

CreateComparisonReport

Compare deux VIs spécifiés et renvoie un rapport HTML, XML, Word ou texte contenant les résultats de la comparaison.

Tableau 28. Arguments CreateComparisonReport répertorie les arguments disponibles pour cette opération.
Tableau 28. Arguments CreateComparisonReport
Argument Obligatoire ou facultatif Description Par défaut
-vi1 Nécessaire Nom ou chemin du premier VI que vous comparez.
-vi2 Nécessaire Nom ou chemin du deuxième VI que vous comparez.
-reportType Optionnelle Type de fichier désiré pour le rapport. Cet argument prend en charge les valeurs suivantes :
  • HTML : produit un rapport au format HTML avec des images externes et un fichier de style.
  • HTMLSingleFile : produit un rapport au format HTML avec des images intégrées et une définition de style.
  • MicrosoftWord : produit un rapport au format Microsoft Word.
    Remarque Microsoft Word doit être installé sur votre ordinateur pour que cette option fonctionne.
  • PlainText : produit un rapport en texte brut.
  • XML : produit un rapport au format XML avec des images externes.

Si vous ne spécifiez pas cet argument, il est déduit de la valeur fournie pour -reportPath.

HTMLSingleFile
-reportPath Nécessaire Nom ou chemin du rapport.
-o Optionnelle Écrase les rapports existants et les fichiers de support dans le répertoire de rapport spécifié, s'ils existent.
-c Optionnelle Crée un nouveau répertoire pour le chemin de rapport spécifié s'il n'existe pas.
-nofp Optionnelle Exclut les différences de face-avant du rapport de comparaison.
-nofppos Optionnelle Exclut les différences de position de la face-avant du rapport de comparaison.
-nobd Optionnelle Exclut les différences de diagramme du rapport de comparaison.
-nobdcosm Optionnelle Exclut les différences esthétiques du diagramme du rapport de comparaison.
-noattr Optionnelle Exclut les différences d'attributs de VI du rapport de comparaison.
-d Optionnelle Compare les VIs spécifiés sans inclure les dépendances.

Vous pouvez choisir n'importe quel VI arbitraire pour vi1 et vi2. vi1 n'est pas nécessairement le fichier de base, et vi2 n'est pas nécessairement une modification du fichier de base. Dans le cadre du rapport de comparaison :

  • vi1 est le VI que vous assignez pour l'état initial (à partir de l'état dans vi1)
  • vi2 est le VI que vous assignez pour l'état final (à l'état dans vi2)

Pour exécuter cette opération dans la CLI pour LabVIEW, exécutez une commande en utilisant la syntaxe suivante :

LabVIEWCLI -OperationName CreateComparisonReport -vi1 <name or path of first VI> -vi2 <name or path of second VI> -reportType <file type of report> -reportPath <name or path of output report>

Par exemple :

LabVIEWCLI -OperationName CreateComparisonReport -vi1 "firstVI.vi" -vi2 "secondVI.vi" -reportType "HTMLSingleFile" -reportPath "report.html"

RunVIAnalyzer

Exécute la tâche d'Analyseur de VIs spécifiée dans le toolkit LabVIEW VI Analyzer et enregistre le rapport du test à l'emplacement spécifié.

Tableau 29. Arguments RunVIAnalyzer répertorie les arguments disponibles pour cette opération.

Tableau 29. Arguments RunVIAnalyzer
Argument Obligatoire ou facultatif Description Par défaut
-ConfigPath Nécessaire Chemin du fichier de configuration qui contient les paramètres d'une tâche d'Analyseur de VIs à utiliser dans l'analyse. Vous pouvez utiliser un fichier de configuration que vous avez enregistré avec l'analyseur de VI ou les VI « Analyseur de VI ». Vous pouvez aussi spécifier un VI, un dossier ou une LLB à analyser. Si vous spécifiez un élément qui n'est pas un fichier de configuration, le VI exécute tous les tests de l'Analyseur de VIs sur l'élément spécifié.
-ReportPath Nécessaire Chemin du fichier de rapport.
-ConfigPassword Optionnelle Mot de passe du fichier de configuration, le cas échéant. Chaîne vide
-ReportSaveType Optionnelle Format du fichier du rapport ou des résultats. Cet argument doit avoir une des valeurs suivantes :
  • ASCII
  • HTML
  • Fichier RSL
ASCII
-ResultsPath Nécessaire Chemin du fichier de résultats. Si le chemin est une chaîne vide, LabVIEW ignore cet argument.
Remarque Cet argument est sensible à la casse.

Pour exécuter cette opération dans la CLI pour LabVIEW, exécutez une commande en utilisant la syntaxe suivante :

LabVIEWCLI -OperationName RunVIAnalyzer -ConfigPath <path to configuration file> -ReportPath <path to report> -ReportSaveType <file type of report> -ConfigPassword <password of configuration file>

Par exemple :

LabVIEWCLI -OperationName RunVIAnalyzer -ConfigPath "C:\temp\test.viancfg" -ReportPath "C:\temp\output.html" -ReportSaveType "HTML" -ConfigPassword "abc"

RunUnitTests

Exécute les tests sur les fichiers spécifiés dans le toolkit LabVIEW Unit Test Framework et enregistre le fichier JUnit dans l'emplacement spécifié.

Remarque Pour exécuter cette opération, vous devez installer la bibliothèque UTF JUnit Report en utilisant le logiciel JKI VI Package Manager (VIPM).

Tableau 30. Arguments de RunUnitTests répertorie les arguments disponibles pour cette opération.

Tableau 30. Arguments de RunUnitTests
Argument Obligatoire ou facultatif Description Par défaut
-ProjectPath Nécessaire Chemin du fichier du projet.
-JUnitReportPath Nécessaire Chemin de destination du fichier JUnit.

Pour exécuter cette opération dans la CLI pour LabVIEW, exécutez une commande en utilisant la syntaxe suivante :

LabVIEWCLI -OperationName RunUnitTests -ProjectPath <path to project file> -JUnitReportPath <path to output JUnit file>
Par exemple :
LabVIEWCLI -OperationName RunUnitTests -ProjectPath "C:\temp\test.lvproj" -JUnitReportPath "C:\temp\test.xml"