Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
We offer a list of Scaleflex's DAM most popular connectors with brief descriptions on how to set them up.
Integrate Hygraph with DAM by Scaleflex to bring in and manage your digital assets seamlessly from the DAM as the Single Source of Truth.
With this application, users can upload, store, edit, manage, optimize, enrich and automate their media assets right within their Hygraph UI, saving time and better enhancing their workflow.
Publish your Media Assets directly from within Hygraph with the Media Asset Widget:
As Original
: This option is available for all assets. Adds them to the content entry as is, as a preview or downloadable element.
As Transformation
: This option is only available for image assets. It lets you modify the image format, quality, size, and even to crop part of it.
This integration is developed and maintained by our partner Hygraph.
Useful resources:
CI-Hub allows you to easily open and modify assets stored in the Scaleflex DAM using Office365, Google, Figma, and Adobe software. It also allows to add a seamless integration of your Scaleflex DAM library as an extension of your own personal computer storage with the CI-Hub Drive connector, that adds a Cloud-connected "additional drive" to your Windows Explorer or Apple Finder.
A complete list of the compatible software tools for use with CI-Hub can be found .
In order to access your DAM assets in the programs mentioned above, you must have:
an active user account in Scaleflex DAM
an active licence registered in CI-Hub (ask your administrator or point of contact)
an access (account or licence) to the software you wish to use for asset modification
installed the corresponding CI-Hub integration (aka. add-on, extension) for that software.
Please check for detailed instructions for your software.
Open the CI-Hub integration panel in the desired software and click the "Login" button
Use your CI-Hub credentials on the page "Sign in to CI HUB" and switch back to the application
Validate your Scaleflex DAM connection and authenticate
[first time] Add a connection to Scaleflex (the [+] icon on the right) and connect using your DAM credentials on the dedicated page, select your Project identifier to connect to
[following times] Reload your connection to Scaleflex (the "refresh" icon at the bottom)
Please note: When you log into your Scaleflex DAM account, and select the project you wish to grant access to via CI-Hub, you must use the name shown in the top right of the Scaleflex DAM interface:
The CI-Hub connector allows you to preview files available in DAM, then to select them for export and open them in your preferred software tool. You may modify the content within that tool and then upload the new version of the file back to Scaleflex DAM. The upload is not automatic and occurs only after the user selects this option.
The connector allows you to search for files and inspect their metadata as well.
Some types of files cannot be opened in certain software. This is a limitation of the software itself and it comes from the "specialisation" of what it is doing. For example, video files cannot be opened using the CI-Hub connector for Adobe Photoshop, nor can Excel sheets be opened using the connector for InDesign.
The Gallery and User Role permissions in Scaleflex DAM may affect the number of files accessible via CI-Hub, as well as the actions that can be applied to them. For example, if a folder is hidden from a specific user in Scaleflex DAM, its content will also be unavailable for that user in CI-Hub. Also, if the user does not have a permission to upload new files in Scaleflex DAM, it may result in a failure to upload the modified file version back to DAM after editing within the specified software.
Some software have file size limitations when importing assets from DAM. Known use cases are:
the integration with Google Slides that do not allow assets bigger than 8MBs. In such cases a solution could be to open the file in Powerpoint or in some of the products of Adobe.
Figma allows images with dimensions up to 4096x4096px to be imported.
The CI-Hub connector needs to actively be connected to Scaleflex DAM in order to fetch the assets content from the Storage, you therefore need to be online and have a steady internet connection.
DAM Akeneo connector app
The DAM Akeneo app offers the following features:
One DAM token supports only one Akeneo EE Instance. One Akeneo EE Instance however can use multiples DAM tokens
Metadata sync locales and code of metadata need to match.
Asset Manager
Medialink Type only: Link Sync
Akeneo Entity Reference
Image Type: Binary sync
Text type: Link sync
Size setting
Support at family level (Asset Manager), Entity level (Entity Reference) for specific Scope and Locale
Metadata sync to Attribute
Support Global
Support value per locale
You need an active DAM account. if you don't already have one;
Your Akeneo plan needs to be Enterprise Edition.
After login to Akeneo, navigate to Connect / App Store and Find the DAM by Scaleflex App
Then click Connect: You will be redirected to the Asset Hub and will be able to choose which token you want to use for your Akeneo EE instance
Each Token can be used for only one Akeneo EE Instance
Multiple Akeneo instance can use the same Token
After selecting your token and clicking Active, you will be redirected back to Akeneo
Then please Confirm that you give App access to the Akeneo EE instance
After confirmation, you will be redirected back to DAM
Choose to go to Setting
View the Asset Library
1. General Settings
General settings:
Enable / Disable: If disabled, you cannot use Akeneo Sync feature on DAM
Default size: Default image size will be used if there are no configs related to each asset
Default function: Crop or Fit
Please click Apply change to update configuration
After updating the settings, please refresh the DAM browser page
Size settings: please see the size section below
Sync all setting / Best fit for newcomers
2. Size Settings
How does it work?
Can be duplicated
Priority: Bottom to Top, and it will apply the first matching setting only
Example: An Asset with these information:
Scope: commerce / Locale: en_US / Family: filerobotmedia
Will try to match setting following the steps bellow:
First try: Type: Asset / Family: filerobotmedia / Scope: commerce / Locale: en_US
Second try: Type: Asset / Family: All Items / Scope: commerce / Locale: en_US
Third try: Type: Global / Scope: commerce / Locale: en_US
Use default setting
Add new
(1) To add new size setting click Add new size on the top right
Explanation
(1) Type - currently the app supports 3 types
Global: Affects all assets including entity and asset
Asset: Asset Family
Entity: Entity Reference
(2) If we choose Asset or Entity, we can also choose which attribute family(asset manager) or entity(entity reference) will be applied this setting
We can also choose All Items to apply to all Family / Entity
(3) / (4) Scope and Locale
To choose locale you muse choose a scope first / can choose No Scope
There are 4 cases which can happen:
(5) / (6) Function and Size
Function: Crop and Fit
Size of asset to be resized
Must follow format: width x height, example: 300x400
Edit / Delete
(1) Click on Edit on each setting
Same as Add new
You can delete by clicking the Delete button on the opened Modal
Synchronize Media
(1) On each Asset / Click Detail
(2) You can choose which type to sync
Entity: Entity reference
Asset: Asset Manager
(3) On Sync Asset Tab
Choose Family or Entity
Choose attribute(For Entity support two types: Text(Link sync) and Image(Binary Sync)
There are 4 cases that can happen:
Value per channel and value per locale are both false: Can sync without choose scopes or locales
Value per locale is true, value per channel is false: Must choose at least one locale
Value per locale is false, value per channel is true: Must choose at least one scope
Value per channel and value per locale are both true: Must choose at least one scope and locale
Entity Code(Entity Ref): Code -> You can search for old code, or create new one.
(4) To check sync history, Click Sync Logs
(5) You can see which locales and scopes were synced by clicking View on each item
Only support attribute with following settings:
Value per locale: true / Value per channel: false
Value per locale: false / Value per channel: false
Configuration step:
(1) Go to store config
(2) In Regional variants, Add new group
(3) Option setting
(3.1) Name of Group - Can be anything you want
(3.2) / (3.3) Code of Locale / Must match the setting in Akeneo / See picture bellow
Metadata setting
(1) Click to manage, Metadata tab; you can add new Group then Add new field
(2.1) API Value must match (3.1) Attribute code(in Entity / Asset Manager Family)
If (3.2) is uncheck then (2.2) is None else (2.2) must specific a Regional variants group as we did above with Same setting as Akeneo locales
How to sync
After configuration, everything is automatic for the mapping between two systems
On each Asset detail(1) you can see Metadata tab(2), You can change value by locale or value only(if value per locale is false)(3) , then click Done(4) to save the value
OneTeg is a no-code integration platform as a service (iPaaS) content and data exchange solution. It allows for easy integration between the Scaleflex DAM and other systems that can run on the Cloud or On-Prem, to solve the complexities of content unification and data synchronization while providing user-driven flows for a simplified integration across platforms.
A complete list of the compatible third party software connected to Scaleflex DAM can be found .
In order to access your DAM assets in the programs mentioned above, you must have:
an active user account in Scaleflex DAM
an active licence registered in OneTeg (ask your administrator or point of contact)
Connect to your OneTeg Dashboard
Define the Scaleflex connection {your_company}.oneteg.com/en/connections
Open the Workflow builder: {your_company}.oneteg.com/en/flows
Click the [+] icon on the top right corner to add a workflow
Build using the block editor (drag & drop, configure elements individuallly)
Save
Full headless access to the Scaleflex DAM library and functions (ref below).
Exemple of workflows
Library of flows:
Details and setting of a flow
The process of uploading the edited version back to DAM depends on the filename of the new file and the configuration of your . If you choose the same filename and folder as the existing asset, be aware that if DAM Storage is set to 'New version,' the file will be uploaded on the top of the existing asset. If it is set to 'Overwrite,' the new file will replace the previous version, and the older file will be lost. If it is set to 'Refuse upload,' you will need to change the filename to import the new file back to the Scaleflex DAM.
You need to login to first
Navigate to Settings / Developement / Akeneo PIM to open the Setting page. Alternatively, you can follow this
The App | Akeneo |
---|
You must close the asset popup and open again to make new metadata available to sync(5)
Connection configuration: you will need to use an API key ( find it there )
No Scope + No Locale | Value per locale: False Value per channel: False |
Scope + No Locale | Value per locale: False Value per channel: True |
No Scope + Locale | Value per locale: True Value per channel: False |
Scope + Locale | Value per locale: True Value per channel: True |
Prismic Headless CMS integration
Instead of using the /list
endpoint (API documentation), this API supports Prismic's format directly.
This endpoint lists the assets with the following settings:
50 elements per pages
ordered by last_update
GET {API_SECRET_KEY}@api.filerobot.com/{TOKEN}/integration/prismic/assets
Property | Description |
---|---|
Parameter | Description |
---|---|
Copy-paste the cURL request in your Terminal to see the API in action.
The response format will look like this:
Where:
results_size is the total counting of the listing result; and could be easily understood as the sum of size(results)
of all pages, while each page contains a maximum of 50 files.
image_url is fixed to be resized to 100x100
description would be returned as a concatenation from blob->meta->search
and blob->meta->tags
and the parsed list of directories and sub-directories. In case the file doesn't have this field (and is at the root folder), it defaults to No description for this file is available
.
DAM Pabbly integration
Pabbly connects more than 800+ software products for seamless real-time data transfer. Their simple integration platform allows anyone to seamlessly integrate DAM with other applications to automate workflows.
You can request for demo if you don't have a DAM Account.
After logging in DAM, you need to login to Pabbly Connect.
In the Actions seaction, search for Filerobot by Scaleflex.
Choose Action Event or Trigger Event from the drop down input and confirm with Connect:
You can find your token and the API key in DAM Asset Hub: Developers / API Secret Keys.
Once you save your Token and API key, you don't need to enter it again for another action event by selecting "Select Existing Connection" option.
Triggers are events that occur in DAM and that events data are sent to Pabbly. DAM Pabbly connector has the following triggers:
DAM Pabbly connector has the following actions and corresponding inputs:
Have a Kontent CMS setup. https://kontent.ai/
Add custom element
Content model (left hand side) > Create new > Custom element (right hand side). You will then have the below view.
**Hosted code URL: https://scaleflex.cloudimg.io/v7/plugins/filerobot-kontent/filerobot-custom-element.html?func=proxy
Parameters:
note: "dir" element is optional, by default will go to the root folder of your library. Do not add "/" at the end of the directory string.
Create new content with this Custom Element
Content & asset (left hand side) > Create new > Chose type: Your_Type_Name. Chose and add some images, publish. You will then have the below view.
The images below are the images added in from the Widget into a Kontent content-item. When they are added, they will have DAM-URLs (instead of their Strapi CMS URLs).
Tutorial: https://kontent.ai/learn/tutorials/develop-apps/build-strong-foundation/set-up-preview/
Go to Settings > API Keys. For this, you will need your Project ID. You may also need your API Key (depends on what you want to do, but for simple things Project ID is enough).
Write a client app that utilizes the Delivery API
Recall that Kontent have 3 sets of APIs that you can interact with
Delivery APIs in plain HTTPS form can be downloaded from https://kontent.ai/learn/tutorials/develop-apps/get-started/postman-collection/ and imported into POSTMAN
For the 3 content items that come out of the box, Kontent already have an example client app, which we can imitate.
This example app was made by using React JS https://github.com/kontent-ai/sample-app-react
Hosted on various Github Pages.
After writing and hosting your client app, go to Settings > Preview URLs and define your Preview URL formats.
See how Kontent defined their preview URLs for their example app:
Codename
, URLSlug
& ItemId
are obtained as follows:
Once you done all the above, you can preview by clicking Preview:
https://scaleflex.zendesk.com/hc/en-gb/requests/new or hello@scaleflex.com
DAM Zapier integration
Zapier connects over 3,000 different tools, applications, and services you need to manage your business. Their simple integration platform allows anyone to seamlessly integrate DAM with other applications to automate workflows.
The DAM integration allows to:
Setup a trigger when a new file is uploaded to DAM (useful for setting up notifications, transforming uploaded files or using other tools)
Upload new files to DAM
Transform files in DAM (this is done by adding transformation functions to the file CDN link)
Search for existing files and folders
Create folders
Start a new Zap and add a tool to start the trigger with. It can be DAM or any other tool. DAM can either start the Zap or execute the actions for the trigger coming from other tools, as shown in the example below.
Once the DAM trigger/action is added, you will be asked to "Choose account" to connect to DAM.
New browser window will pop up asking for authentication details to DAM Asset Hub.
DAM Token can be found in the DAM Asset Hub project selector and next to the project title. While DAM API Secret Key is available in Settings > Access > Security templates (tab) menu in the DAM Asset Hub. Make sure the API Secret Key has the minimum required permission for the actions of the Zap.
Once done, you have successfully connected your DAM account to your Zapier account.
After the account is successfully configured and authenticated, you will be able to set up the triggers and actions for execution.
When selecting the Folder Path, if you leave it as a default option, it will only do actions on the Root folder of your DAM account. When looking for a specific folder, you can add the folder path manually or use the search function for exiting folders in the Root folder path.
DAM Commercetools connector app
Nginx
PM2
Nodejs > v16.10.0
Certbot
To install the DAM module, please follow the steps below:
1.
2. Upload and unzip to the server at your domain path (Ex: /var/www/public_html/)
3. Configuration Commercetools & DAM plugin (Read )
4. Go to the source folder and run "npm install", "npm run build" (this command will build and create a folder public)
5. Go to the folder public and run "pm2 serve --spa".
6. Config your domain, port you will run with Nginx and create SSL with Certbot For example, config with port 8080:
Configure the DAM module as follow:
For Commercetools project:
Clone file custom-application-config.example.mjs and rename to custom-application-config.mjs
Input your Commercetools configuration
Set your entryPointUriPath at src/constants.js
For the DAM module:
Clone file filerobot-config.json.example in folder "src" and rename to filerobot-config.json
Input your DAM token, SEC, upload directory, and any other options as fitting.
In left-menu, select Scaleflex DAM > Products
In this page select your product variant need to upload/update image
To add new image, click on "Add Image" in view page Variant Detail
Select an image on the widget and click on "Insert" button to add the image.
Note: You can select multiple images.
Trigger Name | Description |
---|---|
Action Name | Description | Inputs |
---|---|---|
Get the applicationId and entryPointUriPath of Commercetools
API_SECRET_KEY
can be generated in the Asset hub (documentation)
TOKEN
your DAM token
folder
the path to the folder you would like to list default: /
page
the result page number, starting from 1 default: 1
File Upload
It is fired when a new file is uploaded to Filerobot.File details are sent.
File Upload
Used to upload remote hosted files to DAM
Origin File Url,File name
File Delete
Delete file from DAM
File UUID
File Rename
Used to rename file.
File UUID,File new name
Folder Create
Create new folder in DAM.
Folder path
Folder Delete
Delete folder in DAM
Folder UUID
Folder Rename
Rename folder in DAM
Folder UUID,Folder new name
Folder List
Lists all folders details
(N.A.)
DAM Shopify app
The DAM x Shopify App can be installed from the Shopify App Store.
Create a support request to be helped adding the App to your store.
Have a DAM account, with the DAM App installed. If you don't have an account yet, please contact us to get one;
Create the Security Template Identifier (SEC) to use the app (Settings > Access > Security templates tab > Add template)
You need to have a store on Shopify.
In Shopify, open the DAM app in the Apps menu item and click the button “Configuration”
Fill-in your DAM token, CNAME (not required), Security Template Identifier (SEC), Upload Directory (not required, the default will be "/"), and press “Save”
Add DAM snippets to your theme: In modal Configuration, click the button “Update Snippets” to update or create new DAM snippets in your theme store.
Add product webhooks for actions create/update/delete, that will check and update images from DAM Hub when the user has a permission to create/update/delete.
In Shopify, open the DAM app from the Apps menu item.
Click the button “Sync All Product Media”. The process will run in the background for a few minutes depending on the number of images in your store. It will download all product images from Shopify and store them in your DAM Library.
Fill in your product name. Then press "Sync":
You can add DAM images to your website by editing your theme's code.
The following snippets provide the functionality to display images on your website:
filerobot-image-tag.liquid: Builds an image tag with multiple sources to render product images on your website lazily, applying transformations.
filerobot-product-media.liquid: Uses filerobot-image-tag to render product images on your website, with optional transformations.
filerobot-url.liquid: This will help you build a DAM URL to deliver an image on your website with any transformations that you want to apply.
You can use these snippets in your theme's code, referencing them in other snippets or sections.
You can use filerobot-image-tag.liquid or filerobot-url.liquid to display DAM image on your page
First you will need to assign variable fr_metafields
:
Example:
To render image tag
Example:
To get DAM image url
Example:
Note: Read more about attribute optimizer following this LINK
Require:
Configuration of your application in Shopify
Installing the Product Webhook
To import multiple images you need to follow the document of Shopify: https://help.shopify.com/en/manual/products/import-export/using-csv#adding-multiple-product-images
Copy the image URL in the Hub and paste the URL to the column Image Src in the CSV file. After that, you can use the function "Import" on the Products page to update the product with your CSV file.
Example file:
When Shopify import is done, the DAM webhook will convert the image links from Shopify CDN to DAM CDN link.