Bulk Element Management

Overview

Inside the 'Elements' entry you can reach from the sidebar, you can find three entries that allow you to apply bulk changes to Elements.

Bulk import

This entry allows you to import Elements by using data in specified csv formats.

Intended use

Please note that it is not possible to upload any files except a csv file. Also, after importing Elements, they will not be published automatically.

After importing your Elements, there are two different best practices, depending on what you want to do:

• If you just want to publish them, consider using Bulk Change (see below).
• If you want to review your Elements before publishing them, consider using the Element List of the Frontend application. In this case, you can also upload images or files, if needed.

Hint: You can sort the Element List in the Frontend application so that the last updated Elements appear on top of the list. This makes it easy to curate your content.

Downloading the template for Bulk imports

Click on 'Upload CSV' to open the upload dialogue for the Bulk Import and click on the link inside this popup dialogue to download the template for Elements.

Editing the templates

When editing the CSV file, make sure to not change the column headers; otherwise the import will not work.

Columns inside the elements template

Column	Description
importid	This column shows the identifier that you chose to match updates or creations to this specific element.
name	This column shows the display name of the element.
type	This column shows the content type of the element. Only specific values are allowed. See Supported Content Types.
language	This column shows the language of the element.
url	This column shows url of the element. Used when referring to external content. If provided, it must begin with 'https'.
text	This column shows the text of the element. Used when referring to text content
image	This column shows the image url for the element. If provided, it must begin with 'https'.
tags	This column shows the tags of the element. Tags that do not yet exist will be created. You can specify multiple Tags separated by comma. Eg. A, B
weight	This column shows the weight for the element. This will change the position of the corresponding Element in Search results: The higher the value the more likely the Element will be shown on top of the results.
description	This column shows the description of the element.
customProperties	This column contains the custom properties for the element in JSON format.

Supported languages

The following languages are supported as of now:

Language Code	Language
aa	Qafar
af	Afrikaans
ak	Akan
am	አማርኛ
ar	العربية
as	অসমীয়া
az	azərbaycan
ba	Башҡорт
be	Беларуская
bg	български
bm	bamanakan
bn	বাংলা
bo	བོད་ཡིག
br	brezhoneg
bs	bosanski
ca	català
ce	нохчийн
co	Corsu
cs	čeština
cu	церковнослове́нскїй
cy	Cymraeg
da	dansk
de	Deutsch
dv	ދިވެހިބަސް
dz	རྫོང་ཁ
ee	Eʋegbe
el	Ελληνικά
en	English
eo	esperanto
es	español
et	eesti
eu	euskara
fa	فارسی
ff	Fulah
fi	suomi
fo	føroyskt
fr	français
fy	Frysk
ga	Gaeilge
gd	Gàidhlig
gl	galego
gn	Avañe’ẽ
gu	ગુજરાતી
gv	Gaelg
ha	Hausa
he	עברית
hi	हिन्दी
hr	hrvatski
hu	magyar
hy	Հայերեն
ia	interlingua
id	Indonesia
ig	Igbo
ii	ꆈꌠꁱꂷ
is	íslenska
it	italiano
iu	Inuktitut
ja	日本語
jv	Basa Jawa
ka	ქართული
ki	Gikuyu
kk	қазақ тілі
kl	kalaallisut
km	ភាសាខ្មែរ
kn	ಕನ್ನಡ
ko	한국어
kr	Kanuri
ks	کٲشُر
ku	کوردیی ناوەڕاست
kw	kernewek
ky	Кыргыз
la	lingua latīna
lb	Lëtzebuergesch
lg	Luganda
ln	lingála
lo	ລາວ
lt	lietuvių
lu	Tshiluba
lv	latviešu
mg	Malagasy
mi	te reo Māori
mk	македонски
ml	മലയാളം
mn	монгол
mr	मराठी
ms	Melayu
mt	Malti
my	ဗမာ
nb	norsk bokmål
nd	isiNdebele
ne	नेपाली
nl	Nederlands
nn	nynorsk
no	norsk
nr	isiNdebele
oc	Occitan
om	Oromoo
or	ଓଡ଼ିଆ
os	ирон
pa	ਪੰਜਾਬੀ
pl	polski
ps	پښتو
pt	português
rm	rumantsch
rn	Ikirundi
ro	română
ru	русский
rw	Kinyarwanda
sa	संस्कृत
sd	سنڌي
se	davvisámegiella
sg	Sängö
si	සිංහල
sk	slovenčina
sl	slovenščina
sn	chiShona
so	Soomaali
sq	shqip
sr	srpski
ss	Siswati
st	Sesotho
sv	svenska
sw	Kiswahili
ta	தமிழ்
te	తెలుగు
tg	Тоҷикӣ
th	ไทย
ti	ትግርኛ
tk	Türkmen dili
tn	Setswana
to	lea fakatonga
tr	Türkçe
ts	Xitsonga
tt	Татар
ug	ئۇيغۇرچە
uk	українська
ur	اُردو
uz	o‘zbek
ve	Tshivenḓa
vi	Tiếng Việt
vo	Volapük
wo	Wolof
xh	isiXhosa
yi	ייִדיש
yo	Èdè Yorùbá
zh	中文
zu	isiZulu

