Roles

These are the roles that are needed:

  • Admin
  • Can delete custom actions
  • Can read custom actions
  • Can write custom actions

Custom Actions

A custom action is like a manually triggered webhook. Instead of, as a webhook, being triggered on an event when the specified action happens in iconik, the custom actions let you trigger a manual call from within the iconik GUI and then calls the configured server.

Create a Custom Action

  1. Click on ADMIN in the top navigation.
  2. Choose Settings from the left navigation bar.
  3. Choose Custom Actions from the menu that appears from under the Settings icon.
  4. On the top of the list:
    1. Select the title for the custom action.
    2. Add the URL which the custom action shall POST a message to.
    3. Select from what context the trigger can be called.
      • ASSET - lets you manually trigger an asset from the asset's page or the search page.
      • COLLECTION - lets you manually trigger a collection from the collection's page or the search page.
      • BULK - lets you manually trigger multiple marked entities from the search page.
    4. You may choose to add a metadata view that can be filled in when the custom action is triggered.
  5. Click + ADD to add the action.

Trigger a Custom Action.

It is possible to trigger a custom action from the entity's page or the search page.

Entities

From the entity's page

Go to the entity's page then:

  1. In the upper right corner click on the gear.
  2. The custom actions which have the correct context will be visible in the dropdown list.
  3. Click on the custom action which you want to trigger.
  4. If a metadata view is linked to the custom action a window with the metadata view will appear, fill it in and click SUBMIT.

From the search page

Go to the search page then:

  1. Right click on the entity which you want to trigger.
  2. The custom actions which have the correct context will be visible in the dropdown list.
  3. Click on the custom action which you want to trigger.
  4. If a metadata view is linked to the custom action a window with the metadata view will appear, fill it in and click SUBMIT.

Bulk

To trigger a bulk go to the search page then:

  1. Mark multiple entities from the search page.
  2. Right click on one of the marked entities.
  3. The custom actions which have the Bulk context will be visible in the dropdown list.
  4. Click on the custom action which you want to trigger.
  5. If a metadata view is linked to the custom action a window with the metadata view will appear, fill it in and click SUBMIT.

Update a Custom Action

On the admin page:

  1. Choose Settings from the left navigation bar.
  2. Choose Custom Action from the menu that appears from under the Settings icon.
  3. Double-click on the field for the custom action which you wish to change, the field will then be editable. If you wish to update more than one field, double-click on all the fields you wish to change.
  4. Edit the fields.
  5. Click to update the custom action.

Delete a Custom Action

On the Admin page:

  1. Choose Settings from the left navigation bar.
  2. Choose Custom Actions from the menu that appears from under the Settings icon.
  3. Find the custom action in the list which you wish to delete.
  4. Click on the X icon to the right of the custom action if you still wish to delete it.
  5. Confirm by clicking