Breadcrumbs

Define an IF Condition

Beginning in version 23.253, FileCloud supports expressions, special conditions based on user and path owner properties.

The workflow If a user's account is near its expiration date is available in FileCloud 23.251 and later.

Not all actions are compatible with all conditions. 

When you create a workflow, you must select a condition to act as a trigger.

  • Depending on the trigger, additional parameters may be required. 

  • Once a Condition is selected, compatible Actions can be selected.

Where do I set up the condition?

When you create a new Workflow, you will be able to select a condition.

IfCondition.png
Where do I add my parameters?

After you select a Condition, then you can enter any parameters, such as a date or time.

If you need more information about what parameters are required, look below the Required Parameters box.

Parameters.png

Available Conditions

Client App Conditions

If any new client app connects
image-20251205-205332.png

Workflow Condition

Parameters

Description

If any new client app connects

No parameters required

This condition is triggered when an external (non-browser) client connects to FileCloud Server.

For example, this condition will trigger for clients such as:

  • FileCloudSync

  • FileCloudDrive

  • iOS

  • Android App

Available expression variables: User Context variables.
For instructions on including expressions, see Using Expressions in IF Conditions

File Conditions

If a file is created
image-20251209-190948.png

Workflow Condition

Parameters

Description

If a file is created

{ 
"parent_folder_path_string":"/userid/somepath", 
"use_regex":"1", 
"exclude":"1" 
}

This condition will be triggered if a file is created via any means (Browser, Clients, etc.)

parent_folder_path_string - required as a parameter for this condition to trigger. If the condition needs to be triggered for all folders, then you can set it to be "/". For help specifying the path correctly, see Identifying a FileCloud Specific Path.

use_regex (optional) - specifies how the folder path is validated.

  • 0 or unspecified = use an exact match for the parent folder path string

  • 1 = use a regular expression match for the parent folder path string

exclude (optional) - specifies the system should only perform the action on non-matching paths (do not perform the action on matching paths).

Available expression variables: User Context variables, Path Context variables.
For instructions on including expressions, see Using Expressions in IF Conditions

If a file is updated

Workflow Condition

Parameters

Description

If a file is updated.

{ 
"parent_folder_path_string":"/userid/somepath", 
"use_regex":"1", 
"exclude":"1" 
}

This condition will be triggered if a file is updated.

parent_folder_path_string - required as a parameter for this condition to trigger. If the condition needs to be triggered for all folders, then you can set it to be "/". For help specifying the path correctly, see Identifying a FileCloud Specific Path.

use_regex (optional) - specifies how the folder path is validated.

  • 0 or unspecified = use an exact match for the parent folder path string

  • 1 = use a regular expression match for the parent folder path string

exclude (optional) - specifies the system should only perform the action on non-matching paths (do not perform the action on matching paths).

Available expression variables: User Context variables, Path Context variables.
For instructions on including expressions, see Using Expressions in IF Conditions

If a file is deleted

Workflow Condition

Parameters

Description

If a file is deleted

{ 
"parent_folder_path_string":"/userid/somepath", 
"use_regex":"1", 
"exclude":"1" 
}

This condition will be triggered if a file is deleted.

parent_folder_path_string - required as a parameter for this condition to trigger. If the condition needs to be triggered for all folders, then you can set it to be "/". For help specifying the path correctly, see Identifying a FileCloud Specific Path.

use_regex (optional) - specifies how the folder path is validated.

  • 0 or unspecified = use an exact match for the parent folder path string

  • 1 = use a regular expression match for the parent folder path string

exclude (optional) - specifies the system should only perform the action on non-matching paths (do not perform the action on matching paths).

Available expression variables: User Context variables, Path Context variables.
For instructions on including expressions, see Using Expressions in IF Conditions Available expression variables: User Context variables, Path Context variables.
For instructions on including expressions, see Using Expressions in IF Conditions

If file is downloaded

Workflow Condition

Parameters

Description

If a file is downloaded

{ 
"parent_folder_path_string":"/userid/somepath", 
"use_regex":"1", 
"exclude":"1" 
}

This condition will be triggered if a file is downloaded

parent_folder_path_string - required as a parameter for this condition to trigger. If the condition needs to be triggered for all folders, then you can set it to be "/". For help specifying the path correctly, see Identifying a FileCloud Specific Path.

use_regex (optional) - specifies how the folder path is validated.

  • 0 or unspecified = use an exact match for the parent folder path string

  • 1 = use a regular expression match for the parent folder path string

exclude (optional) - specifies the system should only perform the action on non-matching paths (do not perform the action on matching paths).

