Entity-Referenzierung

Ressourcen und Kanäle referenzieren

Übersicht

Es gibt drei verschiedene Arten von Referenzen, die Sie dem Widget übergeben können. Jede hat unterschiedliche Auswirkungen auf die angezeigten Termine.

Channel Reference

Resource Channels sind Entitäten in timum, die jeweils eine Konfiguration speichern, die das Buchungserlebnis für Kunden verändert. Jede einzelne Ressource hat vier Kanäle, die Benutzer über einen Link an ihre Kunden verteilen können.

Channel Referencejavascript

timum.init({ ref: 'channel-reference@provider' });

Resource Reference

Eine Referenz, die auf eine Ressource verweist, bei der der Kanal unbekannt ist. Der Standard-Kanal (und seine entsprechende Konfiguration) wird verwendet.

Resource Referencejavascript

timum.init({ ref: 'resource-reference@provider' });

Resource Reference mit channelKey

Wenn Sie keine Kanal-Referenz haben, aber einen anderen Kanal als den Standard verwenden möchten, können Sie eine Kombination aus Ressourcen-Referenz und channelKey angeben.

Mit channelKeyjavascript

timum.init({
  ref: 'resource-reference@provider',
  channelKey: 'RESOURCE_EXCLUSIVE'
});

Verfügbare channelKey-Werte

channelKey	Beschreibung
`RESOURCE_PUBLIC`	Öffentlicher Buchungs-Link (Standard)
`RESOURCE_EXCLUSIVE`	Exklusiver Buchungs-Zugang
`RESOURCE_REFERENCE`	Eingebettete Buchungskalender
`CALENDAR_PUBLIC`	Website-Plugin Ansichten und Gesamtkalender

Referenz-Prioritäten

Die folgende Tabelle zeigt, wie BookingJs verschiedene Kombinationen von Referenzen behandelt:

URL ref	init() ref	channelKey	Verhalten
-	-	ignoriert	Widget versteckt
ResourceRef	ignoriert	JA	Widget für channelKey
ResourceRef	ignoriert	-	Standard-Kanal
-	ResourceRef	-	Standard-Kanal
-	ResourceRef	JA	Widget für channelKey
ChannelRef	ignoriert	ignoriert	Kanal anzeigen

Produkt-Referenzen (prdRefs)

Mit prdRefs können Sie festlegen, welche Produkte (Terminarten) dem Kunden zur Auswahl stehen sollen.

Mit Produkt-Filterjavascript

timum.init({
  ref: 'resource-reference@provider',
  prdRefs: 'besichtigung' // Nur dieses Produkt anzeigen
});

// Oder mehrere Produkte
timum.init({
  ref: 'resource-reference@provider',
  prdRefs: ['besichtigung', 'beratung']
});

Timeslot-Referenzen (tslRefs)

Für Szenarien, in denen nur bestimmte Termine geteilt werden sollen, können Sie tslRefs verwenden.

Spezifische Terminejavascript

timum.init({
  tslRefs: ['timeslot-uuid-1', 'timeslot-uuid-2']
});

Hinweis

Wenn tslRefs und prdRefs zusammen verwendet werden, haben tslRefs Priorität, um sicherzustellen, dass alle referenzierten Termine buchbar sind.

Multi-Resource-Widget

Sie können auch mehrere Ressourcen in einem Widget anbieten:

Mehrere Ressourcenjavascript

timum.init({
  ref: ['resource-1@provider', 'resource-2@provider', 'resource-3@provider'],
  allResourcesOption: true // "Alle" Option anzeigen
});