45
MTS TestSuite™ Reporter Add-In User Guide 100-230-971 J

MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

  • Upload
    others

  • View
    2

  • Download
    0

Embed Size (px)

Citation preview

Page 1: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

MTS TestSuite™Reporter Add-In User Guide

100-230-971 J

Page 2: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

©2016MTS SystemsCorporation. All rights reserved.

MTS TrademarksMTS, be certain., Bionix, Echo, ElastomerExpress, Flat-Trac, FlexTest, Just In Case, Landmark, LevelPlus, MTS Acumen, MTS Criterion, MTS Echo, MTS EMExtend, MTS Exceed, MTS Insight, MTSLandmark, MTS TestSuite, RPC, SWIFT, Temposonics, TestWare, TestWorks are registeredtrademarks of MTS SystemsCorporation within the United States. Acumen, AdapTrac, Advantage,Aero ST, Aero-90, AeroPro, Criterion, cRPC, Exceed, First Road, Landmark, MAST, MicroProfiler,MPT, MTS Exceed, MTS Fundamentals, MTS TestSuite, ReNew, SilentFlo, TempoGuard, TestLine,Tytron, Virtual Test Lab, and VTL are trademarks of MTS SystemsCorporation within the UnitedStates. These trademarksmay be registered in other countries.

All other trademarks are the property of their respective holders.

Proprietary SoftwareSoftware use and license is governed byMTS’ End User License Agreement which defines all rightsretained byMTS and granted to the End User. All Software is proprietary, confidential, and owned byMTS SystemsCorporation and cannot be copied, reproduced, disassembled, decompiled, reverseengineered, or distributed without expresswritten consent of MTS.

Software Verification and ValidationMTS software is developed using established quality practices in accordance with the requirementsdetailed in the ISO9001 standards. BecauseMTS-authored software is delivered in binary format, it isnot user accessible. This software will not change over time. Many releases are written to be backwardscompatible, creating another form of verification. The status and validity of MTS’ operating software isalso checked during system verification and routine calibration of MTS hardware. These controlledcalibration processes compare the final test results after statistical analysis against the predictedresponse of the calibration standards.With these establishedmethods, MTS assures its customers thatMTS productsmeet MTS’ exacting quality standardswhen initially installed and will continue to performas intended over time.

Manual Part Number Publication Date Release

100-230-971 J(English)

October 2016 MTS TestSuite MP or TW 4.2 or later

100-230-971 H(English)

August 2015 MTS TestSuite MP or TW 4.1

100-230-971G(English)

October 2014 MTS TestSuite MP or 3.0

Page 3: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Manual Part Number Publication Date Release

100-230-971 F(English)

February 2014 MTS TestSuite MP 2.6.4/TW 2.3.4

100-230-971 E(English)

December 2013 MTS TestSuite MP 2.6.3/TW 2.3.3

100-230-971 D(English)

August 2013 MTS TestSuite MP 2.6/TW 2.3

Page 4: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

MTS TestSuite 4

Technical Support 8How to Get Technical Support 8Start with your manuals 8Technical support methods 8Outside the U.S. 8

Before You Contact MTS 8Know your site number and system number 8Know information from prior technical assistance 9Identify the problem 9Know relevant computer information 9Know relevant software information 9

If You Contact MTS by Phone 10Identify system type 10Be prepared to troubleshoot 10Write down relevant information 10After you call 11

Problem Submittal Form 11

Preface 12Before You Begin 12Safety first! 12Other MTSmanuals 12

Documentation Conventions 12Hazard conventions 12Other special text conventions 13Special terms 13Illustrations 13Electronicmanual conventions 13Hypertext links 13

Working With Test Reports 14Reports 15ReportsOverview 15SystemRequirements 15

Example: Test Report Template 15

Report Template Overview 16Creating report templates 16

Using report templates to generate reports 17

Contents

Page 5: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

5 MTS TestSuite

Formatting Report Templates 17Test Run Variable Table Properties 17

All Test RunsChart Properties 17

All Test Runs Variable Table Properties 23

MTS TestSuite Reporter Excel Add-In 24

Report Templates 25Open a Template 25From the Excel application 25

From anMTS TestSuite application 26

To create a new template 26

Link to the Test that will use the Report Template 26Select the Test Run or Analysis Run Used to Generate Report Previews 27Insert Single Variable Values into Report Template 27Insert Single Variable Values 27

Variable Properties 28

Insert Variable Tables 29Insert a Variable Table 29

Insert a Block Variable Table 30

Insert a Variable Array Table 30

Edit a Table 31

Insert Chart Images 32AddCharts to a Report Template 32

Insert Monitor Views 32Insert a Monitor View 32

Insert Raw Data 33Appending Data to a Single Report 33Example: Appending Raw Data 34

Use Excel Formatting to Customize the Report 36Setting the Default Table Style 36

Generate a Report 36Generating a Report Using the Excel Reporter Add-In 37Create Variables for Reports 37

Contents

Page 6: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

MTS TestSuite 6

Test data 37

Other variables 38

About Variables in Reports 38

Example: Add aMax Load Value to a Report Template 38

Example: Add a Calculated Stress Array Variable to a Report Template 39

Using a Variable for the Report Location 40

Index 42

Contents

Page 7: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E
Page 8: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Technical Support

MTS TestSuite 8

Technical SupportHow to Get Technical SupportStart with your manualsThemanuals supplied byMTS providemost of the information you need to use andmaintain yourequipment. If your equipment includes software, look for online help and README files that containadditional product information.

Technical support methodsMTS provides a full range of support services after your system is installed. If you have any questionsabout a system or product, contact Technical Support in one of the following ways.

Type ofSupport Details

Web site www.mts.com > Contact Us > In theSubject field, choose To escalate a problem;Problem Submittal Form

E-mail Worldwide: [email protected]: [email protected]

Telephone Worldwide: 1 800 328 2255 - toll free in U.S.; +1 952 937 4000 - outside U.S.Europe: +800 81002 222, International toll free in Europe

Outside the U.S.For technical support outside the United States, contact your local sales and service office. For a list ofworldwide sales and service locations and contact information, use theGlobal MTS link at theMTSweb site:

www.mts.com > About MTS Systems > Global Presence > Choose a Region

Before You Contact MTSMTS can help youmore efficiently if you have the following information available when you contact usfor support.

Know your site number and system numberThe site number contains your company number and identifies your equipment type (such asmaterialtesting or simulation). The number is typically written on a label on your equipment before the systemleavesMTS. If you do not know your MTS site number, contact your sales engineer.

Example site number: 571167

