Assets

An asset in Orange Logic is any kind of file or container. An image, a video, a document, a project, and a virtual folder are all assets.

Unique Identifiers

Every asset has a Unique Identifier (sometimes called a System Identifier) that is generated by Orange Logic. In the Orange Logic interface, the unique identifier appears on the Details tab below the asset thumbnail.

Record ID

Every asset in Orange Logci also has a Media Encrypted Identifier (sometimes called a Record ID). In the Orange Logic interface, you can find the media encrypted identifier by right-clicking the asset and selecting Get Link. The media encrypted identifier appears between “asset-management/” and the question mark in the Get Link URL.

You can also retrieve asset identifiers with the Search API. For example, if you have an asset’s unique ID, you can retrieve the asset’s media encrypted identifier. In the following example call, the asset’s unique ID of CTL898546 is used to return its media encrypted identifier of 2RBKT7U02J5F.

/API/search/v4.0/search?query=SystemIdentifier:CTL898546&fields=MediaEncryptedIdentifier

<Items type="List">
<Item>
<SystemIdentifier>CTL898546</SystemIdentifier>
<MediaEncryptedIdentifier>2RBKT7U02J5F</MediaEncryptedIdentifier>
</Item>
</Items>

Formats

When you upload assets, Orange Logic generates various formats that users can download for different purposes. For example, a user might need a lower-quality version of an image for use in an email template.

These proxy files are identified by asset format codes, such as TRX or TR1. You might need to specify an asset format when you use an API to, for example, generate a link to a specific proxy.

Image formats that are often generated on import include:

• TR1: Medium res. (1200px x 1200px).
• TR4: Small thumbnail (352px fixed height).
• TR7: Large thumbnail (192px fixed height).

Your organization can determine the specifications of each proxy, so your Orange Logic instances might use different proxy sizes and asset format codes. An Orange Logic administrator can find a list of asset format codes in the Administration section of the Orange Logic interface.

💡

Tip

You can view your organization’s proxies in the Orange Logic interface by going to Administration > Archives > Asset Formats.

Asset Type and Subtype

All assets stored in Orange Logic have a Type and Subtype.

For example, Image is an asset type. Most organizations have various use cases for images. An event photo and a product photo are both images, but they are used differently. An event photo's metadata might include the event venue, event date, and social media publication. A product photo’s metadata might include the brand, marketing campaign, and SKU number. So, for the Image Asset Type, you might create custom Asset Subtypes called “Event Photo” and “Product Photo.”