Modify KC Security Smart Service

Overview

The Modify KC Security node allows you to select users and groups to be added to a Knowledge Center with one of a specific set of security roles. See Knowledge Center Security for more information.

The available security roles for this are:

• Readers
• Authors
• Administrators

You cannot remove users from a security role, using this smart service.

Only the owner or administrator of a Knowledge Center, a member of the Document Administrators group, or a System Administrator can add users to these roles. Prior security properties can be overridden by this node.

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.

Node inputs

The default inputs are:

Input	Data Type	Required	Multiple
Knowledge Center	Knowledge Center	Yes	No
Readers	People	No	Yes
Authors	People	No	Yes
Administrators	People	No	Yes

If the node is run without being assigned to a user (or a group) you must specify values for each of the Node Inputs listed in the table above. You can either manually enter data into the text-field, or a value can be generated using the using the Expression Editor. When using the Expression Editor, you can reference and modify Process Variables, rules, constants, and other data. The expressions then specify your Node Input values.

If the node is assigned, the Node Input values are typed by your assigned user(s) into a form.

a!modifyKnowledgeCenterSecurity()

The Modify Knowledge Center Security smart service is available as an expression function that can be executed inside a saveInto parameter on an interface component or as part of a Web API.

Syntax

a!modifyKnowledgeCenterSecurity( knowledgeCenter, readers, authors, administrators, onSuccess, onError )

Parameters

Keyword	Type	Description
knowledgeCenter	Knowledge Center	The knowledge center 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().

Feature compatibility

The table below lists this smart service function's compatibility with various features in Appian.

Feature	Compatibility	Note
Portals	Partially compatible	Can be used with Appian Portals if it is connected using an integration and web API.
Offline Mobile	Incompatible
Sync-Time Custom Record Fields	Incompatible
Real-Time Custom Record Fields	Incompatible	Custom record fields that evaluate in real time must be configured using one or more Custom Field functions.
Process Reports	Incompatible	Cannot be used to configure a process report.
Process Events	Incompatible	Cannot be used to configure a process event node, such as a start event or timer event.

Feedback