Ask AI
How can we help? ๐Ÿ‘‹

UiTdatabank (BE clients only)

Updated: 18 November 2024 for Release v204

โš ๏ธ
Take note!

This option is for Belgium customers only!


The UiTdatabank updater makes it possible to directly transfer your events from the website to the UiTdatabank and UitinVlaanderen.be

Do you have specific questions about the updater? Since this is a rather long manual we suggest you to use ctrl+F/cmd+F to easily find the information you are looking for.


UiTdatabank

Your Dashboard has an entire section dedicated to the UiTdatabank updater with four modules, which we will discuss below.

  1. UiTdatabank This is the main section where you can update events manually to the UiTdatabank. If you want to update your events to the UiTdatabank, click the Login button, Log in to the UiTdatabank with your organisation credentials and then click the button Update in the Dashboard to updste all events. See the chapter Testmodus or "debug" modus ย for more information about testing events and updating single events.
  1. UiTdatabank keywordย  The UiTdatabank keyword is also known as "labels" or "trefwoorden" in UiTdatabank. These keywords are labels you can link to your events. It is possible to add new labels yourself in this module. After you have configured all labels you want to use, you can assign these labels to productions in the production module of your dashboard. The label "ook voor kinderen" is validated by publiq. If you don't have the rights to use this label, the importer shows this in an error message.
  1. Uitdatabank theme & type Themes and types are specific characteristics used by UiTdatabank. Each theme and type has its ownย Cdb cat idย that needs to be added in order to be recognized by the UiTdatabank.ย  Documentation from publiq about themes Documentation from publiq about types
โš ๏ธ
Take note!

If you do not specify a type, we will use type "0.51.0.0.0 (onbepaald)". Only one type per production is allowed.ย After you have configured all types and themes you want to use, you can assign these to productions in the production module of your Dashboard in Peppered.


UiTdatabank organisatie

In Control Panel > UiTdatabank you can manage information about your organization:

  • Organisatie ID*ย (required) = Your own UiTID as it is known at publiq. This is a long string of about 32 characters, which will be sent from Peppered to UiTdatabank with every event. It is connected to your UiTID account. Peppered will obtain this ID from publiq, based on the UiTID email address you provide.
  • Default location id = The default location ID will be sent with each event as long as no other specific location has been assigned via the location module (see "assigning locations" below). You can find this ID in UiTdatabank.be in the URL behind "/place/" when you select the location page:
  • Telefoonnummer kassa = This phone number will be shown next to the "tickets" button on Uitinvlaanderen.be and is a required field.

Assigning labels, types and themes to Events

You can assign keywords, types and themes to an event in the Productions module.

Open a Production and assign one or more types, themes or keywords to the production and save the changes.


Assigning Locations

  • If all events are in your own location, you can enter your default locationID in the UiTdatabank organisatie module. All events will be exported to this location.
  • If you also use other locations, you can add new locations in the Locations module in the Event Metadata menu. Make sure to link your Halls to these locations in theย Halls | Settings & Background Image module. Each location has its own LocationID. If the location already exists in UiTdatabank, the ID should be entered in the field "UiTdatabankID" (See point 2. above to find the locationID in UiTdatabank), so all events will be exported using the same, already available location.If the location is not yet present in UiTdatabank, a new location can be created during the update, and the new UiTdatabankID will automatically be added to that location in Peppered during the update process. A new location in UiTdatabank requires a name, street, postal code, city and country. If any of these fields are empty in the location in Peppered, the location willย notย be created in UiTdatabank and the event export will be skipped.
  • Any event that is not connected to a location will be exported to the default location (see point 2. above).
  • Any event that is connected to a location without UiTdatabankID or without the required address fields will be skipped.

