Creating File Triggers
A file trigger initiates a new task whenever a file is created, modified, or deleted in a specified location.
Files can reside in two folder options:
-
File Systems: local and network folders
-
Sharepoint (on-premises version) folder
To create a file trigger:
Each robot that could have a task assigned to based on this trigger must have connectivity and access rights to the specified root folder (so that it can read and act on the folders/files within it)
The Nintex RPA Server must also have access to this folder (to monitor it)
For Files in File systems: local and network folders:
-
Select the folder type File systems
-
Enter the folder path of the root folder that the trigger should monitor in the Folder field
-
Tick the Include Folders check box if you want the trigger to monitor subfolders as well
-
Enter the file name of the file the trigger should monitor in the File field
-
You can use an asterisk as a wildcard for one or more characters within the file name, for example:
-
If you enter the filename
*.docx
, the trigger will look for files with a*.docx
extension (such asinvoice1.docx
andpremium notice.docx
) -
If you enter the filename
*invoice.*
, the trigger will look for files with the wordinvoice
in the filename (such asdecember 2017 invoice.xlsx
andinvoice122017.pdf
)
-
-
-
Indicate one or more event(s) for which the trigger should monitor
-
Enter the Monitoring frequency (the acceptable range is from 20 sec to 300 seconds)
-
(optional) By default, the system logs in to network folder using the Windows Login credentials. For files on a network, you can select to use a credential from the credential vault, or, you can enter another user name and password combination manually.
-
To select a credential from the credentials vault: Select From vault. Select a credential from the list
-
To add credentials manually: Select Manually. Enter the User name and the Password
-
When you select the option to monitor a new file/folder, the option Include existing files becomes enabled. Select this option if you wish the trigger to initiate tasks based on files existing in the specified folder at the time the trigger is created.
For Files in a Sharepoint folder:
-
Select the folder type Sharepoint
-
Enter the Webdav path of the root folder that the trigger should monitor
-
NOTE: to get the Webdav path, open the folder in Sharepoint and click Copy Link in the menu bar
-
You can use an asterisk as a wildcard for one or more characters within the file name, for example:
-
If you enter the filename
*.docx
, the trigger will look for files with a*.docx
extension (such asinvoice1.docx
andpremium notice.docx
) -
If you enter the filename
*invoice.*
, the trigger will look for files with the wordinvoice
in the filename (such asdecember 2017 invoice.xlsx
andinvoice122017.pdf
)
-
-
Tick the Include Subfolders checkbox if you want the trigger to monitor subfolders as well
-
Enter the file name of the file the trigger should monitor
-
Indicate one or more event(s) for which the trigger should monitor
NOTE: When you select the option to monitor a new or renamed file, the option INCLUDE EXISTING FILES becomes enabled. Select this option if you wish the trigger to initiate tasks based on files existing in the specified folder at the time the trigger is created.
-
Enter the Monitoring frequency (the acceptable range is from 20 sec to 300 seconds)
-
To log into Sharepoint: You can select to use a credential from the credential vault, or, you can enter another user name and password manually
-
You can use an asterisk as a wildcard for one or more characters within the file name, for example:
-
If you enter the filename
*.docx
, the trigger will look for files with a*.docx
extension (such asinvoice1.docx
andpremium notice.docx
) -
If you enter the filename
*invoice.*
, the trigger will look for files with the wordinvoice
in the filename (such asdecember 2017 invoice.xlsx
andinvoice122017.pdf
)
-
-
-
To select a credential from the credentials vault: Select From vault. Select a credential from the list
-
To add credentials manually: Select Manually. Enter the User name and the Password
Take special care with Microsoft Office files
Microsoft Office creates temporary files when documents are opened. As a result, editing Office files directly within the monitored folder may cause unexpected results (e.g., the trigger may initiate multiple tasks for a single file modification).
Renaming files
When you set the File trigger to monitor renamed file events, keep in mind that the trigger monitors the new name of the file, not the change in the old name.
For example: Say you have set the trigger to monitor the file name 1.2*.exe
and ticked the New (or renamed) file check box. If you change the file to, say, John.exe
, the event will not be identified as a renamed file. However, if you have a file called John.exe
and you change the name to 1.2x.exe
, the renamed file is identified as renamed.