10.3 Exporting and Importing Assessments, Scripts, and Definitions

You can distribute assessments, assessment configurations, and call scripts by exporting and then importing them into different Vivinet Assessor Consoles or into different assessments. You can export and import the following:

Export Option

Description

Complete Assessment

An entire assessment, including any results or errors logged.

Assessment Definition

An assessment, excluding results or errors.

Script

A script, including any optional parameters selected.

NOTE:

  • If an assessment or script you import is marked as read-only, the SQL database system will cause the import operation to fail. Therefore, if you plan to distribute assessments or call scripts on a CD, you must first copy them to a local drive and change their properties to make them writable before you try to import them.

  • Ensure the directory to which you are exporting the assessment or script allows the System account to have write access. Otherwise, you will receive an error message. The SQL server service, which runs under the System account, must be able to write the exported file to the target directory.

For more information, see the following topics:

10.3.1 Working with Assessments

Suppose you want to use an existing assessment as a template for future assessments. You export an assessment definition, transfer the file to another computer if desired, and then import it, into another copy of Vivinet Assessor, for example. You can also use the following procedure to export an entire assessment.

To export an assessment or an assessment definition:

  1. Open the assessment you want to export and make sure it is not running or verifying. The assessment cannot be active during the export.

  2. On the File menu, click Export and then click Complete Assessment or Assessment Definition.

  3. In the Save As dialog box, supply the name you want to assign to the exported file.

  4. Browse to the location where Vivinet Assessor will save the exported file.

  5. Click OK.

After the export is complete, you can move, or import, the exported file anywhere you like, including to another computer. The exported file has the extension .AEF.

Vivinet Assessor does not allow you to overwrite an existing assessment if that assessment is active. When you import an assessment definition, the status of the assessment will be changed back to “Ready to verify” if the status was “Completed,” “Running,” “Stopped,” or “Stopped with Errors.” Any results are lost.

Before you can import an .aef file, the Group or user names field on the Security tab for the file must contain permission for Network Service. You need to give this permission for each .AEF file individually, even if the file is located in a directory that already has permission given to Network Service.

To set up Network Service permissions and import an .aef file:

  1. Right-click the assessment and select Properties.

  2. On the Security tab, click Add.

  3. In the Object Name field, type Network Service.

  4. Click OK.

  5. Click OK and continue with your import.

  6. On the File menu, click Import.

  7. In the Look in field, enter the location where you saved the exported assessment definition, or click Browse to find the exported file.

  8. In the Import as assessment name field, supply a name for the imported file. Or choose the name of an existing assessment from the list.

  9. Click OK.

  10. If you import a file with the name of an existing assessment, you are asked whether you want to overwrite the existing assessment. Click Yes.

10.3.2 Working with Call Scripts and Definitions

Vivinet Assessor exports all the call scripts and QoS definitions in the source assessment. You cannot overwrite only a selected script or definition in the destination assessment when you import the scripts or definitions you exported.

To export call scripts or QoS definitions:

  1. Open the assessment that uses the call scripts or QoS definitions you want to export.

  2. On the Options menu, click Call Scripts or Options, and then select Export.

  3. In the Save As dialog box, supply the name you want to assign to the script or definition file once it is exported.

  4. Browse to the location where Vivinet Assessor will save the exported file.

  5. Click OK.

When the export operation is complete, you can move the exported file anywhere you want. However, bear in mind that it can only be imported from a local, fixed drive.

To import call scripts or QoS definitions:

  1. From the assessment into which you want to import the scripts or definitions, click Call Scripts or QoS Definitions on the Options menu, and then select Import.

  2. In the Import dialog box, enter the location where you saved the exported script file, or click Browse to find the exported file.

  3. Click OK.