-
General
-
Releases
-
Base Connector
-
- Beginner's Guide
- Overview
- Stations
- Datamaps
- Importing templates
- Setting conditions
- Job related tasks
- Job filter function
- How to create backups
- Running and Monitoring Jobs
- Export Job Automation
- Import/Export & copy of data map rows
- Synchronizing references that are not contained in views
- Get the preconfigured "Source data set - Template"
- Configuring categories and products
- Fill Bundle and Variant tables from children
- Channel/View Tree Maintenance Active Job
- Configuring the price & stock modules
- Configuring the price/stock value ranges
- Configuring volume discounts/scale prices
- How to export prices
- How to export stock values from certain storage units
- Use of Contentserv Credentials
- Connector & Station User Limitation
- Show all articles ( 9 ) Collapse Articles
-
- Working with placeholder in conditions
- Improve usability of SC::Tables
- Placeholder for SC::Price, SC::Channel, SC::Stock
- REST Service API for SAWS Tables (Prices, Stock, Channels & Complex Articles)
- Dataflow import of SC::Tables
- Dataflow export of SC::Tables
- The datamap summary - Creating an automated documentation
- Export images as a ZIP file
- Image export with direct access to the CONTENTSERV platform
- Image export with no access to the CONTENTSERV platform
- Image export from a third party system
- How to configure CS Dashboard
- Setup a transformation list for CSTypes
- FAQ
- Transfer final result files to remote server by using FTP, sFTP, WebDAV or Azure Blob Storage
- Export Smart Document via Active Script and assign output to product
- Format Macros
- Controlling Connector Jobs via the REST API
- Sales Channel Maintenance via Excel Cross-Reference
- Sales Channel Inheritance Active Job
- Show all articles ( 5 ) Collapse Articles
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
-
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for CS type reference
- Loop values for a CS table
- Loop value for simple data record
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- Contentserv Item Attribute Storage Format
-
Owl Cloud Services
-
Owl Data Hub
-
Ursula AI
-
GenericJSON / DynamicJSON Connector
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
-
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for a CS table
- Loop values for CS type reference
- Loop value for simple data record
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- Contentserv Item Attribute Storage Format
-
GenericXML Connector
-
- All Tutorials for creating XMLs
- SAWSConnector settings
- Station configuration
- Example station configuration
- Source data set configuration
- Example source data set mappings for the XML export
- Job configuration
- Simple XML Tags
- Images
- References
- SC::Prices
- SC::Stock
- SC::Channel
- Specials
- BMECat 1.2 Template
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
-
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for a CS table
- Loop values for CS type reference
- Loop value for simple data record
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- Contentserv Item Attribute Storage Format
-
SimpleExcel Connector
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
-
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for a CS table
- Loop values for CS type reference
- Loop value for simple data record
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- Contentserv Item Attribute Storage Format
-
Magento Connector
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
-
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for a CS table
- Loop values for CS type reference
- Loop value for simple data record
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- Contentserv Item Attribute Storage Format
-
Shopware 5 Connector
-
- Configuration Shopware
- Configuration PIM
- Shopware attribute setting
- Configuration SAWSConnector
- Station configuration
- Source data set configuration
- Configuring categories and products
- Price table configuration for Shopware
- Result in Shopware
- Subshops and the SAWSConnector Shopware
- ean
- Custom Fields (attribute)
- highlight
- purchaseSteps
- stockMin
- supplierNumber
- notification
- shippingFree
- length
- height
- width
- weight
- shippingTime
- metaKeywords
- Show all articles ( 9 ) Collapse Articles
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
-
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for a CS table
- Loop values for CS type reference
- Loop value for simple data record
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- Contentserv Item Attribute Storage Format
-
Shopware 6 Connector
-
- Tutorial Video
- First steps
- Import Shopware settings
- Export categories
- Export media files
- Export simple products
- Export multiple languages
- Export variant products
- Export product properties
- Export custom fields
- Export product cross-selling relationships
- Export prices
- Export stocks
- Export into any other Shopware field
- How to address multiple Shopware 6 websites
- How to address different Shopware 6 Sale-Channels from one Contentserv System
- Useful Links
- Sales Channel Maintenance via Excel Cross-Reference
- Show all articles ( 3 ) Collapse Articles
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
-
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for a CS table
- Loop values for CS type reference
- Loop value for simple data record
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- Contentserv Item Attribute Storage Format
-
OXID Connector
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
-
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for a CS table
- Loop values for CS type reference
- Loop value for simple data record
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- Contentserv Item Attribute Storage Format
-
Typo3 Connector
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
-
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for a CS table
- Loop values for CS type reference
- Loop value for simple data record
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- Contentserv Item Attribute Storage Format
-
Other Connectors
Generate Descriptions with Ursula AI Active Job
(Since version 1.20)
The SAWSConnector Suite encompasses many Active Jobs. One of these it the Generate Text with Ursula AI Active Job. This Active Job enables you to maintain descriptions of any kind via the Ursula AI. For example: Alt texts for images, further product descriptions or accessibility descriptions for vision impaired people.
The following article shows you how to configure this Active Job while explaining the options.
First Create An Active Job
You create an Active Job in the following steps:
1) Select the ActiveJobs in the menu on the left.
2) Click on ‘Create New’ in the top menu.
3) Click on ‘Script’ and select ‘SAWS – Generate Descriptions with Ursula AI’ from the drop-down menu.
4) Then fill in the other boxes as required.
5) Save the Active Job using the Save button or the key combination ALT
+ S
.
i) You can’t specify the ID for your Active Job! It will be assigned automatically and consecutively.
6) Under ‘Show more options …’ you will find further useful functions, such as a timeline, CloudStream tools or help pages.
Settings
After saving, you will have access to additional tabs and input boxes to precisely define your Active Job. These include:
Label
Defines the name of your Active Job.
Category
Defines the associated category. This is sorted in the ‘Presets’ sub-menu.
Description
The description of the script can only be read by you and the users authorised by you.
Record Type
Defines what is to be included for text generation. You can choose between ‘Products’ (i.e. products from the PIM system) and ‘DAM Files’ (such as images, videos and media).
Root Node
Defines the sub trees for which the AI text generation is executed. You can select individual files and folders for processing.
Filter Objects by this Favorite
After you have selected a root node the option for a filter by favorites will appear. This allows you to integrate specific structures, priorities or workflows into the process.
Languages (First will be used as default language)
Selects the languages in which the text is generated. As in the title mentioned, the first choice is used as the default language. This is especially important for languange-independent attributes since they will be populated in the default language.
Attributes for AI description (+)
This menu can be used to define product and media attributes that are to be included for the AI to work off to provide a better context. For example, name, size, colour, etc. can be included to generate a product description. Multi-selection is also possible here.
Image Attribute
Selects the images and image folders to be used for text generation.
Important: To maximize usability, this field only appears after the other input boxes have been filled / satisfied.
Preset for image export
Determines the preset via the image is exported. There is a variety of predefined presets available which were provided by Contentserv but it is always possible to create your own. Ursula AI uses the properties stored in the presets to create it’s description texts.
It is currently recommended to use a maximum image size of 300 x 300 pixels.
Target Attribute
Defines in which attribute the generated text should be stored. This can be the description field, an alt text box, or simply the meta tags for SEO purposes, for example.
Replace value in target attribute only if condition is met
Allows the selection of filling conditions. These can be limited to empty fields, for example, so that no existing or inherited texts are replaced.
Prompt Attribute
You can also store an AI prompt directly in the product, e.g. to focus on a specific property or not to mention certain terms in context. You can use this field to have the Ursula AI take these stored prompts into account.
Additional AI Instructions
Allows you to give the AI additional instructions, such as a linguistic style, to draw attention to certain details or to avoid selected terms.
This will only be taken into account if the ‘Prompt Attribute‘ in the product is empty.
Starting the Active Job
7) After you have filled out all boxes and selected your options you can start (i.e. run) the Active Job by clicking on the ‘Run ActiveScript’ button in the menu on the upper right.
Be aware: Once the Active Job has started it cannot be stopped until the task is finished or it runs out of time (which can be specified in the tab ‘Automation’).
Afterwards a logs window in the lower right of the UI will show you what tasks the Ursula AI has completed, if there were possible complications, and errors.
Run Example
To fully understand how you can create description texts with the Ursula AI it is best demonstrated with a step-by-step case example.
1) I create an Active Job, select the ‘SAWS – Generate Descriptions with Ursula AI‘ and fill out the input boxes.
The description is—of course—not necessary but could help me later remembering the specific purpose of this Active Job.
2) For ‘Record Type‘ I choose ‘DAM Files‘ so the Ursula AI will generate it’s produce as such.
3) When I click an ‘Root Node‘ a context menu opens:
4) Inside the ‘Data Selection Dialog‘ I select the folder ‘Images‘ and the subfolder ‘People‘ for an example. With a double-click on this folder, it is now shown in the selection list on the right.
5) The ‘Root node‘ box only shows the ID. This can vary. Single entries or images for example are usually named directly.
6) For ‘Filter Objects by this Favorite‘ I select ‘SAWS / Leaf Elements‘ which filters the objects down to their lowest elements in the tree.
7) By clicking on languages another context menu opens:
8) Here I choose a variety of languages the description(s) will be created in. As the first and therefore automatically assigned default language I select English, followed by German, French, and Japanese. In the input box they are sorted by ID and when they where selected.
9) For the next step, I wanted to specify the attributes the Ursula AI uses for it’s creation process.
By clicking on ‘Add Next Object‘ (+) another context menu opens:
10) In the subsequent trees and folders I selected the attributes ID, External Key, File Name and Last Change for overview purposes. By double-clicking on them they’re shown in the selection list on the right.
In theory, it is possible to choose an almost infinite number of attributes. However, more then 50 entries or attributes with excessive amount of information can lengthen and complicate your prompt too much for the Ursula AI to generate a useful text. Also there is a almost non-existent chance of the universe collapsing which has proven to be very unhealthy for plant life. Also existence.
11) For the ‘Preset for image export‘ I selected ‘AI Optimized WEBP (9)‘ to make it easer for Ursula AI to fulfil it’s purpose.
12) As ‘Target attribute‘ I choose ‘Media Descriptipn (334)‘ from the context menu.
13) When asked to ‘Replace value in target attribute only if condition is met‘ I allow Ursula AI to ‘Always replace value‘ so the generated texts can overwrite everything that’s written in the Media Description tags.
It is possible to choose less drastic options, so the AI only generate texts when there is none at the first place or inherited.
14) Almost done! For a ‘Prompt Attribute‘ I select the color so the Ursula AI will mention and focus on this characteristic.
15) And for the ‘Additional AI Instructions‘ I tekk the Ursula AI to generate alternative meta texts within EU accessibility guidelines.
16) It is done! For the final step, I save my progress and run the Active Job. Let Ursula AI work its magic.
Warning & Disclaimer
AI-generated texts and content may be inaccurate, incorrect or misleading.
It is therefore recommended that you read, review, and edit them yourself after creation.