Ocilion TV - Infos und Einrichten

Owned by Stephan Fischer
Aug. 28, 2023
7 min read

Die Freischaltung von Fernseh- und Radiosendern für das Ocilion TV kann über AlwinPro Care durchgeführt werden. Dabei können Patienten individuell TV-Artikel zugeordnet werden, die die freigegebenen TV-Sender bestimmen.

Voraussetzungen:

  • AlwinPro Care Version 14.0.1

  • Zusatzmodul (kostenpflichtig): “Authentifizierungs-Server TV”

Unterstützte Features in AlwinPro Care

  • Gebuchte Artikel werden täglich abgerechnet.

  • CheckIn/CheckOut eines Patienten/Gast inkl. Buchung eines “Ocilion Produkts” und optionalen “Ocilion Optionen”

  • Umzug

  • Parken

Vorbereitungen

Damit eine Anbindung von Ocilion TV an AlwinPro Care erfolgen kann, müssen eine Reihe von Vorbereitungen getroffen werden und zwar sowohl in AlwinPro Care also auch im Ocilion Portal

Vorbereitungen Ocilion

Uhrzeit / NTP Server

Die Freischaltung von Diensten erfolgt im Ocilion Server nicht jetzt, sondern immer zu einer festgelegten Uhrzeit. Bitte achten Sie daher darauf, dass die Uhrzeit im AlwinPro Care Server synchron ist mit der Uhrzeit im Ocilion Server, sonst kann es bei der Freischaltung von TV Kanälen zu Verzögerungen kommen. Achten Sie auch darauf, dass die Zeitzone im AlwinPro Care Server korrekt eingestellt ist.

Modus

Ocilion-TV muss im Modus Hotel betrieben werden. Die anderen Betriebsmodi (Carrier) werden von AlwinPro Care nicht unterstützt.

Zugangsdaten

Für den Zugriff auf die Ocilion-API wird ein Anwender mit entsprechenden Rechten benötigt. Bitte beachten Sie, dass die Anwender des Ocilion Portals in der Regel keine Zugriffsberechtigung für die API haben und dass sie dieses Recht auch nicht selbst zuweisen können. Ein passender Anwender muss vom Ocilion Support angelegt werden.

World-ID

Für die Einrichtung von AlwinPro Care müssen Sie die World-ID ihrer Installation kennen. Normale Anwender haben im Ocilion Portal keinen Zugriff auf die Einrichtung von Welten und haben daher auch keinen Zugriff auf die World-ID. Erfragen Sie daher die World-ID vom Ocilion Support.

Räume

Um die TV-Geräte später einem Patienten zuordnen zu können, werden Räume benötigt. jeder Patient ist später einem Raum zugeordnet. Legen Sie daher im Ocilion Portal einen Raum je TV-Gerät an.

Gäste

AlwinPro Care wird später jeden Patienten als Gast anlegen. Achten Sie daher darauf, dass im Ocilion Portal keine Gäste angelegt sind, die auf diese Weise die verwendeten Räume blockieren könnten.

Produkte und Optionen

Ocilion TV bietet sehr vielfältige Möglichkeiten die Senderlisten zu Produkten und Optionen zuzuordnen. Allerdings werden diese Möglichkeiten in AlwinPro Care nicht in vollem Umfang unterstützt. AlwinPro Care unterstützt nur EIN Produkt mit einer beliebigen Anzahl von Optionen.

Achten Sie darauf, dass die Optionen untereinander keine Beziehungen haben. Beziehungen können in AlwinPro Care nicht abgebildet werden und führen zu Fehlern.

Ordnen Sie diesem Produkt sämtliche Sender zu, die für jeden Patienten kostenlos verfügbar sind. Erstellen Sie weiterhin eine beliebige Anzahl von Optionen, die durch AlwinPro Care optional und kostenpflichtig hinzugebucht werden können.

Kosten können nur den Optionen zugeordnet werden, aber nicht dem Produkt. Das Produkt ist für alle Patienten kostenlos. Nur die Optionen können kostenpflichtig sein.

Bitte beachten Sie, dass die Verwaltung der Kosten ausschließlich in AlwinPro Care erfolgt. Die im Ocilion Portal festgelegten Kosten sind für AlwinPro Care ohne Bedeutung, Sie dienen lediglich der Information des Patienten.

Vorbereitungen AlwinPro Care

Zusatztext für Räume

