This business component lets you invite people to Barium Live directly from a process application.
It can be a powerful tool, especially for larger corporations, to dynamically assign tasks to people. This regardless if they are prior users of Barium Live or not.
SETUP
The business component “Invite user to space” must be activated on contract level. Please contact sales@barium.se to get access to the business component.
CONFIGURATION
Adding the Business Component to your Space
Before using the business component for the first time, it needs to be added to the space.
This is done under Space Settings > Business Components.
Press “Add new” and choose “Invite Users To Space” and give it a name and press save
The Business component is now ready to be used in a process.
Usage
Add the business component to the Process.
To add the business component to your process you need to open the Component tab (1) and locate the “Invite User To Space” business component (2). Then drag and drop it into your process.
Configure the component
Double click on the component to access the configuration settings.
There you can specify:
who should be invited,
write an extra message to them in their invite, and
whether they should login using IdP or not.
Individuals will be invited as “Users” with the “Run” permission to the space that the process is run in. If there is an IdP configured and they are invited using IdP they will also be invited to the default space with permissions according to those set by the IDP settings.
Email addresses
The Email addresses field lets you specify what emails you wish to send an invite to. The field expects comma separated values from email addresses. You can also use variables, and they can even be mixed in with e-mail addresses in plain text.
When evaluating the contents of the field, it first finds and replaces all the variables and then separates the text on comma.
Example
“email@email.com,$variabel$,mejl@mejl.com”
where $variable$ = “mail@one.com,mail@two.com”
would first evaluate the variable and become:
“email@email.com,mail@one.com,mail@two.com,mejl@mejl.com”
which is split by comma to the four emails:
email@email.com
mail@one.com
mail@two.com
mejl@mejl.com
Message attached to email
This field allows you to attach a message to the space invite email. The field expects either plain text, variables or a mix of them both.
Example
“Hello there $name$, you have been invited to participate in $instanceName$ at Barium.”
where:
$name$ = “Darrel”
$instanceName$ = “the annual survey”
would be evaluated to:
“Hello there Darrel, you have been invited to participate in the annual survey at Barium.”
The message is used in the invitation email that looks like the sample below.
Note: text inside ‘<’ ‘>’ represents variable values that will be set by Barium Live when the application is run.
An account has been created for you in Barium Live
Created by: <Space owner>
Created date: <Email sent date>
Contract: <The space’s contract>
Attached message: <YOUR MESSAGE>
If you want to accept the invitation follow this link.
Need help? Please contact Barium support.
Invited users use IDP
The checkbox allows you to decide if the users should be invited as IdP users (using IdP Login) or as regular users (using the Barium login).
Important! if you invite your user as IdP users, ensure that their email address is the same as their IdP provides in their list of claims otherwise the invited user will not be able to login via their IdP.
Note: This setting is only visible if your contract is linked with an Identity provider.
Running the Component
When running the component it will make a best effort based execution, meaning that if a user could not be invited (for any reason) the business component will still be counted as successfully run.
However, if a variable specified in either Email addresses or Message attached to email can’t be found the business component will fail it’s execution.