Create public links for approved assets automatically

When you have a lot of assets and need to create public links for all of them after they are approved, it's easier and faster to use Sitecore Content Hub's actions and triggers. This way, a public link is created automatically as soon as an asset is approved.

This walkthrough describes how you can automate the creation of public links and describes how to:

Create a script

The first step is to create a script that tells Content Hub to automate the creation of public links for the original asset renditions if the links don't already exist.

To create a script:

On the menu bar, click Manage .
On the Manage page, click Scripts.
On the Scripts page, click Script.

In the Script dialog, fill in the following fields:

Field	Description
Name	A name for your script, for example, CreateAssetPublicLinkOnApproval.
Type	A script type, for example, Action.
Description	An optional description for your script.

Click Save.
On the Scripts page, click the CreateAssetPublicLinkOnApproval script you created.
On the script details page, in the top-right corner, click Edit.

In the script editor, enter the following code:

RequestResponse

using System.Linq;
using System.Threading.Tasks;

var assetId = Context.TargetId;

// Check if public links don't exist yet
var query = Query.CreateQuery(entities => from e in entities
  where e.DefinitionName == "M.PublicLink"
  && e.Parent("AssetToPublicLink") == assetId.Value
  && e.Property("Resource") == "downloadOriginal"
  && e.Property("IsDisabled") == false
  select e);
query.Take = 1;

var result = await MClient.Querying.QueryIdsAsync(query);
if (result.TotalNumberOfResults > 0)
{
  MClient.Logger.Info("Public links already exist for asset with id '" + assetId + "'");
  return;
}

// Create public links
await CreateForRendition("downloadOriginal", assetId.Value);
MClient.Logger.Info("Created public link 'downloadOriginal' for asset with id '" + assetId + "'");

async Task CreateForRendition(string rendition, long assetId)
{
  var publicLink = await MClient.EntityFactory.CreateAsync("M.PublicLink");

  if (publicLink.CanDoLazyLoading())
  {
    await publicLink.LoadMembersAsync(new PropertyLoadOption("Resource"), new RelationLoadOption("AssetToPublicLink"));
  }

  publicLink.SetPropertyValue("Resource", rendition);

  var relation = publicLink.GetRelation<IChildToManyParentsRelation>("AssetToPublicLink");
  if (relation == null)
  {
    MClient.Logger.Error("Unable to create public link: no AssetToPublicLink relation found.");
    return;
  }

  relation.Parents.Add(assetId);

  await MClient.Entities.SaveAsync(publicLink);
}

Click Save changes.
Click Build.
Click Publish.

Create an action

The next step is to create an action based on the CreateAssetPublicLinkOnApproval script.

To create an action:

On the Manage page, click Actions.
On the Actions page, click New action.

In the New action dialog, fill in the following fields:

Field	Description
Name	A name for your action. You can use the script name, namely CreateAssetPublicLinkOnApproval.
Label	Optional label for your action.
Type	A type for this action. For this example, select Action script.
Script	The script you want to use, for example, CreateAssetPublicLinkOnApproval.

Click Save.

Create a trigger

The last step is to create a trigger that will create a public link every time an asset is approved.

To create a trigger:

On the Manage page, click Triggers.
On the Triggers page, click New trigger.

On the trigger creation page, on the General tab, fill in the following fields:

Field	Description
Name	The name of the trigger, for example, CreateAssetPublicLinkOnApproval.
Description	Optionally, enter a label for your action.
Objective	Select Entity creation and Entity modification.
Execution type	Select In process.

On the Conditions tab, click Add definition and, in the drop-down list, click Asset (M.Asset).
In the condition list, select Final lifecycle status, current value, contains, all, and Approved.
On the Actions tab, under Post actions, click Add action and select the action you created.
Click Save and close.
In the Save dialog, click Activate to activate the trigger.

After the trigger is activated, a public link will be created for an asset immediately after it is approved.

Do you have some feedback for us?

If you have suggestions for improving this article,