Modify Folder Security Smart Service

Overview

The Modify Folder Security smart service allows you to select a user to be added to a specified folder as a reader, author, and/or administrator. Only a System Administrator or a Knowledge Center Administrator can add users in these roles.

CAUTION: This node can only be executed with the appropriate user rights. Attempting to complete this task without sufficient rights generates an error message for the Process Administrator and pauses the process.

Properties

  • Category: Document Management

  • Icon:

  • Assignment Options: Attended/Unattended

Configuration Options

This section contains tab configuration details specific to this smart service. For more information about common configurations see the Process Node Properties page.

Data Tab

This tab displays all the Node Inputs and Node Outputs for the Service Node. You can add additional inputs and outputs, if needed. The default inputs are:

Input Type Required Multiple
Folder Folder Yes No
Readers People No Yes
Authors People No Yes
Administrators People No Yes

The users and groups selected as readers, authors, and administrators will be added to that role for the folder. The folder's existing readers, authors, and administrators, will not be removed when this smart service executes.

a!modifyFolderSecurity()

The Modify Folder Security smart service is available as an expression function that can be executed inside a saveInto on a Interface Component or as part of a Web API.

Syntax

a!modifyFolderSecurity(folder, readers, authors, administrators, onSuccess, onError)

Inputs

  • folder (Folder): The folder you want to set security for.
  • readers (List of User or Group): The new users and groups to have reader access to the folder.
  • authors (List of User or Group): The new users and groups to have author access to the folder.
  • administrators (List of User or Group): The new users and groups to have administrator access to the folder.
  • onSuccess (Any Type): A list of saves or an HTTP response to execute after the smart service executes successfully. Created with a!save() or a!httpResponse().
  • onError (Any Type): A list of saves or an HTTP response to execute when the smart service does not execute successfully. Created with a!save() or a!httpResponse().
FEEDBACK