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.

  • To enter the path to a specific folder, enter root folder/parent folder/child folder.
  • To enter the root folder, leave the path blank.
  • To enter the path using SpEL (Spring Expression Language) syntax, enter the path using the format ((#item.acnestors[X].id == 123)). This resolves to a boolean. For example, to find a folder such as 2021-02, use the format ((new java.text.SimpleDateFormat(‘yyyy-MM’).format( new java.util.Date() ) )).

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.

  • To enter the path to a specific folder, enter root folder/parent folder/child folder.
  • To enter the root folder, leave the path blank.
  • To enter the path using SpEL (Spring Expression Language) syntax, enter the path using the format ((#item.acnestors[X].id == 123)). This resolves to a boolean. For example, to find a file such as 2021-02, use the format ((new java.text.SimpleDateFormat(‘yyyy-MM’).format( new java.util.Date() ) )).

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:

  • The following filter would trigger the event if a folder has a specific ID:
    ((#item.id == 234))
  • The following filter would trigger the event if a document comparison result has a status of “Accepted” or “In Progress:
    ((#status.name != 'Accepted' && #item.type == ‘Compare_Result’)) or ((#item.status.name == ‘In Progress’ && item.type == ‘Compare_Result’))

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’))