Page 9: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Technical Support

9 MTS TestSuite

When you havemore than oneMTS system, the system job number identifies your system. You canfind your job number in your order paperwork.

Example system number: US1.42460

Know information from prior technical assistanceIf you have contactedMTS about this problem before, we can recall your file based on the:

l MTS case number

l Name of the person who helped you

Identify the problemDescribe the problem and know the answers to the following questions:

l How long and how often has the problem occurred?

l Can you reproduce the problem?

l Were any hardware or software changesmade to the system before the problem started?

l What are the equipment model numbers?

l What is the controller model (if applicable)?

l What is the system configuration?

Know relevant computer informationFor a computer problem, have the following information available:

l Manufacturer’s name andmodel number

l Operating software type and service patch information

l Amount of systemmemory

l Amount of free space on the hard drive where the application resides

l Current status of hard-drive fragmentation

l Connection status to a corporate network

Know relevant software informationFor software application problems, have the following information available:

l The software application’s name, version number, build number, and (if available) softwarepatch number. This information can typically be found in the About selection in the Helpmenu.

l The names of other applications on your computer, such as:

l Anti-virus software

l Screen savers

l Keyboard enhancers

l Print spoolers

l Messaging applications

Page 10: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Technical Support

MTS TestSuite 10

If You Contact MTS by PhoneA Call Center agent registers your call before connecting you with a technical support specialist. Theagent asks you for your:

l Site number

l Email address

l Name

l Company name

l Company address

l Phone number where you can be reached

If your issue has a case number, please provide that number. A new issue will be assigned a uniquecase number.

Identify system typeTo enable the Call Center agent to connect you with themost qualified technical support specialistavailable, identify your system as one of the following types:

l Electrodynamicmaterial test system

l Electromechanical material test system

l Hydromechanical material test system

l Vehicle test system

l Vehicle component test system

l Aero test system

Be prepared to troubleshootPrepare to perform troubleshooting while on the phone:

l Call from a telephone close to the system so that you can implement suggestionsmade overthe phone.

l Have the original operating and application softwaremedia available.

l If you are not familiar with all aspects of the equipment operation, have an experienced usernearby to assist you.

Write down relevant informationIn case Technical Support must call you:

l Verify the case number.

l Record the name of the person who helped you.

l Write down any specific instructions.

Page 11: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Technical Support

11 MTS TestSuite

After you callMTS logs and tracks all calls to ensure that you receive assistance for your problem or request. If youhave questions about the status of your problem or have additional information to report, pleasecontact Technical Support again and provide your original case number.

Problem Submittal FormUse the ProblemSubmittal Form to communicate problemswith your software, hardware, manuals, orservice that are not resolved to your satisfaction through the technical support process. The formincludes check boxes that allow you to indicate the urgency of your problem and your expectation of anacceptable response time.We guarantee a timely response—your feedback is important to us.

You can access the ProblemSubmittal Form at www.mts.com > Contact Us (upper-right corner) > IntheSubject field, choose To escalate a problem; Problem Submittal Form

Page 12: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Preface

MTS TestSuite 12

PrefaceBefore You BeginSafety first!Before you use your MTS product or system, read and understand the safety information provided withyour system. Improper installation, operation, or maintenance can result in hazardous conditions thatcan cause severe personal injury or death, or damage to your equipment and specimen. Again, readand understand the safety information provided with your system before you continue. It is veryimportant that you remain aware of hazards that apply to your system.

Other MTS manualsIn addition to thismanual, youmay receive additional manuals in paper or electronic form.

Youmay also receive anMTS SystemDocumentation CD. It contains an electronic copy of themanuals that pertain to your test system.

Controller and application softwaremanuals are typically included on the software CD distribution disc(s).

Documentation ConventionsThe following paragraphs describe some of the conventions that are used in your MTSmanuals.

Hazard conventionsHazard noticesmay be embedded in thismanual. These notices contain safety information that isspecific to the activity to be performed. Hazard notices immediately precede the step or procedure thatmay lead to an associated hazard. Read all hazard notices carefully and follow all directions andrecommendations. Three different levels of hazard noticesmay appear in your manuals. Following areexamples of all three levels. (for general safety information, see the safety information provided withyour system.)

Danger: Danger notices indicate the presence of a hazard with a high level of risk which, ifignored, will result in death, severe personal injury, or substantial property damage.

Warning: Warning notices indicate the presence of a hazard with amedium level of riskwhich, if ignored, can result in death, severe personal injury, or substantial property damage.

Caution: Caution notices indicate the presence of a hazard with a low level of risk which, ifignored, could causemoderate or minor personal injury or equipment damage, or couldendanger test integrity.

Page 13: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Preface

13 MTS TestSuite

Other special text conventions

Important:

Important notices provide information about your system that is essential to its proper function.While not safety-related, if the important information is ignored, test resultsmay not be reliable,or your systemmay not operate properly.

Note:

Notes provide additional information about operating your system or highlight easilyoverlooked information.

Recommended:

Recommended notes provide a suggested way to accomplish a task based on what MTS hasfound to bemost effective.

Tip:

Tips provide helpful information or a hint about how tomost efficiently accomplish a task.

Access:

Access provides the route you should follow to a referenced item in the software.

Example: Examples show specific scenarios relating to your product and appear with a shadedbackground.

Special termsThe first occurrence of special terms is shown in italics.

IllustrationsIllustrations appear in thismanual to clarify text. They are examples only and do not necessarilyrepresent your actual system configuration, test application, or software.

Electronic manual conventionsThismanual is available as an electronic document in the Portable Document File (PDF) format. It canbe viewed on any computer that has Adobe Acrobat Reader installed.

Hypertext linksThe electronic document hasmany hypertext links displayed in a blue font. All blue words in the bodytext, along with all contents entries and index page numbers, are hypertext links. When you click ahypertext link, the application jumps to the corresponding topic.

Page 14: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

MTS TestSuite 14

Working With Test ReportsReports 15

Report Templates 25

Generate a Report 36

Page 15: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

15 MTS TestSuite

ReportsReports OverviewTheReporter Add-In is a licensed option that can be used to create report templates and generatereports for test runs or analysis runs. You can generate reports for a single test run or for a group oftest runs.

To generate a report, youmust select a report template file that defineswhat information is shown in atest report and how that information appears in the report. The report template and the resulting reportareMicrosoft Excel files.

Note:A report can be generated without Excel installed. The Reporter Add-In is required to createreport templates.

System RequirementsTo create report templates and view reports, the Reporter Add-In requiresMicrosoft Office (Excel)2007 or 2010.

