Schnittstellendienste erstellen
Über den Schnittstellendienst kann der Benutzer Daten aus einer CSV- oder Excel-Datei in eine SCV-Tabelle importieren bzw. Daten aus einer SCV-Tabelle in eine CSV- oder Excel-Datei exportieren. In diesem Thema wird beschrieben, wie Sie einen Schnittstellendienst mit Dateneinheit = SCV-Tabelle und einem Schnittstellentyp = CSV erstellen.
So erstellen Sie einen Schnittstellendienst:
- Wählen Sie den Pfad Konfiguration > Allgemein > Schnittstellendienste > Schnittstellendienste.
- Klicken Sie auf Neu. Daraufhin wird das Fenster Neuer Schnittstellendienst angezeigt.
- Geben Sie die folgenden Daten ein:
- Schnittstellentyp
- Der Typ der Schnittstelle. Wählen Sie "CSV" aus.
- Dateneinheit
- Die Dateneinheit, die der Schnittstelle zugeordnet werden soll. Wählen Sie "SCV-Tabelle" aus.Hinweis: Das Kontrollkästchen Spalte pro Kennzahl wird angezeigt, wenn das Feld Dateneinheit auf "Szenarienwert" gesetzt ist.
- Schnittstellenrichtung
- Die Richtung des Datenflusses. Mögliche Werte:
- Import
- Export
- Klicken Sie auf OK. Es wird eine neue Seite für die Schnittstellendienste angezeigt.
-
Geben Sie auf der Registerkarte Schnittstellendetails die folgenden Informationen an:
- Name
- Ein eindeutiger Name des Schnittstellendienstes.
- Anzeigename
- Der Name, der für den Schnittstellendienst angezeigt wird. Wenn dieser Wert nicht festgelegt ist, wird der im Feld Name angegebene Wert voreingestellt.
- System
- Gibt den Status des Schnittstellendienstes an. Mögliche Werte:
- An (aktiviert)
- Aus (deaktiviert)
Hinweis: Diese Option ist für die durch das System definierte Einheit aktiviert. - Schnittstellentyp
- Der Typ der Schnittstelle. Dieser Wert wird als Standardwert aus dem Fenster Neuer Schnittstellendienst übernommen.
- Dateneinheit
- Die Dateneinheit, die der Schnittstelle zugeordnet werden soll. Dieser Wert wird als Standardwert aus dem Fenster Neuer Schnittstellendienst übernommen.
- Schnittstellenrichtung
- Die Richtung des Datenflusses. Dieser Wert wird als Standardwert aus dem Fenster Neuer Schnittstellendienst übernommen.
-
Geben Sie auf der Registerkarte Datenquelle die folgenden Informationen an:
- Datenquelle
- Der Name der Datenquelle (Datei, FTP oder Amazon S3), wie in SCP definiert. Die in der Datenquelle definierte Definition wird beim Ausführen des Schnittstellendienstes mithilfe eines Makros verwendet.Hinweis: Wenn Sie Daten manuell mit einem Dateischnittstellendienst importieren oder exportieren, durchsuchen Sie die Datei, die auf Ihrem lokalen Computer verwendet werden soll.
- Dateinamenmuster verwenden
- Ein Muster oder Ausdruck zum Definieren des Dateinamens. Es wird der Import mehrerer Dateien und das Bestellen oder Gruppieren der Dateien zum Importieren der neuesten Version unterstützt. Es wird der Dateiname mit dem passenden Muster importiert.Hinweis: Diese Option wird nur angezeigt, wenn das Feld Schnittstellentyp auf "Import" gesetzt ist.
- Dateien
- Der Name der für den Schnittstellendienst zu verwendenden Datei. Die angezeigten Dateien basieren auf der definierten Datenquelle. Wenn die Dateien nicht angezeigt werden, klicken Sie auf das Pluszeichen (+), um die erforderliche Datei hinzuzufügen.Hinweis: Wenn die Option Dateinamenmuster verwenden auf "An" gesetzt ist, wird die Feldbezeichnung als Dateinamenmuster angezeigt, und es kann ein regulärer Ausdruck als Dateiname verwendet werden. Die folgenden Variablen werden mit einem Unterstrich als Trennzeichen zwischen den Variablen akzeptiert:
- Beliebiges alphabetisches Zeichen (A-Z)
- Beliebiges alphanumerisches Zeichen (A-Z,0-9)
- Beliebiges numerisches Zeichen
- Feldnamen in Kopfzeile
- Gibt den Inhalt der ersten Zeile der Datei an, die importiert oder exportiert wird. Wenn der Parameter auf "An" gesetzt ist, sind die folgenden Szenarien möglich:
- Wenn die Datei importiert wird, enthält die erste Zeile der Importdatei Feldbezeichnungen und kann übersprungen werden.
- Wenn die Datei exportiert wird, enthält die erste Zeile der Exportdatei die Feldköpfe.
-
Wählen Sie den erforderlichen SCV-Tabellennamen auf der Registerkarte SCV-Tabelle aus. Die Daten auf der Registerkarte Zuordnungen werden auf Basis der von Ihnen ausgewählten SCV-Tabelle angezeigt.
Hinweis:
- Wenn die Datei importiert wurde, werden alle in SZ_SCV_TABLE registrierten Tabellen aufgelistet, für die Folgendes gilt: table_area = Posteingang oder %_Import.
- Wenn die Datei exportiert wird, werden alle SCV-Tabellen und -Ansichten aufgelistet.
-
Geben Sie auf der Registerkarte Dateidetails die folgenden Informationen ein:
- Dateitrennzeichen
- Der Typ des Dateitrennzeichens. Mögliche Optionen:
- Komma
- Registerkarte
- Senkrechter Strich (Pipe)
Hinweis: Standardmäßig ist der Wert des Parameters auf "Komma" gesetzt. - Zahlenformat
- Das Zahlenformat für die Werte, die beim Import von Daten in numerische Felder der SCV-Datenbank validiert werden sollen. Die numerischen Werte werden auf Basis des definierten Formats exportiert.
- Datumsformat
- Das Datumsformat für die Werte, die beim Importieren von Daten in die Datumsfelder der SCV-Datenbank überprüft werden soll. Die Datenwerten werden auf Basis dieses definierten Formats exportiert.Hinweis: Sie müssen das Kennzeichen für Monat und Stunde in Großbuchstaben angeben.
-
Klicken Sie auf die Registerkarte Dateiverarbeitung.
Hinweis: Diese Registerkarte wird nur angezeigt, wenn das Feld Schnittstellenrichtung auf "Import" gesetzt ist.
-
Geben Sie die folgenden Daten ein:
- Dateien anordnen nach
- Die Reihenfolge (aufsteigend), in der die Dateien im dem Verzeichnis auf Basis des angegebenen Werts organisiert werden. Die folgenden Variablen können verwendet werden:
- %file_1 = Die erste Variable im Dateinamen
- %file_2 = Die zweite Variable im Dateinamen
Hinweis: Diese Option ist nur aktiviert, wenn die Option Dateinamenmuster verwenden auf der Registerkarte Datenquelle auf "An" gesetzt ist. - Neueste Datei importieren
- Gibt das Importmuster des Schnittstellendienstes an. Mögliche Szenarien:
- An: Importiert die letzte Datei auf Basis des Dateinamenstempels oder auf Basis des Werts, der in der Option Dateien anordnen nach festgelegt ist.
- Aus: Importiert alle Dateien in einer Reihenfolge, und zwar entweder nach Zeitstempel (die Systemzeit, zu der die Datei gespeichert wurde) oder nach dem Wert, der in der Option Dateien anordnen nach festgelegt ist.
Hinweis:- Diese Option ist nur aktiviert, wenn die Option Dateinamenmuster verwenden auf "An" gesetzt ist.
- Der Zeitstempel basiert auf dem Quell-BS.
- Dateien gruppieren nach
- Die Kriterien, anhand derer die Dateien in einer Gruppe organisiert werden. Die Dateien werden in jeder Gruppe auf Basis des Wertes organisiert, der in der Option Dateien anordnen nach festgelegt ist. Anderenfalls werden die Dateien nach dem neuesten Datum und der Uhrzeit sortiert. Die neueste Datei in jeder Gruppe wird importiert.Hinweis: Diese Option ist nur aktiviert, wenn die Option Dateinamenmuster verwenden auf "An" gesetzt ist.
- Datei nach Import umbenennen
- Die Variablen, auf deren Basis die erfolgreich importierten Dateien umbenannt werden. Die folgende Variablen werden zum Umbenennen verwendet:
- %file = Vollständiger Dateiname
- %file_0 = Dateiname ohne Erweiterung
Beispiele:
- %file_Save: Die Datei "TAR_MD_BOM_20170705060012.csv" wird in "TAR_MD_BOM_20170705060012_save.csv" umbenannt.
- %file_0_complete: Die Datei "TAR_MD_BOM_20170705060012.csv" wird in "TAR_MD_BOM_20170705060012_complete" umbenannt.
-
Geben Sie auf der Registerkarte Importverhalten die folgenden Informationen ein:
- Zieltabelle vor dem Import leeren
- Gibt an, ob in der Zieltabelle alle Zeilen gelöscht oder ob Daten an den ausgehenden Datensatz angehängt werden müssen, bevor die Schnittstelle ausgeführt und Zeilen importiert werden können. Mögliche Szenarien:
- An: Löschen und einfügen
- Aus: Anhängen
- Löschen basiert auf Quellspalte/Wert
- Die Bedingung, auf Basis derer Datensätze aus der Zieltabelle gelöscht werden. Mögliche Szenarien:
- Wenn in diesem Feld keine Werte angegeben sind, werden alle Datensätze aus der Zieltabelle gelöscht.
- Wenn angegeben, werden nur jene Datensätze gelöscht, für die die Werte in den Feldern Quellenspalte und Wert identisch sind.
Hinweis: Diese Optionen sind nur aktiviert, wenn die Option Zieltabelle vor dem Import leeren auf "An" gesetzt ist.
- Klicken Sie auf die Registerkarte Exportfilter. Auf dieser Registerkarte können Sie die Bedingungen zum Filtern der Daten beim Export definieren.
-
Geben Sie die folgenden Daten ein:
- Spalte
- Der Spaltenname der SCV-Tabelle.
- Operator
- Der Operator, der zum Festlegen der Filterbedingung verwendet wird. Mögliche Werte:
- Gleich
- Ungleich
- Wie
- Nicht wie
- Ist null
- Ist nicht null
- Wert
- Der Wert, auf den die Filterbedingung angewendet werden kann.
-
Klicken Sie auf die Registerkarte Exportverhalten.
Hinweis: Diese Registerkarte wird nur angezeigt, wenn die Schnittstellenrichtung auf "Import" gesetzt ist.
-
Geben Sie die folgenden Daten ein:
- Zeitstempel an Dateinamen anhängen
- Zeigt an, ob dem exportierten Dateinamen ein Zeitstempel hinzugefügt werden muss.Hinweis:
- Der Zeitstempel muss im UTC-Format angegeben werden und vor der Erweiterung und nach einem Unterstrich zum Dateinamen hinzugefügt werden. Beispiel: Dateiname_20171030135355.csv.
- Standardmäßig ist der Wert auf "Aus" gesetzt.
- Enthält Anführungszeichen für exportierte Werte.
- Zeigt an, ob die exportierten Werte in Anführungszeichen eingeschlossen werden.Hinweis: Standardmäßig ist der Wert auf "An" gesetzt.
- Klicken Sie auf die Registerkarte Zuordnungen. Die Registerkarte Zuordnungen zeigt die Liste der Attribute an. Die Attributliste wird auf Basis der ausgewählten SCV-Tabelle vorgegeben.
- Fügen Sie, falls erforderlich, ein neues Attribut hinzu. Informationen dazu finden Sie unter Neues Attribut hinzufügen.
-
Klicken Sie auf die Registerkarte Importkonstanten. Diese Registerkarte enthält eine Liste mit Attributen aus der SCV-Tabelle, denen beim Importieren der Daten ein Konstantenwert zugeordnet werden soll.
Hinweis:
- Diese Registerkarte wird nur angezeigt, wenn das Feld Schnittstellenrichtung auf "Import" gesetzt ist.
- Der auf dieser Registerkarte angegebene Wert überschreibt die Daten, die auf der Registerkarte Zuordnung zugeordnet wurden.
- Fügen Sie ggf. eine neue Importkonstante hinzu. Informationen dazu finden Sie unter Neue Importkonstante hinzufügen.
-
Klicken Sie auf die Registerkarte Exportkonstanten. Diese Registerkarte enthält eine Liste mit Attributen aus der SCV-Tabelle, denen beim Exportieren ein Konstantenwert zugeordnet werden soll.
Hinweis: Diese Registerkarte wird nur angezeigt, wenn das Feld Schnittstellenrichtung auf "Export" gesetzt ist.
- Fügen Sie ggf. eine neue Exportkonstante hinzu. Informationen dazu finden Sie unter Neue Exportkonstanten hinzufügen.
- Klicken Sie auf Speichern.