Udostępnij przez


Metoda ReportingService2010.CreateRole

Dodaje nową rolę, do baza danych serwera raportów.Metoda ta dotyczy tylko trybu macierzystego.

Przestrzeń nazw:  ReportService2010
Zestaw:  ReportService2010 (w ReportService2010.dll)

Składnia

'Deklaracja
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateRole", RequestNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",  _
    ResponseNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
Public Sub CreateRole ( _
    Name As String, _
    Description As String, _
    TaskIDs As String() _
)
'Użycie
Dim instance As ReportingService2010
Dim Name As String
Dim Description As String
Dim TaskIDs As String()

instance.CreateRole(Name, Description, _
    TaskIDs)
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateRole", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapHeaderAttribute("TrustedUserHeaderValue")]
public void CreateRole(
    string Name,
    string Description,
    string[] TaskIDs
)
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateRole", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
public:
void CreateRole(
    String^ Name, 
    String^ Description, 
    array<String^>^ TaskIDs
)
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateRole", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
member CreateRole : 
        Name:string * 
        Description:string * 
        TaskIDs:string[] -> unit 
public function CreateRole(
    Name : String, 
    Description : String, 
    TaskIDs : String[]
)

Parametry

  • Name
    Typ: System.String
    Nazwa nowej roli.Wartość tego parametru musi być między 1 do 260 znaków.
  • Description
    Typ: System.String
    Opis nowej roli.Wartość tego parametru musi być między 1 do 512 znaków.
  • TaskIDs
    Typ: array<System.String[]
    Tablica identyfikatorów reprezentujących zadania do zadań zestaw dla roli.

Uwagi

W poniższej tabela przedstawiono informacje nagłówka i uprawnienia na tej operacji.

Użycie nagłówek protokołu SOAP

(W)TrustedUserHeaderValue

(Ruch wychodzący)ServerInfoHeaderValue

Tryb macierzysty wymagane uprawnienia

CreateRoles(System)

Tryb programu SharePoint wymagane uprawnienia

Nieobsługiwana

Ta metoda wygeneruje OperationNotSupportedSharePointMode wyjątek przy wywołaniu w trybie SharePoint.

Name i Description Parametry są wymagane i nie powinien być zestaw do nullodwołanie o wartości null (Nothing w języku Visual Basic) (nic nie w języku Visual Basic).Wartość dla Name musi być unikatowy.

Co najmniej jedno zadanie musi przydzielić rolę.Nie można łączyć system -poziom i elementu -poziom zadań w obrębie jednej roli.Aby uzyskać więcej informacji na temat zadań, zobacz Uprawnienia i zadania.

Przykłady

Aby skompilować ten przykład kodu, należy odwołać WSDL usług Reporting i przywozu niektórych obszarów nazw.Aby uzyskać więcej informacji, zobacz temat Compiling and Running Code Examples.Następujący kod w przykładzie wykorzystano CreateRole metoda, aby utworzyć rolę użytkownika, który ma uprawnienia do wyświetlania folderów i raporty:

Imports System
Imports System.Web.Services.Protocols

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

      Try 
         Dim name As String = "Report Browser" 
         Dim desc As String = "View folders and reports." 
    
         Dim tasks As Task() = rs.ListTasks("All")  
         Dim taskIDs As New List(Of String)()  
    
         For Each t As Task In tasks  
            taskIDs.Add(t.TaskID)  
         Next 
    
         rs.CreateRole(name, desc, taskIDs.ToArray())
      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()
   {
      ReportingService2010 rs = new ReportingService2010();
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;

      try
      {
         string name = "Report Browser";
         string desc = "View folders and reports.";

         Task[] tasks = rs.ListTasks("All");
         List<string> taskIDs = new List<string>();

         foreach (Task t in tasks)
         {
            taskIDs.Add(t.TaskID);
         }

         rs.CreateRole(name, desc, taskIDs.ToArray());
      }
      catch (SoapException e)
      {
         Console.WriteLine(e.Detail.InnerXml.ToString());
      }
   }
}