Tutorial (using TRAINING)
This tutorial will walk you through the entire setup of the ecosystem necessary to make use of the Behavior: BEH_CREATE_MEMBER_ROLES_FROM_ACTIVITY_INSTANCES.
Purpose
To re-cap, the essential idea of this behavior is to fulfill the need to use an Activity Instance on an organization’s Learning Plan Instance to collect information about member roles which we want to assign to the owner of the Learning Plan Instance. The behavior will be launched from a Complete Learning Plan workflow and will find any Activity Instances, of the desired Activity Type, on the current Learning Plan Instance, that are Completed Successfully. For each of these Activity Instances, it will add a Member Role of the defined type to the owner of the Learning Plan Instance.
Creating the Necessary Objects
As an ADMIN on the TRAINING database, first create a Create Activity Workflow and a Complete Activity Workflow:
Navigate to Admin → Activities
Click on third-level-nav “Activity Types”
Click “Add Activity Type”
Name it “Activity to Capture Member Role Information”
Save the new Activity Type
Navigate to Admin → Workflows
Click “Add Workflow”
Create the workflow for “Create Activity”
Add a new Data Entry Step
No default actions:
Add an action to the newly created step:
Make it a “Complete Successfully” action and change color from orange to green:
Should look like this:
Create a second workflow for “Complete Activity”
Add a single data entry step to the workflow:
We will be using this activity to capture information for a role for which there may be multiple instances, so we must provide a field to fill out as a Role Label. Click “Add Input Field”
Add a new Input Field:
And add a single “Complete Successfully” action to the workflow step.
It should look like this when you’re done:
On the workflow List page, Click “Disabled” in the status column next to the two new workflows you created.
Now return to Admin → Activities and click “Add Activity” and fill it out as follows:
Click “Complete Configuration”
Note the activity ID for the newly created activity:
Next, create a “Complete Learning Plan” workflow
At this time, we do not need to add any steps, but it might be wise to leave the workflow edit screen open on a tab, we intend to return to it.
On the workflow list page, “Enable” that workflow:
Now we need to configure some roles. Go to Admin → Roles. We are going to be adding two roles: (one has a status list, both are Organization member types)
Back on the Workflow List page (Admin → Workflows) choose the “Provider - Grant” workflow and “Provider - Edit” workflow and assign them to the new Roles you created:
Go to Admin → Roles → Permissions, and give “Organization With Branches” the Practitioner Area Access permission:
Now add a step and action to the Complete Learning Plan Workflow. The action will require adding a behavior:
Then edit the “Save” action to add a second behavior to it:
Now go to Admin → Credentials (Disciplines) and click “View List” in the Applications column next to American Society of Office Dogs (or any other discipline)
Choose “Add Application”
Configure it as follows:
Once you save, Scroll down and click “Add Group”
Rename “New Group” to “Branches to Add”
Click “Configure Search” and set the “Search Experience” use the Activity ID you noted above in step 23.
Click “Edit Group” and Make sure “Allow Practitioners to Add Activities” is checked
Click “Show Details”
Click “Publish”
Go to Admin → Members
Click “Add Member”
Configure as shown:
Configure the password to be something you remember
On their profile page, click “Become an Organization with Branches”
Choose a Unique ID and Click Grant Role
Log out of the Admin user, and log in as your new doggie barber user.
Click “My Cycle → Applications” and begin the “Collect Information About Branches” Application
Click “Add Activity”
And fill out your desired role label
Click “Finished Providing Information”
Add as many more as you would like, each must have a unique label.
Then click “Create” in the top left corner and click “Finish Later”
Then click “My Account” in the far top left of the screen
And note the newly added Member Role: