ExecuteScript Method (dicomScriptFileName, continueOnError)

DVTk API

[This is preliminary documentation and is subject to change.]

Execute a Script File of type DICOMScript (.DS) / DICOMSuperScript (.DSS).

Declaration Syntax

Visual Basic

Visual C++

bool ExecuteScript(
	string dicomScriptFileName,
	bool continueOnError
)

Function ExecuteScript ( _
	dicomScriptFileName As String, _
	continueOnError As Boolean _
) As Boolean

bool ExecuteScript(
	String^ dicomScriptFileName, 
	bool continueOnError
)

Parameters

dicomScriptFileName (String): Script File of type DICOMScript (.DS) / DICOMSuperScript (.DSS)

continueOnError (Boolean): Continue a DICOMSuperScript when one of the conatining DICOMScripts fails on an error.

Return Value

Remarks

The continue on error allows control over the DICOMSuperScript. The DICOMSuperScript will continue if one of the containing DICOMScripts fails on an error.

A DICOMScript (.DS) describes a single Test Scenario. ACSE Requests and Responses and DIMSE Command / IOD combinations are used to perform a given Test Scenario.

DVT interprets a DICOMScript in order to perform a Test Scenario.

DICOMScripts should be written according to the role played by DVT:

SCU write a DICOMScript that plays the SCU role in a given Test Scenario.
SCP write a DICOMScript that plays the SCP role in a given Test Scenario.
FSC write a DICOMScript that plays the FSC role in a given Test Scenario (creates Files-sets).

A DICOMSuperScript (.DSS) contains a list of DICOMScript (filenames) that together are used to describe a Test Scenario. DVT executes the DICOMScripts in the order given in the DICOMSuperScript.

The DICOMSuperScript enables the reuse of certain DICOMScripts in various Test Scenarios - e.g., DICOMScript that makes an Association for CT Image Storage. It is possible to repeat the DICOMScript execution a number of times using the
DO n dicomscript
instruction where ‘n’ is the number of times that dicomscript is to be executed.

Assembly: DVTK (Module: DVTK) Version: 0.0.0.0