Add attributes to an export template
How to add one or multiple attributes to an export template in the Developer Portal, by name or from a CSV file.
You can add attributes to each export template. Once you do so and publish the changes, the new attributes appear in each export created in the Productsup platform using this export template.
New attributes are added at the end of the attribute list. To change their position, see Order attributes.
Add attributes by name
Go to Export templates in the Developer Portal.
Use the search bar to find the export template where you need to add attributes.
Select the needed export template to open the export template setup page:
In the section Attributes and analyzer tests, select Add attributes.
- To add one attribute, enter its name in the text field and select Add.
- To add multiple attributes, enter their names in the text field, one name per line, up to 500 names at a time. Once you have added all attributes, select Add.
If delta updates are on and the export template has no Delta Key yet, the dialog also shows Delta Key. Choose one or more of the new attributes as Delta Keys, then select Add. On an export template without attributes, you must choose at least one. See Delta updates.
You have successfully added new attributes. To set them up, see Change attribute settings. To change their position, see Order attributes.
If an attribute with the same name already exists in the export template, it is skipped, and the Developer Portal tells you which names were skipped.
Add attributes from a CSV file
To add many attributes with their settings at once, upload a CSV file.
On the export template setup page, in the section Attributes and analyzer tests, select Add Columns via CSV.
Select Download Template to get a CSV file with the right columns.
Fill in one row per attribute:
| Column | What to enter |
|---|---|
Fieldname | The attribute name. Required. |
Alias | Optional. See Change attribute settings. |
Description | Optional. |
Example | Optional. |
Format | Optional. |
Mandatory | Optional. yes, y, true, or 1 (in any letter case) makes the attribute mandatory. Any other value, or an empty cell, makes it optional. A CSV file cannot make an attribute conditionally mandatory. |
Select Choose file, select your CSV file, and then select Upload.
A CSV file can have up to 5,000 rows, not counting the header row. The Developer Portal shows the progress while it adds the attributes.
Rows whose attribute name already exists in the export template are skipped, and the Developer Portal lists their names.
Caution
The Developer Portal adds the rows in batches of 500, in the order of the file. If a batch is refused, for example because of invalid data, the import stops there and the Developer Portal shows how many attributes were added and why it stopped.
The attributes added before that stay in the export template. Fix the file, remove the rows that were already added, and upload it again.
Your changes do not become available in the platform until you select Publish. See Publish export template changes.
How is this guide?