Метод Security.CreateCategories

Статья
08/03/2015

Создает одну или несколько категорий безопасности.

Пространство имен: WebSvcSecurity
Сборка: ProjectServerServices (в ProjectServerServices.dll)

Синтаксис

'Декларация
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/office/project/server/webservices/Security/CreateCategories", RequestNamespace := "https://schemas.microsoft.com/office/project/server/webservices/Security/",  _
    ResponseNamespace := "https://schemas.microsoft.com/office/project/server/webservices/Security/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Sub CreateCategories ( _
    categories As SecurityCategoriesDataSet _
)
'Применение
Dim instance As Security
Dim categories As SecurityCategoriesDataSet

instance.CreateCategories(categories)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/office/project/server/webservices/Security/CreateCategories", RequestNamespace = "https://schemas.microsoft.com/office/project/server/webservices/Security/", 
    ResponseNamespace = "https://schemas.microsoft.com/office/project/server/webservices/Security/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public void CreateCategories(
    SecurityCategoriesDataSet categories
)

Параметры

categories
Тип: WebSvcSecurity.SecurityCategoriesDataSet

Содержит сведения об одной или нескольких категорий безопасности.

Замечания

Параметр categories должен содержать по крайней мере один SecurityCategoriesDataSet.SecurityCategoriesRow , определяющий новой категории. SecurityCategoriesDataTable может содержать несколько объектов SecurityCategoriesRow . Project Server проверяет каждый SecurityCategoriesRow из следующих:

Уникальное название категории и GUID
Наличие пользователей и групп (при его наличии), имеющие разрешение категории
Наличие проектов (если они имеются) в категории
Наличие ресурсы (если они имеются) в категории

Существует семь объекты DataTable в SecurityCatagoriesDataSet. SecurityCategoriesDataTable должен содержать данные. Таблицы данных выполняется в порядке, следующим образом:

SecurityCategories Каждая строка указывает категорию GUID, имя и описание. Для создания категории безопасности требуются только идентификатор GUID и имя (WSEC_CAT_UID и WSEC_CAT_NAME).
UserRelations Необязательный атрибут. Каждая строка указывает категорию GUID и GUID ресурса.
GroupRelations Необязательный атрибут. Задает GUID категории и группы GUID.
Разрешенияпользователя Необязательный атрибут. Каждая строка задает GUID категории, GUID ресурса и разрешений и задает Allow или Deny для разрешения.
GroupPermissions Необязательный атрибут. Каждая строка задает GUID категории, GUID группы и разрешения и задает Allow или Deny для разрешения.
SecurityCategoryObjects Необязательный атрибут. Каждая строка задает GUID категории, тип объекта (проекту или ресурсу) и идентификатор GUID объекта.
SecurityCategoryRules Необязательный атрибут. Каждая строка задает GUID категории, тип объекта (проекту или ресурсу) и тип правила. Сведения о перечисления правила содержатся ProjectSecurityRules и ResourceSecurityRules.

Примеры допустимого категорий выберите категорию на странице "Управление категориями" в Project Web App для просмотра полей и параметров на странице "Добавление или изменение категории".

Разрешения Project Server

Разрешение	Описание
ManageSecurity	Позволяет пользователю управлять безопасности сервера Project Server. Глобальное разрешение.

Примеры

В следующем примере вызывается CreateCategories для создания двух категорий безопасности, которые указаны в SecurityCategoriesDataSetmultiCategoryDs.

Дополнительные сведения и полный пример приложения, который создает одну категорию безопасности с группой в разделе С помощью методов безопасности в PSI. Можно добавьте следующий код в пример приложения и измените значение resourceGuid. После запуска приложения открыть страницу "Управление категориями" в Project Web App и нажмите кнопку Test категории 1 и тестирования категорий 2 для просмотра результатов.

/* 
 * Add this code to the sample code in the article
 * Using Security Methods in the PSI.
 */

// Set the GUID for an existing resource.
Guid resourceUid = new Guid("a1fcbf91-e91d-44e2-a4a7-3b4b698cb984");

Guid category1Guid = Guid.NewGuid();
Guid category2Guid = Guid.NewGuid();

SvcSecurity.SecurityCategoriesDataSet multiCategoryDs =
   new SvcSecurity.SecurityCategoriesDataSet();
SvcSecurity.SecurityCategoriesDataSet.SecurityCategoriesRow category1Row =
   multiCategoryDs.SecurityCategories.NewSecurityCategoriesRow();
SvcSecurity.SecurityCategoriesDataSet.SecurityCategoriesRow category2Row =
   multiCategoryDs.SecurityCategories.NewSecurityCategoriesRow();

