Tedious Task Manager (TTM) User Manual
Contents
1. 40 Save file 41 49 41 uil V9 M 42 23 e 42 Wait for 43 Wait FOr USET a 42 25 43 BCE L 25 Find and replace 25 FTP delete remote file 27 FTP transfer Ros Gun had dq 26 G Get current project i etiku 27 Get c rrent time datu 31 Get specific 31 Get user INPUT scbnnasicvsensanenanctavtecnendanstsstiavaansees 33 INI file manipulation 33 L LabvIEW palette 40 e T NER 25 M Manipulate VIS eem 35 jii UB l 38 N jil o a 16 P Porta etti ia id 46 46 mail server 46 Return email address 46 SCHIDETOIGBE 46 esa tasca 46 WINGO WY 46 PIEK E 38 PEIUOOCUEITIGET e ratos et Nue Puedo 39 R AR mte 40 Save ifa 41 Script PERO g a 182. 19 TOOLS for SMART MINDS 50 cee EDER 15 EOC UU 44 g a 15 R NDIN E ET 44 SCHDETIDEGEV PA 47 Online Sept OER 47 16 eye cere eer 41 SYSTE 42 V cim 20 DECANE occae eibi 20 21 Ww WAT ON I oo teasers PR EE 42 Wait TOR UME Ed dotar EU REOR db nanan 43 Malt TOF USER bite a 42 Z 43 Tedious Task Manager User Manual
3. Variable Name FIGURE 7 USE BUTTON TO DECLARE A VARIABLE Variable Name FIGURE 8 ADD VARIABLE WINDOW LET YOU DECLARE A VARIABLE IMPORTANT Variable names are case sensitive hence Build BUILD and build are treated as three different variables Variable names can be compose with the following set of characters a z A Z 0 9 space When a script runs TTM executes commands in the planned order if finds a variable name TTM proceeds as follow If variable name is not found in TTM lookup table TTM creates variable and initialize the value according to command result otherwise TTM updates variable s value according to command result TOOLS for SMART MINDS 20 Tedious Task Manager User Manual IMPORTANT When a script is loaded into memory with a run or edit command a new name space is created so all existing variables are deleted Remember that every time you run a script all existing variables are destroyed so a script cannot make use of variables created or modified by other scripts USING VARIABLES Variables can be used in every field of a command except command description that must be a static text When you specify a variable name you have to write variable name inside lt and gt brackets as shown in the following example Description copy source code to backup server Hide Error Source Path c my projects PROJECT NAME gt
4. FIGURE 16 EMAIL EDITOR WINDOW TOOLS for SMART MINDS 24 Tedious Task Manager User Manual EXTRACT STRING This command gets a string part from an input string provided by a variable value Extracted string is set to an output string value description Variable Name in Type STRING zzzz 30000 Variable out Save FIGURE 17 ExTRACT STRING EDITOR WINDOW This command handles three different types of extraction si Description Example STRING Extract STRING value after xxxx Input string c projects my file zip token cikprojectsk STRING my file zip STRING zzzz Extract STRING value between Input string my package 1 0 12 vip two different tokens called xxxx my package respectively xxxx and zzzz 2777 STRING 1 0 12 STRING zzzz Extract STRING value before zzzz Input string my file zip token 7777 STRING my file FIND AND REPLACE STRING This command loads in memory a file finds Search string value and replaces all its occurrences with Replace string value Desin A T FIGURE 18 FIND amp REPLACE EDITOR WINDOW 25 If file is not found an error is returned If Replace string is left empty this command removes all occurrences of Search string from file String replacement is not case sensitive Y
5. Ea 27 FIGURE 21 GET CURRENT PROJECT EDITOR WINDOW sees een seerne nens ennen eger 27 FIGURE 22 LABVIEW OPTION WINDOW WITH VI SERVER SETTINGS c eene ana ahna anna tna ana shade ranae aan 28 FIGURE 23 GET FILE VERSION EDITOR WINDOW scccccsscccscscccecsccssseeucsseuesseesscuseeeuesseuesseeuseseueeseuseeseneeseuesenes 29 FIGURE 24 USE PROPERTY DIALOG TO VIEW FILE VERSION p GR Eos bx e Far 29 FIGURE 25 ENABLING AUTO INCREMENT OPTION INTO BUILD SPECIFICATION PROPERTIES 30 FIGURE 26 GET FOLDER FROM FILE PATH EDITOR 30 FIGURE 27 GET TIME EDITOR WINDOW o 31 9 FIGURE 28 GET TIME EDITOR WINDOW y ovde Ar e 31 FIGURE 29 GET USER INPUT EDITOR WINDOW 33 FIGURE 30 INI FILE MANIPULATION EDITOR WINDOW s eau ciiin MEAN c ERR tpe eA va Doa Se cede 33 FIGURE 31 AVAILABLE ACTIONS SELECTION sese essais ases enata
6. Tedious Task Manager TTM User Manual July 2012 Edition TOOLS for SMART MINDS 2 Tedious Task Manager User Manual Worldwide technical support and product information www toolsforsmartminds com TOOLS for SMART MINDS Corporate headquarter Via Padania 16 Castel Mella 25030 Brescia Italy Copyright 2010 Tools for Smart Minds All rights reserved TOOLS for SMART MINDS 4 Tedious Task Manager User Manual Contents FIGURE INDEX ABOUT THIS MANUAL CONVENTIONS INTRODUCTION DISTRIBUTIONS TTM standalone application TTM LabVIEW ADD ON REQUIREMENTS INSTALLATION GETTING STARTED WITH TEDIOUS TASK MANAGER TTM RUNNING TTM INSIDE LABVIEW RUNNING TTM STANDALONE APPLICATION CREATING A NEW SCRIPT EDITING A SCRIPT SHUTTING DOWN SYSTEM AFTER SCRIPT EXECUTION MAINTAINING SUMMARY WINDOW OPEN ON ERROR NOTIFICATIONS ADDING A COMMAND Add command Duplicate command DISABLING ENABLING A COMMAND DELETING A SCRIPT DUPLICATING A SCRIPT AVAILABLE COMMANDS SCRIPT VARIABLES Declaring variables Using variables TOOLS for SMART MINDS 6 Tedious Task Manager User Manual 12 12 13 13 13 13 13 13 14 14 14 15 15 16 16 16 17 17 17 18 18 19 20 20 20 21 CREATE A VARIABLE BUILD A LABVIEW PROJECT UNZIP A COMPRESSED FILE CoPY MOVE RENAME FILES AND FOLDERS CREATE A FOLDER DELETE A FILE FOLDER EMAIL EXTRACT STRING FIND AND REPLACE STRING
7. Refer to LabVIEW error code help to get more details about errors and their meaning 45 PARAMETERS This window let you specify TTM parameters to send emails store scripts and log information To open Parameters window click on Option Parameters for Options menu The following figure appears Script Folder C Users Administrator Documents LabVIEW Data TOOLS for SMART MINDST TN scripts Log Folder CA Users Administratori Documents LabVIEW Data TOOLS for SMART MINDS TTM log FIGURE 55 PARAMETERS WINDOW Mail server is your SMTP mail server required to send emails Important if mail server is not properly configured TTM cannot notify emails at the end of script execution and Email command fails execution Return address is sender mail address of all email sent by TTM Script Folder is folder where TTM stores script files At first run TTM creates a folder named LabVIEW TOOLS for SMART MINDS scripts into current user s data folder Log folder is folder where store log files At first run creates a folder named LabVIEW TOOLS for SMART MINDSY log into current user s data folder TOOLS for SMART MINDS 46 Tedious Task Manager User Manual ONLINE SCRIPTS LIBRARY You can browse online script library at the following address http www toolsforsmartminds com products labview script library ph In this page you find useful scripts created and TTM community that you can download without regist
8. the system dependent exit code returned by command is used to evaluate if Command completed successfully or not Exit code equal to zero means no errors When you have type Command field can use Test button to run system command Use Test button to execute Command WAIT FOR USER This command stops script execution until user presses OK button in a message box displayed with Message Description Message FIGURE 48 WAIT FOR USER EDITOR WINDOW WAIT FOR FILE This command stops script execution until Target File performs action specified in Action field Description hideError B Action Arrives ancel TOOLS for SMART MINDS 42 Tedious Task Manager User Manual FIGURE 49 WAIT FOR FILE EDITOR WINDOW Available actions are Action Description 0 AEREE Waits until file is move or deleted by third party applications or users WAIT FOR TIME This command stops script execution until specified Time is reached Use Include date and Include time to determine the exact behaviour of command Description Include date Include time 00 00 00 000 Time DDAMM YYYY FIGURE 50 WAIT FOR TIME EDITOR WINDOW Notice that if Include date is checked command can run only one time and further executions don t wait for specified date and time ZIP FOLDER FILE This command zips file or folder specified in Source file or fold
9. FTP TRANSFER A FILE ON A HOST FTP DELETE A FILE ON A HOST GET CURRENT PROJECT GET FILE VERSION GET FOLDER PATH FROM A FILE FULL PATH GET SPECIFIC FOLDER GET TIME GET USER INPUT INI FILE MANIPULATION Read Key Action Remove Key Remove Section Write Key LOAD FILE MANIPULATE VIs MD5 PICK FILE PRINT DOCUMENT 22 22 23 23 24 24 24 25 25 26 27 27 29 30 31 31 33 33 34 34 34 35 35 35 38 38 39 RUN VI SAVE FILE START LABVIEW SYSTEM WAIT FOR USER WAIT FOR FILE WAIT FOR TIME ZIP FOLDER FILE RUNNING A SCRIPT PARAMETERS ONLINE SCRIPTS LIBRARY INDEX TOOLS for SMART MINDS 8 Tedious Task Manager User Manual 40 41 41 42 42 42 43 43 ad 46 47 49 FIGURE INDEX FIGURE 1 TEDIOUS TASK MANAGER IS LAUNCHED FROM TOOLS TASM MENU eee mmn 14 FIGURE 2 MAIN WINDOW DISPLAYS ALL AVAILABLE SCRIPTS MG ern tesserae nun 14 FIGURE 3 SCRIPT EDITOR WINDOW a edic sabi dte dde 15 FIGURE 4 SCRIPT EDITOR WINDOW HAS NOTIFICATION SECTION AT THE BOTTOM TO SPECIFY EMAIL ADDRESSES 16 FIGURE 5 COMMAND SELECTION WINDOW eR PEU reds 17 FIGURE 6 DISABLED COMMANDS ARE MARKED WITH A CROSSED senes nnus 18 FIGURE 7 USE BUTTON TO DECLARE A VARIABLE css
10. two zip files Proiect amp first one with current project source i lib code project folder and its sub Ves Ves T4SM link SEM folders and second one with user lib folder and its subfolders Questions If you have any question regarding these scripts TTM usage or you encounter issues please contact us at support toolsforsmartminds com 152 LabVIEW FIGURE 56 ONLINE SCRIPT LIBRARY WEB PAGE 47 TOOLS for SMART MINDS 48 Tedious Task Manager User Manual INDEX C commands Build labVIEW 22 Sol 23 Create 22 DE ise 24 A p HIER TER TITRE 24 25 Find and replace 25 FTP delete remote file 27 FTP transfer THO 26 Get current project 27 Get file version 27 29 Get folder from file path 30 Get specific 31 GEE TIME 31 Get user 33 INI file 33 MEET TT 35 Manipulate 5 35 A 38 MOVE 23 PICK 38 PICK TC mE E 38 Print document ae uu EINE ie 39
11. D KEY ACTION WINDOW Important Notice that Section value has to be indicated without square brackets REMOVE KEY This action removes Key from the key set in Section if present Section Key Fields with cannot be empty FIGURE 33 REMOVE KEY ACTION WINDOW REMOVE SECTION This action removes Section and all keys associated if present FIGURE 34 REMOVE SECTION ACTION WINDOW TOOLS for SMART MINDS 34 Tedious Task Manager User Manual WRITE KEY This action writes a Key value into Section If Key is not present among key set in Section it creates a new key Sect on i Key Value Fields with cannot be empty FIGURE 35 WRITE KEY ACTION WINDOW Important This command is helpful when vou need to maintain variable values calculated bv a script for other scripts or for future executions of the same script or to exchange these valuese with third partv applications LOAD FILE This command loads a file into a variable Description Hide Error File Path 2 O Variable Name Save FIGURE 36 LOAD FILE EDITOR WINDOW If file not exists an error is returned MANIPULATE VIS This command selects a list of VIs into selected folder and performs the following task on each VI e Block diagram clean up e change password e change allow debugging VI property e custom manipulation This command is als
12. _ lt BUILD gt zip Destination server backup LabVIEW projects lt PROJECT NAME gt Sup he Last Execution Time 0 0 sec FIGURE 9 A COMMAND WITH VARIABLES IN ITS FIELDS Source Path field contains two variables PROJECT NAME and BUILD their values have to be calculated in other commands executed before the one in above example TTM stores in a lookup table all variable names and their values so in above example TTM can evaluate Source Path substituting lt PROJECT NAME gt and BUILD with respective values 21 CREATE A VARIABLE This command creates a variable and sets a value If Variable value contains references to other variables when script is executed TTM calculates a run time value Variable name can be composed with any character in this set a z A Z 0 9 space Description Variable Name Variable Value FIGURE 10 CREATE A VARIABLE EDITOR WINDOW BUILD A LABVIEW PROJECT This command builds one or more build specifications of a selected LabVIEW project Building specifications have to be present into LabVIEW project at the time this command executes IMPORTANT This command is available in TTM ADD ON for LabVIEW Uc b I 1 LV Project l Description Project Path Load Build specs pO Remove build spec Last Execution Time 0 0 sec FIGURE 11 BUILD LV PROJECT EDITOR WINDOW To properly configure this command follow the
13. command returns a folder s full path among a list of available specific folders Description Hide Error Folder LabVIEW folder FIGURE 27 GET TIME EDITOR WINDOW You can choose one of the following folder s full path Folder 005 GET TIME This command sets a variable value equal to the PC s time at the moment it is executed You can specify the format of time with Time format field description Time farmat Variable FIGURE 28 GET TIME EDITOR WINDOW If Time format is left empty assumes default time format 96Y96m96d 96H96M96S that means data and time info are represented as YYYYmmdd HHMMSS Notice that you can use fixed string inside time format to create special string For example you can use the following Time format Year Y Month m and TTM calculates at runtime the following value Year 2012 Month 03 The following table illustrates available format codes locale specific time hour 24 hour clock hour 12 hour clock fractional seconds with digit precision a m p m flag locale specific date Format can be composed by any combination of format codes string constant and VARIABLES TTM evaluates Format in two steps 1 Variable evaluation variable names are changed with their values 2 Format codes evaluation format codes are changed with their values at the time of
14. ct eturns current LabVIEW project s name Get File version eturns executable file version Get Folder form file path eturns a folder path which contain a specific file Get Specific folder eturns a system folder FTP file transfer Transfers a file on a FTP host Get User input INI File Manipulation eads and writes keys into a IN configuration file Load file Loads a text file into a variable Manipulate VIs Clean up block diagram and set password to list of selected 5 Print document rint documents on a selected printer uns external VI to execute custom commands Start LabVIEW uns latest LabVIEW version installed in your PC D e R R R R R R R d R E 05 Zip a specific file or folder DISABLING ENABLING A COMMAND Every command can be disabled or Enabled When a script runs only enabled command are executed Use Enable command and Disable command to change selected command s state Disabled commands have a special symbol at the left of their name as shown below test FiGURE 6 DISABLED COMMANDS ARE MARKED WITH CROSSED CIRCLE DELETING A SCRIPT TOOLS for SMART MINDS 18 Tedious Task Manager User Manual To delete an existing script select its row from script table and click on Script Delete form Scripts menu Confirm your choice to delete script form disk DUPLICATING A SCRIPT To duplicate an existing script select its row from script table an click on Scripts Duplicate from Script
15. cutersescsccseersercssessasceses 40 FIGURE SAVEFILE EDITOR WINDOW ed tuit sevo persos ew O S ali ata 41 FIGURE 46 START LABVIEW EDITOR WINDOW 5555s is ca pl ta raise Feu base st 41 FIGURE AF SYSTEM SED TOR WINDOW editur Nt aad dd boa uda at Go ad RS S 42 FIGURE 48 WAIT FOR USER EDITOR WINDOW een rene ensure erne ensure eee 42 FIGUREZ9 WAIT FOR FILE EDITOR WINDOW S Sessio pier ence y ran 43 FIGURE WAIT FOR TIME EDITOR WINDOW jiu ba ce eed 43 FIGURE EDITOR WINDOW TU 43 FIGURE RIGHT CHCICON A ROW TO RUN A SCRIPT Pr NI A 44 FIGURE 53 WHEN SCRIPT RUNS A LOG PAGE DISPLAY PROGRESS OF enne 44 FIGURE 54 IF A COMMAND FAILS A RED LIGHT SIGNALS THAT SCRIPT EXECUTION HAS BEEN ABORTED 45 TOOLS for SMART MINDS 10 Tedious Task Manager User Manual FIGURE do P ARAIVIETERS WINDOWS to 46 FIGURE 56 ONLINE SCRIPT LIBRARY WEB PAGE r rer rez tren ses ue 47 ti ABOUT THIS MANUAL The TTM User Manual describes the functionalities of Tedious Task Manager TTM a productivity tools capable to edit run parametric scripts and provide useful information about the way scri
16. during their execution These monitor windows display details about execution status and optionally a progress bar If a command fails its execution script aborts and stop executing the commands which follow the one who failed TTM keeps track of start time and end time for every command and after first run uses this information to estimate execution duration for single commands and whole script TOOLS for SMART MINDS 44 Tedious Task Manager User Manual stress test Example IX start time end time command error code Time s vars MN 18 02 2012 22 26 06 18 02 2012 22 26 06 crestevarPROKCT _ _ PROJECT 18 02 2012 22 26 06 18 02 2012 22 26 06 Getfolderfrom PROJECT JO PROJECT FOLDER 185220 222606 I852012 222858 build of stress testvprey completed 18 02 2012 22 28 58 18 02 2012 22 28 58 JEXEBULD 18 02 2012 22 28 58 18 02 2012 22 28 58 Getfolderfrom lt JO JEXEFOLDER 18 02 2012 22 28 58 Zip PROJECT FOLDER STRESS TEST EXE BUILD D HN ON 18 02 2012 22 28 59 18 02 2012 22 28 59 email source code to development team TCP Open Conne 54 FIGURE 54 IF A COMMAND FAILS A RED LIGHT SIGNALS THAT SCRIPT EXECUTION HAS BEEN ABORTED When a command fails TTM indicates returned error code in log table as shown above Error codes refer to LabVIEW error coding tables
17. e made with LabVIEW application builder you have to check Auto increment as shown in the following figure 29 Information Source Files Destinations Source File Setting Icon Advanced Additional Exclusions Windows Security Shared Variable Deployment Version Number Auto increment Major Minor Fix 11 0 Product name My application Run Time Languages Pre Post Build Actions Preview Legal copyright Copyright 2011 Company name My company Internal name my Application P Description my Applicatiori FIGURE 25 ENABLING AUTO INCREMENT OPTION INTO BUILD SPECIFICATION PROPERTIES GET FOLDER PATH FROM A FILE FULL PATH This command sets a variable value equal to a full path of the folder that contains File Path Use Levels Up to select the number of elements removed from File Path value Description Hide Error File Path Levels Up 1 Variable Name FIGURE 26 GET FOLDER FROM FILE PATH EDITOR WINDOW Example If File Path is projects NLabVIEWNCustomer ABCD Application When Level Up is set to 1 command returns projects LabVIEW Customer ABCD Application A When Level Up is set to 2 command returns c projects NLabVIEWNCustomer ABCD When Level Up is set to 3 command returns projects LabVIEW TOOLS for SMART MINDS 30 Tedious Task Manager User Manual GET SPECIFIC FOLDER This
18. elect file with smallest file size among files which match specified pattern order alphabetical order not case sensitive order alphabetical order not case sensitive User Selection Let user select a file In this case Folder is used as start path for file dialog and user can choose a file path in every folder In this case only a non existing file can be specified TOOLS for SMART MINDS 38 Tedious Task Manager User Manual PRINT DOCUMENT This command prints a document using windows shell to a selected printer if no printer is selected default printer is used Fields with cannot be empty FicURE 42 PRINT DOCUMENT EDITOR WINDOW 39 RUN VI This command runs a VI which path is specified in VI Full Path field Selected VI must fulfil connector pane requirements Description VI Full Path Password Test connector pane FIGURE 43 RUN VI EDITOR WINDOW If VI is password protected use Password field to allow TTM to load and run selected VI You can find a template that shows how to properly setup connector pane for your VIS in Addons TOOLS for SMART MINDS gt palette FIGURE 44 TEMPLATE IS AVAILABLE IN LABVIEW PALETTE Create a copy of template file and put your code in its diagram Input parameters are e Variables in it s an array of clusters with all script s variables and their respective values e Errorin for future use Output values are e Variables ou
19. er field into Destination File If Destination File exists TTM deletes it before creating zip file Description Hide Error 5ource file or falder n Destination Last Execution Time 0 0 sec FIGURE 51 21 EDITOR WINDOW If a zip file with the same name exists it is deleted before starting creation of new zip file 43 RUNNING A SCRIPT To execute a script you have to right click on the script s row in script table as show in the following figure Tedious Task Manager Description File name Task Count Last execution Last Result TTM build and backup TTM build and backup script 2 12 02 2012 17 01 23 Successful stress test TTM Example TTM example script 10 13 02 2012 16 00 38 Successful test email test email gent 13 02 2012 13 52 15 Successful Duplicate Delete FIGURE 52 RIGHT CLICK ON A ROW TO RUN A SCRIPT Alternatively you can run a script from Scripts Run menu When a script is running a log page is displayed as shown below end time command status error code Time s vars 18 02 2012 22 26 06 18 02 2012 22 26 06 create var PROJECT completed 0 PROJECT 18 02 2012 22 26 06 18 02 2012 22 26 06 Get folder from PROJECT completed 0 PROJECT FOLDER 18 02 2012 22 26 06 build of stress test lvproj FIGURE 53 WHEN SCRIPT RUNS A LOG PAGE DISPLAY PROGRESS OF EXECUTION Some commands open a monitor window
20. execution TOOLS for SMART MINDS 32 Tedious Task Manager User Manual GET USER INPUT This command sets a variable value with an input text User input can be empty text Description VariableName FIGURE 29 GET USER INPUT EDITOR WINDOW When this command runs script execution is stopped until user confirms input and presses OK button on a message box INI FILE MANIPULATION This command allows you to manipulate a INI configuration file In a single command you can group different actions on the same file Command opens configuration file performs all actions and then saves it Description xa 7 Create If Not Found Fields with cannat be empty FIGURE 30 INI FILE MANIPULATION EDITOR WINDOW If file not exists and Create if not found is NOT checked an error is returned Actions on configuration file are indicated in action list Available actions are indicated in the following table Action Description When you press Add Action button actions are listed in a specific window as shown in the next figure 33 Removekey Removesection WiriteKey Important all key values are treated as string values regardless of their format READ KEY ACTION This action reads Key value from Section Key value is saved into Variable Name variable Section Variable Fields with cannot be empty FIGURE 32 REA
21. following steps select LabVIEW project 2 Click Load build specs button to load specifications Build list is compiled with available build specifications TTM associates a new variable to every build specification with names EXE 1 EXE 2 etc 3 Selected unwanted build specifications and click Remove Build specs to remove them from table 4 Use triple click on a Variable name to edit its value if required TOOLS for SMART MINDS 22 Tedious Task Manager User Manual Build list must contain at least a building specification Build specifications are compiled in the same order they are indicated in Build List IMPORTANT Set Build specification value to an empty string to allow TTM to search into build specification list of selected project and use an existing build specification When LabVIEW starts building process interaction with TTM windows is suspended up to the end of building process Trying to stop building process can drive TTM to unpredictable behavior UNZIP A COMPRESSED FILE This command unzips compressed files and folders contained into Zip file All created files and folders are created into Target folder If target folder doesn t exist TTM creates it before unzipping Description Hide Error Zip File Target folder FIGURE 12 UNziP EDITOR WINDOW If Target folder doesn t exist it is created automatically CoPY MOVE RENAME FILES AND FOLDERS This command copies or move
22. he destination where TTM has to delete file indicated in Remote Path field Both fields can be composed with variables Click Test credentials button to verify FTP connection with specified credentials If remote path value ends with a backslash character TTM considers this path as a folder and abort command because TTM doesn t delete remote folder GET CURRENT PROJECT This command retrieves current project file name You have to specify a Variable Name that is set at run time with open project full path If multiple projects are open it returns the first project file name Description Get current project myProject Hide Error Port 3363 Variable Name myPraject FiGURE 21 CURRENT PROJECT EDITOR WINDOW If no projects are open an error is returned Ensure VI server is enabled in LabVIEW and specify the right TCP port value The following figure illustrates the LabVIEW option page where you can enable VI Server 27 Category VI Server New and Changed Front Panel Block Diagram Controls Functions Palettes Environment search Paths Printing source Control Menu Shortcuts Revision History Security Activex shared Variable Engine Main Application Instance vl Server Use default Note The VI Server options on this page only apply to the selected application instance Refer to the LabVIEW Help for more information about VI Server options Web Server VI Scripting Show VI Sc
23. ng a set of existing command with the command selection window DUPLICATE COMMAND Use Duplicate command button to create a new command as copy of an existing one new duplicated command is inserted before existing one Build LV Project Copy Move Create folder Delete Email Extract String FTP File transfer Find amp Replace Get Current Project Get File Version 4 Get Folder from file path Get Specific folder Get Time Get User Input INI File Manipulation Load file MD5 Available built n in commands Command brief Creates a list of variables description FIGURE 5 COMMAND SELECTION WINDOW When you click on a row of commands table TTM displays a brief description To proceed with command selection press Add button or double click on command row TTM scripts are composed by a sequence of commands in most cases built in commands can be used to fulfill user s needs If you need to integrate a script with special features not available as external application you can create your custom commands as LabVIEW VIs is provided with a template you can use to create your own commands See Run VI command description the get more details Available commands are 17 Build selected specifications Copies moves file Creates a new folder eletes a file or folder F P Find amp Replace ind a string into a text file and replace it with a new string Get current proje
24. o useful to analyse a set of VIs and create a comprehensive report where VIs grouped by their state idle Run bad The report can be customized with VI s metrics VI s help details and VI s password 35 Set Current Vis password value to open password protected Vis If Change Vis password checkbox is marked every VI is saved with New VIs password value Meere Folder list Show details Show details if not all VIs are in idle state Clean Glean up options change Allow debugging debugging value to apply custom manipulation Custom Manipulation VI Create Report file name Add state to report add metrics to add Help infa to report Add Ms password to report Current VI s password Edit password Change Vis password New VI s password Edit password Fields with cannot be empty FIGURE 37 MANIPULATE VIS EDITOR WINDOW Use Clean Up options button to customize the way clean up is performed the following figure illustrates default values for block diagram clean up TOOLS for SMART MINDS 36 Tedious Task Manager User Manual Clean Up Options in Left Alignment Strict Rules Max Heuristic Iterations Max Simplex Iterations Horizontal Block Padding Vertical Horizontal Wire F adding 3 Vertical Auto Tune by Topology Fine Tune Y Positions Align All Controls on Left Align All Indicato
25. ou can specify variables in both Search string and Replace string fields FTP TRANSFER A FILE ON A HOST This command transfers a file to a remote host using FTP protocol NN Last Execution Time FIGURE 19 FTP FILE TRANSFER EDITOR WINDOW Host specifies the destination where TTM has to copy file selected in Local Path field Both fields can be composed with variables Click Test credentials button to verify FTP connection with specified credentials If remote path value ends with a backslash character TTM considers this path as a folder and appends the file name extracted from Local path value as illustrated in the following examples Example 1 Local path c mydata myfile txt Remote path sharedData XYZ TTM tries to create the file sharedData XYZ In the above case XYZ is used as remote file name instead of myfile txt Example 2 Local path c mydata myfile txt Remote path sharedData XYZ In this second case tries to create the file sharedData XYZ myfile txt In the above case XYZ is considered as a folder name TOOLS for SMART MINDS 26 Tedious Task Manager User Manual FTP DELETE A FILE ON A HOST This command deletes a file on a remote host using FTP protocol Wert 00000000000 FTP account FTP password o Set password Last Execution Time 0 0 sec FIGURE 20 FTP DELETE EDITOR WINDOW Host specifies t
26. pts have completed their job or have fails at a certain point CONVENTIONS The following conventions appear in this manual The symbol leads you through nested menu items dialog box options to a final action The sequence Tools Options directs you to pull down the Tools menu select Options item Bold Bold text denotes items that you must select or click on the software such as menu items and dialog box options Bold text also denotes parameter names italic Italic text denotes variables emphasis a cross reference or an introduction to a key concept This font also denotes text that is a placeholder for a word or value that you must supply monospace Text in this font denotes text or characters that you should enter from the keyboard sections of code programming examples and syntax examples This font is also used for the proper names of disk drives paths directories programs subprograms subroutines device names functions operations variables filenames and extensions and code excerpts monospace italic Italic text in this font denotes text that is a placeholder for a word or value that you must supply TOOLS for SMART MINDS 12 Tedious Task Manager User Manual INTRODUCTION This document illustrates how to use TTM Tedious Task manager If you are a developer you are reading the right document TTM is a productivity tool dedicated to automate repetitive activities you encounter every time
27. purpose Commands table contains all script s commands Use button list at the right of Commands table to add edit remove commands to vour script Click Add command button to add new command to vour script New commands are appended at the end of the list To change the order of execution of commands select the command vou want to move up or down and click on Move up or Move down buttons Click Remove command button to remove a command from script Use Run command button during script editing to execute a single selected command Use Variables button to view current variables values Below script s name vou have two checks Shutdown at completion e Maintain Summary Window Open on Error These checks are evaluated after script execution 15 SHUTTING DOWN SYSTEM AFTER SCRIPT EXECUTION When your script takes a lot of time to execute you may wish TTM switches off your PC when finishes to execute the selected script Switching computer off is done regardless script fails of succeeds Mark this checkbox when for example launched script execution is going to end late in the evening and you don t want to keep your PC on all night By default this checkbox is set to FALSE MAINTAINING SUMMARY WINDOW OPEN ON ERROR When script execution is not supervised and you want to have details about script execution in case of fail set Maintain Summary Window Open On Error checkbox to TRUE so that when script execution aborts due to a command error s
28. ration and have to copied into TTM Script Folder Script library page can be open also from Help Script library online 749 TOOLS FOR SMART MINDS SOFTWARE SOLUTIONS JIM TEDIOUS TASK MANAGER TIM SCRIPT LIBRARY ae In our script library you find useful examples of TTM usage These scripts are available for TTM ADD ON for LabVIEW and TTM standalone application Download scripts and start saving time E 2 How to add scripts to your personal library Download script files somewhere in your PC and then save them into TTM default script folder Use Option gt gt open script folder in Option menu to explore default script folder S SCCT pond If you are a LabVIEW developer download TTM ADDON for LabVIEW here If you develop with programming languages or want to automate your file management download TTM standalone application here DOCUMENTATION T T T T TTM g Title Description EUN standalone Author Download 2 J LabVIEW application A T 5 c T T 5 This script creates a zip file with all ob files included in current projects Yes No T4SM link folder and its subfolders It creates an executable from projects build specifications Build amp retrieves exe build number and Backup create a zip file with projects Yes No T4SM link source code and names ZIP file with projects name and build number This script creates
29. ripting functions properties and methods Display additional VI Scripting information in Context Help window Accessible Server Resources VI calls VI properties and methods Application properties and methods Control properties and methods FIGURE 22 LABVIEW OPTION WINDOW WITH VI SERVER SETTINGS TOOLS for SMART MINDS 28 Tedious Task Manager User Manual GET FILE VERSION This command retrieves version of executable file exe specified in File Path You have to specify a Variable Name that is set at run time with file version Description Hide Error File Path Variable E FIGURE 23 GET FILE VERSION EDITOR WINDOW File version can be viewed with file s property dialog box into resource explorer browse to your executable folder and right click on your file choose properties and select version tab as shown in the following figure 221 notepad Properties Property Value Description File description Notepad Type Application File version hid Product name Microsoft Windows Operating System Product version 65 1 7600 15385 Copyright Microsoft Corporation All rights reserv Size 183 KB Date modified 7 14 2008 3 38 AM Language English United States Original filename NOTEPAD EXE Remove Properties and Personal Information FIGURE 24 USE PROPERTY DIALOG TO VIEW FILE VERSION File version is defined during executable creation If your executable files ar
30. rs on Right Use Array Dimension Heuristics FIGURE 38 CLEAN UP OPTIONS WINDOW You can exclude subfolders and VIs with Exclusions button FIGURE 39 EXCLUSIONS WINDOW 37 MD5 This command computes the MD5 message digest of a file The MD5 message digest is a 128 bit number displaved in lowercase hexadecimal format Description Hide Error File E el Variable Name Create file Sae FIGURE 40 MD5 EDITOR WINDOW If file not exists an error is returned MD5 value is saved into Variable Name and if Create file is checked in a file with same name and path of File Path field but with extension equal to MD5 PICK FILE This command sets a variable with the selected file full path File selection is done according to selected Criteria and Pattern among available file in Folder at the time command runs If no files are present an error is returned c D ee Description Hide Error Folder Criteria User selection Pattern Variable Name FIGURE 41 Pick FILE EDITOR WINDOW Available criteria are illustrated in the following table Select file with most recent date and time among files which match specified pattern Select file with most old date and time among files which match specified pattern Select file with biggest file size among files which match specified pattern S
31. s menu 19 AVAILABLE COMMANDS In this chapter TTM s available commands are described A script is composed by a sequence of commands TTM executes commands in the same order they are placed into the sequence Commands are defined by a description and some parameters which depend on command type Description doesn t affect command execution simply describes the command purpose in your script If Description is left empty TTM fills it automatically with a default value and most significant field s values Some command s editors show Hide error checkbox in the upper right corner This field avoid TTM to stop script execution if command fails SCRIPT VARIABLES Except Description field and variable names all other text fields can be set to static values for example C myData or dynamic values for example MY DATA that evaluates during script execution Variables are defined during script editing phase and are evaluated during script execution Commands are executed in the same order they are displayed in script editor So variable s values are calculated in that order A variable s value can be composed with other variables DECLARING VARIABLES Variables are declared during script editing and are initialized at script loading with empty values or during script execution Variables can be declared inside command s editors with button as shown in the following figure EET Hide Error
32. s file indicated in Source Path field File is copied onto Destination path Both Source Path and Destination are evaluated at run time and can contain VARIABLE NAMES Use Copy file flag to choose if file has to be copied or moved Description Source file folder Destination folder Copy file add To Destination Folder Last Execution Time 0 0 sec Fields with cannot be empty FIGURE 13 Copy Move EDITOR WINDOW If file exists before command execution it is overwritten If Destination folder does not exist Copy Move command creates it Set Add to Destination Folder checkbox to TRUE if you want to move copy Source file folder into Destination folder Set Add to Destination Folder checkbox to FALSE if you want to rename Source file folder with Destination folder as new name 23 CREATE A FOLDER This command creates a folder as specified in Folder name Description Hide Error Folder name M A FIGURE 14 CREATE FOLDER EDITOR WINDOW If folder exists before command execution no error is returned DELETE A FILE FOLDER This command deletes folder file specified in Path field decison hide Error FIGURE 15 DELETE EDITOR WINDOW If Path doesn t exist no error is signaled EMAIL This command sends email to specified list of recipients Email can has one attached file All fields are evaluated at run time and can contain variable names
33. sas esser suas 34 FIGURE 32 READAGEY ACTION WIND OMY OUR Peta us ev 34 FIGURE 33 REMOVE ACTION WINDOW l A ra EA gidu GA rd Eu VR Lv UNDER 34 FIGURE 34 REMOVE SECTION ACTION irs ierat ak i i OR v EN EN AN ERRARE S EXER REP a a ke p a 34 FIGURE 35 itia 35 FIGURE SO LOAD FILE EDITOR WINDOW a 35 FIGURE S A MANIPULATE VIS EDITOR WINDOW 255 Ope roa tea rosis 36 FIGURE SGS CLEAN UP OPTIONS WINDOW Tuy due Vite POVERO 37 FIGURE 39 EXCLUSIONS WINDOW cbr Ur ER 27 FIGUREAO MDS EDITOR WINDOW 38 FIGURE 41 PICK FILE EDITOR WINDOW ia ia frat bi i 38 FIGURE Z2 PRINT DOCUMENT EDITOR WINDOW sd enia 39 40 FIGURE 44 TEMPLATE IS AVAILABLE IN LABVIEW PALETTE 0sccscascescsccsccvvcsccseersescsccseerpsc
34. scccsescesesscesescccnceseueeseuessesseseussseuesseeuseneuseseueseseseseuesenes 20 FIGURE 8 ADD VARIABLE WINDOW LET YOU DECLARE A 20 FIGURE 9 A COMMAND WITH VARIABLES IN ITS 5 esses ssa ese 21 FIGURE 10 CREATE A VARIABLE EDITOR WINDOW ia a ei KA abba ka 22 FIGURE 11 BUILD LV PROJECT EDITOR a rene een een reen sense enes enes eee 22 FIGURE 12 UNZIP EDITOR WINDOW ei i ka jek ad ea 23 FIGURE 13 COPY MOVE EDITOR WINDOW ssecccceeecccessccccceeccccecccecuecececeececcacccecaueececauececaueececuuneeecaueceeaueess 23 FIGURE 14 CREATE FOLDER EDITOR WINDOW een enn ennen seere 24 FIGURE 15 DELETE EDITOR WINDOW rak 24 FIGURE 16 EMAIL EDITOR WINDOW i nnnnnesneneseresa sese sess s ssa 24 FIGURE 17 EXTRACT STRING EDITOR WINDOW EX FN 25 FIGURE 18 FIND amp REPLACE EDITOR WINDOW cscccccsscccnsscesscscessseenceseeseeneceeuceseuesseuesseeuseeeuseseeuseseueeseuesenes 25 FIGURE 19 FTP FILE TRANSFER EDITOR i 26 FIGURE 20 FIP DELETE EDITOR WINDOW kein
35. t first activation TTM takes longer time to display its main window because it creates default folder used to store scripts and log files The following figure shows TTM main window edious Task Manage Scripts Options Help B l D ipti TTM build and backup stress test TTM Example test email File name TTM build and backup script TTM example script test email script Task Count Last execution 2 10 1 Last Result Successful Successful Successful 12 02 2012 17 01 23 13 02 2012 16 00 38 13 02 2012 13 52 15 FiGURE 2 TTM MAIN WINDOW DISPLAYS ALL AVAILABLE SCRIPTS 14 TOOLS for SMART MINDS Tedious Task Manager User Manual CREATING A NEW SCRIPT To create a new script click on Scripts New from Scripts menu Type script file name and a new empty script is created EDITING A SCRIPT To edit an existing script click on Scripts Edit form Scripts menu Script Editor s window appears and you can edit script properties TTM sets script name equal to its file name you can change script name at any time editing Name field Shutdown at Completion Maintain Summary Window Open On Error W Name and descriptions Description 4 Script Execution Time 0 0 sec Command Add command Command list im FIGURE 3 SCRIPT EDITOR WINDOW Bv default script file Name is used as script s name Description is used to describe the script
36. t it s an array of clusters with all script s variables and their new values e Error out returns VI error after its execution Notice that custom VIs cannot create new variables they can only change existing variable s values If custom VI has a visible Panel and interaction with user is required you have to set VI s Panel to modal behavior TOOLS for SMART MINDS 40 Tedious Task Manager User Manual SAVE FILE This command save a text into a file Description File Path Content FIGURE 45 SAVE FILE EDITOR WINDOW Content field is saved into the file specified bv File path Content can contain variable names closed in lt gt brackets START LABVIEW This command starts current version of LabVIEW of the same machine where TTM is running Description Start LabVIEW Hide Error Cancel Save FIGURE 46 START LABVIEW EDITOR WINDOW This command has no parameters Instead of this command use System command to run a older version of LabVIEW on machines where multiple versions are installed IMPORTANT This command is available only in TTM standalone application 41 SYSTEM This command executes a system command TTM waits until Command terminates its execution Description Hide Error Wait until completion Command Last Execution Time 00 sec FIGURE 47 SYSTEM EDITOR WINDOW If Wait until completion is selected
37. tructions RUNNING TTM INSIDE LABVIEW If you have installed TTM for LabVIEW you can launch TTM main window from Tools TASM menu as shown below File Operate 8 Help Measurement amp Automation Explorer Instrumentation b FPGA Module b Real Time Module b DSC Module b 5 M Wi ne p Security b i Emi User Name BH Rea Convert Build Script O Moi Source Control b VI Analvzer b Open LLB Manager CA Import b ared Variable b CA Shared Variabl Distributed System Manager Find VIs on Disk pri Prepare Example for NI Example Finder str Remote Panel Connection Manager calc Web Publishing Tool e acc Control Design and Simulation b 3 Bro Create Data Link Find LabVIEW Add ons I t Internet FPGA Proj LAVA SignalExpress hAanaane b b b Latest from ni com LabVIEW News LabVIEW in Action 1 Example Programs Training Resources Online Support Discussion Forums Code Sharing KnowledgeBase Request Support Help Getting Started with LabVIEW List of All New Features Q Find Examples Find Instrument Drivers Find LabVIEW Add ons Ted 5 Task FIGURE 1 TEDIOUS TASK MANAGER IS LAUNCHED FROM TOOLS TASM MENU RUNNING TTM STANDALONE APPLICATION Click on Start All Programs b TOOLS for SMART MINDS gt gt from start menu A
38. ummary window shows all execution details NOTIFICATIONS Notifications allows TTM to notify the final execution status at the end of script execution by email Click Notification button to extend Script Editor with notification section as shown in the following figure ame Shutdown at Completion Maintain Summary Window Open On Error W VU ORAN EZ script Execution Time 0 0 sec Commands Command description Add command Duplicate command Remove command Run command Enable command Disable command Move up Move down Variables notify fail to notify success to Addaddress l address list Remove address notification parameters FIGURE 4 SCRIPT EDITOR WINDOW HAS NOTIFICATION SECTION AT THE BOTTOM TO SPECIFY EMAIL ADDRESSES TOOLS for SMART MINDS 16 Tedious Task Manager User Manual If TTM completes script without errors a successful notification is sent to all recipients indicated in Address List If Script execution aborts a single email is sent to recipient indicated in Notify fail to field Important TTM can send emails only if mail server is properly configured Please read Paragraph Parameters at the end of this manual to setup SMTP parameter and allow TTM to send email ADDING A COMMAND There are two buttons that allows to add a command to a script ADD COMMAND Use Add command button to add a new command Commands can be selected amo
39. when you are at work With TTM you can e build executables at specific time e save source code into a zip file automatically with a specific name calculated dynamically e organize your code files avoiding mistakes e send emails to your team mates when a build is ready e many more nice things DISTRIBUTIONS TTM is available in two different distributions TTM STANDALONE APPLICATION This distribution of TTM runs on Windows based PC and is generally used to schedule some repetitive activities on files folders etc TTM LABVIEW ADD ON This distribution of TTM is fully integrated with LabVIEW development environment and can execute some specific LabVIEW commands like building specifications and running custom VI REQUIREMENTS TTM standalone application requires Windows XP Vista 7 TTM ADD ON for LabVIEW requires LabVIEW 2012 or higher FTP file transfer functionality is available only if Internet Toolkit is properly installed INSTALLATION Download TTM VIP at the following link https www toolsforsmartminds com products ttm ph To install the vip package use VIPM package manager You can download a copy at the following URL www jki net 13 GETTING STARTED WITH TEDIOUS TASK MANAGER TTM In this chapter you learn how to create your own scripts to automate everyday activities TTM provides a list of built in functionalities called commands you can extend this set of commands with your VIs and command line ins
Download Pdf Manuals
Related Search