PEIQ Knowledge Base

[0-20] INBOUND / OUTBOUND via SFTP

Owned by Martin Huber
Last updated: 2022-10-19 by Manh Long Nguyen
3 min read

Transportverfahren

SFTP (von PEIQ bereitgestellter SFTP Zugang)

Objekt

Diverse Formate wie XML, PDF, JSON, CSV, Bildformate (JPG, PNG), etc.

Trigger

Typischerweise festgelegt in den auf sFTP basierenden Schnittstellen

Unterstützte Drittsysteme

SFTP-Clients

PEIQ PRINT NGEN enthält Mechanismen, die Im- und Exporte verschiedenster Daten automatisch auf Windows-Dateifreigaben durchführen. Diese Im- und Export-Verzeichnisse (Hotfolder) können über einen von PEIQ gestellten SFTP-Server auch außerhalb der Cloud-Umgebung zur Verfügung gestellt werden, z. B. um Agenturmeldungen kontinuierlich in PEIQ PRINT NGEN zu importieren oder Print-Daten für Dienstleister:innen bereitzustellen.

Funktionalitäten der Schnittstelle

  • Generische Schnittstelle zum Austausch von Bewegungsdaten

  • Verschlüsselter Transport

  • Externe Rechteverwaltung und Zugriff per SFTP auf Verzeichnisebene (Eigener SFTP-Zugang pro Verzeichnis möglich)

  • Ausgehende Daten werden von PEIQ zum Abruf bereitgestellt (OUTBOUND, Richtung bezieht sich auf Perspektive von PEIQ); OUTBOUND = ausgehende Daten werden im SFTP-Verzeichnis abgespeichert, um von dort abgeholt zu werden

  • Eingehende Daten schreibt ein Drittsystem auf den SFTP Bereich in der PEIQ Cloud (INBOUND, Richtung bezieht sich auf Perspektive von PEIQ); INBOUND = eingehende Daten werden von außen in den Ordner kopiert und regelmäßig durch PEIQ eingelesen und interpretiert

Inhaltsverzeichnis

Zugriffswege

Der Zugriff auf die Verzeichnisse erfolgt über folgende Protokolle und Clients:

  • Protokoll: SFTP (SSH File Transfer Protocol/Secure File Transfer Protocol)

  • Port: 22

  • Authentifizierung: Benutzername/Passwort oder Benutzername/Zertifikat

  • Clients (Auswahl):
    GUI: Z. B. FileZilla
    Kommandozeile/Skript: OpenSSH, verfügbar unter Windows 10 und Server 2019 nativ, ältere Windows-Versionen per Installation von OpenSSH, Linux, MacOS
    Eigenes Programm: SSH/SFTP-Bibliotheken sind für verschiedenste Programmiersprachen verfügbar

  • SFTP-Verzeichnis:
    Das SFTP-Verzeichnis ist (technisch bedingt) immer das Unterverzeichnis “/sftp”. Deshalb muss beim Zielverzeichnis (“entferntes Verzeichnis”) immer “sftp” oder “/sftp” eingetragen werden, damit der Upload funktioniert.

Hinweis:

Linux ist case-sensitive und der SFTP-Server läuft unter Linux. Demzufolge lautet der Ordner /sftp.

Entferntes Verzeichnis bei Transfer-Einstellungen

Der Up- oder Download über das jeweilige SFTP-Rootverzeichnis (/) ist nicht möglich.

Unterverzeichnis /sftp

 

Workflow

Import

  • Importe werden per SFTP im SFTP-Eingangsverzeichnis angeliefert

  • Ein Workflowdämon überwacht dieses Verzeichnis und importiert in einem definierten Zeitintervall (z. B. jede Minute) neu eingelaufene Daten nach PEIQ PRINT NGEN (“Abräumen”)

Export

  • Exporte werden als XML, PDF oder ähnliches im SFTP-Ausgangsordner aus PEIQ PRINT NGEN abgelegt 

  • Dort können die Daten vom externen Anbieter je nach eingesetztem Workflow automatisiert oder manuell abgeholt werden. Dabei ist “abzuräumen”.

 

Im folgenden Video werden die Importworkflows (TV, Börse, Karikatur, Rätsel etc.) erklärt:

https://www.youtube.com/watch?v=LVpNSRurT6A&t=1s

Ordnerstruktur

Abhängig vom vereinbarten Funktionsumfangs der PEIQ Cloud und den aktivierten Schnittstellen werden gewisse Ordner bereitgestellt, um diese den entsprechenden externen Dienstleister (Inhaltelieferanten oder Inhalteverarbeiter) freigeben zu können. Dies erfolgt sowohl auf dem Test- als auch auf dem Prod-System.

Die genaue Benamung und Ordnerstruktur ergibt sich aus den jeweiligen Schnittstellen-Dokus und den Mitwirkungs-Werte-Listen.

Die Ordnerstruktur orientiert sich an folgender Illustration. Dabei bilden die nachfolgend eingefärbten Ordner jeweils einen separat verschlüsselten Zugang.

