logo
logo

Ordering profiles

Each media type has an ordering profile. An ordering profile is a system configuration that specifies how media content is handled during a download.

Ordering profile content

The following example illustrates an ordering profile:

{
  "supportedConversionTypes": ["Png", "Jpg", "Jpeg", "Gif", "Tif", "Tiff"],
  "presets": [
    {
      "name": "Web",
      "conversion": [
        {
          "type": "colorProfile",
          "value": "sRGB"
        },
        {
          "type": "fileExtension",
          "value": "Png"
        }
      ],
      "isReadOnly": "true"
    }
  ],
  "processingOptions": [
    {
      "type": "colorProfile",
      "values": ["sRGB", "CMYK"]
    },
    {
      "type": "resolution",
      "values": [
        {
          "Unit": "DPI",
          "Value": 72
        },
        {
          "Unit": "DPI",
          "Value": 150
        },
        {
          "Unit": "DPI",
          "Value": 300
        }
      ]
    },
    {
      "type": "fileExtension",
      "values": ["Jpg", "Png", "Tif"]
    }
  ]
}

In this example, there are three sections:

  • Supported conversion types

    This is a list of the file extensions supported by the media engine for conversions.

  • Presets

    Presets are predefined media conversions that are available in the renditions list on the Download options page.

  • Processing options

    This list defines the processing options that are available for custom downloads on the Download options page.

Supported conversion types

This section defines the file extensions that are supported by the media engine for conversions.

"supportedConversionTypes": [
    "Png",
    "Jpg",
    "Jpeg",
    "Gif",
    "Tif",
    "Tiff"
  ]

The supportedConversionTypes property is an array that contains the file extension values. The following table lists valid file extensions.

Media typeExtensions
ImagesRaw, Jpg, Jpeg, Gif, Tga, Bmp, Cr2, Srw, Raf, Orf, Nef, Erf, Dng.
VectorsPng,Ai,Eps, Svg, Psd, Tiff, Tif, Psb.
DocumentsPdf,Pptx, Ppt, Docx, Doc, Xlsx, Xls, Rtf, Txt, Indd,Idml, Key, Csv.
AudioWav, Aif, Aiff, Mp3.
VideosMpeg, Mpg, Flv, Mp4, Mov, Wmv, Avi, WebM, M4v.

Presets

This section predefines a list of media conversions that can be applied from the renditions list on the Download options page. The following example creates a Web conversion preset that applies the sRGB color profile and the Png file extension.

"presets": [
    {
        "name": "Web",
        "conversion":[
            {
                "type":"colorProfile",
                "value":"sRGB"
            },
            {
                "type":"fileExtension",
                "value":"Png"
            }
        ],
        "isReadOnly": "true"
    }
  ]

The presets property is an array of preset objects. Each preset object has the following properties:

  • name

    This property defines the name of the preset, which is visible in the selection list in the Download options page.

  • conversion

    This property is an array of conversion parameters. Each conversion parameter has a type property and a value property. The possible parameter types and values are detailed in the table below.

  • isReadOnly

    This property defines whether the preset instance is read-only. This property can be set to true or false.

Conversion parameters

TypeExampleDescription
FileExtension
{
"type":"fileExtension",
"value":"Png"
}
This parameter defines the target file extension of the conversion (single value).

Possible values:
  • Images: Raw, Jpg, Jpeg, Gif, Tga, Bmp, Cr2, Srw, Raf, Orf, Nef, Erf, Dng.
  • Vectors: Png,Ai,Eps, Svg, Psd, Tiff, Tif, Psb.
  • Documents: Pdf,Pptx, Ppt, Docx, Doc, Xlsx, Xls, Rtf, Txt, Indd,Idml, Key, Csv.
  • Audio: Wav, Aif, Aiff, Mp3.
  • Videos: Mpeg, Mpg, Flv, Mp4, Mov, Wmv, Avi, WebM, M4v.
Resolution
{
"type":"resolution",
"value": {
"Unit": "DPI",
"Value": 150
}
}
This parameter defines the resolution of the preset.

Possible values:
  • Unit: Px, Dpi, Cm, Mm, Kbps, Mbps.
  • Value: The resolution value (integer).
ColorProfile
{
"type": "colorProfile",
"value": "sRGB"
}
This parameter defines the color profile of the preset.

Possible values:
  • sRGB
  • CMYK
ResizeLogic
{
"type": "resizeLogic",
"value": "DoNotResize"
}
This parameter defines the resize logic of the preset.

