Wait for Drive
The Wait for Drive action waits for a specific drive to be mapped or unmapped.
Note: The Actions Quick Reference provides a complete list of actions that you can print for easy reference.
Create a Wait for Drive action
-
Ensure that the user who will be running this action is a local administrator and/or the bot is running as an administrator.
-
In Nintex Bot, on the Actions list, click Computer and select Wait for Drive.
-
Select the Drive letter. Optionally, click the Magic Wand to use the Expression Builder.
-
Select to Wait for the Drive to appear or Drive to disappear.
-
In the timing settings, select how long wait for the drive to appear or disappear.
-
If needed, adjust the Run error task settings to fine tune how the action runs.
- Run error task: A botflow containing an error task automatically runs the error task in the event of an error. If the botflow does not contain an error task, the botflow stops in the event of an error.
- Stop on error: The botflow stops in the event of an error.
- Ignore errors: The action is skipped in the event of an error and the botflow attempts to execute the next action.
-
(Optional) Add a Note to document special instructions or functionality.
-
Toggle the run switch to Run and click OK to execute and save the action.
Note: The run switch is set to Run by default. To create or modify this action without executing it, click the slider to change the option to Don't Run. For more information, go to Action Builder.
When the action is executed, Nintex Bot will first get the letters of all drives and then check each one against the drive letter that you set up in the action. If the drive is found, then that means that it is mapped. If the drive is not found, then it is not mapped. Nintex Bot will wait for the drive by letter, and then depending on the settings, it will succeed or fail.
Here are examples of how the action works, depending on the settings:
-
If the drive is not found and you set up the action to wait to disappear, the action was successful.
-
If the drive is found and you set up the action to wait to appear, the action was successful.
-
Nintex Bot will continue to check for the desired condition until the timing constraints are met or the conditions are met.
-
If the 'Wait for' setting is not satisfied and the condition is not met, Nintex Bot will pause for 500 milliseconds and try again by getting all the mapped drives and then comparing the letters.
-
If you selected 'Do not wait' in the timing settings, Nintex Bot will only try to find the drive once and then return a success or failure message.
-
If you selected to 'Wait up to' a specific time in the timing settings, Nintex Bot will pause for 500 milliseconds and then try again. If the action conditions are met, then it will return a success message. If the action conditions are not met and the timing constraints have been met, the action will return a failure message, or it will continue to retry until the specified wait time has been reached or the condition has been met.
-
If you selected to wait forever in the timing settings, Nintex Bot will continue to attempt to pause for 500 milliseconds and try again by getting all the mapped drives and then comparing the letters until the conditions are met, the execution is paused or stopped, or the application is closed. This is not recommended.
-