Legende

SFTP

noch nicht vorhanden

Nicht-SFTP

SFTP

noch nicht vorhanden

Nicht-SFTP

Themengebiet

1. Hierachie

2. Hierarchie

3. Hierarchie

4. Hierarchie

Themengebiet

1. Hierachie

2. Hierarchie

3. Hierarchie

4. Hierarchie

Agenturen

AgnBilder

AFP

 

 

 

 

DPA

 

 

 

 

IMAGO

 

 

 

 

RND

 

 

 

 

SID

 

 

 

 

SPS

 

 

 

AgnTexte

AFP

 

 

 

 

DPA

 

 

 

 

EPD

 

 

 

 

KNA

 

 

 

 

OTS

 

 

 

 

RND

 

 

 

 

RP

 

 

 

 

SID

 

 

 

 

SPS

 

 

Anzeigen

Anzeigen

Adserver

 

 

 

 

Anbieter Anzeigen

 

 

 

 

Busseforms

 

 

 

 

CRM

 

 

 

 

Datawarehouse

 

 

 

 

Fueller

 

 

 

 

IS-MAM

 

 

 

 

Online-Anzeigen

 

 

 

 

Partnerverlage

 

 

 

Import Druckmaterial

Anbieter Druck

 

 

 

Import Logos

Anbieter Logo

 

 

Dienstleister

Pressemonitor

 

 

 

Archiv

Archivimport

Artikel

 

 

 

 

Bilder

 

 

 

 

Seiten

 

 

 

Archivexport

 

 

 

Produktionsdaten

Import_Produktionsdaten

 

 

 

Technik

 

 

 

 

Grafische red. Anlieferungen

Bilder

 

 

 

 

Borse

 

 

 

 

Export_Bilder

 

 

 

 

Export_Seiten

 

 

 

 

Grafiken

 

 

 

 

Horoskope

 

 

 

 

Karikatur

 

 

 

 

Logos

 

 

 

 

Raetsel

 

 

 

 

RND

 

 

 

 

Seiten_Extern

 

 

 

 

Sudoku

 

 

 

 

TVProgramm

 

 

 

 

Wetter

 

 

 

Statistik

create

 

 

 

 

Export_Datenbereitstellung_Statistik

 

 

 

E-Paper

Epaper

export-hugo

 

 

 

 

Partnerverlage

 

 

 

 

Visiolink

 

 

Event

Events

LeoEvent

 

 

 

 

MSU

 

 

Blattplanung/Druck

PDF

 

 

 

 

Planungsdaten

 

 

 

 

ppi

 

 

 

Repro

repro

in

 

 

 

 

out

 

 

 

Bildoptimierung_Extern

in

 

 

 

 

out

 

 

Sport

Sporttabellen

MSU

 

 

Geschäftspartner/Stammdaten

Import Geschäftspartner

CRM

 

 

 

 

Honorarsystem

 

 

 

 

FI

 

 

 

Export Zahlungsdaten

CRM

 

 

Honorar/Abrechnung

Export_Honorar

Export

 

 

 

 

ExportFehler

 

 

 

Export Rechnungsdaten

Postversand

 

 

 

 

Partnerverlage

 

 

 

 

Datawarehouse

 

 

 

 

FI

 

 

 

 

elektr. Rechnungen

 

 

 

 

steuerl. Betrachtung

 

 

 

Mitwirkungspflichten zum Setup

Die Mitwirkung, die für dieses Setup erforderlich ist, finden Sie hier:

Mitwirkungspflichten: INBOUND / OUTBOUND via SFTP

Mitwirkungspflichten zum Betrieb

  • Der/die Kund:in muss die zeitnahe Abholung bereitgestellter Export-Daten sicherstellen

  • Der/die Kund:in muss sicherstellen, dass nur die verabredeten Dateiformate in die jeweiligen Verzeichnisse hochgeladen werden und keine zusätzlichen oder nicht-importierbaren Dateien

  • Der verwendete SFTP-Client muss fehlertolerant sein, um auch kurze Ausfälle des SFTP-Servers z. B. bei Wartungsarbeiten oder durch Schwenks im Loadbalancer ohne Ausfall zu überbrücken

  • Der/die Kund:in muss sicherstellen, dass der SFTP-Client für die hochgeladenen Dateien den Zeitstempel des Upload-Vorgangs verwendet (wichtig für das Monitoring)

Bekannte Fehlerquellen

  • Der/die Kund:in versucht sich per FTP-Protokoll zu verbinden (anderes, veraltetes Protokoll)

  • Der/die Kund:in versucht sich per FTPS-Protokoll zu verbinden (anderes Protokoll)

  • Der/die Kund:in stellt im Client nicht Port 22 ein.

Optionale weitere Informationen (auf Anfrage)

https://peiq.atlassian.net/wiki/spaces/CORE/pages/906133524

Verwandte Seiten

 

 

 

Impressum