TABLE OF FIGURES... II A - DISCUSSION...1 B - CONFIGURATION...4. B.1 - Setup Dialog... 4 B.2 - Description... 5 B.3 - Controls...

Transcription

1 Radiant Technologies, Inc. 2835D Pan American Freeway NE Albuquerque, NM Tel: Fax: Table of Contents TABLE OF FIGURES... II A - DISCUSSION...1 B - CONFIGURATION...4 B.1 - Setup Dialog... 4 B.2 - Description... 5 B.3 - Controls... 5 C - EXECUTION, ARCHIVE REGRAPH AND EXPORTING...6 C.1 - Execution... 6 C.2 - Archive Recall... 7 C.3 Admin Info... 9 C.4 - Exporting C.5 - Controls C.6 - Discussion D USER VARIABLES...18 E - CHANGE RECORD...19 I

2 Table of Figures Figure A.1 - Timed Branch Abort Execution Logic Figure A.2 - Sample Logic Flow Test Definition Figure B Timed Branch Abort Task Configuration Dialog Figure C Timed Branch Abort Task Execution Dialog Figure C Access the Timed Branch Abort Task in the DataSet Archive Figure C Configuration Dialog for the Task Recalled from the DataSet Archive... 9 Figure C Admin Info Subdialog Figure C Export Dialog Figure C Standard Windows File Browser Dialog Figure C Export Configuration Dialog - Printer Option Figure C Standard Windows Printer Configuration Dialog Figure C Sample Timed Branch Abort Task Text Export File Figure C Sample Timed Branch Abort Task Excel Export Output Figure C Sample Timed Branch Abort Task Word Export Output II

3 Radiant Technologies, Inc. 2835D Pan American Freeway NE Albuquerque, NM Tel: Fax: VII Tasks A. Program Control 1. Branch Tasks iv. Manual Branch Abort Task A - Discussion The purpose of the Timed Branch Abort Task is identical to that of the Manual Branch Abort Task. It affords the operator of the Vision/Precision Ferroelectric Tester system an opportunity to manually abbreviate the number of iterations in a Branch Loop by selecting either Branch Abort or Continue Branching at each iteration of the Branch Loop. However, the Manual Branch Abort Task has the disadvantage of requiring the operator to monitor the execution of the Test Definition and to make the decision at each iteration. The Timed Branch Abort Task ameliorates this situation and allows unsupervised Test Definition execution by combining the Manual Branch Abort with a Delay Task to allow the decision dialog to expire after a user-programmable amount of time. If the dialog expires with no user input, the Branch Abort flag will not be set and Branching will continue until the Branch Task's Branch Logic Condition fails. Although the Timed Branch Abort Task has been added with Version for the specific purpose of introducing an unsupervised Manual Branch Abort Task, identical functioning is available through the Delay Task. That Task presents the user with a Loop Abort button. When clicked, the delay is immediately abbreviated and the Branch Abort flag is set. In fact, any Task that presents the user with a dialog - whether the dialog expires or requires input - has the ability to abort any Branch Loop that it is programmed into. This is true of Delay, DC Bias, Waveform, Pause, Manual Exit and Timed Exit among other. Nevertheless, the Timed Branch Abort Task is provided to allow the user to specifically address its function. The Timed Branch Abort Task logical effect on Test Definition execution is shown in Figure A.1. 1

