Zum Hauptinhalt springen

Individuelle Felder

1. Allgemeine Informationen​

Der Reiter „individuelle Felder“ wird benötigt für die Schnittstelle zu AVS, Feratel und Thaler.
Dieses Feld wird mit den Kontakten verknüpft. D. h. alle hier definierten Felder tauchen in einem separaten Tab bei jedem Kontakt auf.

Es ist darauf zu achten, dass die angelegten Felder korrekte Einträge im Feld „Werte“ aufweisen, da es sonst zu einer Fehlermeldung im Kontakt kommen kann.


2. Definieren der individuellen Felder​

Die Einstellungen können in den Einstellungen im Reiter „individuelle Felder“ vorgenommen werden.
Durch Klick auf den Button „Hinzufügen“ wird ein neues Feld angelegt. Folgende Werte müssen jetzt noch angegeben werden:

  • Feldname
    Wird als Label für das Feld verwendet, welches im Kontakt dann links neben dem Eingabefeld steht.

  • Kontakttyp
    Hier gibt es zwei Einstellmöglichkeiten, die definieren, bei welcher Kontaktart das Eingabefeld erscheinen soll:

    • PERSON oder
    • COMPANY
  • Feldtyp
    Drei Einstellmöglichkeiten gibt es hier:

    • INPUT - Ein einfaches Eingabefeld
    • SELECT - Ein Auswahlfeld, welches ermöglicht, aus vorgegebenen Werten einen auszuwählen
    • CHECKBOX - Eine einzelne Checkbox wird dargestellt.
  • Werte der Felder
    Abhängig vom Feldtyp sollte hier Folgendes stehen:

    • INPUT
      Hier ist kein Eintrag notwendig. Ein vorhandener Eintrag wird zurzeit noch ignoriert.
    • SELECT
      Hier ist zwingend ein syntaktisch korrekter Eintrag notwendig. In einer eckigen Klammer stehen Wertepaare, die durch einen Doppelpunkt getrennt und von Hochkomma/Anführungszeichen umschlossen sind. Mehrere Einträge dieser Art werden innerhalb der eckigen Klammer durch Komma getrennt. Die Syntax muss somit wie folgt aufgebaut sein:
      ["gespeicherter Wert:angezeigter Wert", ...] Z. B.:
      ["1:Erwachsener","2:Kind","3:Geschäftsreisender"]
    • CHECKBOX
      Ein Eintrag ist in den meisten Fällen nicht notwendig, allerdings möglich. Der hier eingetragene Text erscheint rechts neben der Checkbox.
  • Standardwert

Tragen Sie hier einen Standardwert ein, wenn bei jedem Gast zunächst ein Standardwert eingetragen werden soll.

  • API-Export
    Dieses Feld wird zurzeit noch nicht benutzt.

3. Beispiel​

3.1 Definitionen individueller Felder:​

image-20251007-054215.png

3.2 Auswirkung im Kontakt im Reiter individuelle Felder:​

image-20251007-054236.png

3.3 Praktische Anwendung am Beispiel AVS​

Bei der automatischen Erstellung und Übertragung des Meldescheins sollte es keine manuellen Eingriffe des Anwenders geben.
Ein obligatorisches Feld innerhalb des Meldescheins ist die Kategorie des Gastes. Diese Kategoriebezeichnungen sind jedoch regional unterschiedlich und können somit nicht starr hinterlegt werden.

Folgende Vorgehensweise ist notwendig, damit die Kategorie automatisch zugewiesen werden kann.

Es wird ein individuelles Feld Kategorie definiert. Als Werte werden dort die regional gültigen Kategorien hinterlegt.

Beim Gast muss dann die entsprechende Kategorie eingestellt werden.

In der Konfiguration z. B. der AVS-Schnittstelle muss eingestellt werden, welches der individuellen Felder den benötigten Wert beinhaltet.
Bei der Erstellung des Meldescheins kann die benötigte Kategorie des Gastes dann automatisch aus dem Feld des Kontakts gelesen werden, in dem sie hinterlegt wurde.