Security.CreateCategories método

Artigo
07/15/2015

Cria uma ou mais categorias de segurança.

Namespace: WebSvcSecurity
Assembly: ProjectServerServices (em ProjectServerServices.dll)

Sintaxe

'Declaração
<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 _
)
'Uso
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
)

Parâmetros

categories
Tipo: WebSvcSecurity.SecurityCategoriesDataSet

Contém as informações sobre uma ou mais categorias de segurança.

Comentários

O parâmetro categories deve conter pelo menos um SecurityCategoriesDataSet.SecurityCategoriesRow que define uma nova categoria. O SecurityCategoriesDataTable pode conter vários objetos SecurityCategoriesRow . Project Server valida cada SecurityCategoriesRow para o seguinte:

Nome da categoria exclusivo e o GUID
Existência de usuários e grupos (se houver) que possuem a permissão de categoria
Existência de projetos (se houver) na categoria
Existência de recursos (se houver) na categoria

Existem sete objetos de DataTable em um SecurityCatagoriesDataSet. Somente o SecurityCategoriesDataTable deve conter dados. As tabelas de dados estão em ordem, da seguinte maneira:

SecurityCategories Cada linha especifica o GUID da categoria, nome e descrição. Somente o GUID e o nome (WSEC_CAT_UID e WSEC_CAT_NAME) são necessárias para criar uma categoria de segurança.
UserRelations Opcional. Cada linha especifica a GUID da categoria e o GUID do recurso.
GroupRelations Opcional. Especifica a GUID da categoria e o GUID do grupo.
Permissõesde usuário Opcional. Cada linha especifica o GUID da categoria, o GUID do recurso e a permissão e define Allow ou Deny para que a permissão.
GroupPermissions Opcional. Cada linha especifica o GUID da categoria, o GUID do grupo e a permissão e define Allow ou Deny para que a permissão.
SecurityCategoryObjects Opcional. Cada linha especifica o GUID da categoria, tipo de objeto (projeto ou recurso) e GUID do objeto.
SecurityCategoryRules Opcional. Cada linha especifica o GUID da categoria, tipo de objeto (projeto ou recurso) e tipo de regra. Para obter informações sobre as enumerações de regra, consulte ProjectSecurityRules e ResourceSecurityRules.

Para obter exemplos de categorias válidos, clique em uma categoria na página Gerenciar categorias no Project Web App, para ver os campos e as configurações na página Adicionar ou editar categoria.

Permissões do Project Server

Permissão	Descrição
ManageSecurity	Permite que um usuário gerenciar a segurança do Project Server. Permissão global.

Exemplos

O exemplo a seguir chama CreateCategories para criar duas categorias de segurança que são especificadas no SecurityCategoriesDataSetmultiCategoryDs.

Para obter informações adicionais e um aplicativo de exemplo completo que cria uma categoria de segurança com um grupo, consulte Usando os métodos de segurança na PSI. Você pode adicionar o código a seguir para o aplicativo de amostra e modificar o valor de resourceGuid. Depois de executar o aplicativo, abra a página Gerenciar categorias no Project Web App e clique em categoria de teste 1 e 2 de categoria de teste para ver os resultados.

/* 
 * 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);