Operations
Each time you set up an entity operation, you make that operation available on an entity details page. This process involves configuring several categories of settings including:
- Display - set the display format, icon, label, and button style for the operation.
- Operation - define the behavior of the operation.
- Visibility - specify the conditions that determine if an operation is visible.
- Permissions - set the permissions required for an operation to be visible.
You can also specify which operations are available when you add a Selection component. The list of potential operations depends on the entity definition associated with the page.
The following sections describe the page operations available in Sitecore Content Hub and list associated operation settings.
Add label
Applicable to: content
Use this operation to add labels to a selection of project content.
Operation settings
Add to entity
Applicable to: assets, collections, content, print, products, projects
Use this operation to link a child entity to a parent entity. You can, for example, add the Add to entity operation to the Asset details page so users can add an asset to a product.
If you have Read permission but not Update permission on the parent entity, an error occurs at the validation step.
Operation settings
Add to saved selection
Applicable to: assets, collections, content
Use this operation to share a selection of assets with other users. You can, for example, add the Add to saved selection operation to the Asset details page so that users can add assets to a saved selection.
Annotate
Applicable to: assets
Use this operation to provide feedback by adding comments to an entity as part of a review process. You can, for example, add the Annotate operation to the Asset details page so that users can comment on assets.
API keys
Applicable to: collections
Use this operation to create an authentication API key to access the Preview API or the Delivery API.
For an example of the API keys operation, see API keys and Content collection details.
Operation settings
Approve
Applicable to: assets
Use this operation to move assets from the Under review status to the Approved status. Other examples include MRM jobs and CMP flow. You can, for example, add the Approve operation to the Selection component on the Review page.
Operation settings
Archive
Applicable to: assets
Use this operation to move entities in a state flow to the Archived assets page. This lets you move assets from the Approved status to the Archived status. You can, for example, add the Archive operation to the Asset details page so that users can archive assets they no longer need.
Operation settings
Assign state flows
Applicable to: assets, collections, content, print, products, projects
Use this operation to add an entity to a state flow. You can, for example, add the Assign state flows operation to the Content details page so users can add or remove an entity from a state flow.
Attach to campaign
Applicable to: content
Use this operation to add content to a campaign. You can, for example, add the Attach to campaign operation to the Ideas page during the ideation process.
Check in
Applicable to: Adobe InDesign, Adobe Illustrator, and Adobe Photoshop documents.
Use this operation to check in assets previously checked out of Content Hub.
Operation settings
Check out
Applicable to: Adobe InDesign, Adobe Illustrator, and Adobe Photoshop documents.
Use this operation to check out assets from Content Hub to Adobe InDesign, Illustrator, or Photoshop.
Operation settings
Create draft
Applicable to: assets
Use this operation to adapt and reuse items using drafts. This lets you maintain the intent, style, tone, and context of the original item and edit items without directly applying the changes to the original version. You can also save a modified item as a standalone item. You can, for example, add the Create draft operation to the Content details page so users can create a draft of assets.
Operation settings
Create variant
Applicable to: content
Use this operation to create variants of existing entities to customize content for a specific target group (for example, audience, market, country, culture, and so on). You can customize any entity definition (for example, content, product, and so on). You can, for example, add the Create variant operation to the Product details page so users can create a product variant.
Operation settings
Delete
Applicable to: assets, collections, content, print, products, projects
Use this operation to delete an entity. Users are redirected to a different page depending on the lifecycle status the asset had before it was deleted:
Lifecycle status | Redirection page |
---|---|
Created | /pages/{uiCulture}/Create |
UnderReview | /pages/{uiCulture}/WaitingRoom |
Approved | /pages/{uiCulture}/Assets |
Archived | /pages/{uiCulture}/ArchivedAssetsOverview |
Operation settings
Detach from original
Applicable to: content, products
Use this operation to apply a copy profile to a variant, causing it to become a standalone entity that is detached from the original. You can, for example, add the Detach from original operation on the Content details page so users can detach content or products from the original.
Operation settings
Direct publish
Applicable to: assets
Use this operation to move an asset from the Created status to the Approved status, without the asset passing through the Under Review status.
Operation settings
Discard checkout
Applicable to: assets
Use this operation to discard a checked out entity (for example, discarding an asset checked out in Sitecore Connect for Creative Cloud.
Download
Applicable to: assets, collections, content
Use this operation to convert the selected entity files before downloading entity renditions. You can, for example, add the Download operation to the Asset details page so users can download content, assets, or collections.
Operation settings
Duplicate
Applicable to: content
Use this operation to create a copy of an original entity. You can, for example, add the Duplicate operation to the Content details page so users can create a duplicate of content.
Operation settings
Edit
Applicable to: assets, collections, content, print, products, projects
Use this operation to edit one or more entities through a defined page. You can, for example, add the Edit operation to the Assets page and then select the Mass edit page for editing the selected assets.
Operation settings
Edit in table
Applicable to: assets
Use this operation to perform a mass update of the metadata for multiple selected entities. You can, for example, add the Edit operation to the Assets page and then select the Asset mass edit table page for editing the selected assets.
Operation settings
External actions
Applicable to: assets, collections, content, print, products, projects
Use this operation to execute one or more preconfigured actions.
Operation settings
Find duplicate files
Applicable to: assets
Use this operation to display a list of duplicate files for an entity. You can, for example, add the Find duplicate files operation to the Asset details page to let users locate duplicate assets.
An asset is flagged as a duplicate if the file representing its current version is also used as any version of another asset. This means that if you upload a new version of an existing asset and the new file is not used for any other assets, the updated asset is not considered a duplicate even if it was one previously. However, any version of an asset that uses the same file as another asset is flagged as a duplicate, even if the asset itself is not. You can use the Find duplicate files operation for any asset or file that is flagged as a duplicate.
To determine whether two entities are duplicates, the system compares each one's Digest value. This is a string of 40 characters used to distinguish the properties of the underlying data.
Check an asset’s Digest value
Generate PDF
Applicable to: assets, collections, content, print, products, projects
Use this operation to generate a PDF from a list of entities.
Operation settings
Move to trash
Applicable to: assets
Use this operation to move assets to the trash. The assets in your trash are visible on your My trash page. This is known as a soft deletion, as opposed to a hard deletion where an asset is deleted permenantly. For example, you can add the Move to trash operation to the Asset details page so that users can move assets to trash.
Operation settings
OneDrive checkout
Applicable to: assets
Use this operation to upload a checked-out file to OneDrive. The asset is locked in Content Hub until the file is checked back in.
OneDrive download
Applicable to: assets
Use this operation to download files from Content Hub to OneDrive. Files are not tracked and assets remain unlocked.
Overwrite values
Applicable to: content
Use this operation to specify how the values of a variant or a draft are created and which fields are overwritten. You can, for example, add the Overwrite values operation to the Content details page so users can select a new campaign to overwrite the current selection.
Operation settings
Preview
Applicable to: assets
Use this operation to view entity details without leaving the Search page or losing the search progress. You can, for example, add the Preview operation to the Asset details page so users can display an inline preview of an asset.
Operation settings
Public links
Applicable to: assets
Use this operation to share assets with external people who do not have permission to download the assets. This functionality provides an unsigned public link to any pre-generated file rendition of an asset. Content Hub can auto-generate a publicly accessible link to all the existing renditions of an asset.
To create public links, you must have the appropriate user group permissions.
Operation settings
Publish entities to delivery platform
Applicable to: assets, collections, content, print, products, projects
Use this operation to publish an entity definition or publish entity definition members.
Operation settings
Refresh renditions
Applicable to: assets
Use this operation to perform a mass refresh of the renditions for an entity.
Operation settings
Reject
Applicable to: assets
Use this operation to reject an asset awaiting review, reverting the asset's status to Created and preventing it from being Approved until someone makes the necessary changes and resubmits it for another review. For example, you can add the Reject operation to the Selection component on the Review page so that users can reject an asset and send it back for a rework.
Remove from collection
Applicable to: assets, collections, content
Use this operation to remove one or more entities from a collection. You can, for example, add the Remove from collection operation to the Selection component on the Collection page so users can remove entities from a collection.
Operation settings
Remove from saved selection
Applicable to: assets, collections, content
Use this operation to remove entities from a saved selection. You can, for example, add the Remove from saved selection operation to the Asset details page so that users can remove assets from a saved selection.
Remove label
Applicable to: content
Use this operation to remove labels from a selection of project content.
Operation settings
Request download
Applicable to: assets
Use this operation to submit a request to download an asset, which involves specifying when and how the asset will be used in accordance with digital rights management. For example, you can add the Request download operation to the Selection component on the Assets page so that users can request to download assets.
Operation settings
Restore
Applicable to: assets
Use this operation to restore an asset from the My trash page.
Operation settings
Save
Applicable to: assets, collections, content, print, product, projects
Use this operation to save changes made to entities.
Operation settings
Save as new
Applicable to: content
Use this operation to save an entity as a new version. You can, for example, add the Save as new operation to the Content details page so users can save drafts as new versions of their content.
Operation settings
Send to content
Applicable to: assets
Use this operation to send assets to the Sitecore Digital Asset Management (DAM) system. They are given a status of Created using the status identifier M.Final.LifeCycle.Status.Created. You can, for example, add the Send to content operation to the Project content page so that when users upload a file and click Send to content, the project content changes into a DAM asset, and its status changes to Created.
The file remains available in the project.
Operation settings
Share via email
Applicable to: assets
Use this operation to send an email with links to a selection of assets. In this way, you can share multiple assets with multiple recipients at the same time. You can, for example, add the Share via email operation to the Asset details page so users can send links to various assets to others by email.
To use the Share via email operation, you must have the ShareViaEmail permission. DownloadOriginal and Order permissions are not mandatory in this case. To learn more about permissions, see User group policies.
State flow transitions
Applicable to: assets, collections, content, print, products, projects
Use this operation to display the status of an entity that is in a state flow. You can, for example, add the State flow transitions operation to the Content details page so users can see the status of the content. You can configure this operation to either display every state flow linked to the entity, or display a single specific state flow.
Operation settings
Submit for approval
Applicable to: assets
Use this operation to send an asset for approval.
For more information, see Adobe InDesign.
Operation settings
Submit
Applicable to: content
Use this operation to submit an entity for approval. For example, submitting a draft for approval or submitting a content idea for approval.
Operation settings
Toggle switch
Applicable to: assets, collections, content, print, products, projects
Use this operation to add a toggle switch to a particular field.
Operation settings
Unarchive
Applicable to: assets
Use this operation to restore archived entities.
Operation settings
Unlink
Applicable to: assets
Use this operation to unlink an entity from another entity, for example, unlinking an asset from a usage right.
Operation settings
Unlock
Applicable to: assets
Use this operation to unlock assets that have been locked. Assets are locked when checked out to OneDrive or when you create a draft. They stay locked until a reviewer approves or discards the draft or the asset is checked in.
Use this operation only if the normal flow of unlocking an asset with a check in from OneDrive or by approving a draft does not work. When you unlock assets with this operation, the draft or OneDrive flow no longer works.
Operation settings
Unpublish entities from delivery platform
Applicable to: assets, collections, content, print, products, projects
Use this operation to unpublish entity definitions or unpublish entity definition members from the delivery platform.
Operation settings
Upload
Applicable to: assets
Use this operation to upload files to an entity, for example, to upload assets or to upload a new version of an asset.
Operation settings
Usage
Applicable to: assets
Use this operation to track the usage and the impact of published entities.
Operation settings
User access
Applicable to: collections
Use this operation to define access to a content collection.
Use direct link
Applicable to: assets
Use this operation to access the direct or gateway link to an asset.
You can enable the following renditions in the media processing flow:
- Big thumbnail (chili_bigthumbnail)
- Chili Lowres PDF (chili_pdf_lowres)
- Chili PDF (chili_pdf)
- Portal large (portal_large)
- Order (property:MainFile)
- Metadata (metadata)
- PDF (pdf)
- Vision analysis (vision_analysis)
- Print massive (print_massive)
- Extracted content (txt)
- Portal massive (portal_massive)
- MP3 (mp3)
- WEBM (webm)
- Storyboard (storyboard)
- Vision ready (vision_ready)
- Portal medium (portal_medium)
- Vision OCR (vision_ocr)
- mp4
- Video analysis metadata (videoai_metadataVideoIndexer)
- Video analysis storyboard keyframe (videoai_storyboardKeyframesVideoIndexer)
- Video analysis storyboard faces (videoai_storyboardFaceVideoIndexer)
- webvtt (webvtt)
Operation settings
Variants
Applicable to: content
Use this operation to display the variants of an entity.
Operation settings
Version history
Applicable to: content
Use this operation to view the changes over time to all versions of a content item.
View ancestor details page
Applicable to: content
Use this operation to view the detail page of the content's ancestor.
Operation settings
View detail page
Applicable to: assets, collections, content, print, products, projects
Use this operation to open the details page of an entity.
This operation is not available if the selected rendition does not exist for the asset. If no rendition is selected, the operation is always visible.
Operation settings
View details
Applicable to: assets, collections, content, print, products, projects
Use this operation to view related details of an entity in a new window.
This operation is not available if the selected rendition does not exist for the asset. If no rendition is selected, the operation is always visible.
Operation settings
View draft
Applicable to: content
Use this operation to view the draft or variant created from an original entity.
Operation settings
Applicable to: content
Use this operation to view the original content used to create a draft or variant.
Operation settings
View related entity
Applicable to: assets, collections, content, print, products, projects
Use this operation to view related entities and navigate to a specific related entity with a single click. An entity relation links to the related entity resources. For example, you can add this operation to an Entity operations component on the Content details page to see related campaigns where the relation is CampaignToContent and the details page is ContentCampaignDetail.