Supported Content Types

The following Content Types are supported as of now:

type	Description
1	Text
2	Other (Office, Video or PDF)
3	External Content

Please note that you need to specify the Content Type as a number, otherwise you will be presented an error message when checking the Import Data. See Checking your Import Data

Custom Properties

Please note the intended behaviour of the 'Custom Properties' field:

• This field expects you to provide custom properties as a JSON Object in a { "key": "value"} format.
• If you leave this field blank, there will be no changes to the custom properties for the corresponding Element.
• If you provide a custom property, it will be created or updated on the Element, depending on if it had existed before.
• To explicitly delete a custom property on that Element, set the value of the specific key of the property you want to delete to null as in {"key": null}.

Uploading your CSV file

Please use the 'Upload CSV' button to open the corresponding popup dialogue. Click on 'Select file' inside that dialogue, choose your CSV file and click on 'Upload File'.

Please note that you can mouseover the column headers of the preview to find descriptions of the corresponding columns.

Checking your Import Data

After clicking on the 'Check Import Data' button, the imported data will be checked and the result of this check will be displayed inside the preview.

If any errors have been found, the corresponding lines and columns will be colored in red. If you hover one of the red-colored 'Error' elements, a tooltip will be shown, displaying a more specific error message.

Selecting a Playlist

By choosing a Playlist in the corresponding dropdown field, you can assign all imported Elements to a Playlist automatically.

In this case, all Elements that are not already part of the Playlist will be appended at the end of the Playlist.

Completing the import

If no errors have been found during the previous check, a popup dialogue will be shown, telling you that there was no error and asking if you want to import.

Just confirm this popup dialogue to complete your import.

Bulk Delete

This entry allows you to select one or more elements and delete them all at once by clicking on the 'Delete Selected' button.

Please note that you can order the columns by clicking on the corresponding icon and that you can filter by the Display Name by clicking on the corresponding magnifier icon.

Please note that there may be several pages the elements are shown in. Just use the page navigator above or below the table to jump to other pages.

Bulk Change

This entry allows you to select one or more Elements and apply one of the following operations to them by clicking on the corresponding button:

Publish Selected

This will publish all selected Elements.

Please note that for the success message at the end, the number of all successful Elements will be counted, not just the ones that have been changed.

UnPublish Selected

This will unpublish all selected Elements.

Please note that for the success message at the end, the number of all successful Elements will be counted, not just the ones that have been changed.

Set Selected to Public

This will set the selected Elements to Public if they are not assigned to any Group.

Please note that for the success message at the end, the number of all successful Elements will be counted, not just the ones that have been changed. Elements that are assigned to a specific group will NOT be counted.

Set Selected to Private

This will set all selected Elements to Private.

Please note that for the success message at the end, the number of all successful Elements will be counted, not just the ones that have been changed.