Definieren Sie in den Grundeinstellungen einen Zusatztext, der die Zuordnung zur Ocilion Raumnummer enthalten soll.

Ordnen Sie im Organigramm allen Patientenzimmern (bzw. Bettenplätzen) die entsprechende Raum ID aus dem Ocilion Portal zu.

Bei Patientenzimmern (bzw. Bettenplätzen) ohne Ocilion TV muss der entsprechende Eintrag im Zusatztext des Organigramms leer bleiben. Bitte achten Sie darauf, dass der Eintrag in diesem Fall wirklich leer ist und nicht mit irgendwelchen Kommentaren gefüllt wird.

Einrichtung AlwinPro Care

Grundeinstellung Ocilion TV

Beginnen Sie die Einrichtung in den Grundeinstellungen mit
Krankenhausmodul > Ocilion TV

Führen Sie jetzt folgende Einstellungen durch

  • Markieren Sie Ocilion TV aktivieren

  • SystemIP:Port: Die Adresse unter der die API des Ocilion Servers erreicht werden kann.

  • World-ID: Die World-ID Ihrer Ocilion Installation.

  • Benutzername: Der Benutzername für den Zugriff auf die Ocilion API.

  • Passwort: Das Passwort für den Zugriff auf die Ocilion API.

Nachdem Sie diese Einstellungen durchgeführt haben, klicken Sie jetzt auf Verbinden. AlwinPro Care stellt nun eine Verbindung mit dem Ocilion Server her und ruft alle verfügbaren Produkte und Optionen ab.

Nach dem erfolgreichen Abruf erhalten Sie eine entsprechende Meldung

Sollten Sie eine Meldung bekommen, dass die Authentifizierung am Server fehlgeschlagen ist, so kann das auch bedeuten, dass der von Ihnen verwendete Anwender keinen Zugriff auf die Ocilion API hat.

 

Vertragsgruppe: Die von AlwinPro Care angelegten Gäste müssen immer einer Vertragsgruppe zugeordnet werden. Diese Vertragsgruppe legt das Profil des Gastes innerhalb der Ocilion API fest. Wählen Sie hier aus, welche Vertragsgruppe die Patienten erhalten sollen.

Produkt für gebuchte Zimmer: Wählen Sie das Produkt aus, welches freigeschaltet werden soll, wenn ein Zimmer (bzw. Bettenplatz) belegt ist. Dieses Produkt wird grundsätzlich jedem Patienten freigeschaltet. Dieses Produkt wird auch dann freigeschaltet, wenn der Patient keinen TV-Artikel gebucht hat.

Zuordnung von Alwin Produkt-ID zu Ocilion Optionen:
Wählen Sie in dieser Liste die Ocilion Optionen aus, die Sie optional Patienten zuordnen möchten. Vergeben Sie für jede Ocilion Option eine willkürliche Alwin Produkt ID.

Zusatztext für Zimmernummern:
Wählen Sie den Zusatztext aus, unter dem die Ocilion Zimmer ID gespeichert wird. Dies ist der Zusatztext, für den Sie während der Vorbereitung eine Bezeichnung ausgewählt haben.

Grundeinstellung Artikel

Die Ocilion Optionen müssen jetzt noch Artikeln zugeordnet werden, damit sie den Patienten berechnet werden können. Die Vorgehensweise ist hier ein wenig unterschiedlich, je nachdem ob individuelle Artikel oder Pakte verwendet werden.

Artikel basierte Abrechnung

Es wird hier für jede Ocilion Option ein eigener TV Artikel angelegt. Wichtig ist, dass hier die Produkt ID genau so angegeben wird, wie weiter oben in den Grundeinstellungen von Ocilion TV.

Zur Erinnerung: Es können ausschließlich Ocilion Optionen mit Kosten versehen werden. Das Ocilion Produkt wird jedem Patiententen freigeschaltet, selbst wenn er keinen TV Artikel gebucht hat.

Paket basierte Abrechnung

In der Paket basierten Abrechnung gibt es je Paket nur ein TV-Produkt. Idealerweise werden die Optionen im Ocilion Portal also so gewählt, dass sie den AlwinPro Paketen entsprechen. Es ist jedoch auch möglich mehrere Produkt IDs Komma getrennt einzugeben und somit mehrere Ocilion Optionen einem AlwinPro Paket zuzuordnen.

