Folder.Share

Modifies a shared folder user list. The shared folder user list is not stored on the server. Instead, the user list, with respective user rights, is passed to the server with each request to add, delete, or save the shared list.

Parameters

User.context (Required)

Specifies the context identifier for this user's session.

Folder.Share (Required)

Specifies the required action.

Folder.id or Folder.drn (Required)

Specifies the folder identifier.

Folder.SaveShare (SUBACTION)

Specifies to save the shared folder user list.

Folder.Share.subject

Specifies the subject of the shared folder.

Folder.Share.User.email

Specifies to add the specified user to the shared folder list.

ADD.<email address>

Specifies to grant create rights in a shared folder.

DELETE.<email address>

Specifies to grant delete rights in a shared folder.

DELETEUSER.<email address>

Specifies to delete the specified user from the shared folder list.

EDIT.<email address>

Specifies to grant edit rights in a shared folder.

READ.<email address>

Specifies to grant read rights in a shared folder.

Return Values

Returns the same values as Folder.ListShare.

Saving Folder Lists

Specifying the Folder.SaveShare subaction saves the shared folder list.

Adding Users

Specifying the Folder.Share.User.email subaction with a value of the user name or email address adds a user to the shared folder list. Alternatively, the GroupWise Address Book (Folder.Directory action) can be used to look up multiple users that can be added to the shared folder list.

Deleting Users

Specifying the DELETEUSER.[email or name] removes a user from the shared folder list.

Each user can have four different rights to a shared folder: add, delete, edit, and read. These specific rights are preappended to the user's email address and passed to the server during a request.

Example

<FORM method=post action=/servlet/webacc>
   <INPUT type=hidden name=User.context value=xyz>
   <INPUT type=hidden name=action value=Folder.Action>
   <INPUT type=hidden name=Folder.id value=1>
   <INPUT type=checkbox name=ADD.jDoe.po.domain value=on>
   <INPUT type=checkbox name=READ.jDoe.po.domain value=on>
   <INPUT type=image name=Folder.SaveShare src="btsaveus.gif">
</FORM>