ImaCash-Integration

VGaleno

Verbinden Sie VGaleno über einen Informix-DSN mit 32 Bit mit ImaCash. Prüfen Sie einen vorhandenen ODBC oder richten Sie mit dem Anbieter und Kit 1.0.1 einen neuen ein.

Illustration eines Kassenterminals für ImaCash-Integrationen; keine VGaleno-Bildschirmaufnahme
Apotheke

VGaleno konfigurieren

Diese Integration verursacht zusätzliche Kosten zur Standardlizenz von ImaCash. Bestätigen Sie die Bedingungen mit Imagina vor der Inbetriebnahme.

1. Angaben von VGaleno

VGaleno muss den kompatiblen Informix-Treiber mit 32 Bit und seine Voraussetzungen installieren, System-DSN und Authentifizierung einrichten sowie private Verbindungsdaten, Struktur, Lese- und Bestätigungsrechte und die Schubladen-ID des Arbeitsplatzes bestätigen. Das Paket hilft bei der Windows-Einrichtung; es ersetzt weder Installation noch Prüfung durch den Anbieter.

2. Vorhandenen oder neuen ODBC wählen

ImaCash benötigt IBM INFORMIX ODBC DRIVER mit 32 Bit, auch unter Windows mit 64 Bit. Das Paket nutzt Windows PowerShell 5.1 mit 32 Bit. Hat VGaleno bereits einen funktionierenden DSN eingerichtet, prüfen Sie ihn direkt, statt ihn grundsätzlich neu anzulegen.

Laden Sie ImaCash VGaleno 1.0.1 (x86) unter den Abhängigkeiten für Admin oder Händler herunter. Das vollständige ZIP enthält den PowerShell-Assistenten, IBM Informix Client SDK 4.10.TC16W4 und Visual C++ 2013 x86. Bestätigen Sie die Kompatibilität von Arbeitsplatz und Server mit VGaleno.

ImaCloud-Abhängigkeiten öffnen (Anmeldung erforderlich)

Wenn der ODBC bereits eingerichtet ist

Stimmen Sie das normale Schließen von ImaCash ohne laufende Vorgänge ab. Entpacken Sie die vollständige ZIP-Datei und starten Sie COMPROBAR.cmd direkt mit dem tatsächlichen Windows-Benutzer und den Berechtigungen von ImaCash. Geben Sie den vorhandenen x86-System-DSN an. INICIAR.cmd und ein Neuerstellen des DSN sind nicht erforderlich. Nach erfolgreicher Prüfung folgen die bestätigte Schublade und die ImaCash-Felder. Fehlt die Verbindung, richten Sie sie wie nachfolgend beschrieben mit VGaleno ein.

Wenn der DSN fehlt: Einrichtung mit VGaleno

  1. INICIAR.cmd: entpacken Sie das gesamte ZIP in einen lokalen Ordner; starten Sie es nicht im Archiv. Schließen Sie ImaCash regulär ohne laufende Vorgänge und öffnen Sie diese Datei. Windows fordert Administratorrechte zur Vorbereitung des Arbeitsplatzes an.
  2. Fehlen Visual C++ 2013 x86 oder der Informix-x86-Treiber, öffnet der Assistent die mitgelieferten offiziellen Installationsprogramme. Bearbeiten Sie deren Dialoge und Bedingungen; die Installation ist nicht unbeaufsichtigt. Wenn ein Windows-Neustart angefordert wird, starten Sie neu und öffnen Sie INICIAR.cmd erneut.
  3. Nur für einen neuen DSN: Geben Sie die von VGaleno bestätigten privaten Daten ein, darunter DSN-Name, Server, TCP-Port, Informix-Instanz, Datenbank und Schubladen-ID. Kit 1.0.1 verlangt auch bei einem Dienstalias einen numerischen Port; es ermittelt ihn nicht aus dem Alias. hosts, services, ClientLocale und DatabaseLocale sind Anbietervorgaben. Der Assistent ermittelt keine Schublade und verändert ImaCash nicht.
  4. Beim Erstellen eines neuen DSN öffnet sich der offizielle Treiberdialog zur Anmeldung. Der Assistent fragt keine Passwörter ab und speichert sie weder in PowerShell noch in JSON oder Berichten. Wird ein passender vorhandener DSN wiederverwendet, öffnet sich dieser Dialog nicht automatisch erneut; prüfen Sie dessen Anmeldung bei Bedarf mit VGaleno.

Geben Sie die privaten Daten des von VGaleno berechtigten Kontos in der lokalen Konfiguration ein. Es benötigt Lese- und die zur Vorgangsbestätigung erforderlichen Schreibrechte; reiner Lesezugriff reicht nicht aus. Gewähren Sie keine allgemeinen Administrationsrechte.

Vor Änderungen an hosts oder services werden überprüfte Sicherungen angelegt. Ein inkompatibler DSN oder Aliasse mit anderem Ziel werden nicht überschrieben: Halten Sie bei Konflikten an und prüfen Sie diese mit dem Anbieter. Firewall, Virenschutz und Serversicherheit werden nicht verändert. TLS oder ein anderes Protokoll erfordert ein von VGaleno bestätigtes kompatibles Profil.

3. Mit dem tatsächlichen ImaCash-Benutzer prüfen