Available expression variables: User Context variables, Path Context variables.
For instructions on including expressions, see Using Expressions in IF Conditions

If a file is added or updated

Workflow Condition

Parameters

Description

If a file is added or updated

{ 
"parent_folder_path_string":"/userid/somepath", 
"use_regex":"1", 
"exclude":"1" 
}

This condition will be triggered if a file is added or updated

parent_folder_path_string - required as a parameter for this condition to trigger. If the condition needs to be triggered for all folders, then you can set it to be "/". For help specifying the path correctly, see Identifying a FileCloud Specific Path.

use_regex (optional) - specifies how the folder path is validated.

  • 0 or unspecified = use an exact match for the parent folder path string

  • 1 = use a regular expression match for the parent folder path string

exclude (optional) - specifies the system should only perform the action on non-matching paths (do not perform the action on matching paths).

Available expression variables: User Context variables, Path Context variables.
For instructions on including expressions, see Using Expressions in IF Conditions

If file was not modified/created in specified days
2025-12-04_14h16_38.png

Workflow Condition

Parameters

Description

If a file was not modified/created in specified days

{
  "parent_folder_path_string": "/johndoe",
  "number_of_days": 7,
  "skip_recently_accessed": 1,
  "exclude_recyclebin": 1,
  "exclude": ".*secret.*"
}

This condition will be triggered if a file was not created [specified days] ago or has not been updated for [specified days].

  • This is useful for removing old files that are no longer being used

  • This check will run once a day

parent_folder_path_string - required as a parameter for this condition to trigger.

  • If the condition needs to be triggered for all folders, then you can set it to be "/". For help specifying the path correctly, see Identifying a FileCloud Specific Path.

  • NOTE: ONLY Managed storage paths are supported for this condition.

number_of_days - required to specify the number of days before the current date that a file was last modified.

  • This will be checked once a day and all files that match this condition will be subject to the THEN action you choose.

  • For example, if you specify the number of days as 15, all files in the specified folder that have not been modified in the last 15 days will subject to the the THEN action you configure.

skip_recently_accessed - required to specify whether files that were viewed or downloaded during the number of days are considered modified. Default is false, viewed or downloaded files are not considered recently modified. When true, files viewed or downloaded within number_of_days are considered modified and will not be included in the Then action.

exclude_recyclebin - (added in FileCloud version 21.3) optional (default is false) When true, files in recycle bin are not considered.

exclude - (added in FileCloud version 22.1) optional - specifies the system should only perform the action on non-matching paths (do not perform the action on matching paths).

trigger_date - (added in FileCloud version 23.253) optional (default is BOTH) - specifies which field to use as the date the file was last modified.
Use one of the following values:
BOTH - (default) Check if the CREATED_DATE and the MODIFIED_DATE are the specified number of days ago or more.
CREATED_DATE - Check if the CREATED_DATE is the specified number of days ago or more.
MODIFIED_DATE - Check if the CREATED_DATE is the specified number of days ago or more.

Available expression variables: User Context variables.
For instructions on including expressions, see Using Expressions in IF Conditions

If the file uploaded is bigger than the expected size
IfFileBiggerThanExpected.png

Workflow Condition

Parameters

Description

If the file uploaded is bigger than expected size.

{ 
"size":"4" 
}

This condition will be triggered when an uploaded file is bigger than the size specified.

size - specifies the maximum expected file size in MB.

Available expression variables: User Context variables.
For instructions on including expressions, see Using Expressions in IF Conditions

If the file downloaded is bigger than the expected size

Workflow Condition

Parameters

Description

If the file downloaded is bigger than expected size.

{ 
"size":"4" 
}

This condition will be triggered when a downloaded file is bigger than the size specified.

size - specifies the maximum expected file size in MB.

Available expression variables: User Context variables.
For instructions on including expressions, see Using Expressions in IF Conditions

Folder Conditions

If a folder is created

Workflow Condition

Parameters

Description

If a folder is created

{ 
"parent_folder_path_string":"/userid/somepath", 
"use_regex":"1", 
"exclude":"1" 
}

This condition will be triggered when a folder is created in the system

parent_folder_path_string - required as a parameter for this condition to trigger. If the condition needs to be triggered for all folders, then you can set it to be "/". For help specifying the path correctly, see Identifying a FileCloud Specific Path.

use_regex (optional) - specifies whether system uses an exact match for the parent folder path string ("use_regex": "0" or missing) or whether to use a regular expression match ("use_regex":"1")

