# Self Service Check-In einrichten

|                        |                                                                                                                                                                                                                         |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| URL Self-Service-App   | <https://self-checkin.converia.de/>                                                                                                                                                                                     |
| Betriebssystem         | Windows 10/11                                                                                                                                                                                                           |
| Browser                | Chrome, Edge, Firefox                                                                                                                                                                                                   |
| Java Version           | <p><a href="https://www.oracle.com/java/technologies/java-se-glance.html">Oracle Java SE</a> oder <a href="https://converia.slab.com/posts/open-java-installieren-nz8mhjy3">OpenJDK</a></p><p>Version 22 oder neuer</p> |
| Converia-Print-Adapter | ZIP-Paket und Passwort zum Entpacken unter: <https://x.converia.de/index.php/s/zBw5x8wpFoZRzaK>                                                                                                                         |

## Allgemein

Für den schnellen und unkomplizierten Check-In vor Ort durch die Teilnehmenden selbst, bietet Converia eine Weboberfläche an. Ein zusätzlicher Print-Adapter ermöglicht zudem den automatisierten Badge-Druck über angeschlossene Drucker bei Check-In.

Die Weboberfläche kann über die meistgenutzten aktuellen Browser (Chrome, Edge, Firefox) aufgerufen werden und kann somit vor Ort, z.B. auf Microsoft-Tablets im Kiosk-Mode genutzt werden, damit die Teilnehmenden sich eigenständig einchecken und ggf. Ihre Badges selbstständig drucken können.

Einzelne Check-In-Stationen können je nach Bedarf für unterschiedliche Einsatzzwecke konfiguriert werden.

### Stations-Modi

#### Full → *Check-In und Badge-Druck sind über eine Station möglich*

Kann genutzt werden, wenn die Teilnehmenden sich mit dem Barcode auf der Buchungsbestätigung selbstständig einchecken sollen und mit dem Check-In auch der Badge-Druck ausgelöst werden soll.

#### Badge only → *Nur der Badge-Druck ist möglich*

Kann genutzt werden, wenn es reine Badge-Druck-Stationen geben soll und der Check-In nicht notwendig ist, oder separat z.B. an Check-In-Only-Stationen stattfindet.

#### Check-In only → *Nur der Check-In ist möglich*

Bietet sich an, wenn Badges vorgedruckt und bereits ausgegeben wurden oder wenn der Check-In via Ticket auf der Buchungsbestätigung erfolgen soll und Badges nicht benötigt werden.

## Anforderungen an Arbeitsstationen für Self-Service mit Druck:

Damit der Self-Check-In inklusive Badge-Druck im Browser genutzt werden kann, müssen bestimmte Anforderungen erfüllt werden.&#x20;

* Windows-PC (bzgl. Leistung genügt hierfür ein Microsoft-Tablet wie z.B. ein Surface)
* Stabiles WLAN/Internet
* USB-Anschluss (mind. USB 2.0) für Anschluss der Scanner
* Badge-Drucker über Netzwerk oder USB angeschlossen
* Software:
  * aktuelles Windows Betriebssystem (10/11)
  * aktueller Browser (Chrome, Edge, Firefox)
  * Aktuelles Java (Oracle oder OpenJava)
  * Aktuelle Version Converia-Print-Adapter
* API-Key und URL der Converia-Installation (via Converia-Support)

## Self-Service einrichten

### Java Runtime Enviroment bereits installiert?

Über die Eingabeaufforderung (cmd.exe) in Windows kann geprüft werden, ob und welches Java Runtime Enviroment installiert ist. Am einfachsten findet man die Eingabeaufforderung über den Ausführen-Dialog (Win+R).

<figure><img src="https://slabstatic.com/prod/uploads/v54u0pgn/posts/images/f49pRc8YbYw19ax7-zNO8hAJ.png" alt=""><figcaption><p>Abb. 1: Ausführen Dialog</p></figcaption></figure>

Im Kommandozeilenfenster ("Windows Eingabeaufforderung") den Befehl `java -version` eingeben:

```
Microsoft Windows [Version 10.0.22631.3155]
(c) Microsoft Corporation. Alle Rechte vorbehalten.

C:\Users\#username#>java -version
openjdk version "18.0.1.1" 2022-04-22
OpenJDK Runtime Environment (build 18.0.1.1+2-6)
OpenJDK 64-Bit Server VM (build 18.0.1.1+2-6, mixed mode, sharing)

C:\Users\#username#>
```

### Converia Print-Adapter installieren

* Aktuellen Printserver mit der EXE-Datei installieren **und starten**, falls er nicht direkt bei Installation gestartet wurde (z.B. per Doppelklick vom Desktop oder startAdapter.cmd im Installationsverzeichnis)

### Converia Print-Adapter testen

* **Test 1:** Nach erfolgreicher Installation sind die lokalen Drucker im Converia-Backend verfügbar (Countermodus = Ja auswählen)

<figure><img src="https://slabstatic.com/prod/uploads/v54u0pgn/posts/images/RLsFNQJIQ6tzUslgLOn9s9j9.png" alt=""><figcaption><p>Abb. 2: Druckerliste in der Konfiguration</p></figcaption></figure>

* **Test 2:** Beim Aufruf von [`https://printservice.local:8081/printerList`](https://printservice.local:8081/printerList) im Browser werden alle lokal verfügbaren Drucker aufgelistet

<figure><img src="https://slabstatic.com/prod/uploads/v54u0pgn/posts/images/5Tt2_fCyz20bBnMaPOmKofge.png" alt=""><figcaption><p>Erfolgreicher Browseraufruf des Printer-Adapters</p></figcaption></figure>

* **Test 3:** Es gibt nach dem Start im Taskmanager einen entsprechenden Prozess in der Rubrik Hintergrundprozesse:

<figure><img src="https://slabstatic.com/prod/uploads/v54u0pgn/posts/images/g0DpgH-HHzpLxw7j0G7sCUTj.png" alt=""><figcaption><p>Abb. 3: Print-Adapter-Hintergrundprozess im Task-Manager (Java SE)</p></figcaption></figure>

<figure><img src="https://slabstatic.com/prod/uploads/v54u0pgn/posts/images/r20w6NZm0h-8gjN9JKHfC66X.png" alt=""><figcaption><p>Abb. 4: Print-Adapter-Hintergrundprozess im Task-Manager (Open Java)</p></figcaption></figure>

### Self-Service-App aufrufen

* Converia bietet die Self-Service-Anwendung mittlerweile als Webservice unter [https://self-checkin.converia.de](https://self-checkin.converia.de/#!/settings) für ALLE Converia-Installationen an **oder unter eigener Domain** bei eigenem Hosting.
* Ggf. "*settings"* eingeben oder [Settings-Link](https://self-checkin.converia.de/#!/settings) aufrufen, falls noch alte oder falsche Einstellungen hinterlegt sind und die Settings nicht automatisch gestartet werden

### Verbindung zur eigenen Converia Installation herstellen

* API-Key des entsprechenden Backend-Users eingeben, in der Regel gibt es hierfür einen eigenen BE-Nutzer, z.B. s*elf-check-in-1*
* URL der eigenen Converia-Installation eingeben, z.B. <https://demo.converia.de> (mit https\:// und ohne "/" am Ende)

<figure><img src="https://slabstatic.com/prod/uploads/v54u0pgn/posts/images/wUzKvNoxZ9Pj7Bp0Ly05sQ6r.png" alt=""><figcaption><p>Abb. 5: Einrichtung Schritt 1: API-Key und URL eingeben, Verbindung zur Installation herstellen</p></figcaption></figure>

* Wenn API-Key und URL korrekt sind, werden die Veranstaltungen der Installation geladen und es erscheinen weitere Auswahlfelder für **Konferenzauswahl** und **Check-In-Liste.**
* Falls API-Key und URL nicht korrekt sind und nicht zusammenpassen, erscheint die Fehlermeldung "Connection to server not possible". Daten prüfen & korrigieren, notfalls Cache leeren & Cookies löschen.
* Konfiguration fertigstellen: Station mode, Translation mode, Veranstaltung, Check-In-Liste usw. nach konkreten Anforderungen auswählen:

<figure><img src="https://slabstatic.com/prod/uploads/v54u0pgn/posts/images/2z3CVSjGfx3EOw49uLG4cDUz.png" alt=""><figcaption><p>Abb. 6: Einrichtung Schritt 2: Modus &#x26; Parameter der Station konfigurieren</p></figcaption></figure>

## Scanner

### Empfohlene Scanner: Honeywell Voyager 1400g

Wir empfehlen zum Einsatz in Converia den QR-Code-Scanner **Honeywell Voyager 1400g**. Das Modell kann über uns gemietet werden und wir können hierfür eine erprobte Konfiguration und ein umfangreiches Hersteller-Handbuch bereitstellen.

{% hint style="info" %}
Informationen zum Konfigurieren unseres Scanners, siehe [Scanner für den Vor-Ort-Einsatz konfigurieren](https://manual.converia.de/teilnehmende/check-in-vor-ort/scanner-fur-den-vor-ort-einsatz-konfigurieren).&#x20;

Informationen zum Honeywell Voyager 1400g, siehe [Herstellerseite](https://sps.honeywell.com/us/en/products/productivity/barcode-scanners/general-purpose-handheld/voyager-1400g-general-duty-scanner).
{% endhint %}

{% file src="<https://4086967078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyzdXgmSBPNkQushdnuut%2Fuploads%2Fjd31xWOf0tVtlekgOHMQ%2FScanner_Check-In_Configuration_VG1400.pdf?alt=media&token=8f005aaa-3b88-4f9e-bb2f-fcbc4eb26995>" %}
Scanner Konfiguration PDF
{% endfile %}

{% file src="<https://4086967078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyzdXgmSBPNkQushdnuut%2Fuploads%2F3W2nwItjsOpBb4268l1O%2FScanner_Check-In_Configuration_VG1400.docx?alt=media&token=4f9ee44f-c37c-4736-9130-8a1341bc796e>" %}
Scanner Konfiguration Word
{% endfile %}

{% file src="<https://4086967078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyzdXgmSBPNkQushdnuut%2Fuploads%2FylszE5sIsH6POzmJQ88T%2Fmanual_VG1400_UG-Rev-C.pdf?alt=media&token=607fdcf1-3308-4826-9c5d-e4afc1a8102a>" %}
Honeywell Bedienungsanleitung
{% endfile %}

### Einsatz eigener Scanner

Der Self Check-in wird in der Regel mit von Converia gelieferten Scannern betrieben. Es ist allerdings auch möglich, eigene Scanner einzusetzen, wenn diese entsprechend konfiguriert werden können. Die korrekte Konfiguration eigener Scanner liegt in der Verantwortung des Kunden.

Das wichtigste Scanner-Setting ist, dass der gescannte Code vom Scanner mit einem Prefix an den Computer geliefert werden muss. An diesem Prefix erkennt Converia, dass es sich nicht um eine Tastatureingabe handelt, sondern einen Scan und behandelt die Daten entsprechend anders.

#### Zwingend erforderlich:

* <mark style="color:red;">**Prefix "#" oder "$"**</mark>

{% hint style="info" %}
Im Zusammenhang mit dem Prefix spielt oft das Länder-Tastaturschema des Scanners und des PCs eine Rolle. Daher unbedingt im Onsite-Setting testen und konfigurieren.
{% endhint %}

#### Weitere empfohlene Scanner-Konfiguration

* Passendes Länder-Tastaturschema (Keyboard Country Layout)
* 100 ms Pause nach dem Prefix (ggf. 10 ms Pause nach jedem gescannten Zeichen)
* Suffix: "CR" (CR=Return) - Eingabe wird abgeschlossen und schneller weiterverarbeitet
* ggf. Autoscan aktivieren, ohne dass eine Taste am Scanner gedrückt werden muss
* Lautstärke des Quittungstons auf Vor-Ort-Geräuschkulisse anpassen

{% hint style="warning" %}
An manchen Settings (Browser/OS/Hardware) sind 100 ms Pause nach dem Prefix erforderlich, da sonst das erste gescannte Zeichen nicht erkannt wird, wenn es zu schnell nach dem Prefix folgt. (Ggf. an kürzere Pausen herantasten)
{% endhint %}

## Check-In Betrieb - Scanmodus

Sind alle Einstellungen abgespeichert, geht der Self Check-in in den Scanmodus und wartet auf Eingaben über den Scanner.

<figure><img src="https://slabstatic.com/prod/uploads/v54u0pgn/posts/images/c3DDDDWi0Mk58-6D52IE1vXx.png" alt=""><figcaption><p>Abb. 7: Self-Service-Station im Einsatz - Wartet auf Scan</p></figcaption></figure>

Im Scanmodus scannen Teilnehmende oder Servicepersonal Converia-Dokumente mit QR-Code oder Barcode ein (Buchungsbestätigung oder Badge). Mit dem Scan prüft das System selbständig, ob die Teilnehmenden alle eingestellten Voraussetzungen zum Check-In und/oder Badgedruck erfüllen.

Im Erfolgsfall wird der:die Teilnehmende eingecheckt und/oder ein Badge gedruckt.

<figure><img src="https://slabstatic.com/prod/uploads/v54u0pgn/posts/images/oF2OvQBP2gg8-iXhqRCGRY-b.png" alt=""><figcaption><p>Abb. 8: Self-Service-Station im Einsatz - Erfolgreicher Check-In</p></figcaption></figure>

<figure><img src="https://slabstatic.com/prod/uploads/v54u0pgn/posts/images/HnvbQEN7h6MX9J3JceNXNWig.png" alt=""><figcaption><p>Abb. 9: Self-Service-Station im Einsatz - Erfolgreicher Check-In und Badgedruck</p></figcaption></figure>

Falls der eingesannte Code nicht zum Eintritt berechtigt, wird ein großes rotes X angezeigt, zusammen mit entsprechenden Hinweis. Weitere Details können an einem Info-Counter geklärt werden.

<figure><img src="https://slabstatic.com/prod/uploads/v54u0pgn/posts/images/23pOcYmtr5VayB7MeoPPKlCe.png" alt=""><figcaption><p>Abb. 10: Self-Service-Station im Einsatz - Check-In nicht möglich</p></figcaption></figure>

Falls der Scan nicht funktioniert, kann der Buchungscode auch **manuell** eingegeben werden (z.B. "000157IB18B0" Aufbau: Buchungsnummer 6-stellig, großes i, Hashcode 5-stellig). Der entsprechende Wert findet sich auf der Buchungsbestätigung mit Barcode und im Buchungsexport).

<figure><img src="https://slabstatic.com/prod/uploads/v54u0pgn/posts/images/6f6F4goPr6KCZFRBmyIsLByz.png" alt=""><figcaption><p>Abb. 11: Manuelle Eingabe der Buchungs- oder Mitgliedsnummer</p></figcaption></figure>

## Troubleshooting

* Trotz Auswahl eines lokalen Druckers und Ausführung des Druckprozesses, erfolgt kein Ausdruck
  * Es wurde bereits ein Badge gedruckt. Der Prozess muss in den Buchungsdetails der Buchung zurückgesetzt werden.

<figure><img src="https://slabstatic.com/prod/uploads/v54u0pgn/posts/images/SwcuPo3jkm-tpM5DtG7FEXNY.png" alt=""><figcaption><p>Abb. 12: Badge als nicht gedruckt markieren</p></figcaption></figure>

### Allgemeine Fehlerdiagnose (eher technischer Support)

* Settings überprüfen
* Print Server prüfen
  * siehe Abschnitt [Printer-Adapter testen](https://converia.slab.com/posts/self-service-stationen-fur-self-check-in-ggf-mit-badge-druck-xprki2xs#h63vg-converia-print-adapter-testen)
  * Prozess ggf. beenden und neu starten
* Läuft der Druckserver?
  * Manuell testen: <https://printservice.local:8081/printerList>
* In den Settings das Logging aktivieren und Log-Datei sichern
* Fehlercodes prüfen

### Fehlercodes

| **Interner Name**                                 | **Code**                               | **Beschreibung**                                                                       |
| ------------------------------------------------- | -------------------------------------- | -------------------------------------------------------------------------------------- |
| API\_ERROR\_CODE\_NO\_SSL                         | <mark style="color:blue;">1000</mark>  | Kommunikation mit dem Server nicht möglich, da keine SSL Verbindung besteht.           |
| API\_ERROR\_CODE\_NO\_FRAME\_ID                   | <mark style="color:blue;">1001</mark>  | Kommunikation mit dem Server nicht möglich, da Konferenz ID nicht übergeben wurde.     |
| API\_ERROR\_CODE\_NO\_API\_KEY                    | <mark style="color:blue;">1002</mark>  | Kommunikation mit dem Server nicht möglich, da API Key nicht übergeben wurde.          |
| API\_ERROR\_CODE\_INVALID\_API\_KEY               | <mark style="color:blue;">1003</mark>  | Kommunikation mit dem Server nicht möglich, da API Key nicht richtig ist.              |
| API\_ERROR\_CODE\_INVALID\_ACTION                 | <mark style="color:blue;">1004</mark>  | Kommunikation mit dem Server nicht möglich, da ungültige Aktion aufgerufen wurde.      |
| API\_ERROR\_CODE\_INVALID\_PARAMETER\_BOOKING\_ID | <mark style="color:blue;">1101</mark>  | Kommunikation mit dem Server nicht möglich, da Buchungs ID nicht übergeben wurde.      |
| API\_ERROR\_CODE\_INVALID\_PARAMETER\_LIST\_ID    | <mark style="color:blue;">1121</mark>  | Kommunikation mit dem Server nicht möglich, da List ID nicht übergeben wurde.          |
| API\_ERROR\_CODE\_INVALID\_PARAMETER\_ERROR\_CODE | <mark style="color:blue;">1131</mark>  | Kommunikation mit dem Server nicht möglich, falscher Status Code.                      |
| API\_ERROR\_CODE\_INVALID\_PARAMETER\_STATE\_CODE | <mark style="color:blue;">1132</mark>  | Kommunikation mit dem Server nicht möglich, falscher Status Code.                      |
| ERROR\_BOOKING\_ID\_INVALID                       | <mark style="color:green;">5101</mark> | Buchungs ID nicht gültig.                                                              |
| ERROR\_BOOKING\_ID\_NO\_FRAME                     | <mark style="color:green;">5102</mark> | Buchung gehört nicht zu dieser Konferenz.                                              |
| ERROR\_CHECKIN\_STATE                             | <mark style="color:green;">5103</mark> | Checkin nicht möglich, da die Anforderungen nicht erfüllt wurden.                      |
| ERROR\_DOUBLE\_CHECKIN                            | <mark style="color:green;">5104</mark> | Person ist bereits eingecheckt.                                                        |
| ERROR\_CLIENT\_SCAN                               | <mark style="color:blue;">5105</mark>  | Fehler beim Scan im Self Checkin.                                                      |
| ERROR\_BADGE\_NOT\_FOUND                          | <mark style="color:green;">5106</mark> | Badge nicht konfiguriert.                                                              |
| ERROR\_BADGE\_PRINTED                             | <mark style="color:green;">5107</mark> | Badge bereits gedruckt.                                                                |
| ERROR\_OPEN\_PAYMENT                              | <mark style="color:green;">5108</mark> | Zahlung für diese Person noch offen.                                                   |
| ERROR\_EVENT\_CONDITION                           | <mark style="color:green;">5109</mark> | Person hat die relevante Veranstaltung nicht gebucht.                                  |
|                                                   | <mark style="color:green;">5110</mark> | Check-In nicht möglich, Nachweis fehlt                                                 |
| MSG\_ERROR\_INTERNAL\_PRINTER\_ERROR              | <mark style="color:blue;">6000</mark>  | Interner Druckerfehler.                                                                |
| MSG\_ERROR\_INTERNAL                              | <mark style="color:blue;">7000</mark>  | Interner Ausnahmefehler.                                                               |
| MSG\_ERROR\_CORS                                  | <mark style="color:blue;">8000</mark>  | In der Regel Verbindungsprobleme mit dem Server. Internetverbindung und Domain prüfen. |

***

<mark style="color:blue;">→ relevant für technischen Support</mark>

<mark style="color:green;">→ relevant für Counter Personal</mark>

## Weiterführende Informationen

<https://openjdk.org/>

<https://www.oracle.com/java/technologies/java-se-glance.html>

[Voyager 1400g General Duty Scanner | Honeywell](https://sps.honeywell.com/us/en/products/productivity/barcode-scanners/general-purpose-handheld/voyager-1400g-general-duty-scanner)