Example: Test Report Template

Example of Test Report Template

Page 16: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

MTS TestSuite 16

Example of Test Report Generated From Report Template

Report Template OverviewA report template is an Excel template file that defineswhat information is shown in a test report andhow that information appears in the report. You can design report templates to generate reports for asingle test run, and when used with MTS TestSuite Software, reports for a group of test runs.Templates for both types of reports are created in the sameway.

Because the report template defines the information that appears in the report, different test types(with unique sets of variables and other information) may require their own custom report templates.Another use of report templates is to customize the type of information shown for a specific audience.

Creating report templatesReport templates are created andmodified using theMTS TestSuite Report tab that appears in theMicrosoft Excel application.When theMTS TestSuite application is installed, anMTS TestSuiteReport tab appears in theMicrosoft Excel application.

You create or edit report templates by dragging test information, in the form of charts and variables,into the area of the report template where you want it to appear. Once information is added, you canformat it by selecting the cell and using theProperties tab to further define the information.

Page 17: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

17 MTS TestSuite

Using report templates to generate reportsAfter a test is run, theMTS TestSuite application creates a test report by taking the report templateassigned to the test, populating it with the data from the test run, formatting the data, and saving thereport as a separate report file.

Formatting Report TemplatesAfter you have run your tests, you can define or change the information, characteristics, andappearance of the selected procedure activities and runtime display components that appear in yourreports.

Test Run Variable Table PropertiesThe Test Run Variable Table template allows you to select which test run results to show in yourreport from run single-value variables.

Test Run Review GraphThe Test Run Review Graph shows a graphical representation of a test run.

Test Run Results - Single-Value Variables

Item Description

Display Select one of the following:

l Value—Shows the variable value from the test run.

l Value with unit in a single cell—Combines thevariable value from the test run with the unit valuesdefined in the test into a single cell.

l Value with unit in adjacent cells—Places thevariable value from the test run into the selected cellsand places the unit into an adjacent cells.

Select Where Used Select if you want variables used in the Result, Calculation,Pretest, or During-Test included in your report.

Select Category or Categories Select which variable categories will be included in your report.

All Test Runs Chart PropertiesIn theAll Test Runs Variable Table template, select theAll Test Runs Chart field to view and edittheProperties.

Traces

Page 18: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

MTS TestSuite 18

A trace is the representation of a series of values plotted against another series of values. Dependingon the type of view, you can plot signal or variable data on either the Y axis or X axis.

If you definemore than one trace on an axis, all the tracesmust have the same dimension. Forexample, you cannot add a force signal trace and a displacement signal trace together on the Y axis.

Line and Symbol

Item Description

Opacity Adjust the opacity to better see through traceswhen they overlap. If you setthe opacity to a lower value, it makes the tracemore transparent.

Draw Line Select this check box to draw lines between data points. Clear theDrawLine check box and clickOK to only show data points if aSymbol Type isselected; otherwise, the trace is not drawn.

Line Thickness Select the thickness of the lines from 1 to 10 points.

Line Type Select the line style as solid, dotted, or dashed.

Symbol Type Select the type of symbol to mark the location of data points. If you do notwant to mark the data points with symbols, choose the blank selection in thelist.

Symbol Size Select the size of the data point symbols. To automatically size the symbols,select themultiple size image, which is the first item in the drop-downmenu.

Plot Previous Test Runs

Page 19: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

19 MTS TestSuite

You can plot multiple test runs on oneArray-Variable Chart. On theExplorer panel, clickTest-RunDisplay. After you add anArray-Variable Chart to theDesigner tab, theProperties panel displaysthePlot Previous Test Runs panel. Modify theY-Offset andX-Offset values to displace themultipletraces. Multiple test runs display only on theMonitor tab. You can still view the single test result undertheResults > Variable Chart tab.

Limit or Curve Fit Lines

To add a Limit or Curve Fit Line, click the Add a Limit or Curve Fit Line icon in the property panel titlebar.

Item Description

Color Click the drop-downmenu and select the color of the associated line.

Limit Type Select one of the following limit type:

l Horizontal

l Vertical

l Slope Intercept, m∙x + b

l General XY (Single Value or Array)

l Indexed Values

l Horizontal at Index

l Vertical at Index

For details about each limit type, including the fields you can configure whenselecting each different option, see theMTS TestSuite TW Elite UserGuide.

Y Variable Select a single-value variable or an array variable for which you want dataplotted on the Y axis of the chart.

X Variable Select a single-value variable or an array variable for which you want dataplotted on the X axis of the chart.

Legend Label Select this option to add a custom legend label to the chart. In the text box,enter the name of the legend label.

Page 20: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

MTS TestSuite 20

X-Axis and Y-Axis

Item Description

Display Unit Select a display unit for the selected trace signal. The list only shows the setof units that are compatible with the dimension of the signal that is assignedto the selected trace.

Blank is the default value.

Maximum or Min-imum

Set the display range of the Y axis to themaximumor minimum values.

Click the corresponding button to use this feature.

To have the software calculate themaximumor minimum values of the Ysignal and then set themaximumor minimumdisplay range to the values,click to clear the check boxes.

Tomanually set themaximumor minimumdisplay range for the Y axis,select the check boxes and then specify themaximumor minimum values.

Page 21: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

21 MTS TestSuite

Item Description

Mean or Amplitude Set the display range of the Y axis to the amplitude or mean values.Amplitude is a plus or minus display range. Mean is an offset, and theamplitude is relative to themean.

Click the corresponding button to use this feature.

Click to clear the check box(es) to have the application set the amplitude ormean display range to the amplitude or mean values of the X signal.

Select the check boxes and then specify the amplitude or mean values tomanually set the amplitude or mean display range for the X axis.

Expand Only Select the check box to allow a range to automatically expand if the dataexceeds themaximumandminimum ranges. The chart does not rescale toa smaller range.

When the range expands during auto-scaling, theExpand Only optionprevents the range from contracting with the command stops.

Specifying theMaximum andMinimum for an axis avoids auto-scaling;however, also selectingExpand Only implies that you want to auto-scale ifthe data is outside the specified range.

Log Scale Toggle between linear scale and log scale for the axis. Select the check boxfor logarithmic scale. Leave the box blank for linear scale.

X-Axis and Y-Axis Advanced Properties

Item Description

Log Base Set the base for displaying values in a logarithmic format. Click the up ordown arrows to raise or lower the base.

Label Digits Set the number of significant digits displayed in the labels along the X axisand Y axis. Only non-zero digits are shown after the decimal point to avoidovercrowding in the label area next to the axis.