4 Figure A.1 - Timed Branch Abort Execution Logic. It is important to note that if the Timed Branch Abort Task follows other Branch aborting Tasks in the Test Definition (including other Timed Branch Abort Tasks) it will take precedence and overwrite any aborting action taken by previous Tasks if the user interacts with the Task. If some previous Task set the Branch Abort condition, but the user sets the Continue condition, the Branch Task is free to Branch. If the user sets the Branch Abort flag, the Branch will abort unless a subsequent Manual Branch Abort Task or Timed Branch Abort Task changes the condition. If a Timed Branch Abort sets an abort, the abort may be cleared by a subsequent Manual Branch Abort or Timed Branch Abort Task. However, Tasks that have Branch Abort as a secondary function cannot clear a Branch Abort flag. On the other hand, if a Timed Branch Abort Task sets a "Continue" condition, any subsequent Task can set the Branch Abort condition. If, however, the Timed Branch Abort Task is allowed to expire, it will not adjust the Branch Abort flag in any way. Any previous setting or clearing of the Branch Abort flag that reaches the Timed Branch Abort Task will be allowed to pass through the Task to the Branch Task when operating without human interaction. Consider the rather silly Test Definition of Figure A.2. The Branch Task response to the various logical conditions of Timed Branch Abort One and Timed Branch Abort Two are shown in Table A.1. The Table assumes that the Branch Task Branch Logic Condition is 2

5 met so that the Task would Branch based on it. Figure A.2 - Sample Logic Flow Test Definition. Timed Branch Abort One Timed Branch Abort Two Branch Task Response Abort Abort Abort Loop Abort Continue Continue Looping Abort Expire Abort Loop Continue Abort Abort Loop Continue Continue Continue Looping Continue Expire Continue Looping Expire Abort Abort Loop Expire Continue Continue Looping Expire Expire Continue Looping Changes for Version 4.x.x: Task is added in Version 4.1.x. Added the Admin Info button. Added configuration of the Test Definition Graphing Task representation. 3

6 B - Configuration Task Name: Timed Branch Abort Version: Last Update: 26 February 2009 In QuikLook Menu: No Folder: Program Control Subfolder: Branching Subsubfolder: None Window Name: Timed Branch Abort Configuration Change Record: Change Record Known Bugs: None User Variables Added: User Variables B.1 - Setup Dialog Figure B Timed Branch Abort Task Configuration Dialog. 4

7 B.2 - Description The setup of the Timed Branch Abort Task is a simple matter. As with all Tasks a name is specified. The name should be unique for the Task and should clearly identify the type of Task. A User Self-Prompt can be set to pass a message to the execution dialog to be displayed when the Task executes. The prompt may have a User Variable appended to it. This variable might be a measurement parameter that would facilitate the decision to abort or continue. Exporting is done from this dialog only on Archive Recall. A Duration control specifies the extent of time the execution dialog will appear at each Branch Loop iteration. Changes for Version 4.1.x: The Task was added in Version 4.1.x. B.3 - Controls Name Type Default Description Task Name Text TBA-# This serves as a root identifier for this instance of the Timed Branch Abort Task. The Task will be identified with this value in the Editor and the Current Test Definition (CTD). Executed Tasks will be displayed and stored with this name with a. and an execution number appended to it. Each new instance of the Task within the Editor should have a unique Task Name assigned. 30-character limit Duration Integer 10 5 to 1000 seconds. Time, in integer seconds, that the Task will wait for user Branch Abort/Branch Continue input during execution. A progress dialog will appear for this length of time. User Self- Prompt Parameter to Append to Prompt Text "" 60-Characters maximum. A text message that is displayed on Task execution. This allows the user to program a reminder to him/herself. The message may have a User Variable appended to it. The variable might serve as a criterion for deciding whether or not to abort Branching. List Box <<None> > This box is used to select one of the registered User Parameters to append to User Self-Prompt on Task execution. Comments Text A string of up to 511 characters to be written at the user s discretion. Intended to allow a detailed description of the design decision to include the Hysteresis Task. Export Help OK Cancel Button Unpressed Disabled during normal configuration. Enabled only on Archive Recall. This button is used to configure and enable the exporting of Task information. Button Unpressed Read this Help page. Button Unpressed Close the configuration dialog. Accept the configured Task values and add the Task to the Test Definition Button Unpressed Close the configuration dialog. Do not add the Task to the list in the Editor. 5

