Versions Compared

Version Old Version 17 New Version 18
Changes made by

Seth Petry-Johnson

Seth Petry-Johnson

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Pros

Cons

(plus) Highly performant

(minus) Does not perform Actions or Behaviors

(plus) Supports bulk updates in a single API call

(minus) Does not enforce Validation Rules; caller is responsible for ensuring data is valid

(plus) Updates a Workflow Instance regardless of which Step it is on

(minus) Can create issues if Attributes are updated in a way that the Workflow would not allow, and therefore does not account for

(minus) Only supports data types that store a simple value in the ITEM_ATTRIBUTE_VALUE table

(minus) Currently supports Extrinsic Attributes only

Logging

A WORKFLOW_LOG entry is created for each Workflow Instance that is updated by this API, with a WORKFLOW_VALUE_LOG entry for each individual Attribute that is included in the payload.

Since this is not considered a “Workflow operation”, some of the columns in WORKFLOW_LOG contain specific values:

.FROM_STEP_ID = 0
.FROM_STEP_NUMBER = 0
.FROM_STEP_TITLE = “** /SetAttributeValues **”
.TO_STEP_ID = 0
.TO_STEP_NUMBER = 0
.TO_STEP_TITLE = “** /SetAttributeValues **”
.ACTION_ID = 0
.ACTION_TITLE = “** /SetAttributeValues **”
.PERSON_ID = 1 (System user)
.LOGGED_IN_PERSON_ID = 1 (System user)

Supported Entities / Workflow types

The API currently supports Activity, Activity Instance, Learning Plan Instance, Member Role, and Activity Offering Instance Attributes.

Workflow Type

Rules

Create Activity

The Workflow Instance must be Incomplete.

Complete Activity

Complete Learning Plan

Complete Create Offering

Grant Role / Edit Role

The status of the Workflow Instance does not matter. Member Role Attributes can always be updated by this API.

Supported Attribute data types

...

Info

See also Workflow Attributes for the list of “Importable” data types

  • Activity Lookup

  • Address

  • Boolean

  • Competency Classification (warning) Technically importable, but not actually supported

  • Date

  • Date Time

  • Entity Image

  • Long Text

  • DateMember

  • Pick List

  • Member Role

  • Boolean

  • Vimeo SourceMulti-Select List

  • Numeric

  • PD In Focus Source

  • Multiselect Pick List

  • Tag List

  • Entity Image

  • Rating

  • Competency Classification

  • Date Time

  • Activity Lookup

  • Rich Text

  • Member Role

  • AddressRich Text

  • Short Text

  • Tag List

  • Vimeo Source

Using the API

Calling this API requires an API Key with the SetAttributeValues permission.

...

Field

Description

entityTypeAbbr

One of these values:

  • “AD” for Activity

  • “AI” for ActivityInstance

  • “AO” for ActivityOffering

  • “LPI” for LearningPlanInstance

  • “MR” for MemberRole

wfiId

The ID of the Workflow instance.

  • Activity - must point to an Incomplete Create Activity WFI

  • ActivityInstance - must point to an Incomplete Complete Activity WFI

  • ActivityOffering - must point to an Incomplete Create Offering WFI

  • LearningPlanInstance - must point to an Incomplete Complete LP WFI

  • MemberRole - can point to any Grant Role or Edit Role WFI, regardless of status

values

An array of attribute values to set.

values[i].attrDefId

Attribute Definition Id ID of the attribute to set. Must be a valid Attribute defined for the specified entity type.

values[i].val

Value to set.

Note

No validation or processing is performed on this value.

Take care when using this with data types that handle structured data, as you are responsible for correctly formatting the value in the API call.

...