category1Row.WSEC_CAT_UID = category1Guid;
category1Row.WSEC_CAT_NAME = "Test Category 1";
category1Row.WSEC_CAT_DESC = "This is test category 1.";
multiCategoryDs.SecurityCategories.AddSecurityCategoriesRow(category1Row);

category2Row.WSEC_CAT_UID = category2Guid;
category2Row.WSEC_CAT_NAME = "Test Category 2";
category2Row.WSEC_CAT_DESC = "This is test category 2.";
multiCategoryDs.SecurityCategories.AddSecurityCategoriesRow(category2Row);

// (Optional) Add a user to category 1.
SvcSecurity.SecurityCategoriesDataSet.UserRelationsRow userRelationsRow =
   multiCategoryDs.UserRelations.NewUserRelationsRow();
userRelationsRow.WSEC_CAT_UID = category1Guid;
// Change the following GUID to a resource that is on your system.
Guid existingResUid = new Guid("88979803-2230-48b4-b23b-4af0e4a40392");
userRelationsRow.RES_UID = existingResUid;
multiCategoryDs.UserRelations.AddUserRelationsRow(userRelationsRow);

// (Optional) Specify the permissions for the user on category 1.
SvcSecurity.SecurityCategoriesDataSet.UserPermissionsRow userPermRow =
   multiCategoryDs.UserPermissions.NewUserPermissionsRow();
userPermRow.WSEC_CAT_UID = category1Guid;
userPermRow.RES_UID = existingResUid;
userPermRow.WSEC_ALLOW = true;

// For example, add the "Open Project" permission.
userPermRow.WSEC_FEA_ACT_UID = PSLibrary.PSSecurityCategoryPermission.OpenProject;
multiCategoryDs.UserPermissions.AddUserPermissionsRow(userPermRow);

// (Optional) Add an object (project or resource) to category 2.
SvcSecurity.SecurityCategoriesDataSet.SecurityCategoryObjectsRow category2ObjectRow =
   multiCategoryDs.SecurityCategoryObjects.NewSecurityCategoryObjectsRow();
category2ObjectRow.WSEC_CAT_UID = category2Guid;
category2ObjectRow.WSEC_OBJ_TYPE_UID = PSLibrary.PSSecurityObjectType.Project;

// Add an existing project to category 2. 
// Change the following GUID to a project that is on your system.
category2ObjectRow.WSEC_OBJ_UID = new Guid("BC323C21-B7E4-4631-AF99-C44E5C52BA4E");
multiCategoryDs.SecurityCategoryObjects.AddSecurityCategoryObjectsRow(category2ObjectRow);

// (Optional) Set some dynamic rules on category 2.
SvcSecurity.SecurityCategoriesDataSet.SecurityCategoryRulesRow category2RulesRow1 =
   multiCategoryDs.SecurityCategoryRules.NewSecurityCategoryRulesRow();
category2RulesRow1.WSEC_CAT_UID = category2Guid;
category2RulesRow1.WSEC_OBJ_TYPE_UID = PSLibrary.PSSecurityObjectType.Project;
category2RulesRow1.WSEC_OBJ_RULE_TYPE = (int)PSLibrary.ProjectSecurityRules.OwnerAtSameRbsNode;
multiCategoryDs.SecurityCategoryRules.AddSecurityCategoryRulesRow(category2RulesRow1);

SvcSecurity.SecurityCategoriesDataSet.SecurityCategoryRulesRow category2RulesRow2 =
   multiCategoryDs.SecurityCategoryRules.NewSecurityCategoryRulesRow();
category2RulesRow2.WSEC_CAT_UID = category2Guid;
category2RulesRow2.WSEC_OBJ_TYPE_UID = PSLibrary.PSSecurityObjectType.Project;
category2RulesRow2.WSEC_OBJ_RULE_TYPE = (int)PSLibrary.ProjectSecurityRules.AllCurrentAndFuture;
multiCategoryDs.SecurityCategoryRules.AddSecurityCategoryRulesRow(category2RulesRow2);

SvcSecurity.SecurityCategoriesDataSet.SecurityCategoryRulesRow category2RulesRow3 =
   multiCategoryDs.SecurityCategoryRules.NewSecurityCategoryRulesRow();
category2RulesRow3.WSEC_CAT_UID = category2Guid;
category2RulesRow3.WSEC_OBJ_TYPE_UID = PSLibrary.PSSecurityObjectType.Project;
category2RulesRow3.WSEC_OBJ_RULE_TYPE = (int)PSLibrary.ProjectSecurityRules.ManagedByUser;
multiCategoryDs.SecurityCategoryRules.AddSecurityCategoryRulesRow(category2RulesRow3);

security.CreateCategories(multiCategoryDs);