Archive.QueueArchiveProject Method
Saves a copy of the specified project from the Published to the Archive database. Creates a version of the project.
Namespace: WebSvcArchive
Assembly: ProjectServerWebServices (in ProjectServerWebServices.dll)
Syntax
'Declaration
<SoapDocumentMethodAttribute("http://schemas.microsoft.com/office/project/server/webservices/Archive/QueueArchiveProject", RequestNamespace := "http://schemas.microsoft.com/office/project/server/webservices/Archive/", _
ResponseNamespace := "http://schemas.microsoft.com/office/project/server/webservices/Archive/", _
Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function QueueArchiveProject ( _
jobUID As Guid, _
projectUID As Guid, _
archivedProjectUID As Guid, _
versionDescription As String, _
retentionPolicy As Integer, _
permanentArchive As Boolean _
) As Guid
'Usage
Dim instance As Archive
Dim jobUID As Guid
Dim projectUID As Guid
Dim archivedProjectUID As Guid
Dim versionDescription As String
Dim retentionPolicy As Integer
Dim permanentArchive As Boolean
Dim returnValue As Guid
returnValue = instance.QueueArchiveProject(jobUID, _
projectUID, archivedProjectUID, _
versionDescription, retentionPolicy, _
permanentArchive)
[SoapDocumentMethodAttribute("http://schemas.microsoft.com/office/project/server/webservices/Archive/QueueArchiveProject", RequestNamespace = "http://schemas.microsoft.com/office/project/server/webservices/Archive/",
ResponseNamespace = "http://schemas.microsoft.com/office/project/server/webservices/Archive/",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public Guid QueueArchiveProject(
Guid jobUID,
Guid projectUID,
Guid archivedProjectUID,
string versionDescription,
int retentionPolicy,
bool permanentArchive
)
Parameters
- jobUID
Type: System.Guid
GUID of the queue job.
- projectUID
Type: System.Guid
GUID of the project to archive.
- archivedProjectUID
Type: System.Guid
GUID of the archived project.
- versionDescription
Type: System.String
Description of the project version.
- retentionPolicy
Type: System.Int32
Specifies the retention policy; values can be -2, -1, 0, or greater than 0.
- permanentArchive
Type: System.Boolean
Set true to maintain a permanent copy and avoid accidental deletion.
Return Value
Type: System.Guid
Returns a GUID for the project version.
Remarks
QueueArchiveProject is an asynchronous method that sends a message to the Project Server Queuing Service.
Following are the values for retention policy.
Value of retentionPolicy |
Description |
---|---|
> 0 |
Set the project retention policy; override the Project Server default retention policy. |
0 |
Unlimited retention. Archive the project and do not check for retention delete. |
-1 |
Use the project policy if it is set, otherwise use the Project Server default. |
-2 |
Use the Project Server default retention policy and clear the project retention policy. |
Save the returned project version GUID to use with QueueRestoreProject.
Project Server Permissions
Permission |
Description |
---|---|
Schedule or perform a backup of Project Server entities. Global permission. |