Resource::UpdateResources method

Office 2013 and later

Updates, deletes, or creates one or more resources.

Namespace:  WebSvcResource
Assembly:  ProjectServerServices (in ProjectServerServices.dll)

C#
VB
C++
Copy
No code example is currently available or this language may not be supported.

Parameters

rds
Type: WebSvcResource.ResourceDataSet

A ResourceDataSet containing the updated resource data.

validateOnly
Type: System.Boolean

If true, only validates the data and does not create the new resources.

autoCheckIn
Type: System.Boolean

If true, automatically checks in the resource data.

Return value

Type: WebSvcResource.ResourceDataSet
The returned ResourceDataSet contains the changes made.

UpdateResources deletes a resource if the ResourceDataSet parameter does not contain information for an existing resource, creates a resource if the resource does not exist in the enterprise resource pool, or updates existing resources with new data.

Each resource to be modified or deleted needs to be checked out to the current authenticated user before calling UpdateResources.

Project Server Permissions

Permission

Description

ManageUsersAndGroups

Allows a user to manage all enterprise users, resources and groups. Global permission.

NewResource

Allows a user to create a new resource. Global permission.

ManageActiveDirectorySettings

Allows a user to manage user information. Global permission.

EditEnterpriseResourceData

Allows a user to edit or delete this resource. Category permission.

The following example gets a list of all existing enterprise resources, checks out the first resource, updates the name of the resource, and then saves the change to the server and checks in the resource.

Please see Prerequisites for ASMX-based code samples in Project 2013 for critical information on running this code sample.

C#
Copy 
using System;
using System.Collections.Generic;
using System.Text;
using System.Net;
using System.Windows.Forms;
using System.Web.Services.Protocols;
using PSLibrary = Microsoft.Office.Project.Server.Library;

namespace Microsoft.Office.Project.Samples.UpdateResources
{
   class Program
   {
       static void Main(string[] args)
      { 
         const string PROJECT_SERVER_URI    = "http://ServerName/ProjectServerName/";
         const string RESOURCE_SERVICE_PATH = "_vti_bin/psi/resource.asmx";
         
         try
         {
            // Set up the resource object and dataset
            SvcResource.Resource resourceSvc = new SvcResource.Resource();
            SvcResource.ResourceDataSet resourceDs = new SvcResource.ResourceDataSet();            
            resourceSvc.Url = PROJECT_SERVER_URI + RESOURCE_SERVICE_PATH;
            resourceSvc.Credentials = CredentialCache.DefaultCredentials;

            // Read read all the resources
            resourceDs = resourceSvc.ReadResources(string.Empty, false);

            // Check out the first resource for updating.
            //  - This assumes the resource is checked in.
            //  - An error occurs if the resource is already checked out.
            resourceSvc.CheckOutResources(new Guid[] { resourceDs.Resources[0].RES_UID });

            // Update the resource name of the first row.
            Console.WriteLine ("Modifying resource " + resourceDs.Resources[0].RES_ID + " (" + resourceDs.Resources[0].RES_NAME + ")");
            resourceDs.Resources[0].RES_NAME += " Modified at: " + DateTime.Now.ToShortTimeString();

            // Send the update to the server and automatically check in the changed row
            resourceSvc.UpdateResources(resourceDs, false, true);
         }
         catch (System.Web.Services.Protocols.SoapException ex)
         {
            string errMess = "";
            PSLibrary.PSClientError error = new PSLibrary.PSClientError(ex);
            PSLibrary.PSErrorInfo[] errors = error.GetAllErrors();

            for (int j = 0; j < errors.Length; j++)
               errMess = errMess + errors[j].ErrId.ToString() + "\n";
            errMess = errMess + "\n" + ex.Message.ToString();

            MessageBox.Show(errMess, "Error", MessageBoxButtons.OK,
               MessageBoxIcon.Error);
         }
         catch (WebException ex)
         {
            string message = ex.Message.ToString() +
               "\n\nLog on, or check the Project Server Queuing Service";
            MessageBox.Show(message, "Project Creation Error",
               MessageBoxButtons.OK, MessageBoxIcon.Error);
         }
         catch (Exception ex)
         {
            MessageBox.Show(ex.Message, "Error", MessageBoxButtons.OK,
         MessageBoxIcon.Error);
         }
      }
   }
}
Show: