Table of Contents

Anwendungsszenarien

Der unitop HUB bietet zahlreiche Funktionen, die in verschiedenen Geschäftsszenarien eingesetzt werden können. Im Folgenden werden die wichtigsten Anwendungsszenarien vorgestellt.

Drucken von PDF-Dokumenten auf lokalen Druckern

Sie haben Business Central in der Cloud, müssen aber Dokumente wie Belege, Rechnungen oder Berichte auf lokalen Druckern ausgeben.

  1. Einrichtung

    • Öffnen Sie die "Hub Einrichtung" über die Suche in Business Central.
    • Stellen Sie sicher, dass eine gültige Hub-Konfiguration vorhanden ist und die Verbindung funktioniert.
    • Öffnen Sie über "Client Drucker Einrichtungen öffnen" die Druckereinrichtung.
    • Legen Sie die benötigten Drucker mit einem eindeutigen Code und einer Beschreibung an.

  2. Drucker abrufen

    • Verwenden Sie die Funktionsart "Get Printer List", um die verfügbaren Drucker abzurufen.
    • Wenn Sie die Drucker von einem Client abrufen möchten, aktivieren Sie "Auf dem Client ausführen" und geben Sie eine Client-ID an.

  3. PDF-Dokument drucken

    • Wählen Sie die Funktionsart "Print PDF".
    • Wählen Sie die passende "Hub Einrichtung Code".
    • Geben Sie den "Druckername" oder den "Druckereinrichtungs-Code" an.
    • Laden Sie das PDF-Dokument als Datei-Blob hoch oder geben Sie eine Berichtsnummer an.
    • Konfigurieren Sie bei Bedarf weitere Druckoptionen wie Anzahl Kopien, Farbdruck, Duplexdruck und Querformat.
    • Bei Bedarf können Sie auch Papierformat und Seitenränder anpassen.
    • Führen Sie die Anfrage aus.
Hinweis

Verwenden Sie das unitop Hub Testcockpit, um die Druckfunktion mit verschiedenen Einstellungen zu testen, bevor Sie sie in Ihrem Produktivprozess implementieren.

Dateioperationen auf dem lokalen Dateisystem

Sie müssen aus Business Central heraus Dateien auf dem lokalen Dateisystem speichern, abrufen oder löschen.

  1. Datei speichern

    • Öffnen Sie das "unitop Hub Testcockpit" über die Suche oder die Hub-Einrichtung.
    • Wählen Sie die Funktionsart "Save File".
    • Wählen Sie die passende "Hub Einrichtung Code".
    • Geben Sie den "Zielpfad" an, in dem die Datei gespeichert werden soll.
    • Definieren Sie den "Dateinamen" und bei Bedarf die "Dateierweiterung".
    • Laden Sie den Dateiinhalt als "Datei Blob" hoch.
    • Führen Sie die Anfrage aus.

  2. Datei abrufen

    • Wählen Sie die Funktionsart "Get File".
    • Wählen Sie die passende "Hub Einrichtung Code".
    • Geben Sie den vollständigen Pfad zur Datei im Feld "Quelldateipfad" an.
    • Führen Sie die Anfrage aus.
    • Der Inhalt der Datei wird als Base64-codierter Text im Antwortfeld zurückgegeben.

  3. Datei löschen

    • Wählen Sie die Funktionsart "Delete File".
    • Wählen Sie die passende "Hub Einrichtung Code".
    • Geben Sie den vollständigen Pfad zur Datei im Feld "Quelldateipfad" an.
    • Führen Sie die Anfrage aus.

Hinweis

Der unitop HUB kann nur auf Pfade zugreifen, die im "File Interface" des unitop HUB Control konfiguriert wurden. Stellen Sie sicher, dass die erforderlichen Pfade dort freigegeben sind.

PDF-Manipulation

