You can use the following triggers to initiate an event. Note that using filters in triggers requires a basic understanding of SpEL and the Blue Relay API.
Trigger | Description |
On Attribute Create | An attribute is added to a folder or file. You can use the following options to further define the trigger. Name To trigger the event if the attribute has a specific name, enter the attribute name. Value To trigger the event if the attribute has a specific value, enter the attribute value. Filter Use a filter to define the attributes that will trigger the event. Enter the filter using SpEL (Spring Expression Language) syntax. For example, the following filter would trigger the event if the attribute name is “Invoice Date”: ((#attribute.name == ‘Invoice Date’)) |
On Comment Create | A comment is added to a folder or file. |
On Data Set Row Create | A new row is added to a data set. You can use the following options to further define the trigger. Data Set To trigger the event when a row is added to a specific data set, select a data set. Filter Use a filter to define the new data set rows that will trigger the event. Enter the filter using SpEL (Spring Expression Language) syntax. For example, the following filter would trigger the event if the field “Field” contains the value “Value”: ((#row.cells[‘Field’] == ‘Value’)) |
On Email Receive | An email is received. You can use the following options to further define the trigger. Host, Port To trigger the event when emails are received by a specific mail server, enter the server’s hostname and port. Username, Password To trigger the event when emails are received by a specific Blue Relay user, enter the user’s username and password. |
On File Create | A document is uploaded to the Files area. You can use the following options to further define the trigger. Parent To trigger the event when a file is uploaded to a specific folder, select a folder. Filter Use a filter to define the files that will trigger the event. Enter the filter using SpEL (Spring Expression Language) syntax. For example, the following filter would trigger the event if the file version is greater than 1: ((#file.version > 1)) |
On Folder Create | A folder is created in the Files area. You can use the following options to further define the trigger. Parent To trigger an event when a folder is created in a specific folder, select a folder. Filter Use a filter to define the folders that will trigger the event. Enter the filter using SpEL (Spring Expression Language) syntax. For example, the following filter would trigger the event if the folder title is “ABC”: ((#folder.title == ‘ABC’)) |
On Form Create | A form is created. You can use the following options to further define the trigger. Parent To trigger the event when a form is created in a specific folder, select a folder. Filter Use a filter to define the forms that will trigger the event. Enter the filter using SpEL (Spring Expression Language) syntax. For example, the following filter would trigger the event if the form title is “Specific Form”: ((#form.title == ‘Specific Form’)) |
On Form Submit | A form is submitted. You can use a filter to further define the trigger. Enter the filter using SpEL (Spring Expression Language) syntax. For example, the following filter would trigger the event if the form title is “Specific Form”: ((#form.title == ‘Specific Form’)) |
On FTP File Create | A file is uploaded via FTP. You can use the following options to further define the trigger. Server Address To trigger the event when files are uploaded to a specific FTP server, enter the server’s address. Username, Password To trigger the event when files are uploaded by a specific Blue Relay user, enter the user’s username and password. Path To trigger the event when files are uploaded to a specific location on the FTP server, enter the path using one of the following formats.
Filter Use a filter to define the FTP file uploads that will trigger the event. Enter the filter using SpEL (Spring Expression Language) syntax. For example, the following filters would trigger the event if the filename starts with, ends with, or contains “Test”: ((#item.title.startsWith(“Test”))) ((#item.title.endsWith(“Test”))) ((#item.title.contains(“Test”))) |
On Group Create | A group is created. You can use a filter to further define the trigger. Enter the filter using SpEL (Spring Expression Language) syntax. For example, the following filter would trigger the event if the group name contains “Admin”: ((#item.name.contains(“Admin”))) |
On Local File Create | A file is uploaded to the Blue Relay server. You can use the following options to further define the trigger. Path To trigger the event when files are uploaded to a specific folder, enter the path using one of the following formats.
Filter Use a filter to define the files that will trigger the event. Enter the filter using SpEL (Spring Expression Language) syntax. For example, the following filter would trigger the event if the filename is “My First File”: ((#item.title == “My First File”)) |
On Markup Create | An annotation is added to a document. You can use a filter to further define the trigger. For example, the trigger could apply if an annotation is added to a specific document, if a specific user creates an annotation, or if an annotation is added to a file with a specific status. Enter the filter using SpEL (Spring Expression Language) syntax. For example, the following filter would trigger the event if the filename is “A Markup”: ((#item.title == “A Markup”)) |
On Question Answer | An answer is submitted for a form question. You can use the following options to further define the trigger. Form Name To trigger the event when questions from a specific form are answered, select a form. Filter Use a filter to define the questions that will trigger the event. Enter the filter using SpEL (Spring Expression Language) syntax. For example, the following filter would trigger the event if the answer is not blank: ((#answer.display != null)) |
On Status Change | A status is changed. You can use the following options to further define the trigger. Status To trigger the event when a specific status is assigned to an item, select the status. Filter Use a filter to define the status (or statuses) that will trigger the event. Enter the filter using SpEL (Spring Expression Language) syntax. For example:
|
On Tag Create | A tag is added to a folder or file. You can use the following options to further define the trigger. Tag To trigger the event when a specific tag is created, enter the tag. To enter multiple tags, use a comma-separated list (for example: apple, orange, banana). Filter Use a filter to define the tags that will trigger the event. Enter the filter using SpEL (Spring Expression Language) syntax. For example, the following filter would trigger the event if any document containing “2021” is tagged: ((#item.title.contains(‘2021’))) |
On User Create | A new Blue Relay user is created. You can use a filter to define the users that will trigger the event. Enter the filter using SpEL (Spring Expression Language) syntax. For example, the following filter would trigger the event if the user’s first name is “Bob”: ((#user.firstName == ‘Bob’)) |