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.

PropertyValuesDescriptionRequires restart?
asset.expire.enabledtrue / falseIf 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.No
image.expire_assets_actionnotVisible, autoTask, delete, or a folder path

The following values are accepted for this property:

  • autotask: Expired assets will trigger any autotask with expiration criteria
  • delete: Expired assets will be deleted from NetX. 
  • notVisible: Expired assets will become invisible to non-administrator level users.
  • folder path: If the value of this property corresponds to a NetX folder path, e.g. /top level folder/subfolder/more subfolders, expired assets will be moved to the named folder. 

No

Setting expiration for a single asset

Context menu

  1. Right-click an asset's thumbnail while viewing a gallery or the dashboard
  2. Select Expiration from the context menu.
  3. 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

  1. Navigate to an asset's detail page.
  2. Use the asset's action menu; select Expiration.
  3. 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

  1. Navigate to an asset's detail page.
  2. 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. 
  3. A confirmation dialogue will appear; click Yes.

Context menu

  1. Right-click an asset's thumbnail while viewing a gallery or the dashboard
  2. Select Expiration from the context menu.
  3. Choose Unset expiration.
  4. A confirmation dialogue will appear; click Yes.

Setting expiration for multiple assets

Selection bar

  1. Select the assets to be expired.
  2. Use the action menu of the selection bar and select Expiration.
  3. Choose Set expiration.
  4. Either use the calendar picker or input a date by hand; the format is yyyy-mm-dd.

Context menu

  1. Right-click an asset's thumbnail while viewing a gallery or the dashboard
  2. Select Expiration from the context menu.
  3. Choose Set expiration.
  4. Either use the calendar picker or input a date by hand; the format is yyyy-mm-dd.


Clearing expiration for multiple assets

Selection bar

  1. Select any assets with expiration dates you would like to clear.
  2. Use the action menu of the selection bar and select Expiration.
  3. Choose Unset expiration.
  4. A confirmation will appear; click Yes. This will remove all expiration dates from all assets in your selection.

Context menu

  1. Right-click an asset's thumbnail while viewing a gallery or the dashboard
  2. Select Expiration from the context menu.
  3. Choose Unset expiration.
  4. A confirmation will appear; click Yes. Note that if there is an 


Customizing expiration events with AutoTasks 

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>
CODE