Sie müssen PDF-Dokumente bearbeiten, z.B. mehrere PDFs zusammenführen, ein PDF in Einzelseiten aufteilen oder ein PDF mit einem Passwort schützen.

  1. PDF-Dateien zusammenführen (Append PDF)

    • Öffnen Sie das "unitop Hub Testcockpit" über die Suche oder die Hub-Einrichtung.
    • Wählen Sie die Funktionsart "Append PDF".
    • Wählen Sie die passende "Hub Einrichtung Code".
    • Laden Sie die Basis-PDF als "Datei Blob" hoch.
    • Laden Sie die anzuhängende PDF als "Zusätzliche Datei Blob" hoch.
    • Führen Sie die Anfrage aus.
    • Die zusammengeführte PDF wird im Antwortfeld zurückgegeben.

  2. PDF in Einzelseiten aufteilen (Split PDF)

    • Wählen Sie die Funktionsart "Split PDF".
    • Wählen Sie die passende "Hub Einrichtung Code".
    • Laden Sie die PDF als "Datei Blob" hoch.
    • Definieren Sie die "Startseite" und "Endseite" für den Ausschnitt.
    • Führen Sie die Anfrage aus.
    • Die extrahierten Seiten werden als neue PDF im Antwortfeld zurückgegeben.

  3. PDF mit Passwort schützen

    • Wählen Sie die Funktionsart "Set PDF Password".
    • Wählen Sie die passende "Hub Einrichtung Code".
    • Laden Sie die PDF als "Datei Blob" hoch.
    • Geben Sie das gewünschte Passwort im Feld "PDF Passwort" ein.
    • Führen Sie die Anfrage aus.
    • Die passwortgeschützte PDF wird im Antwortfeld zurückgegeben.

  4. PDF zu PDFa konvertieren

    • Wählen Sie die Funktionsart "Convert PDF 2 PDFa".
    • Wählen Sie die passende "Hub Einrichtung Code".
    • Laden Sie die PDF als "Datei Blob" hoch.
    • Wählen Sie das gewünschte PDFa-Format aus.
    • Führen Sie die Anfrage aus.
    • Die konvertierte PDFa wird im Antwortfeld zurückgegeben.

Kommunikation mit externen Systemen über TCP

Sie müssen mit einem externen System wie einem Kassensystem, einer Waage oder einem anderen Gerät über TCP kommunizieren.

  1. TCP-Nachricht senden
    • Öffnen Sie das "unitop Hub Testcockpit" über die Suche oder die Hub-Einrichtung.
    • Wählen Sie die Funktionsart "Send TCP".
    • Wählen Sie die passende "Hub Einrichtung Code".
    • Geben Sie die "TCP Adresse" und den "TCP Port" des Zielgeräts an.
    • Verfassen Sie die "TCP Nachricht", die gesendet werden soll.
    • Aktivieren Sie bei Bedarf "TCP Antwort abwarten", wenn eine Antwort vom Zielgerät erwartet wird.
    • Führen Sie die Anfrage aus.
    • Wenn "TCP Antwort abwarten" aktiviert war, wird die Antwort im Antwortfeld zurückgegeben.

Kommunikation über serielle Schnittstellen (COM-Port)

Sie müssen mit einem Gerät kommunizieren, das über eine serielle Schnittstelle (COM-Port) angeschlossen ist, wie z.B. ein Barcode-Scanner, eine Waage oder ein älteres Peripheriegerät.

  1. COM-Port-Kommunikation einrichten
    • Öffnen Sie das "unitop Hub Testcockpit" über die Suche oder die Hub-Einrichtung.
    • Wählen Sie die Funktionsart "ComPort".
    • Wählen Sie die passende "Hub Einrichtung Code".
    • Geben Sie den "COM-Port" an (z.B. COM1, COM2).
    • Konfigurieren Sie die Kommunikationsparameter:
      • Baudrate
      • Datenbits
      • Parität
      • Stoppbits
      • Übertragungsmodus
      • Bei Bedarf Start- und Endzeichen
    • Geben Sie den zu sendenden "Inhalt" an.
    • Wenn Sie die Kommunikation auf einem Client ausführen möchten, aktivieren Sie "Auf dem Client ausführen" und geben Sie eine Client-ID an.
    • Legen Sie bei Bedarf einen "Timeout in Sekunden" fest.
    • Führen Sie die Anfrage aus.