exclude (optional) - specifies the system should only perform the action on non-matching paths (do not perform the action on matching paths).

Available expression variables: User Context variables, Path Context variables.
For instructions on including expressions, see Using Expressions in IF Conditions

If a folder is deleted

Workflow Condition

Parameters

Description

If a folder is deleted

{ 
"parent_folder_path_string":"/userid/somepath", 
"use_regex":"1", 
"exclude":"1" 
}

This condition will be triggered when a folder is deleted

parent_folder_path_string - required as a parameter for this condition to trigger. If the condition needs to be triggered for all folders, then you can set it to be "/". For help specifying the path correctly, see Identifying a FileCloud Specific Path.

use_regex (optional) - specifies whether system uses an exact match for the parent folder path string ("use_regex": "0" or missing) or whether to use a regular expression match ("use_regex":"1")

exclude (optional) - specifies the system should only perform the action on non-matching paths (do not perform the action on matching paths).

Available expression variables: User Context variables, Path Context variables.
For instructions on including expressions, see Using Expressions in IF Conditions

User Account Conditions

If a user's last login is older than...
UsersLastLogin.png


Workflow Condition

Parameters

Description

If a user's last login is older than ...

{

"last_login_days_ago": 30, "user_account_type": "USER_ACCOUNT_LIMITED_ACCESS", "day_interval": 1, "skip_users_not_logged_in": 1, "skip_admin_users": 0, "include_domain": "domain.com", "exclude_domain": "subdomain.domain.com,@otherdomain.com" }

 

For example, every five days to check for full access users who have not logged in for the last 30 days.
Omit them from this check if they have never logged in or are promoted admins.

{ "last_login_days_ago": 30, "user_account_type": "USER_ACCOUNT_FULL_ACCESS", "day_interval": 1,     "skip_users_not_logged_in": 1, "skip_admin_users": 1,


}


If a user's last login is older than the specified number of days, then the THEN condition you configure will be run. 
last_login_days_ago: Number of days since last login.
user_account_type - type of account. You must use one of the following values:

  • USER_ACCOUNT_ANY

  • USER_ACCOUNT_FULL_ACCESS

  • USER_ACCOUNT_GUEST_ACCESS

  • USER_ACCOUNT_LIMITED_ACCESS (for external users)

  • USER_ACCOUNT_DISABLED

day_interval - the number of days between checks

  • For daily operation, specify a value of 1

skip_users_not_logged_in (optional): Skip users who have never logged in to the system. This enables you to only apply the action to users who are already using the system. Values are true and false.

skip_admin_users (added in FileCloud 23.251) Optional. Do not include promoted admins. 
0 (default) - Include promoted admins 
1 - Do not included promoted admins

Available expression variables: User Context variables.
For instructions on including expressions, see Using Expressions in IF Conditions

If a new user is created
image-20251209-193327.png

Workflow Condition

Parameters

Description

If a new user is created ...

None

When a new user account is created, the THEN action you configure will be triggered.

Optional Parameters

auth-type - Type of authentication. This is optional and can be:

  • DEFAULT

  • ACTIVEDIRECTORY

  • LDAP

user_access_level: Account access level. This is optional and can be:

  • USER_ACCOUNT_ANY_ACCESS (default)

  • USER_ACCOUNT_FULL_ACCESS

  • USER_ACCOUNT_GUEST_ACCESS

  • USER_ACCOUNT_LIMITED_ACCESS (for external users)

user_login_method: How user authenticates. This is optional and can be:

  • LOGIN_METHOD_ANY (default)

  • LOGIN_METHOD_DEFAULT

  • LOGIN_METHOD_SSO

Available expression variables: User Context variables (_user.email, _user.username)
For instructions on including expressions, see Using Expressions in IF Conditions

If a user's account is older than
UserAccountOlder.png


Workflow Condition

Parameters

Description

If a user's create date is older than

Available in FileCloud Version 23.232

{
"days": 30,
"include_domain": "contractor.com",
"exclude_domain": "subdomain.domain.com,@otherdomain.com"
}


For example, if a user's account was created more than 60 days ago
and it is in the domain contractor.com

{ "days": 60, "include_domain": "contractor.com", }

This condition is triggered when a user's create date is older than the number of days specified in days.

Parameters

days - Required. When a user's create date is older than this number of days, the condition is triggered.

Available expression variables: User Context variables.
For instructions on including expressions, see Using Expressions in IF Conditions

If a user's account is near its expiration date
image-20251209-194405.png


Workflow Condition

Parameters

Description

If a user's account is near its expiration date

