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.

NameDatentypBeschreibungPflichtfeldWerte
accountACCOUNTJa
filesFILELISTThe files to be uploaded to Cloudinary.Ja
file transformationsSPREADSHEETOptional. 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
mappingdefinitionSTRINGThe mapping definition JSON StringNein
Folgende Felder sind zu konfigurieren:

FeldDatentypBeschreibungPflichtfeldStandardwert
filenameSINGLEThe name of the file. Has to be present in the input filelist. Otherwise the corresponding row will be ignored.Ja
asset_folderSINGLEThe folder where the asset is placed within the Cloudinary repository.Nein
upload_presetSINGLEName 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
tagsSINGLEA comma-separated list of tag names to assign to an asset that replaces any current tags assigned to the asset (if any).Nein
contextSINGLEA 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 imageNein
metadataSINGLEA 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_modeSINGLEIf the requested dimensions have a different aspect ratio than the original, these modes crop out part of the image.Nein
resize_modeSINGLEThese modes adjust the size of the delivered image without cropping out any elements of the original image.Nein
gravity_modeSINGLEWhen 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
qualitySINGLECloudinary'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
widthSINGLEYou 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
heightSINGLENein
aspect_ratioSINGLEAspect 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
opacitySINGLEAdjust 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_paddingSINGLEYou 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_autoNein
background_colorSINGLEUse 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
bordersSINGLEAdd 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_borderNein
artistic_filterSINGLEApply artistic filters to the image.Nein
advanced_filterSINGLESee 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_formatSINGLETarget image format. Leave empty to retain original. If no valid extension is specified, source format will be used.Nein
custom_propertiesSINGLESet 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
limitSTRINGThe maximal number of files/rows tro process.Nein
upload presetSTRINGUpload 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 qualitySTRINGTarget transformation quality (auto modes or in percent).Nein
  • disabled
  • auto
  • best
  • good
  • eco
  • low
  • 100
  • 80
  • 50
  • 35
  • 20
transformation widthSTRINGTarget transformation width (in pixels). Select default to keep original width.Nein
  • default
  • 1000
  • 500
  • 250
  • 150
  • 100
  • 50
  • 30
transformation heightSTRINGTarget transformation height (in pixels). Select default to keep original height.Nein
  • default
  • 1000
  • 500
  • 250
  • 150
  • 100
  • 50
  • 30
transformation cropping modeSTRINGIf 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 modeSTRINGThese 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 modeSTRINGWhen 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 propertiesSTRINGWith 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 formatSTRINGTarget 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.

NameDatentypBeschreibungWerte
resultSPREADSHEETThe result spreadsheet containing the processing parameters and file uris.
failedSPREADSHEETThe spreadsheet containing the failed requests.
Folgende Felder sind im Output enthalten:

FeldDatentypBeschreibungStandardwert
original_filenameSINGLE
asset_idSINGLE
public_idSINGLE
versionSINGLE
version_idSINGLE
signatureSINGLE
widthSINGLE
heightSINGLE
formatSINGLE
target_formatSINGLE
resource_typeSINGLE
created_atSINGLE
tagsSINGLE
bytesSINGLE
typeSINGLE
etagSINGLE
placeholderSINGLE
urlSINGLE
secure_urlSINGLE
folderSINGLE
overwrittenSINGLE
error_messageSINGLE
result filelistFILELISTList containing all processed files.