NetX's Asset Expiration feature allows you to assign a date to an asset, on which a preset action will trigger. This feature can be used in a variety of scenarios, such as automatically hiding assets whose licenses have expired or deleting assets when they are no longer needed to free up storage space.
Expiration dates are effective at midnight UTC; all configured expiration actions will trigger at this time.
Setup
The properties below are used to enable and configure asset expiration.
| Property | Description |
|---|---|
asset.expire.enabled |
If the value of this property is true, asset expiration will be enabled. If the value of this property is false, the asset expiration feature will not be available via the UI or AutoTask. Value options: true / false Requires restart? No |
image.expire_assets_action |
The following values are accepted for this property:
Value options: notVisible / autoTask / delete / a folder path Requires restart? No |
Setting expiration for a single asset
Context menu
- Right-click an asset's thumbnail while viewing a gallery or the dashboard.
- Select Expiration from the context menu.
- Either use the calendar picker or input a date by hand; the format is yyyy-mm-dd. A flag will appear at the top-right corner of the asset's thumbnail indicating that the asset is set for expiration.
Asset detail
- Navigate to an asset's detail page.
- Use the asset's action menu; select Expiration.
- Either use the calendar picker or input a date by hand; the format is yyyy-mm-dd. A flag will appear at the foot of the window indicating the date of its expected expiration. In addition, a red indicator will appear the top-right corner of the asset's thumbnail in the gallery.
Clearing expiration for a single asset
Asset detail
- Navigate to an asset's detail page.
- Either use the asset's action menu to select Expiration then Clear expiration, or the x that appears in the expiration flag at the foot of the to-be-expired asset's detail page.
- A confirmation dialogue will appear; click Yes.
Context menu
- Right-click an asset's thumbnail while viewing a gallery or the dashboard.
- Select Expiration from the context menu.
- Choose Unset expiration.
- A confirmation dialogue will appear; click Yes.
Setting expiration for multiple assets
Selection bar
- Select the assets to be expired.
- Use the action menu of the selection bar and select Expiration.
- Choose Set expiration.
- Either use the calendar picker or input a date by hand; the format is yyyy-mm-dd.
Context menu
- Right-click an asset's thumbnail while viewing a gallery or the dashboard.
- Select Expiration from the context menu.
- Choose Set expiration.
- Either use the calendar picker or input a date by hand; the format is yyyy-mm-dd.
Clearing expiration for multiple assets
Selection bar
- Select any assets with expiration dates you would like to clear.
- Use the action menu of the selection bar and select Expiration.
- Choose Unset expiration.
- A confirmation will appear; click Yes. This will remove all expiration dates from all assets in your selection.
Context menu
- Right-click an asset's thumbnail while viewing a gallery or the dashboard.
- Select Expiration from the context menu.
- Choose Unset expiration.
- A confirmation will appear; click Yes. Note that if there is an
Customizing expiration events with AutoTasks
Autotasks that use the expire action must also have the property image.expire_assets_action set to autoTask
Configuring expiration workflows via AutoTask allow you to more specifically determine what occurs when an asset is expired by setting a task's trigger criteria to expire. For information regarding AutoTasks and their actions, see AutoTasks.
In the following example, once an asset is expired the value of its Status attribute will become Diogenes' barrel; a notification email will then be sent to all members of the NetX group Admins of Refuse.
<autotask>
<task name="Asset Expiration Task">
<matchCriteria type="and">
<criteria type="action" value="expire"/>
</matchCriteria>
<modifications>
<modify type="attribute" name="Status" value="Diogenes' barrel"/>
</modifications>
<notifications>
<notify emailTemplate="notifyAdminExpiration.tpl" groupName="Admins of Refuse" type="email"/>
</notifications>
</task>
</autotask>