Please enable JavaScript to view this site.

QPR Knowledge Base 2023.1

  •      
  • Navigation: Developer's Guide > QPR Web Services Foundation > Functions

    SetAccessLevel

    Scroll Prev Top Next More

    Revision history:

    Introduced in QPR 8.1

     

    Sets object rights for a user or a group. This function is supported only for objects in the SC namespace

     

    Synopsis:

     

    void SetAccessLevel(string sessionId, string objectIds, string userIds, AccessLevel accessLevel, bool removeAccess, string options)

     

    Return Value:

     

    None.

     

    Parameters:

     

    sessionId: String. ID of an authenticated session.

    objectIds: String. A comma-separated list of FullID's of objects to which the access level is set. This parameter supports also the following special ID's:

    SC.<model>.-2 = user element type

    SC.<model>.-3 = scorecard element type

    SC.<model>.-7 = information item element type

    userIds: String. A comma-separated list of login names or FullID's of users and groups

    accessLevel: Value of an enumerated type with the following values: -3 = Model Administrator, -2 = Model User, -1 = None, 0 = View, 1 = Update, 2 = Full. Note: Values -3 and -2 are valid only for models. -1, 0, 1, 2 are valid only for model objects.

    removeAccess: Boolean. Defines whether access is removed from user or added to user. Note: When removing access for model objects, the accessLevel value is ignored.

    options: String. A comma-separated list of options for the command. Note that there can be also mandatory options specific to product and object type.

     

    Example Procedure:

     

    ServiceClient client = new ServiceClient("WSHttpBinding_IService");

    string sessionId = client.Authenticate("qpr", "demo");

    client.SetAccessLevel(sessionId, "SC.1938773693.281", "CEO", AccessLevel.View, false, "");

    client.LogOff(sessionId);

    client.Close();