ContentDeploymentJob.Test ContentDeploymentJob.Test ContentDeploymentJob.Test Method

Definition

Overloads

Test() Test() Test()

Tests this ContentDeploymentJob object synchronously.

Test(Boolean) Test(Boolean) Test(Boolean)

Tests this ContentDeploymentJob job asynchronously by default.

Test(String) Test(String) Test(String)

Performs a test run for the content deployment job.

Test(Boolean, String) Test(Boolean, String) Test(Boolean, String)

Performs a test run for the content deployment job based on the type of transformation and by using the specified snapshot.

Test() Test() Test()

Tests this ContentDeploymentJob object synchronously.

public:
 void Test();
public void Test ();
Public Sub Test ()

Test(Boolean) Test(Boolean) Test(Boolean)

Tests this ContentDeploymentJob job asynchronously by default.

public:
 void Test(bool runAsynchronously);
public void Test (bool runAsynchronously);
Public Sub Test (runAsynchronously As Boolean)
Parameters
runAsynchronously
Boolean Boolean Boolean

Whether to run this job asynchronously or synchronously.

Test(String) Test(String) Test(String)

Performs a test run for the content deployment job.

public:
 void Test(System::String ^ sourceContentDBSnapshotName);
public void Test (string sourceContentDBSnapshotName);
Public Sub Test (sourceContentDBSnapshotName As String)
Parameters
sourceContentDBSnapshotName
String String String

Specifies a name of a SQL snapshot to be used for export operation.

Exceptions

A specific reason is better described by the actual exception's message. Some common ones can include:An attempt is made to execute a job that is already running.An attempt is made to execute a job that is in a timed out state (LastStatus property).An attempt was made to run the job by using SQL snapshot for export, but the SQL Server being used does not support SQL snapshots.The SQL snapshot specified by sourceContentDBSnapshotName was not found.

Can be propagated from underlying Windows SharePoint Services 3.0 (WSS) layers.

Remarks

The test run includes the export phase of the content deployment job only.

The method executes the content deployment job synchronously. That is, it will not return until the execution of the content deployment job is complete. In this case that means that the export phase of the job will run in the current process.

The execution of the content deployment job propagates content to the target normally as determined by the value of the ExportMethod property of the job.

If sourceContentDBSnapshotName is null or Empty, the use of SQL snapshot for export during the execution of the content deployment job is determined by the value of the SqlSnapshotSetting property (see SqlSnapshotSetting for more information). Otherwise, the execution of the content deployment job will use SQL snapshot specified by sourceContentDBSnapshotName for export. In this case, if the SQL Server snapshot specified by sourceContentDBSnapshotName does not exist or if the SQL Server being used does not support SQL snapshots, the execution of the job will fail.

If an attempt is made to execute a job that is already running or is in a timed out state (LastStatus property), the execution of the job will fail.

Test(Boolean, String) Test(Boolean, String) Test(Boolean, String)

Performs a test run for the content deployment job based on the type of transformation and by using the specified snapshot.

public:
 void Test(bool runAsynchronously, System::String ^ sourceContentDBSnapshotName);
public void Test (bool runAsynchronously, string sourceContentDBSnapshotName);
Public Sub Test (runAsynchronously As Boolean, sourceContentDBSnapshotName As String)
Parameters
runAsynchronously
Boolean Boolean Boolean

Specifies whether to execute the content deployment job synchronously or asynchronously.

sourceContentDBSnapshotName
String String String

Specifies a name of a SQL snapshot to be used for an export operation.

Exceptions

A specific reason is better described by the actual exception's message. Some common messages include:An attempt is made to execute a job that is already running.An attempt is made to execute a job that is in a timed out state (LastStatus property).An attempt was made to run the job by using SQL snapshot for an export, but the SQL Server being used does not support SQL snapshots.The SQL snapshot specified by sourceContentDBSnapshotName was not found.

Can be propagated from underlying Windows SharePoint Services (WSS) layers.

Remarks

The test run includes the export phase of the content deployment job only.

If runAsynchronously is true, the method starts to execute the content deployment job and can return before the execution of the content deployment job is complete. In this case, that means that the export phase of the job will run in the timer service. Otherwise, the method will not return until the execution is complete; in this case, the export phase of the job will run in the current process.

The execution of the content deployment job is propagates content to the target normally as —determined by the value of the ExportMethod property of the job.

If the sourceContentDBSnapshotName parameter is null or Empty, the use of SQL snapshot for an export during the execution of the content deployment job is determined by the value of the SqlSnapshotSetting property (see the SqlSnapshotSetting for more information). Otherwise, the execution of the content deployment job will use SQL snapshot specified by the sourceContentDBSnapshotName parameter for export. In this case, if the SQL snapshot specified by sourceContentDBSnapshotName does not exist or if the SQL Server being used does not support SQL snapshots, the execution of the job will fail.

If an attempt is made to execute a job that is already running or is in a timed out state (LastStatus property), the execution of the job will fail.

Applies to