Skip to content
English
  • There are no suggestions because the search field is empty.

Import data with a programme data sync integration

This article describes how you can import data when you have a programme sync integration and how you can lock items to prevent them from being overwritten when synced.

A Programme Data Sync connects your third-party software directly to our platform, allowing you to manage your event data in a single primary source. Once connected, you can run imports manually or schedule automated syncs to ensure your app stays up to date.

This article walks you through setting up a sync channel, running or scheduling imports, and locking specific data so manual updates are not overwritten during future syncs.

Set up the programme data sync

To set up a programme data sync, a dedicated integration channel must first be developed for your event. Please contact your Customer Success Manager for more information about creating a backend channel.

How to add a channel (sync) to studio

Once the backend setup is complete, you can connect the channel directly inside Floq Studio.

👉 Here are the steps to take in the Floq studio:

  • Click on your event level studio.
  • Select the Integrations button on the main navigation bar.
  • Click the purple Add a channel button.image-png-Jun-13-2024-12-43-38-8919-PM
  • Choose your created channel from the pop out box that opens.
  • Click Create to fetch the channel settings.

After confirming or adjusting your settings, such as the data source URL, the channel is added to your list. You can now verify that the integration works by running the channel (top right button).

Run a channel

Running a channel imports your data immediately on demand.

To run an import, press the Run channels button at the top right of the screen. The system will start fetching and processing the latest data from your third-party system.

You can monitor the results of any sync in the Runs table. If a run fails, a red cross icon appears in the Status column. Click on the Warning or Failed status to open the logs and review details about the issue.

Schedule a job

While running a channel imports data once, scheduling a job allows you to automate imports and automatically publish app releases on a recurring basis.

👉 How to schedule an automated importimage-png-Jun-13-2024-12-49-52-4356-PM

  • Navigate to the Scheduled jobs tab and click Add job.
  • Choose a name (for example: "daily programme sync during the event"), then Select the date and time for the initial run.
  • Select an optional repetition frequency, such as Runs hourly or Runs daily.
  • Set an end date for the schedule, then click Add to save.

All scheduled jobs run in the Central European Time (CET) timezone. Please calculate and adjust your local start time accordingly when setting up new jobs.

You can set up different scheduling strategies depending on your event phase. For example, you can set up daily syncs in the weeks leading up to your event and switch to hourly syncs during live event days.

Review your active schedules in the Scheduled jobs table. You can track individual import statuses under the Programme data sync tab beneath Runs, and check publishing progress on the Releases page.

Lock objects, fields and references

Your third-party system should serve as the primary source of truth for your event data. When possible, update information in your external software and sync those changes to Floq Studio.

For different reasons, it could however happen that you need to make your changes in our system instead. If you're making manual changes to this channel-imported data, they shouldn't be overwritten the next time your channel is run. To prevent this, fields and sections of data coming from a channel are automatically locked when you make manual changes to them. The channel does not overwrite these locked fields or references.

Lock objects

Locking an entire object prevents all of its fields and referenced data from being updated during subsequent imports.

  • Open the detail page of the item you wish to lock.
  • Click the Lock object icon at the top right of the page.
  • To lock items in bulk, select multiple items in the table and choose Change lock status in the batch edit toolbar.

Batch locking only applies to imported items. Manually created items in Floq Studio will be ignored by this batch action.

 

You can also lock objects in batch by selecting them in the table and choosing Change lock status in the batch edit toolbar. Please note that only imported can be locked, so this batch action will ignore manually created items.

Lock fields

Fields refer to the input controls located under the General section of an item.

When you edit a field manually, it locks automatically and displays a lock icon on the right side. To unlock a field, click the lock icon again so the next import can update its value.

Fields that are not configured to receive channel updates cannot be locked.

Lock references

References connect items together, such as attaching a speaker or author to a session or poster presentation.

  • Click the cross icon next to a reference to hide it from the app.
  • Added or removed references will display a strikethrough effect to indicate they are no longer visible (for example: Speaker)image-png-Jun-13-2024-01-12-49-1261-PM
  • Click the Restore icon (represented by a reverse clock) to allow the channel to update the reference again.

Locking references ensures that removed or newly assigned roles, tags, and session links remain unchanged during future sync runs.

 

⚙️ Troubleshooting

  • Scheduled job did not run at the expected time: Verify that your job was scheduled in Event time or Local time. If your local time zone differs from the event time, update the scheduled start time to match the correct offset.
  • Import run displays a red cross status: Click directly on the Failed status text in the Runs table to view the error log. It is recommended to check the logs to see if you can notice what went wrong, and check with the third-party integration if there is a block there.
  • Manual edits were overwritten after a sync: Check if the modified field or object displays a lock icon. If an object was unlocked manually or created outside the import workflow, re-enable the lock status on the item detail page to preserve your changes.