Color Set the color of the associated trace or axis. Click the down arrow andselect a color from the list.

Draw Grid Lines Select the check box to show grid lines on the chart. Clear the check box tosuppress the grid lines.

Page 22: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

MTS TestSuite 22

Point Pick

Item Description

Show highlightcircle

Select to show a crosshair, circle, and data point value when selecting adata point in the chart.

Show delta andslope Labels

Select to show the values of two points, the difference between their values,and the slope of a line drawn through the two points.

Number of rows Enter the number of rows used to arrange the labels, delta, and slope. Clickthe up or down arrows to increase or decrease the number of rows. Thevalue range is 1-6.

Chart Titles and LegendClick the Titles and Legends button to open the Chart Titles and Legend window where you canconfigure the details of your display and legend, such as color, font size, location in the window, andborder details.

Page 23: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

23 MTS TestSuite

All Test Runs Variable Table PropertiesTheAll Test Runs Variable Table template allows you to select which results to show in your reportfrom a test and test runs.

Page 24: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

MTS TestSuite 24

Item Description

Maximum Column Count Use the combo box to set themaximumnumber of columns thatwill show in the report.

Test Run Results The Test Runs Results section in theProperties panel allowyou to select if tagged test runs (not included), statistics, or com-ments will be included in your report.

Select All Variables TheSelect All Variables section allows you select if you wantResult, Pretest, orDuring-Test variables included in your report.

Select Category or Cat-egories

TheSelect Category or Categories section allows you to selectwhich variable categories will be included in your report.

MTS TestSuite Reporter Excel Add-InTheMTS TestSuite Report ribbon contains all the controls required to create report templates andgenerate reports that include test-run data.

Report Ribbon

Number Function Description

1 Link Link to an existing test to provide access to variables, and preconfiguredmonitor views and other charts and tables that you can add to the reporttemplate.

2 Insert Insert and configure variables, charts, andmonitor views.

3 Generate Generate a report to preview changesmade to a report template, by selectingan analysis run or test run and clickingReport.

Note: To access online help for theMTS Reporter Add-In, click thehelp button in the ribbon.

Report Ribbon Functions

Page 25: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

25 MTS TestSuite

Report TemplatesCreating a report template is an iterative process that follows this basic outline:

1. To begin, open an existing template file or create a new one and link it to a test.

Important:MTS-supplied templates often have preconfigured data acquisition activities andvariables that save data for use in various charts/tables that appear in the test, reporttemplates, and post-test analysis. If you are creating your own tests, youmust createdata acquisition activities and variables to save the data.

2. Use the controls on theMTS TestSuite Report ribbon to perform a task, such as inserting avariable table or inserting a chart image.

Template cells that contain inserted variable values, tables, or charts are indicated by a lightblue color.

3. Select a source and click theReport button to generate a report based on an actual test run oranalysis run.

Important:TheReporter Add-In does not support Excel’s Undo command so you are given theyes/no choice of saving the template when you generate a report.

4. View the report to preview the template changes and correct any errors.

5. Iterate until the report template is complete.

For detailed information on how to create report templates, see the following tasks:

“Open a Template” on page 25

“Link to the Test that will use the Report Template” on page 26

“Select the Test Run or Analysis Run Used to Generate Report Previews” on page 27

“Insert Single Variable Values” on page 27

“Insert a Variable Table” on page 29

“Insert Chart Images” on page 32

“Insert Monitor Views” on page 32

“Insert Raw Data” on page 33

“Use Excel Formatting to Customize the Report” on page 36

Open a TemplateWhen creating a report template, you can either open an existing template or start with a new (blank)template.

From the Excel applicationIf you launch Excel as a stand-alone application, use this procedure to open a template.

Page 26: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

MTS TestSuite 26

1. Start the Excel application.

2. From theOffice button, open an existing template file.3. Optional: Save the template file (as an Excel Template) with a different name if you are

creating a new report template from an existing template.

From an MTS TestSuite applicationTo open a template from anMTS TestSuite application:

1. In theMTS TestSuite test application, open a test.

2. Click theReport Templates tab.3. Open a template.

To edit and save an existing template:

A. In the template list, select an existing template and click theEdit icon.B. The Excel application starts automatically and opens the template. The test is

automatically linked to the template.

To create a new templateTo create a new template:

1. On the Report Templates toolbar, click theNew icon.

2. Type a name for the new template and clickOK. The new template is added to the templatelist.

3. In the template list, select the new template and click theEdit icon.4. The Excel application starts automatically and opens the template. The test is automatically

linked to the template.

Link to the Test that will use the Report TemplateReport templates are typically created for specific tests that use unique sets of variables and otherinformation.When a test is linked, the Excel Add-In parses the selected test file to determine thevariables andmonitor views used in the test.

Important:Only the variables andmonitor views that are available in the test can be added to the reporttemplate.

From the Excel application

If you launch Excel as a stand-alone application, use the following procedure to open a test:

1. At the top of the Excel window, click theMTS TestSuite Report tab.2. In the Link area of theMTS TestSuite Report ribbon, click Test and select the test or analysis

definition that you want to use to build the report template.

Page 27: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

27 MTS TestSuite

Note:You can also link to an Analysis Definition when using the Reporter Add-In with MTSTestSuite Multipurpose Software and an Analyzer application. Once a definitions file isselected, the charts and variables defined in the file are available for use in a template.

From anMTS TestSuite application

If you open a test in anMTS TestSuite application and use that application to open an existing templateor create a new template, the test selection is automatically linked to the template.

Select the Test Run or Analysis Run Used to Generate Report PreviewsBefore you can generate a report, youmust define the test run or analysis run that the template will useto generate reports. The test run that you select should be representative of the types of tests that willuse the report template.

Each time you clickReport, the Reporter Add-In will use data from the test run to populate the variouscharts and tables that are in your template. This allows you to preview the template changes andcorrect any errors.

1. On theMTS TestSuite Report ribbon, clickSource.2. From the list, click the test run or analysis run that you want to use to generate reports.

Note:Analysis runs are only available when using the Reporter Add-In with MTS TestSuiteMultipurpose Software in conjunction with an Analyzer application.

Insert Single Variable Values into Report TemplateClick theSingle Variable Value button to show a Variables panel that lists all the variables andvariable categories that appear in the test that is linked to the template.

To add single variables to the report template, click-and-drag the desired variable (or an entire variablecategory) from theVariables list to the desired location in the template.

Once a variable is added, you can format it by selecting the cell and using theProperties tab to furtherdefine what appears in the cell.

