ReportingService2005.CreateRole(String, String, Task[]) Método

Definición

Espacio de nombres:

ReportService2005

Ensamblado:

ReportService2005.dll

Agrega un nuevo rol a la base de datos del servidor de informes.

public:
 void CreateRole(System::String ^ Name, System::String ^ Description, cli::array <ReportService2005::Task ^> ^ Tasks);

public void CreateRole (string Name, string Description, ReportService2005.Task[] Tasks);

member this.CreateRole : string * string * ReportService2005.Task[] -> unit

Public Sub CreateRole (Name As String, Description As String, Tasks As Task())

Parámetros

Name

String

Nombre del nuevo rol. El valor de este parámetro debe tener entre 1 y 260 caracteres.

Description

String

Descripción del nuevo rol. El valor de este parámetro debe tener entre 1 y 512 caracteres.

Tasks

Task[]

Matriz de objetos Task que representa las tareas que se van a establecer para el rol. Solo la propiedad TaskID del objeto Task se envía para crear un rol.

Ejemplos

Para compilar este ejemplo de código, debe hacer referencia al Reporting Services WSDL e importar determinados espacios de nombres. Para obtener más información, vea Compilar y ejecutar ejemplos de código. En el ejemplo de código siguiente se usa el CreateRole método para crear un rol de usuario que tenga permisos para ver carpetas e informes:

Imports System  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2005()  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials  

      Dim name As String = "Report Browser"  
      Dim desc As String = "View folders and reports."  
      Dim setTasks(2) As Task  
      setTasks(0) = New Task()  
      setTasks(1) = New Task()  
      setTasks(2) = New Task()  

      Try  
         Dim returnedTasks As Task() = rs.ListTasks()  

         Dim t As Task  
         For Each t In  returnedTasks  
            If t.Name = "View reports" Then  
               setTasks(0) = t  

            Else  
               If t.Name = "View folders" Then  
                  setTasks(1) = t  

               Else  
                  If t.Name = "View resources" Then  
                     setTasks(2) = t  
                  End If  
               End If  
            End If   
         Next t  
         rs.CreateRole(name, desc, setTasks)  

      Catch e As SoapException  
         Console.WriteLine(e.Detail.InnerXml.ToString())  
      End Try  
   End Sub 'Main  
End Class 'Sample  

using System;  
using System.Web.Services.Protocols;  

class Sample  
{  
   public static void Main()  
   {  
      ReportingService2005 rs = new ReportingService2005();  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  

      string name = "Report Browser";  
      string desc = "View folders and reports.";  
      Task[] setTasks = new Task[3];  
      setTasks[0] = new Task();  
      setTasks[1] = new Task();  
      setTasks[2] = new Task();  

      try  
      {  
         Task[] returnedTasks = rs.ListTasks();  

         foreach( Task t in returnedTasks )  
         {  
            if ( t.Name == "View reports" )  
            {  
               setTasks[0] = t;  
            }  

            else if ( t.Name == "View folders" )  
            {  
               setTasks[1] = t;  
            }  

            else if ( t.Name == "View resources" )  
            {  
               setTasks[2] = t;  
            }  
         }  

         rs.CreateRole( name, desc, setTasks );  
      }  

      catch ( SoapException e )  
      {  
         Console.WriteLine( e.Detail.InnerXml.ToString() );  
      }  
   }  
}  

Comentarios

En la siguiente tabla se muestra la información de encabezado y de permisos de esta operación.

Encabezados SOAP	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
Permisos necesarios	CreateRoles (Sistema)

Los Name parámetros y Description son necesarios y no deben establecerse null en (Nothing en Visual Basic). El valor de Name debe ser único.

Debe asignar al menos una tarea al rol. No se pueden combinar tareas de nivel de sistema y de elemento dentro de un solo rol. Para obtener más información sobre las tareas, vea Tareas y permisos.