{ "days_to_expiry": 10, "days_interval": 5, "skip_admin_users": 1 }


For example, When a user's account is set to expire in 15 days, perform an action such as sending the user an email. Send the email again every 5 days, but the last 5 days, send the email every day. Do not perform the action on promoted admins.

{ ""days_to_expiry": 15, "days_interval": 5, "skip_admin_users": 1


}


days_to_expiry - Number of days before account expiration

days_interval - (optional)

At what interval to perform the action again after it is performed the first time. During the last interval, the action is performed every day. Default is 5 days. For example:

  • Action is "Send an email"

  • days_to_expiry = 15

  • days_interval = 5

An email is sent at 15 days before account expiration, 10 days before account expiration and 5, 4, 3, 2, and 1 days before account expiration.

skip_admin_users Optional. Do not include promoted admins. 
0 (default) - Include promoted admins 
1 - Do not included promoted admins

Interval Logic

During the last interval, the action is executed every day. For example:

  • Action: "Send an email"

  • days_to_expiry = 15

  • days_interval = 5

An email is sent at 15 days before account expiration, 10 days before account expiration and 5, 4, 3, 2, and 1 days before account expiration.


Other Conditions

If a comment is added

https://fileclouddocs.atlassian.net/wiki/s/1331239570/6452/c11dd4bd07a44814325c72b7051d9159888992e7/_/images/icons/emoticons/lightbulb_on.png Comments can be added to files and folders.

IfCommentAdded.png

Workflow Condition

Required Parameters

Description

If a comment is added

{ 
"parent_folder_path_string":"/userid/somepath", 
"use_regex":"1", 
"exclude":"1" 
}

Available expression variables: User Context variables.
For instructions on including expressions, see Using Expressions in IF Conditions

This condition will be triggered when a comment is added

parent_folder_path_string - required as a parameter for this condition to trigger. If the condition needs to be triggered for all folders, then you can set it to be "/". For help specifying the path correctly, see Identifying a FileCloud Specific Path.

use_regex (optional) - specifies whether system uses an exact match for the parent folder path string ("use_regex": "0" or missing) or whether to use a regular expression match ("use_regex":"1")

exclude (optional) - specifies the system should only perform the action on non-matching paths (do not perform the action on matching paths).

Available expression variables: User Context variables, Path Context variables.
For instructions on including expressions, see Using Expressions in IF Conditions

Perform an action periodically at specified time and interval
2024-04-09_13h36_47.png

Workflow Condition

Parameters

Description

Perform an action periodically at specified time and interval

{ 
"time_string":"16:45:05",
"day_interval":"7"
}

This condition will be triggered when the current time on the FileCloud Server matches the supplied time.

day_interval - number of days that passes after a THEN action before it is triggered again.

  • The THEN action you choose will be triggered every "day_interval" days.

  • If the "day_interval" is 1, it is done daily

time_string - the time of day when you want the THEN action triggered

  • The matching time includes the time zone

  • The time is specified in a 24-hour format of Hours, minutes, seconds

start-date - Date that FileCloud begins checking for the condition

end-date - Last date that FileCloud checks for the condition.

Available expression variables: None.

Perform an action on the specified date
SpecifiedDate.png

Workflow Condition

Parameters

Description

Perform an action on the specified date

{
"date_string":"2020-01-11"
}

When the date matches the supplied date and time, the THEN action you configure will be run.

date_string - date and time in a 24-hour format

  • yyyy-mm-dd H:i:s

Available expression variables: None.

Perform an action periodically

Workflow Condition

Parameters

Description

Perform an action periodically

None. The frequency depends on how you configure the cron or task scheduler frequency.

This requires you to set up one of the following:

  • cron job

  • task scheduler

Available expression variables: None.

If share has not been accessed for specified days
ShareNotAccessed.png

Workflow Condition

Parameters

Description

If a share has not been accessed for specified days

{ 
"share_permission":["PUBLIC", "PRIVATE"],
"number_of_days":"180", 
}

This condition will be triggered when a shared file or folder has not been accessed for the specified number of days. 

  • NOTE: The only supported action is Delete share.

  • This is useful for removing shared files that are no longer being used

  • This check will run once a day

number_of_days - required to specify the number of days before the current date that a shared file was accessed.

  • This will be checked once a day and all files that match this condition will be subject to the THEN action you choose.

  • For example, if you specify the number of days as 15, all shared files or folders that have not been accessed in the last 15 days will subject to the the THEN action you configure.

Available expression variables: Share Context variables.
For instructions on including expressions, see Using Expressions in IF Conditions