Note:Only variables that are used in the test or analysis definition that you linked the template to willappear in the Variables panel.

Insert Single Variable ValuesTo insert a single variable value:

1. Open a report template that you want to edit, or open a new template.

2. Click theMTS TestSuite Report tab in the Excel ribbon.3. ClickSingle Variable Value.4. From theVariables panel, drag a single variable or an entire category of variables to an Excel

cell location.

Page 28: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

MTS TestSuite 28

If you add a variable category, each variable in that category will occupy a separate cell fillingdown from the current cell location.

5. Define theDisplay properties for the variable.A. Select the variable cell.

B. On theProperties tab, define what appears in the cell(s) when the report isgenerated.

6. Define theUnit Name properties for the variable (if applicable).On theProperties tab’sUnit Name list, select the unit that will appear in the cell(s) when thereport is generated.

7. To preview the changesmade to the template, clickReport, and check for any errors.

Variable Properties

Property Value

Description Shows the variable description defined in the test.

Display Name Shows the variable name defined in the test.

Display name, value withunit in adjacent cells

Places the display name, value, and unit in separate cells.

Unit Shows the unit name defined in the report variableProperties tab.

Value Shows the variable value from the test run.

Value with unit in a singlecell

Combines the variable value from the test run with the unit valuesdefined in the test into a single cell.

Value with unit in adjacentcells

Places the variable value from the test run into the selected cell(s)and places the unit into an adjacent cell(s).

Note:Only variable values that appear in a separate cell can be used in Excel calculations.

ExamplesTo create three separate cells that show the Specimen Thickness variable’s display name, value, andunits:

1. DragSpecimen Thickness from the Reports Variables window to a cell. On thePropertiestab, selectDisplay Name from theDisplay list.

2. Drag the same variable (Specimen Thickness) to a second adjacent cell. On thePropertiestab, use the defaultValue with unit in adjacent cells display setting. This places thevariable value in the second cell and automatically places the variable unit in the adjacent cell.

If the specimen had a thickness of 44mm in the test run data, the report that is generated willhave specimen thickness shown in the first cell, 44 shown in the second cell, andmm shown inthe third cell.

Page 29: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

29 MTS TestSuite

Specimen Thickness 44 mm

To show the same information using two cells:

Set the second cell’sDisplay property toValue with unit in a single cell. This combines thevalue with the unit in a single cell. The same information is shown using two cells.

Specimen Thickness 44mm

Insert Variable TablesTheVariable Tables control allows you to insert the following types of variable tables into the reporttemplate:

Variable Table—includes single-value variables and variable groups in a table format.

Block Table—includes user-selected single-value variables with the ability to use the data acquisitionblocking defined in the test and a block decimation filter to further refine the data that appears in thetable.

Array Table—includes user-selected array variables. A blocking option allows you to show arrayvalue for a single block of data.

Insert a Variable TableTo insert a variable table:

1. Select the cell where you want the table to appear in the generated report.

Note:When a report is generated, the rows required for the table are automatically insertedand any variables below the table are shifted down.

2. In theMTS TestSuite Report ribbon, clickVariable Table and then clickVariable.3. In the Title box, type the title that you want to appear in the report template.4. Optional: select the Test View option.

l Select the Test View check box to show all test variables in the report and recalculateall variables in the common category.

l Clear the Test View check box to show all variables for each test run in the report.

5. Use the following settings to define the variables that will appear in the variable table.

Select All Variables—these check boxes are variable property settings that were defined inthe test. Selecting these check boxes creates an AND function.

For example, if you select theResult andCalculation check boxes, only the variables thathave theResult AND theCalculation check box selected will appear in the table.Select Category or Categories—the category selections determine the type of variablesthat appear in the variable table. If none of the check boxes are selected, the table will containall of the categories. Selecting any of these check boxes creates anOR function.

Page 30: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

MTS TestSuite 30

For example, if you select both theCommon andSpecimen category check boxes, variablesthat are part of theCommon categoryOR theSpecimen category are available to appear inthe table.

Insert a Block Variable TableTo insert a block variable table:

1. Select the cell where you want the table to appear.

Note:When a report is generated, the rows required for the table are automatically insertedand any variables below the table are shifted down.

2. In theMTS TestSuite Report ribbon, clickVariable Table and then clickBlock.3. In the Title box, type the title that you want to appear in the report template.4. From theDisplay list, select the way each variable appears in the table.

This setting applies to all of the cells in the table.

Note:Only variable values that appear in a cell formatted with theValue setting can be usedin Excel calculations.

5. Configure the block settings:

TheName list contains all the blocks that were defined in the test’s data acquisition activities.ClickSelect Blocks to set up a BlockDecimation Filter to further filter the variables thatappear in the table.

6. Use theVariable list to select the variable types that will appear in the table.For more information on setting up the BlockDecimation Filter, see the Data Acquisitionchapter in the User Guide for your test application.

Insert a Variable Array TableEach variable that you add to the table appears as a column heading in the generated report. Each rowin the table represents the indexwhere data was collected.

1. Select the cell where you want the table to appear in the generated report.

Note:When a report is generated, the rows required for the table are automatically insertedand any variables below the table are shifted down.

2. In theMTS TestSuite Report ribbon, clickVariable Table and then clickArray.3. In the Title box, type the title that you want to appear in the report template.4. From theDisplay list, select the way each variable appears in the table.

This setting applies to all of the cells in the table.

Page 31: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

31 MTS TestSuite

Note:Only variable values that appear in a cell formatted with theValue setting can be usedin Excel calculations.

5. Optional: select theShow Index Column check box to add an index column to the generatedreport.

6. Optional: if the test’s data acquisition included blocking, you can use the Blocking settings tofurther define what appears in a report.

Blocking (Optional)In theName list, select the type of block that you want to define. For cyclic tests, this is typicallythe CycleCount block.

In theNumber text box, enter the block number (or variable) for the data that you want toshow in the report. When a report is generated, the values of the selected variables for theblock number that you enter appear in the report.

Note:You can use theNumeric-Variable button to toggle this direct numeric entry or avariable that represents a block in the test.

7. Add variables to the table.

A. In the Array Variables window, click theAdd a new item (+) icon.

B. In theAvailable Variables list, select the array variables that you want to appear inthe table and use the arrow controls to move them to Selected Variables.

Note:Only array variables appear in the list.

If desired, select a variable in theSelected Variables list and use the up and downarrows to rearrange the order that they appear in the table.

C. ClickOK.

8. In the Insert Table window, clickOK.9. ClickReport, check for any errors, and preview the resulting report.

Edit a Table

