Applies access-control settings to a folder or workspace. (V1-V1.0.3)
public void setFunctionMembership( long binderId, String inputDataAsXML );
The setFunctionMembership message provides access-control settings for folder or a workspace. The term function is analogous to a role in the user interface (UI).
The primary use of this message is to establish access-control settings when migrating workspaces and folders from Forum to Novell Teaming. You must ensure that you have migrated Forum user and group names to Novell Teaming that are required for your access-control settings.
NOTE:This message is an overwrite operation, setting all function memberships for the folder or workspace; you cannot use repeated calls to this message to set memberships incrementally. So, set all memberships for the workspace or folder with one call.
The binder identifier of the folder or workspace for which you want to set access control.
A string of XML containing the values needed to set access control. Here is an example of XML that sets the visitor function:
<workAreaFunctionMemberships> <workAreaFunctionMembership> <property name="functionName">__role.visitor</property> <property name="memberName">jGarces</property> <property name="memberName">sChen</property> <proprty name="members">1,2,3</property> </workAreaFunctionMembership> . . . </workAreaFunctionMemberships>
To obtain the functionName value:
Sign in as a site administrator for Novell Teaming.
In the administration portlet, click
.Click any item (for example,
).Note or copy the identifier in the __role.participant). This identifier begins with a double underscore ( _ ).
text box (for example,You can pass either user or group names (for example, jGarces or sChen) or user or group identifiers (for example, 1, 2, 3). Novell Teaming reserves the identifiers -1 for the workspace or folder owner, and -2 for a team member.
This code uses the content of the XML string s to establish access-control settings for the folder or workspace whose binder identifier is 21.
The message table for the Windows based wsclient.bat program (Section 2.0, Web Services Message Reference)