Dateiübertragung via FTP/SFTP

Sie müssen Dateien zu einem FTP- oder SFTP-Server hoch- oder herunterladen.

  1. FTP-Upload

    • Öffnen Sie das "unitop Hub Testcockpit" über die Suche oder die Hub-Einrichtung.
    • Wählen Sie die Funktionsart "FTP Upload File".
    • Wählen Sie die passende "Hub Einrichtung Code".
    • Geben Sie den "FTP Host", "FTP Nutzername" und "FTP Passwort" an.
    • Definieren Sie den "FTP Dateipfad", wo die Datei gespeichert werden soll.
    • Laden Sie den Dateiinhalt als "Datei Blob" hoch.
    • Bei Bedarf können Sie die Anzahl der "Versuche" anpassen.
    • Führen Sie die Anfrage aus.

  2. SFTP-Upload

    • Wählen Sie die Funktionsart "SFTP Upload File".
    • Wählen Sie die passende "Hub Einrichtung Code".
    • Geben Sie den "SFTP Host", "SFTP Nutzername" und "SFTP Passwort" an.
    • Definieren Sie den "SFTP Dateipfad", wo die Datei gespeichert werden soll.
    • Laden Sie den Dateiinhalt als "Datei Blob" hoch.
    • Führen Sie die Anfrage aus.

  3. SFTP-Download

    • Wählen Sie die Funktionsart "SFTP Download File".
    • Wählen Sie die passende "Hub Einrichtung Code".
    • Geben Sie den "SFTP Host", "SFTP Nutzername" und "SFTP Passwort" an.
    • Definieren Sie den "SFTP Dateipfad" der herunterzuladenden Datei.
    • Führen Sie die Anfrage aus.
    • Der Inhalt der Datei wird als Base64-codierter Text im Antwortfeld zurückgegeben.

Zahlungsabwicklung mit Zahlungsterminals

Sie müssen eine Zahlung über ein Zahlungsterminal abwickeln, das das ZVT-Protokoll unterstützt.

  1. Zahlung senden
    • Öffnen Sie das "unitop Hub Testcockpit" über die Suche oder die Hub-Einrichtung.
    • Wählen Sie die Funktionsart "Send Payment".
    • Wählen Sie die passende "Hub Einrichtung Code".
    • Geben Sie die "ZVT Kartenlesegerät IP" oder die "ZVT Kartenlesegerät Domain" an.
    • Definieren Sie den "ZVT Kartenlesegerät Port".
    • Tragen Sie den "Zahlungsbetrag" ein.
    • Führen Sie die Anfrage aus.
    • Das Ergebnis der Zahlungstransaktion wird im Antwortfeld zurückgegeben.

Verwenden von Plugins

Sie haben ein spezielles Plugin für den unitop HUB entwickelt oder installiert und möchten dieses aus Business Central heraus aufrufen.

  1. Plugin installieren

    • Platzieren Sie die Plugin-Dateien im "Plugins"-Unterordner des unitop HUB-Installationsverzeichnisses.
    • Starten Sie den unitop HUB-Dienst neu.

  2. Plugin ausführen

    • Öffnen Sie das "unitop Hub Testcockpit" über die Suche oder die Hub-Einrichtung.
    • Wählen Sie die Funktionsart "Execute Plugin".
    • Wählen Sie die passende "Hub Einrichtung Code".
    • Geben Sie den "Plugin Name" an.
    • Bei Bedarf definieren Sie den "Plugin Namespace", "Plugin Klassenname" und "Plugin Funktionsname".
    • Wenn das Plugin Parameter benötigt, geben Sie diese als gültiges JSON-Array im Feld "Plugin Parameter" an.
    • Wenn Sie das Plugin auf einem Client ausführen möchten, aktivieren Sie "Auf dem Client ausführen" und geben Sie eine Client-ID an.
    • Führen Sie die Anfrage aus.
    • Das Ergebnis der Plugin-Ausführung wird im Antwortfeld zurückgegeben.
×
Vergrößertes Bild