8 C - Execution, Archive Regraph and Exporting C.1 - Execution When the Test Definition execution reaches the Timed Branch Abort Task, a dialog appears as shown in Figure C.1... Figure C Timed Branch Abort Task Execution Dialog. The execution of this Task is very similar to the Delay Task. The dialog remains visible and the Test Definition remains paused until the user acknowledges the dialog by clicking Abort Branch or Continue Branching or the programmed Task duration expires. This expiration is the feature that distinguishes this Task from the Manual Branch Abort Task and allows it to be run unsupervised. A prompt, programmed by the user, appears that may be used to key the Abort or Continue action. The prompt is a one line message that may have any single User Variable appended to it. Clicking Abort Branch will set a 6

9 flag that tells the subsequent Branch Task to discontinue Branching regardless of the status of the Branch Logic Condition. Clicking Continue Branching will clear that flag. However, the Branch may still terminate based on the results of the Branch Logic Condition comparison. C.2 - Archive Recall As with all Tasks, the Timed Branch Abort Task can be recalled from the DataSet Archive to review the Task configuration and the outcome of its execution. To recall, open the desired DataSet and its Archive. Open the appropriate Executed Test Definition (ETD) and its "Data Folder". Finally, double-click on the desired copy of the Timed Branch Abort Task. 7

10 Figure C Access the Timed Branch Abort Task in the DataSet Archive. 8

11 First the original configuration dialog appears. The controls show the values as they were configured for the Task execution. Most controls are disabled. The Export and Admin Info controls are active and may be used as described below. Help is also available. Cancel will close the dialog. Configured and Executed date/time controls appear for reference and documentation. Figure C Configuration Dialog for the Task Recalled from the DataSet Archive. C.3 Admin Info The Admin Info button shown in Figure C.2.2 has been added to all Tasks as of Version 4.2.x. The button opens one of two subdialogs. Program Tasks, such as the Automatic Branch Abort Task present the dialog of Figure C.3.1. Here, the Vision Version and compilation date along with the Task configuration and execution date and time are presented. This information is of minor value to the user. However, Measurement Tasks also present Tester Type, Tester Serial Number and Driver Version. This information can 9

12 be useful to RTI in helping the customer troubleshoot problems with Vision and/or the tester. Note that the exporting of this information has also been added to the export target applications as described below. C.4 - Exporting Figure C Admin Info Subdialog. In order to allow data to be exported from the Task when the Task is recalled from the DataSet Archive, an Export button appears on the recalled configuration dialog. This button is normally disabled, but it is enabled in Archive Regraph as in Figure C.2.2, above. Clicking the button produces the new dialog that appears below. Figure C.4.1 shows the Export configuration dialog in which the "Export Text" option is selected and the browser button enable. Figure C.4.2 shows the browser dialog that opens when the Browse for File Name button is clicked. 10

13 Figure C Export Dialog. Figure C Standard Windows File Browser Dialog. 11

14 C.5 - Controls Name Type Default Description Select List "Print" Select between the "Print", "Export Text", "Export Word" and "Export Option Box Excel" options. This control enables the Browse for File Name button for Line Spacing Left Margin Tab Spacing Browse for File Name File Name all selections except the "Print" option. Integer 100 This control appears when Select Option is set to "Print". Otherwise it is hidden. Increasing or decreasing this value will increase or decrease the vertical spacing of lines on the printed page. Experimentation will fix the value for any given printer. Integer 100 This control appears when Select Option is set to "Print". Otherwise it is hidden. Increasing or decreasing this value will increase or decrease the left start point of text on the printed page. Experimentation will fix the value for any given printer. Integer 200 This control appears when Select Option is set to "Print". Otherwise it is hidden. Increasing or decreasing this value will increase or decrease the horizontal spacing of tabbed sections of text on the printed page. Experimentation will fix the value for any given printer. Button Unpressed This control is enabled for all export options except "Print". For the remaining options, this control must be selected. The browser dialog will appear where a path and file name must be specified for the export output. Text This control is always disabled and cannot be used to specify the file name or path for Text, Word or Excel export. Once the browser is used to select a path and file name, those will be displayed in this control for review. Note that a path and file name MUST be specified for the "Text" and "Vision" export options and may be specified for "Excel" or "Word". Help Button Unpressed Open this help document for review. OK Button Unpressed Accept the configured export and close the dialog. Exporting will occur when the main data regraph dialog is closed. Cancel Button Unpressed Close the export dialog. Do not export. C.6 - Discussion Data can be exported to one of four targets: Printer - Pre-formatted text is sent to the printer when the configuration dialog is closed. Before printing a printer setup dialog will appear (Figure C.6.2), allowing printer options to be adjusted. (The appearance of the dialog will vary from user to user.) With the release of Version 4.1.x, printer text can be formatted from within Vision by adjusting the Line Spacing, Left Margin and Tab Spacing integer values (Figure C.6.1). Experimentation will show the proper settings for all exporting to the attached printer. These controls are hidden unless the printer is specified as the target. 12