1. If theProperties tab is not shown, in theEdit area of theMTS TestSuite Report ribbon, selectthe cell that you want to edit and clickProperties.

2. Click the cell where the Table label appears.

3. Edit the table properties as required.

4. ClickReport, check for any errors, and preview the resulting report.

For more information on creating tables and table properties, see the documentation providedwith theMTS TestSuite test application.

Page 32: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

MTS TestSuite 32

Insert Chart ImagesTheChart Images button allows you to insert a number of chart types into your report. Each chart(except monitor views) includes a set of properties that you can use to define the variables used in thechart and to customize the appearance of the chart. When you generate a report, data from a test runor analysis is shown in the chart.

Important:MTS-supplied templates often have preconfigured data acquisition activities and variables thatsave data for use in various charts/tables that appear in the test, report templates, and post-testanalysis. If you are creating your own tests, youmust create data acquisition activities andvariables to save the data.

Add Charts to a Report TemplateTo add a chart to a report template:

1. Select a cell in the area where you want the chart to appear.

2. On theMTS TestSuite Report tab, clickChart Images, and then click the chart type that youwant to insert.

3. Define the chart area by dragging themouse across an area of cells in the worksheet, andthen clickOK in the Define Chart Area window.

4. On theProperties tab to the right, specify the properties for the type of data you want shownin the chart.

5. ClickReport, check for any errors, and preview the resulting report.

For more information on creating charts and chart properties, see the documentation providedwith theMTS TestSuite test application.

Insert Monitor ViewsThis option allows you to add amonitor view, such as a chart or table, from a test to a report template.When a report is generated using the report template, themonitor view appears in the report as anuneditable graphic image that includes data from the test run.

Important:To change the appearance of the image, youmust edit themonitor view properties in the test.

Insert a Monitor ViewTo insert a monitor view:

1. Select a cell in the area where you want themonitor view to appear.

2. On theMTS TestSuite Report ribbon, clickMonitor Views, and then click themonitor viewtype that you want to insert.

Note:Only themonitor views defined in the test appear in the list.

3. Define the chart area by dragging themouse across an area of cells in the worksheet, andthen clickOK in the Define Chart Area window.

Page 33: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

33 MTS TestSuite

4. ClickReport, check for any errors, and preview the resulting report.

For more information on creatingmonitor views, see the documentation provided with theMTS TestSuite test application.

Insert Raw DataAdding raw data to a report is a convenient way to insert test data into an Excel file.

1. Select the cell where you want the raw data to appear in the generated report.

2. On theMTS TestSuite Report ribbon, clickRaw Data.3. Use the Insert Raw Data window to select and configure the data that you want to show in the

report.

A. In the Data Acquisition box, select the data acquisition activity that includes the rawdata that you want to add to the report.

B. Optional: if the selected data acquisition activity includes block information, use theBlock settings to further define what raw data is inserted into the report.

C. In theSignal list, click theAdd a new item (+) icon to add the signal data that youwant to insert.

Use theSelect Signals list to select the variables that you want to appear in thetable.

To rearrange the order that the signals appear in the report, select a signal in theSelect Signals list and use the up and down arrows to change the order.

Appending Data to a Single ReportIn many cases, each time you generate an Excel report, a new report file is generated.While thisensures that the data from each test run is kept in a separate file, youmay end up with a large amountof individual files if you are runningmultiple test runs.

Using theWrite Options on theReport Templates tab, you can write report results to a single Excelfile. You can append test run data to either a single Excel worksheet, or you can append new test rundata as a new Excel worksheet for each test run. After appending data frommultiple test runs into asingle report file, you can take advantage of statistical analysis tools available in Excel.

1. Navigate to theReport Templates tab.2. Select an existing report template or create a new report template that contains the data that

you want appended to the report file for each test run.

3. InWrite Options, select either:l Append to Existing Worksheet—Appends the data in each new report into aseparate worksheet in the Excel file.

l Add a NewWorksheet—Adds a new worksheet to the Excel file each time thereport is generated.

Page 34: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

MTS TestSuite 34

Note:When selecting this option, keep inmind that each time the report is generated, aduplicate of all existing worksheets in the Excel file will be created in the report file.While this can be helpful if your report containsmultiple worksheets, it is important todelete the default Excel worksheets named Sheet2 and Sheet3 if you are only usingone worksheet. If you do not delete these extra empty worksheets, theywill be copiedinto the Excel file every time a report is generated. This can add clutter to yourappended report.

4. InReport Location, enter the full path to the location of the report including the name of thereport and the file extension. If the report name does not exist, a new report with the name youspecify here will be created. For example, if you enterC:\Users\YourName\Desktop\AppendedReport.xlsx, a new Excel file namedAppendedReport.xlsx will be created and saved to your desktop.

5. At the end of the test procedure (or in the Finish section), add aRun Report activity.6. In theReport Template section of the new Run Report activity, select the name of the report

template in theName drop-down list.7. Save themodified test. When theRun Report activity is encountered during each test run,

the results will be appended to the single Excel file.

Example: Appending Raw DataYou can append raw data frommultiple test runs into a single test report. This allows you toconsolidate your raw data information into one location and to take advantage of the statistical analysistools available in Excel. The following example walks you through setting up a very basic test reportand adding the report template to your test.

1. Add a default test run report template to the test.

A. On theReport Templates tab, click the + sign.B. Select theDefault Test Run Report.C. ClickOpen. The template now appears on theReport Templates tab with the

Template Name "<Report Templates>\Default Test Report.xltx."

2. Modify the default test run report template to include raw data.

A. Double-click <Report Templates>\Default Test Report.xltx to open the reporteditor.

B. Delete the Test Run Review Graph, Test Run Results, or any other objects in thereport template. When you are finished, only the header information should beremaining.

C. Delete theSheet2 andSheet3 tabs at the bottom of the spreadsheet. These tabswillnot be used.

D. Click theMTS Test Suite Report tab, which is located above the Excel ribbon.E. Select a row under the header information in the spreadsheet.

F. ClickRaw Data, which is located in the Excel ribbon.

Page 35: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

35 MTS TestSuite

G. On the left side of theData Acquisition field, click the… button.

H. Select a data acquisition activity, such asDAQ: Crosshead, …I. ClickOK.J. In theSignal List, click the + icon. The Select Signals window appears.

K. Move a few signals to the list of selected variables on the right side of the window,such as _Load and _Time.

L. ClickOK to close the Select Signals window.

M. ClickOK to close the Insert Raw Data window. At this point, your template shouldlook like the following:

N. In Excel, clickFile > Save As.O. Rename the report template to "Default Report with Raw Data."