Other features for UitDatabank

  • Logging in Theย UiTdatabank updater does not require you to login. That will be arranged by a token Peppered obtains from publiq. This token will be connected to your own UiTdatabank account in the administration of publiq. You can update straight away!
  • Excluding events from update to UiTdatabank To exclude an event you can select the "Exclude from export" property in the "Events" module:You can also exclude events in a specific location by leaving the required fields of the location empty and in doing so, preventing the export.
  • UiTdatabank event ID Each production, after a successful update, will obtain a unique UiTdatabank ID. This ID is stored within all events of a production in the Peppered dashboard and is used to update all events of the existing production every time a new update is started.ย Events without this ID have not yet been successfully updated to UiTdatabank.
    • Notion image
  • Images The first image in a media gallery will be updated to UiTdatabank. Once an image is sent, it will not be updated again. If you want to change the image, delete the image in the UiTdatabank first.
  • Copyright of an image Every image needs a mention of the copyright owner to avoid copyright infringements. You can use the "credits" field next to a photo to do so. All event photos without copyright mention will trigger a warning after an update.
  • Title of an event The title and subtitle (artist) in Peppered dashboard are combined to form the title in the UiTdatabank.In Peppered:Moments musicauxย (Title)Keiko Shichijoย (subtitle)In UiTdatabank:Moments musicaux - Keiko Shichijo
  • Production types The updater supports Peppered production types "Default", "Movie" and "Long term".Make sure you add the correct UiTdatabank type to each production.
  • Prices A default price will be updated (per rank, if the event has multiple ranks) to UiTdatabank.Peppered identifies the default price as any regular price that is at the top of the list in the price type module (you can change the order of price types by drag & drop). Conditional prices (for bundles and discount codes) will not be updated to UiTdatabank.
  • UiTpas When your organization participates in UiTpas, the UiTpas prices will be automatically calculated by UiTdatabank. This will be checked based on your OrganisatieID (See "The UiTdatabank menu" above).
  • Description fieldsย  The content of your events can be spread over multiple content fields on the website. You can choose which of these fields need to be combined for the content you want to update to UiTdatabank. Choose one or combine multiple fields:
    • tagline
    • teaser
    • description part 1
    • website sidenote to description part 1
    • description part 2
    • programme
    • credits
โš ๏ธ
Take note!

HTML will be filtered out of the update. UiTdatabank does not accept HTML in content.

  • Option: use external sales URL when filled in This option, when active, will update the "ticket" buttonย on UiTdatabankย with the external sales URL that is filled in in the Peppered dashboard for an event. Ticket buttons on UiTdatabank will no longer link to your website, but directly to the website of the external ticket provider.ย The option is disabled by default, so UiTdatabank events link to events on your own website, even when such an events has an external sales URL on your website.
  • Testmodus or "debug" modus The updater also has a "debug" button. When using this button a test update will be prepared in the Peppered dashboard, informing you which events are available to be updated. It will also show you if any data is missing: The "update" link underneath each event enables you to update only that event to UiTdatabank.

How to Export Productions to UiTdatabank

Once you have added all the data mentioned above go to Dashboard > UiTdatabank

Run the Debug. This will let you know if events will not export to UiTdatabank

  • Green = will export
  • Orange = this is a warning, should try to resolve event will sync
  • Red = Production will not Sync. Fix what is mentioned in the warning. See list below for common issues.

Once you have resolved all the Orange and Red warnings select Export


How to Exclude Events from exporting to UiTdatabank

In Events & Productions > Events, find the event you would like to exclude.

Un-check Include in feeds & exports (checked by default). This will exclude the event from any export or feed. This includes the JSON event feeds and the UiTdatabank export.

Notion image

How to Troubleshoot Events not exporting to UiTdatabank

  • No UiTdatabank type has been selected for the Production
  • Has the Exclude from export (legacy) option been selected in the Event?
  • Title is too long. Title and Subtitle cannot be longer than 90 characters combined
  • Use of more than one UiTdatabank type within one Production: you can only have one!
  • Missing copyright info image data. Make sure to fill out the credits in Peppered.
  • Missing end time and end date. We will automatically use the Start Date if not completed.
  • When it seems you are not allowed to set the status "ook voor kinderen", you probably do not have the rights for it. You can check this yourself in publiq.

Technical settings (Peppered will configure for you)

  • UiTdatabank API version 3 >ย APIv3.
  • UiTdatabank Consumer key (this key will be provided to Peppered by publiq).
  • UiTdatabank V3 host provider base URI (address of the updater).
  • UiTdatabank V3 JWT provider base URI (address of the login).
  • UiTdatabank V3 long-lived JWT (the token used for login, as provided to Peppered by publiq).

To request a connection for your own website use this very handy manual How to install UiTdatabank


Related articles

Did this answer your question?
๐Ÿ˜ž
๐Ÿ˜
๐Ÿคฉ