Da die Optionen hier keinen eigenen Preis haben, sondern das Paket als Ganzes einen Preis hat, ist der Ocilion Self-Service bei Paket basierter Abrechnung nicht möglich.

Self-Service (Beta-Status)

Das Ocilion-TV bietet die Funktion an, Optionen direkt über das TV zu kaufen und auch wieder zu kündigen. Dieser Service wird im Ocilion Portal als Self-Service bezeichnet.

Optionen im Portal anlegen

Um einen Self Service zu ermöglichen, muss bei den Optionen die Verfügbarkeit als Self-Service eingetragen sein. Zu weiteren Details, wenden Sie sich bitte an den Ocilion Support.

Stellen Sie sicher, dass alle im Ocilion Portal verfügbaren Artikel auch in den AlwinPro Care Einstellungen als Artikel angelegt sind und in den AlwinPro Care Grundeinstellungen für Ocilion-TV unter der korrekten Produkt-ID zugeordnet sind.

URL für Zugriff auf AlwinPro Care eintragen

In den Einstellungen im Ocilion Portal muss die URL eingetragen werden, unter der AlwinPro Care erreichbar ist.

Die URL wird für das Schlüsselwort selfservice_auth_uri eingetragen. Weiterhin muss der selfservice_mode AuthNoExecute eingetragen werden.

Verwenden Sie auf keinen Fall den selfservice_mode Execute. Dieser würde dazu führen, dass der Patient TV freischalten kann, ohne dass die Kosten in AlwinProCare erfasst würden.

Die Standard-URL lautet

http://<AlwinProCare-IP>:8080/ocilion/

Der verwendete Port, sowie das verwendete Protokoll (http/https) können in den AlwinPro Care Grundeinstellungen Datei > Programm einrichten > Grundeinstellungen > Krankenhausmodul >Weitere Einstellungen festgelegt werden.

Einstellungen in AlwinPro Care

In den AlwinPro Care Einstellungen wird die IP-Adresse eingestellt, unter der AlwinPro Care für den Ocilion Server erreichbar ist.

Eine explizite Freischaltung für den Self-Service ist in AlwinPro Care nicht notwendig. Wenn Ocilion TV ansonsten korrekt eingerichtet ist, ist auch ein Self-Service möglich.

Logs

Die gesamte Kommunikation zwischen AlwinPro Care und Ocilion TV wird in einem Log festgehalten:

Im Logs Verzeichnis gibt es die Dateien OcilionTV-*.log.

------------------- Self Service 14.08.2023 12:22:47 /ocilion/dbc8e5ee-ffd4-4157-860b-935e0d5393d7/contracts/001/subscriptions {"id":"9e629313-eec6-4c2f-8ccb-2f9d5be40edf","contractId":"536870998","type":"Option","providerBillingId":"c107f95c-3d49-4ac9-aeea-d767cc25e8ac","count":1,"subscriptionStart":"2023-08-14T10:22:46.826402Z","subscriptionEnd":null,"name":"Aurenz-Basis TV","price":30,"currency":"EUR","totalPrice":30} 400 Rejected {message:"Buchung nicht möglich: Der Kontostand ist nicht ausreichend."} ------------------- Self Service 14.08.2023 12:26:13 /ocilion/dbc8e5ee-ffd4-4157-860b-935e0d5393d7/contracts/001/subscriptions {"id":"0bb99556-9f97-4e69-a4a3-372d708d8e72","contractId":"536870998","type":"Option","providerBillingId":"c107f95c-3d49-4ac9-aeea-d767cc25e8ac","count":1,"subscriptionStart":"2023-08-14T10:26:12.737163Z","subscriptionEnd":null,"name":"Aurenz-Basis TV","price":30,"currency":"EUR","totalPrice":30} 200 OK {message:""} ------------------- GET 14.08.2023 12:26:18 http://fes.tvfellow.tv/api/v2/dbc8e5ee-ffd4-4157-860b-935e0d5393d7/guests/536870998 200: { "assignedRoomId": "001", "welcomeScreenShown": true, "billingPreview": false, "firstName": "Henry", "lastName": "Gebühr", "language": "GER", "id": "536870998", "type": "guest", "contractGroupId": "Testgruppe", "active": true, "additionalSettings": [], "deviceLocatorId": "75500-26746-97880", "test": false, "lastChange": "2023-08-14T10:14:12.031051Z", "banned": false } -------------------

© aurenz GmbH 2022