P. Close Excel.

3. Add themodified report template to the test.

A. On theReport Templates tab, click the plus sign icon.

Note:If you are using TWE, click the icon located in the Test Run area—not the Testarea.

B. Select the Default Report with Raw Data.xltx template and clickOpen. The reporttemplate now appears on theReport Templates tab as <ReportTemplates>/Default Report with Raw Data.xltx.

Now that you have created the appended raw data report template and added it to your test, you canfollow the steps described in “Appending Data to a Single Report” on page 33 to incorporate this reporttemplate into your test procedure.When you successfully run the test, you will receive a reportcontaining raw data appended from each test run into a single Excel file.

Page 36: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

MTS TestSuite 36

Use Excel Formatting to Customize the ReportYou can applymany of the Excel formatting options to the report template to customize theappearance of the generated report. These options include, but are not limited to:

l Character formatting

l Footers/headers

l Borders

l Table styles

l Imported graphics (such as company logos)

l Landscape/portrait

l Cell shading

l Margins

Excel calculations

Excel calculations that use data from the test report cannot be entered in a report template. These typeof calculationsmust be added after the report is generated.

Setting the Default Table StyleAll tables within a report rely on a table style to determine the appearance of the cells within the table.You can use Excel to change this default table or to create a new custom table style.

1. Select an empty cell in the report template.

2. Click theHome tab.3. ClickFormat as Table.4. Right-click the desired table style from the list of available table styles.

Note:To create a new table, style, clickNew Table Style.

5. ClickSet As Default.

Generate a ReportVariousMTS TestSuite applications providemultiple methods to generate reports. These includeusing:

l Reporter Excel Add-In (for details, see “Generating a Report Using the Excel Reporter Add-In” on page 37)

l Fatigue and Fracture Analyzer applications (for details, see theMTS Fatigue Analyzer UserGuide orMTS Fracture Analyzer User Guide)

l MTS TestSuite application (for details, see your application operator guide or user guide)

l MTS TestSuiteRun Report activity, which you add to your test procedure to automatically

Page 37: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

37 MTS TestSuite

generate a report at the end of the procedure (for more information, see your application userguide)

Generating a Report Using the Excel Reporter Add-InNote:To generate a report using the Excel Reporter Add-In, youmust have purchased a separatelicense for the Reporter Add-In product. It also requires the installation of Microsoft Excelsoftware or another suitableMicrosoft Excel reader.

1. Open a report template in Excel (MTS templates are located in C:\MTS TestSuite\ReportTemplates).

2. Click theMTS TestSuite Report tab in the ribbon.3. Click the Test icon in the ribbon and open the test that contains the test run that requires a

report.

4. In theGenerate section of the ribbon, clickSource and select the test, test run, or analysis runthat you want to use to create a report.

5. Click the Report icon on the ribbon.

6. The systemwill launch another instance of Microsoft Excel and show the newly generatedreport file.

Create Variables for ReportsMost information that you want to include in a report must be saved in a variable. Some variables areautomatically created andmapped by the application and othersmust be created by the user.

Note:MTS-supplied templates include preconfigured data acquisition activities and variables that savedata for use in various charts/tables that appear in the test, report templates, and post-testanalysis. If you are creating your own tests, youmust create data acquisition activities andvariables to save the data.

Test dataIf you are creating your own tests and want to include test data in reports, youmust create dataacquisition (DAQ) activities to collect the data and create variables where the DAQactivity will save thedata.

l In some instances, this could be as simple as configuring a data acquisition activity toautomaticallymap signals to variables (a process that automatically creates the variablesrequired to store the data).

l In other instances, youmay have to create data acquisition activities that store signal data inarray variables, and then create an array variable that performs calculations on the signal dataand stores the result. For example, a stress array variable could include a stress calculationthat uses data from a load array variable.

In either case, if you want to show test data in a report, your test must include a data acquisition activitythat will collect the data and save it to a variable.

Page 38: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

MTS TestSuite 38

Other variablesIn addition to test data variables, your reports can include other single-variable values that are notassociated with data acquisition. For example, specimen variables include geometry type, diameter,and area. System variables includeMTS Customer Name, MTS Site Number, MTS SystemNumber,Project Name, Test Name, and User Name.

About Variables in ReportsMost information that you want to include in a report must be saved in a variable. Some variables areautomatically created andmapped by the application and othersmust be created by the user.

Note:MTS-supplied templates include preconfigured data acquisition activities and variables that savedata for use in various charts/tables that appear in the test, report templates, and post-testanalysis. If you are creating your own tests, youmust create data acquisition activities andvariables to save the data.

Test dataIf you are creating your own tests and want to include test data in reports, youmust create dataacquisition (DAQ) activities to collect the data and create variables where the DAQactivity will save thedata.

l In some instances, this could be as simple as configuring a data acquisition activity toautomaticallymap signals to variables (a process that automatically creates the variablesrequired to store the data).

l In other instances, youmay have to create data acquisition activities that store signal data inarray variables, and then create an array variable that performs calculations on the signal dataand stores the result. For example, a stress array variable could include a stress calculationthat uses data from a load array variable.

In either case, if you want to show test data in a report, your test must include a data acquisition activitythat will collect the data and save it to a variable.

For information about including other single-variable values that are not associated with dataacquisition in your reports, see “Create Variables for Reports” on page 37 .

Example: Add a Max Load Value to a Report TemplateTo include amax load value in a report, the datamust be stored in a variable that will appear in theReporter Add-InSingle Variable Values list.

Note:Signal and variable names used in the following examplemay vary depending on the type ofMTS test software that is used.

1. If necessary, add theMax/Min DAQ activity in parallel with the command activity where youwant to acquire data.

Page 39: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

39 MTS TestSuite

2. Configure theMax/Min DAQ activity:

A. Add the Load signal to the signal list.B. On theReference Signal list, clickLoad.C. Select theMaximum Values check box.D. On theSave data to variables? list, clickYes, automatically map variables.

TheMaximumLoad calculation value (derived from the Load signal in theMax/MinDAQ activity) is automaticallymapped to the _LoadMaximum variable.

Note:The automaticmapping process creates the _LoadMaximum variable.

3. ClickConfigure to verify that theMaximumLoad Signal was automaticallymapped to the _LoadMaximum variable.

4. When a report template is linked to the test, the _LoadMaximum variable will appear in theSingle Variable Values list (under the Variables category). This allows you to add thatvariable to the template.

Example: Add a Calculated Stress Array Variable to a Report TemplateTo include calculated stress data in a report, the load data used to calculate stressmust be acquiredusing a data acquisition activity and stored in an array variable.