15 Figure C Export Configuration Dialog - Printer Option. 13

16 Figure C Standard Windows Printer Configuration Dialog. Text File - Selecting this option enables the Browse for File Name button. Clicking this button will open a standard browser dialog in which a file name and path must be selected. If the file already exists, the output will be appended to existing text. An output file name must be specified for this export. Figure C.6.3 shows a sample of the Timed Branch Abort Task text export. The information shown in the Admin Info subdialog of Figure C.3.1 has been added to the Text Export output. 14

17 Figure C Sample Timed Branch Abort Task Text Export File. Excel - Selecting this option enables the Browse for File Name button. Clicking this button will open a standard browser dialog in which a file name and path may be selected. Specifying a file name is optional. However, if specified, a unique file name/file path must be created or an overwrite situation will occur. Data are not appended to existing files. When the recalled configuration dialog is closed, the Excel program will be started and a spread sheet created. When Excel is closed, the data will be written to the specified file name, or the user will be prompted to save if the file is not specified. Office/Excel 2000 or later must be loaded for this option. Office/Excel is not provided with the tester or Vision software. Figure C.6.4 shows a sample of the Timed Branch Abort Task Excel export. The information shown in the Admin Info subdialog of Figure C.3.1 has been added to the Excel Export output. 15

18 Figure C Sample Timed Branch Abort Task Excel Export Output. Word - Selecting this option enables the Browse for File Name button. Clicking this button will open a standard browser dialog in which a file name and path may be selected. Specifying a file name is optional. The Word program will be opened and written when the recalled configuration dialog is closed. If a new file name is specified, the document will be saved immediately. If no file name is specified, the user will be prompted to save the documents when closed. Office/Word

19 or later must be loaded for this option. Office/Word is not provided with the tester or Vision software. The information shown in the Admin Info subdialog of Figure C.3.1 has been added to the Word Export output. Figure C Sample Timed Branch Abort Task Word Export Output. 17

20 D User Variables Timed B.A.: Branch Aborted Boolean Flag indicating the operator's decision on Task execution. 18

21 E - Change Record This page specifically lists changes that are visible to the user. Often the software is changed in ways that are not directly apparent to the user. These changes may adjust the version number, in which case they are listed simply as "Internal Changes". Such changes may be indirectly evident in speed and performance improvements or the change of the Task file size. Version June Initial Task development. Set to Version SPC - 26 May Added proper enabling of CTD and ETD display of the Export and Executed controls. - SPC - 29 June Moved to the "Branching" subfolder. 2 July Added Branch and Filter Target Task icons that show the association with the Branch Task by including a blue dot at the icon lower-left corner, or a Filter Task by including a brown rectangle at the lower-right corner. 2 May Version January Set to Version for release. 24 January Removed all references to Office/Word/Excel ' January Eliminated "Excel 2000" and "Word 2000" text from export output. 13 August Version January Set to Version to reflect changes. 22 January Added debug logging calls to facilitate troubleshooting. 22 January Version February Set to Version to match Vision framework version update. 26 February Added the Admin Info Button. 28 July Added configuration of the Task's Test Definition Graphing output. 4 November Version February Set to Version to match Vision framework version update. 5 November

22 Version February Set to Version to match Vision framework version update. 11 January Version February Set to Version to match Vision framework version update. 8 June