Possible values:
  • "DoNotResize": Do not resize.
  • "FillFramesProportionally": Fill the frame proportionally.
  • "FitImagesProportionally": Fit the frame proportionally.
Width
{
"type":"width",
"value": 595
}
This property is linked to the Resize logic property. It defines the width of the resize dimension (integer).
Height
{
"type":"height",
"value": 842
}
This property is linked to the Resize logic property. It defines the height of the resize dimension (integer).

Processing options

This section defines the processing options that are available for custom downloads from the Download options page. It specifies the available conversion parameters as well as the available options for each parameter. In the following example, the available processing options are:

  • The color profile field with the possible options: sRGB and CMYK.
  • The resolution field with the possible options: 72, 150 and 300.
  • The file extension field with the possible values: Jpg, Png and Tif.
"processingOptions": [
    {
      "type": "colorProfile",
      "values": [
        "sRGB",
        "CMYK"
      ]
    },
    {
      "type": "resolution",
      "values": [
        {
          "Unit": "DPI",
          "Value": 72
        },
        {
          "Unit": "DPI",
          "Value": 150
        },
        {
          "Unit": "DPI",
          "Value": 300
        }
      ]
    },
    {
      "type": "fileExtension",
      "values": [
        "Jpg",
        "Png",
        "Tif"
      ]
    }
  ]

The processingOptions property is an array of processing option objects. Each processing option object has the following properties:

  • type

    This property defines the type of the conversion parameter. The possible parameter types are detailed in the table below.

  • values

    This property defines the list of values that are available for selection or input. The possible parameter values are detailed in the table below.

Conversion parameters

TypeExampleDescription
FileExtension
{
"type":"fileExtension",
"values":[
"Png",
"Jpg"
]
}
This parameter defines the available target file extensions for the custom download.

Possible values:
  • Images: Raw, Jpg, Jpeg, Gif, Tga, Bmp, Cr2, Srw, Raf, Orf, Nef, Erf, Dng.
  • Vectors: Png,Ai,Eps, Svg, Psd, Tiff, Tif, Psb.
  • Documents: Pdf,Pptx, Ppt, Docx, Doc, Xlsx, Xls, Rtf, Txt, Indd,Idml, Key, Csv.
  • Audio: Wav, Aif, Aiff, Mp3.
  • Videos: Mpeg, Mpg, Flv, Mp4, Mov, Wmv, Avi, WebM, M4v.
Resolution
{
"type":"resolution",
"values": [
{
"Unit": "DPI",
"Value": 72
},
{
"Unit":"DPI",
"Value": 150
}
{
"Unit":"DPI",
"Value": 300
}
]
}
This parameter defines the available resolutions for the custom download.

Possible values:
  • Unit: Px, Dpi, Cm, Mm, Kbps, Mbps.
  • Value: The resolution value (integer).
ColorProfile
{
"type": "colorProfile",
"values": [
"sRGB",
"CMYK"
]
}
This parameter defines the color profile of the preset.

Possible values:
  • sRGB
  • CMYK
ResizeLogic
{
"type": "resizeLogic",
"values": [
"DoNotResize",
"FillFramesProportionally",
"FitImagesProportionally"
]
}
This parameter defines the resize logic options for the custom download. Selecting a different value than "Do not resize" shows the "Width" and "Height" fields in the selection UI.

Possible values:
  • "DoNotResize": Do not resize.
  • "FillFramesProportionally": Fill the frame proportionally.
  • "FitImagesProportionally": Fit the frame proportionally.
Width
{
"type":"width",
"values": [
200,
300
]
}
This property is linked to the Resize logic property. It defines the width of the resize dimension (integer).

Leave this value empty to enable user input during selection.
Height
{
"type":"height",
"values": [
200,
300
]
}
This property is linked to the Resize logic property. It defines the height of the resize dimension (integer).

Leave this value empty to enable user input during selection.
Note

In the processing options, leave the Width and Height values empty to enable user input during the selection of the custom download properties.

{
"type":"width",
"values": []
},
{
"type":"width",
"values": []
}
"exclusions": []

Edit the ordering profile

  1. On the menu bar, click Manage .

  2. On the Manage page, click Taxonomy and then click the M.AssetMedia taxonomy.

  3. Choose the media type to edit and click Show detail.

  4. Click Edit to start editing the taxonomy details.

  5. Select the preferred JSON editing format (Form, Text, or Tree) and make the required changes.

  6. Click Save.

Can we improve this article ? Provide feedback