COMPROBAR.cmd: schließen Sie das erhöhte Konfigurationsfenster und starten Sie diese Datei mit demselben Windows-Benutzer und denselben Rechten wie ImaCash. Sie fordert keine erhöhten Rechte an: Läuft ImaCash nicht als Administrator, erhöhen Sie auch diese Prüfung nicht. Geben Sie den DSN-Namen ein. Die Prüfung dauert höchstens 30 Sekunden, öffnet den DSN ohne zusätzliche Benutzer- oder Passwortangabe und prüft ausschließlich die Lesestruktur, ohne Verkäufe oder Namen abzurufen oder Geschäftsdaten zu schreiben.

ImaCash öffnet den DSN, ohne Benutzername oder Passwort zur Verbindung hinzuzufügen. Ein Techniker muss das Öffnen und Schließen mit dem später für ImaCash verwendeten Windows-Konto ohne interaktive Zugangsdaten-Eingabe prüfen. Der isolierte Treibertest allein weist diese Anmeldung nicht nach.

Ein erfolgreiches Ergebnis belegt nur die Verbindung und Lesestruktur; weder die Kasse noch die Schreibrechte für Vorgangsbestätigungen sind damit geprüft. Verwenden Sie keine echte Zahlung als Verbindungstest. Der Empfang von Verkäufen und deren Bestätigung erfordert einen mit VGaleno abgestimmten beaufsichtigten Test mit derselben Kasse, demselben Konto und derselben Serverversion.

4. ImaCash-Felder ausfüllen

  1. Der Assistent verändert die ImaCash-Konfiguration nicht. Öffnen Sie Konfiguration > Integration und wählen Sie die Kategorie POS und VGaleno. Pharmacy / Apotheke stammt aus der alten Dokumentation.
  2. Tragen Sie unter Nombre de la BBDD genau General > Data Source Name des geprüften DSN mit 32 Bit ein. User Id, Database Name und Service des Treibers sind andere Felder und gehören hier nicht hinein.
  3. Tragen Sie unter ID Cajón die von VGaleno bestätigte Austauschschublade dieses Arbeitsplatzes ein. Sie muss nicht dem Terminal entsprechen und bezeichnet nicht das Bargeldgerät. Trennen Sie mehrere freigegebene numerische IDs durch Kommas ohne Leerzeichen. COMPROBAR.cmd ermittelt diesen Wert nicht: Nehmen Sie keine Nummer an und erzeugen Sie keine Zahlungen zu seiner Ermittlung.
  4. Stimmen Sie die Inbetriebnahme mit VGaleno ab, bevor Sie die Integration speichern und aktivieren: Beim operativen Start können offene Vorgänge vorliegen. Ändern Sie andere Parameter nicht ohne Bestätigung des Anbieters.

Technische Referenz: manuelle Konfiguration

Diese Referenz benennt Dateien und Felder zur Prüfung mit VGaleno. Behalten Sie eine funktionierende Verbindung bei und wiederholen Sie keine Änderungen des Anbieters oder Assistenten.

Dateien hosts und services

Sichern Sie diese Dateien vor der Bearbeitung als Administrator, ohne eine .txt-Endung hinzuzufügen. Neue Einträge sind nur erforderlich, wenn die von VGaleno genannten Aliasse noch nicht durch die Installation aufgelöst werden.

  • C:\Windows\System32\drivers\etc\hosts: Ordnen Sie die tatsächliche Server-IP dem Computernamen oder Alias zu. Verwechseln Sie diesen Namen nicht mit der Informix-Instanz.
  • C:\Windows\System32\drivers\etc\services: Ordnen Sie den Dienstnamen dem von VGaleno genannten TCP-Port zu. Ändern Sie keinen bestehenden Dienst und setzen Sie nicht grundsätzlich Port 2004 voraus.

Diese beiden Zeilen sind Vorlagen, keine Kopiervorgaben. Die erste gehört in hosts, die zweite in services; ersetzen Sie jeden Platzhalter durch die vom Anbieter bestätigte Angabe.

[IP_VGALENO] [HOST_VGALENO]
[SERVICE_VGALENO] [PORT_VGALENO]/tcp

ODBC-Datenquelle (DSN)

Öffnen Sie unter 64-Bit-Windows den 32-Bit-ODBC-Datenquellen-Administrator. Erstellen Sie einen System-DSN mit IBM INFORMIX ODBC DRIVER, auf den das Windows-Konto zugreifen kann, das ImaCash ausführt.

C:\Windows\SysWOW64\odbcad32.exe

Unter 32-Bit-Windows befindet sich der ODBC-Administrator hier: C:\Windows\System32\odbcad32.exe

  • General > Data Source Name: der später in ImaCash einzugebende DSN-Name. Er muss nicht dem Datenbanknamen entsprechen.
  • Connection: Füllen Sie Server Name (Informix-Instanz), Host Name (Computer oder IP), Service (bestätigter Dienst oder Port), Protocol (gegebenenfalls onsoctcp) und Database Name (aktive Datenbank) mit den Angaben von VGaleno aus.

onsoctcp bedeutet TCP. Enthält Service einen Alias, muss Windows ihn über den zugehörigen Eintrag in services auflösen. VGaleno muss den Port der Installation bestätigen; es gibt keinen universellen Port. Prüfen Sie einen funktionierenden DSN über seinen Namen, ohne ihn zur Eingabe eines numerischen Ports neu anzulegen.

Integration bereit für den nächsten Schritt

Wenn diese Integrationsbeschreibung zu Ihrer Software passt, ist der nächste Schritt der Übergang in den realen Betrieb

Wir helfen Ihnen, den Projektumfang zu prüfen, kompatible Hardware zu bestätigen und den nächsten Implementierungsschritt vorzubereiten.