Skip to content

CloudinaryTransformUpload - Cloudinary

← Cloudinary Add-On Übersicht

This step uploads and transforms your images in one step. The modified images will be saved to your Cloudinary storage.


Inputs

Das sind die Optionen, mit denen man den Step konfigurieren kann.

Name Datentyp Beschreibung Pflichtfeld Werte
account ACCOUNT Ja
files FILELIST The files to be uploaded to Cloudinary. Ja
file transformations SPREADSHEET Optional. Spreadsheet to set parameters per file. The file has to be present in the input filelist. Global set parameters will be ignored if a file is present in this spreadsheet. Nein
mappingdefinition STRING The mapping definition JSON String Nein
Folgende Felder sind zu konfigurieren:

Feld Datentyp Beschreibung Pflichtfeld Standardwert
filename SINGLE The name of the file. Has to be present in the input filelist. Otherwise the corresponding row will be ignored. Ja
asset_folder SINGLE The folder where the asset is placed within the Cloudinary repository. Nein
upload_preset SINGLE Name of an upload preset that you defined for your Cloudinary product environment. An upload preset consists of upload parameters centrally managed using the Admin API or from the Upload page of the Console Settings. An upload preset may be marked as unsigned, which allows unsigned uploading directly from the browser and restricts the optional parameters to: public_id, folder, tags, context, face_coordinates and custom_coordinates. Nein
tags SINGLE A comma-separated list of tag names to assign to an asset that replaces any current tags assigned to the asset (if any). Nein
context SINGLE A pipe-separated list of the key-value pairs of contextual metadata to attach to an uploaded asset. The context values of uploaded files can be retrieved using the Admin API. For example: alt=My image❘caption=Profile image Nein
metadata SINGLE A pipe-separated list of custom metadata fields (by external\_id) and the values to assign to each of them. For example: in_stock_id=50❘color_id=[\"green\",\"red\"]. Nein
crop_mode SINGLE If the requested dimensions have a different aspect ratio than the original, these modes crop out part of the image. Nein
resize_mode SINGLE These modes adjust the size of the delivered image without cropping out any elements of the original image. Nein
gravity_mode SINGLE When used with cropping modes that crop out part of an image, the gravity qualifier specifies which part of the original image to keep when one or both of the requested dimensions is smaller than the original. Nein
quality SINGLE Cloudinary's intelligent quality and encoding algorithm analyzes an image to find the best quality compression level and optimal encoding settings based on the image content and the viewing browser, in order to produce an image with good visual quality while minimizing the file size. Cloudinary automates the file size versus quality trade-off decision, on the fly using perceptual metrics and heuristics that tune the quality settings based on the specific image content and format. Analyzing every image individually to find the optimal compression level and image encoding settings allows for precise adjustment of the compression level complemented by fine tuning of the encoding settings, and can significantly reduce the file size without any degradation noticeable to the human eye. Nein
width SINGLE You can set the target dimensions of your resized image by specifying width, height, and/or the target aspect ratio as qualifiers of your resize transformation. Using an integer value for w (width) or h (height) sets the new dimension to that number in pixels. For example, w_150 sets the width to exactly 150 pixels. Using a decimal value for width or height sets the new dimension relative to the original dimension. For example, w_0.5 sets the width to half the original width. Nein
height SINGLE Nein
aspect_ratio SINGLE Aspect ratios are specified as follows: -a:b where a signifies the relative width and b the relative height (e.g., ar_4:3 or ar_16:9). -a decimal value representing the ratio of the width divided by the height (e.g., ar_1.33 or ar_2.5). 1.0 is a perfect square. Nein
opacity SINGLE Adjust the opacity of an image using the opacity transformation. Specify a value between 0 and 100, representing the percentage of transparency, where 100 means completely opaque and 0 is completely transparent. Nein
content_aware_padding SINGLE You can automatically set the background color to the most prominent color in the image when applying one of the padding crop modes (pad, lpad, or mpad) by setting the background parameter to auto. For more parameters (gradient, color number, direction) visit the documentation at: https://cloudinary.com/documentation/transformation_reference#b_auto Nein
background_color SINGLE Use the background parameter to set the background color of the image. The image background is visible when padding is added with one of the padding crop modes, when rounding corners, when adding overlays, and with semi-transparent PNGs and GIFs. An opaque color can be set as an RGB hex triplet (e.g., b_rgb:3e2222), a 3-digit RGB hex (e.g., b_rgb:777) or a named color (e.g., b_green). Cloudinary's client libraries also support a # shortcut for RGB (e.g., setting background to #3e2222 which is then translated to rgb:3e2222). You can also use a 4-digit or 8-digit RGBA hex quadruplet for the background color, where the 4th hex value represents the alpha (opacity) value (e.g., co_rgb:3e222240 results in 25% opacity). Nein
borders SINGLE Add a solid border around images with the border parameter. The parameter accepts a value with a CSS-like format: width_style_color (e.g., 3px_solid_black). An opaque color can be set as an RGB hex triplet (e.g., rgb:3e2222), a 3-digit RGB hex (e.g., rgb:777) or a named color (e.g., green). You can also use a 4-digit or 8-digit RGBA hex quadruplet for the color, where the 4th hex value represents the alpha (opacity) value (e.g., co_rgb:3e222240 results in 25% opacity). Additionally, Cloudinary's client libraries also support a # shortcut for RGB (e.g., setting color to #3e2222 which is then translated to rgb:3e2222), and when using Cloudinary's client libraries, you can optionally set the border values programmatically instead of as a single string (e.g., :border => { :width => 4, :color => 'black' }). For more options visit: https://cloudinary.com/documentation/transformation_reference#bo_border Nein
artistic_filter SINGLE Apply artistic filters to the image. Nein
advanced_filter SINGLE See respective reference for more options: cartoonify: https://cloudinary.com/documentation/transformation_reference#e_cartoonify pixelate: https://cloudinary.com/documentation/transformation_reference#e_pixelate sepia: https://cloudinary.com/documentation/transformation_reference#e_sepia vignette: https://cloudinary.com/documentation/transformation_reference#e_vignette Nein
target_format SINGLE Target image format. Leave empty to retain original. If no valid extension is specified, source format will be used. Nein
custom_properties SINGLE Set you own custom transformation operation. If set all other parameters will be ignored. For full transformation documentation visit: https://cloudinary.com/documentation/image_transformations Nein
limit STRING The maximal number of files/rows tro process. Nein
upload preset STRING Upload presets enable you to centrally define a set of asset upload options instead of specifying them in each upload call. You can define multiple upload presets and apply different presets in different upload scenarios. Nein
transformation quality STRING Target transformation quality (auto modes or in percent). Nein
  • disabled
  • auto
  • best
  • good
  • eco
  • low
  • 100
  • 80
  • 50
  • 35
  • 20
transformation width STRING Target transformation width (in pixels). Select default to keep original width. Nein
  • default
  • 1000
  • 500
  • 250
  • 150
  • 100
  • 50
  • 30
transformation height STRING Target transformation height (in pixels). Select default to keep original height. Nein
  • default
  • 1000
  • 500
  • 250
  • 150
  • 100
  • 50
  • 30
transformation cropping mode STRING If the requested dimensions have a different aspect ratio than the original, these modes crop out part of the image. Nein
  • none
  • fill
  • lfill
  • fill_pad
  • crop
  • thumb
transformation resize mode STRING These modes adjust the size of the delivered image without cropping out any elements of the original image. If resize mode is selected, the crop mode will be ignored. Nein
  • none
  • scale
  • fit
  • limit
  • mfit
  • pad
  • lpad
  • mpad
transformation gravity mode STRING When used with cropping modes that crop out part of an image, the gravity qualifier specifies which part of the original image to keep when one or both of the requested dimensions is smaller than the original. Nein
  • none
  • auto
  • face
  • center
  • north_east
  • north
  • north_west
  • west
  • south_west
  • south
  • south_east
  • east
transformation custom properties STRING With this parameter custom transformation properties can be set. All other transformation properties are ignored if this parameter is set. For more information visit this cloudinary documentation at: <b>https://cloudinary.com/documentation/image_transformations</b> Nein
transformation target format STRING Target image format. Select default to retain original. Nein
  • default
  • auto select
  • BMP
  • GIF
  • HEIF
  • JPEG
  • JPEG 2000
  • JPEG XR
  • PNG
  • SVG
  • TIFF
  • WebP

Outputs

Das sind die Ergebnisse des Steps, die von nachfolgenden Steps, nach der Ausführung verwendet werden können.

Name Datentyp Beschreibung Werte
result SPREADSHEET The result spreadsheet containing the processing parameters and file uris.
failed SPREADSHEET The spreadsheet containing the failed requests.
Folgende Felder sind im Output enthalten:

Feld Datentyp Beschreibung Standardwert
original_filename SINGLE
asset_id SINGLE
public_id SINGLE
version SINGLE
version_id SINGLE
signature SINGLE
width SINGLE
height SINGLE
format SINGLE
target_format SINGLE
resource_type SINGLE
created_at SINGLE
tags SINGLE
bytes SINGLE
type SINGLE
etag SINGLE
placeholder SINGLE
url SINGLE
secure_url SINGLE
folder SINGLE
overwritten SINGLE
error_message SINGLE
result filelist FILELIST List containing all processed files.