CloudinaryTransformResources Step

• Add-On

  ---

This step downloads your resources and transforms them on request.

Inputs

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

Name	Datentyp	Beschreibung	Pflichtfeld	Werte
account	ACCOUNT		Ja
limit	STRING	The maximal number of files/rows tro process.	Nein
public_ids	STRING	An comma separated list of Public IDs of assets uploaded to Cloudinary. Can be empty if a spreadsheet with public_ids is given. Global set parameters will be ignored if a public_id has custom settings in this spreadsheet.	Nein
transformations	SPREADSHEET	Optional. Spreadsheet to set parameters per public_id. Global set parameters will be ignored if a public_id has custom settings in this spreadsheet.	Nein
mappingdefinition	STRING	The mapping definition JSON String	Nein
	Folgende Felder sind zu konfigurieren: Feld Datentyp Beschreibung Pflichtfeld Standardwert public_id 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 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
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	Pflichtfeld	Werte
result	SPREADSHEET	The result spreadsheet containing the processing parameters and file uris.	Ja
failed	SPREADSHEET	The spreadsheet containing the failed requests.	Ja
	Folgende Felder sind im Output enthalten: Feld Datentyp Beschreibung Pflichtfeld Standardwert public_id SINGLE Nein asset_id SINGLE Nein filename SINGLE Nein version SINGLE Nein version_id SINGLE Nein signature SINGLE Nein width SINGLE Nein height SINGLE Nein format SINGLE Nein target_format SINGLE Nein resource_type SINGLE Nein created_at SINGLE Nein tags SINGLE Nein bytes SINGLE Nein type SINGLE Nein etag SINGLE Nein placeholder SINGLE Nein url SINGLE Nein folder SINGLE Nein overwritten SINGLE Nein error_message SINGLE Nein
result filelist	FILELIST	List containing all processed files.	Ja