In addition, a new stress array variable (that includes the stress calculation) must be created and thedata acquisition activitymust list the stress array variable in theAdditional Variables to Calculatelist.

Note:SomeMTS-supplied templates are preconfigured to include stress array variables and the dataacquisition settings described below.

1. If necessary, add aDAQ activity in parallel with the command activity where you want toacquire data.

2. Select theDAQ activity and configure the DAQproperties:

Note:Signal and variable names used in the following examplemay vary depending on thetype of test software that is used.

A. Select the triggers that you want to use.

B. Add the Load (force) signal to the signal list.C. Add additional signals as required.

3. On theSave data to variables? list, clickYes, automatically map variables.The application automatically creates a new LoadArray variable andmaps it to the Loadsignal.

Page 40: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

MTS TestSuite 40

4. Create aStressArray variable.A. Display theVariables tab.B. Click theAdd new variable icon.C. In the New Variable window, typeStressArray.

5. Configure the properties for theStressArray variable:A. In the Type list, clickArray of Numbers.B. In theDimension list, clickStress.C. Select the Is Calculated check box.D. Click the [...] button to show the Calculation Editor window.

In the Functions area, double-click theStress function.In the Stress calculation, replace the forceArray text with the LoadArray variableand replace the specimenArea text with theArea variable.

6. Configure the data acquisition activity to run the StressArray calculation as load data isacquired.

A. Display the test procedure and select the data acquisition activity.

B. On theSave data to variables? list, clickYes, manually map variables.C. In the data acquisition properties, clickConfigure.D. In theAdditional Variables to Calculate area:

SelectSignal Dependent Variables.Use the arrow buttons tomove theStressArray variable to theAdditional VariableCalculations side of the window.This ensures that the stress calculation is performed and saved in the stress array asnew values of the Load signal are added to the LoadArray.

Using a Variable for the Report LocationInstead of defining a specific report location in which a report will be saved, you can use a variable tostore the report location. By using a variable to store the report location, you can allow test operators todefine where the test report will be saved as a step when they are running the test.

1. Create a new variable for the report location:

A. Select theVariables sub-tab of theDefine tab.B. Click the plus sign to add a new variable. The New Variable window appears.

C. Enter the nameReportLocation as the variable identifier.

D. ClickOK. The variable is added to the list of variables on theVariables sub-tab.

Page 41: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Working With Test Reports

41 MTS TestSuite

2. Configure the properties of the new ReportLocation variable as follows:

A. Set the variable Type to Text.B. Set theDefault Value to an appropriate default location in which the report will be

saved. For example, if you enter "C:\Users\[YourName]\Desktop\MyAppendedReport.xlsx", a new Excel file namedMyAppendedReport.xlsx will be created and saved to your desktop.

C. Set theDefault Option toUse Previous Test Run Value.D. In theAvailability section, selectPretest.

3. Configure the Test Run to use the ReportLocation variable as the report location:

A. Select theReport Templates tab.B. Select the desired report template.

C. Select the cell for the report template under the Report Location column.

D. Click the small Toggle icon that appears on the left side of theReport Location textfield. This changes the report location to a variable selection and changes the cell to adrop-down list.

E. Expand the drop-down selection and select the ReportLocation variable.

4. At the end of the test procedure (or in the Finish section), add aRun Report activity.5. In theReport Template section of the new Run Report activity, select the name of the report

template in theName drop-down list.

Note:TheReportLocation variable will be identified in the name of the report template. Forexample, if you are using a default test template, the template namewill appear as thefollowing:

<Report Templates>\Default Test Run Report.xltx (Excel Workbook),"ReportLocation"

6. Add a new Input Variables activity that immediately precedes theRun Report activity.7. Create a customMessage for the Input Variables activity. For example, the text "Enter the

location in which the report will be saved" would be appropriate.

8. In theVariable list, click the plus sign icon. The Variables Selection window appears.

9. Move the ReportLocation variable to the list of selected variables on the right side of thewindow.

10. ClickOK. When the test is run, the test operator will be prompted to enter a custom reportlocation.

Page 42: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

MTS TestSuite 42

Index

_

_LoadMaximum 39

A

add-in ribbon 16add a new worksheet 33add array variable tables to the report

template 29, 32add specimens to report 32analysis run 27appear in list 31append to existing worksheet 33appending data 33appending raw data 34array variable table 29array variables

adding to a report 29assign test report template 26available views 26

B

blocking settings 31

C

chartsadd to report template 32

charts and variables 27conventions 12create 25creating report templates 16customize 38customize report template 27, 36customize saved report location 40

D

design reports 16

E

edit 26, 36

edit report template 16, 31examples 29Excel reports 16

F

formproblem submittal 11

G

generate 17, 25, 29-30test report 15, 37

generate without Excel 15gernerate 37-38

I

insert raw data 33insert rows 29-30insert single variable value 27insert table 29insert values 30

M

manuals 8Microsoft Excel

customize report template 36generate report 37MTS TestSuite report add-in 24

monitor views 32MPE reports 24

N

names 38-39no Undo command 25

P

preconfigured variables and settings 39preview report 27preview template changes 27

R

report add-in 24report location 34

Page 43: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

Index

43 MTS TestSuite

report template 25-27, 29, 31-32, 36-39add runtime controls 32create 25open 25

report template tables 29report templates 32report variable properties 28Reporter Add-In 25, 27reports 15, 17, 25, 29-31

add specimens 32create templates 25design 16edit template 16generate 15generate in Microsoft Excel 37overview 15preview 27template 16

runtime ontrolsreport template 32

S

sample test report 15save data 25, 32, 37-38select 26select template

Excel 26TestSuite 26

select test report template 26support

phone 10technical 8

system requirements 15

T

tables 31technical support 8template

analysis run 27create 25edit table 31Excel and TestSuite 25insert single variable value 27insert table 29open 25

report 16test run 27

templates 26create 25

test reportsample 15

test report template 26test reports 15, 37-38test run

generate report in Microsoft Excel 37

U

use in Excel calculations 28, 30-31

V

variables 27-31, 38-39

Page 44: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E
Page 45: MTS TestSuite™ Reporter Add-In User Guide Quarantine DO NOT OPEN...ManualPartNumberPublicationDateRelease 100-230-971F (English) February2014 MTSTestSuiteMP2.6.4/TW2.3.4 100-230-971E

MTS Systems Corporation14000 Technology DriveEden Prairie, MN 55344-2290 USAEmail: [email protected]

ISO 9001 Certified Quality Management System