< Back
Print

Placeholders

Placeholders are variables that can be used for any kind of value or logic in connector configurations. They were originally designed to replace placeholders in given values such as product descriptions.

Example:

The product {name} with product number {productNumber} is a great buy!

Output:

The product Smart LED TV with product number PN-10254 is a great buy!

or

The product Strong Coffee with product number PN-45102 is a great buy!

As you can see, the placeholders were replaced with the currently exported placeholder values, in this case “name” and “productNumber”. The format configuration would look like this:

While this is still supported, nowadays, the placeholders are most commonly used for logic, comparisons or altering format settings. This is the placeholder syntax:

{placeholderName}

The placeholder name must not necessarily be in camel-case. They can also be called “{Product Number}” for example, but we prefer camel-case, since it suggests a technical functionality.

Here are a few examples.

This configuration skips any product that does not have a special price or if the special price is higher than the USP price.

 

In this configuration, placeholders are used to fill the prefix and suffix setting of the “Format strings” format.

 

Pre-defined Placeholders

There are a few pre-defined placeholders in the connector that cannot be overwritten and will be replaced by the following pre-defined values.
Placeholder Description Example Values
count Returns the current count of how often the placeholder was reached. It is useful in many connectors to have a unique identifier. 1/2/3
pos Alias of “count”. 1/2/3
StoreView Returns the language key that was set in the language mapping of the datamap. default/en-US/de-DE
LanguageId Returns the Contentserv ID of the current language. 2/1/4
LanguageShortName Returns the short name/key of the current language. en/de/fr/jp
csid Returns the Contentserv ID of the current product/item. 10254/10261
csclass Returns the item type of the current product/item. Pdmarticle/Mamfile
fieldid Returns the Contentserv ID of the attribute that was passed to the format. 162/28/13
fieldname Returns the label of the attribute that was passed to the format. Images/Accessories/Product Number
fieldexternalkey Returns the external key of the attribute that was passed to the format. IMAGES/ACCESSORIES/PRODUCT_NUMBER
ResultValue Returns the result value of the format. Only works in specific configurations. Smart LED TV
Was this article helpful?
How can we improve this article?
Please submit the reason for your vote so that we can improve the article.
Table of Contents