Handbuch als PDF speichern oder drucken  


NVXCFT Cloud File Transfer


Diese App ist vergleichbar mit einer Library und wird für den Dateitransfer in BC verwendet.

Aktuelle Version: 1.1.10.0 ab Business Central 22.

Handbuch


Erstellungsdatum: 2024/11/22
Die aktuelle Version dieses Handbuchs finden Sie unter:

https://www.navax.app/help.php?AppID=NVXCFT&L=de


☰ Inhaltsverzeichnis



Allgemein

  • App Cloud File Transfer

Einrichtung

  • Cloud File Transfer Einrichtung
    In dieser Tabelle werden die Standard-Einrichtungen für den Cloud File Transfer durchgeführt...
  • Aufbewahrungsrichtlinie
    Es wurde eine eigene Aufbewahrungsrichtlinie für das CFT Datei Archiv bereit gestellt...

Aufgaben

  • Arbeiten mit Cloud File Transfer
    Man kann mithilfe von Codeunit CFTFileInterfaceMgtNVX Dateien laut CFT Setup exportieren oder importieren...
  • Export Prozess
    Eine grafische Aufstellung wie der Export Prozess funktioniert...
  • Import Prozess
    Eine grafische Aufstellung wie der Import Prozess funktioniert...

Anhang

  • Versionshinweise

Docs  /  NVXCFT Cloud File Transfer  /  Allgemein
Allgemein

Diese App ist vergleichbar mit einer Library - d.h. alleinstehend kann sie im Prinzip nicht verwendet werden. Die App wird allerdings für den Dateitransfer in BC verwendet.

Business Central in der Cloud

Hier kann diese App mithilfe von einem Flow verwendet werden um Dateien auf einen Server in der Serverlandschaft zu speichern.

Achtung

Für den Flow wird eine PowerAutomate Premium Lizenz benötigt.

Business Central OnPrem

Hier kann diese App mit der App OnPremise File Transfer verwendet werden um Dateien in meiner Serverlandschaft lokal zu speichern. OnPremise File Transfer

Docs  /  NVXCFT Cloud File Transfer  /  Einrichtung
CFT Einrichtung

In dieser Tabelle werden die Standard-Einrichtungen für den Cloud File Transfer durchgeführt.

Allgemein, Felder
Archiv DateipfadGibt den Archiv Dateipfad an.
ÜbertragungsartGibt den Übertragungstyp der Dateiübertragung an.

Standardeinrichtungen, Felder
Standard VerwendungszweckGibt den Standard Verwendungszweck an.
Standard Import PfadGibt den Standard Importpfad an.
Standard Export PfadGibt den Standard Exportpfad an.

Flow, Felder
Import Flow UriGibt die Uri des Flows zum Importieren der Dateien an.
Export Flow UriGibt die Uri des Flows zum Exportieren der Dateien an.
HTTP Request TimeoutGibt den Timeout in Millisekunden für den HTTP Request an. Der Standardwert ist 100000 und der Maximalwert sollte bei 300000 (5 Minuten) liegen.

Hinweis

Wird die OnPremise File Transfer App installiert, so gibt es die zusätzliche Übertragungsart OnPremise.
OnPremise File Transfer

Docs  /  NVXCFT Cloud File Transfer  /  Einrichtung
Aufbewahrungsrichtlinie

Es wurde eine eigene Aufbewahrungsrichtlinie für das CFT Datei Archiv bereit gestellt. Der vorgeschlagene Wert für die Aufbewahrungsdauer ist 6 Monate aber er kann nach belieben angepasst werden.

Docs  /  NVXCFT Cloud File Transfer  /  Aufgaben
Arbeiten mit Cloud File Transfer

Man kann mithilfe von Codeunit CFTFileInterfaceMgtNVX Dateien laut CFT Setup exportieren oder importieren. Die App kann entweder in einer Cloud Datenbank mit Flows verwendet werden oder mit der Erweiterung OnPremise File Transfer für OnPremise Datenbanken den direkten Dateizugriff erlauben und so die Flows zu umgehen. Welche Variante verwendet wird steuert welche Apps Installiert sind und was in der CFT Einrichtung eingestellt ist.

Einrichten der Flows

Über einen HTTP Request an eine der im CFT Setup definierten Uri kann der Export bzw. Import Flow gestartet werden. Die Flows senden ein HTTP POST oder GET Request an die als Webservice freigegebenen Pages um eine Datei nach BC zu importieren oder über zb. einen Dateisystem-Connector in einen vorhandenen Ordner zu exportieren.

Achtung

Für den Flow wird eine PowerAutomate Premium Lizenz benötigt.
In der Repository sind 2 Beispieldateien für den Import oder Export vorhanden. ExportFile_CloudFileTransfer_Demo_20220113070553.zip ImportFile_CloudFileTransfer_Demo_20211020045958.zip In diesen Flows sind Passwörter zur Anmeldung gespeichert. Diese Anmeldedaten müssen nach dem Import der Vorlagen mit echten Daten ersetzt werden. Beim Import sind Anmeldedaten in dem HTTP2 Schritt. Beim Export sind die Anmeldedaten beim HTTP als auch HTTP2 Schritt. Für die Anmeldedaten wird eine Azure Active Directory Application benötigt mit einem Secret. So sind die Daten Einzugeben:

Achtung

Eine Azure Active Directory Registration muss zuvor von den Cloud Administratoren auf den Tenant eingerichtet sein.
Hier sind die Referenzen für die Anlage: Automation APIS Using S2S Authentication V2 OAUTH Client Creds Grant Flow Für den Zugriff auf Lokale Daten auf der OnPremise Infrastruktur wird ein OnPremise Data Gateway benötigt: Gateway Reference OnPremise Data Gateway Ist das Gateway korrekt eingerichtet so ist dann in PowerAutomate eine Verbindung ersichtlich.

Hinweis

Der Flow läuft in der Standardeinrichtung immer Asynchron. Wenn der Flow synchron abgearbeitet werden soll, das heißt, dass die Dateien importiert werden müssen, damit sie in einem Code verwendet werden können. Dann muss das Flow-Beispiel um ein Response-Element erweitert werden. In dem Response-Element (sobald vorhanden) kann dann eingestellt werden, ob der Flow Synchron oder Asynchron verarbeitet wird. Ohne Response-Element wird er immer Asynchron verarbeitet.

Testen der Flows

Nach dem Einrichten können die Flows manuell getestet werden. In den CFT Files können Dateien manuell importiert oder exportiert werden, als auch die Flows manuell gestartet werden. Dafür muss in der CFT Einrichtung bereits der jeweilige Flow eingerichtet sein. Bei dem OnPremise Variante müssen die Flows natürlich nicht getestet werden, da es diese hier nicht gibt.

Implementierung in Anwendungen

Beispielcode für die Implementierung in Prozessen. Die Implementierung ist dieselbe für die Verwendung von Flows oder OnPremise für die Verwendung von direktem Dateizugriff.

Export

Das CFT File muss vor dem Export angelegt werden und die zu exportierende Datei als Blob darin abgelegt werden. Danach kann der Export gestartet werden. 
    procedure ExportFile(FileName: Text; FileSubPath: Text; TempBlob: Codeunit "Temp Blob");
    var
        CFTFile: Record "CFT Files NVX";
        CFTSetup: Record "CFT Setup NVX";
        FileInterfaceMgt: Codeunit CFTFileInterfaceMgtNVX;
        RecRef: RecordRef;
    begin
        CFTSetup.Get();

        CFTFile.Init();
        CFTFile.Usage := CFTFile.Usage::SCHILLPDFFileExportNVX;
        CFTFile.TransferDirection := CFTFile.TransferDirection::Export;
        CFTFile.Filename := CopyStr(FileName, 1, MaxStrLen(CFTFile.Filename));
        CFTFile.FilePath := CopyStr(FileSubPath, 1, MaxStrLen(CFTFile.FilePath));
        CFTFile.ExportType := CFTFile.ExportType::Folder;

        RecRef.GetTable(CFTFile);
        TempBlob.ToRecordRef(RecRef, CFTFile.FieldNo(FileContent));
        RecRef.SetTable(CFTFile);

        CFTFile.Insert(true);

        FileInterfaceMgt.RunFileExport(CFTSetup, CFTFile);
    end;

Import

Vor dem Import müssen die Dateien importiert werden und danach können sie verarbeitet werden. Die Dateien werden Asynchron importiert, das bedeuted, dass sie ggf. noch nicht importiert wurden, wenn sie wie im Codebeispiel ersichtlich durchlaufen werden. 
    procedure ImportAllFilesFromImportPath(ImportPath: Text)
    var
        CFTSetup: Record "CFT Setup NVX";
        FileInterfaceMgt: Codeunit CFTFileInterfaceMgtNVX;
    begin
        CFTSetup.Get();
        FileInterfaceMgt.RunFileImport(CFTSetup, ImportPath);

        CFTFile.Reset();
        CFTFile.SetRange(Usage, Usage::MyUsage);
        CFTFile.SetRange(HasValue, true);
        if CFTFile.FindSet() then
            repeat
                ProcessImportedFile(CFTFile);
            until CFTFile.Next() = 0;
    end;

Docs  /  NVXCFT Cloud File Transfer  /  Aufgaben
Export Prozess

Eine grafische Aufstellung wie der Export Prozess funktioniert.

Docs  /  NVXCFT Cloud File Transfer  /  Aufgaben
Import Prozess

Eine grafische Aufstellung wie der Import Prozess funktioniert.

Docs  /  NVXCFT Cloud File Transfer  /  Anhang
Versionshinweise

Möchten Sie wissen, was sich in der Erweiterung geändert hat?
Nachfolgend finden Sie eine Übersicht über die neuen Funktionen und Änderungen, die in den Updates vorgenommen wurden. Build-Übersicht in DevOps

NVXCFT 1.1.10.0

ab Business Central 22
2024/07/22

  • Fehlerbehebungen

    • Fehler behoben der das setzen des Verwendungszwecks beim manuellen Import verhindert hat.

NVXCFT 1.1.9.0

ab Business Central 22
2024/07/19

  • Verbesserungen

    • Ein Timoutout für HTTP Requests zum starten von den Flows in der Einrichtung hinzugefügt.

NVXCFT 1.1.8.0

ab Business Central 22
2024/06/26

  • Verbesserungen

    • Eine Aufbewahrungsrichtlinie für das CFT Datei Archive hinzugefügt.
    • Die Runtime angepasst, damit sie der Minimalen Abhängigkeit entspricht.

NVXCFT 1.1.7.0

ab Business Central 22
2023/10/19

  • Änderungen

    • Anpassungen für BC 23 Kompatibilität.

NVXCFT 1.1.6.0

ab Business Central 18
2023/10/16

  • Verbesserungen

    • Unterstützung von Synchronen Import und Export Flows. Wenn der Flow einen Response zurückliefert und so eingestellt ist, dass der Anforderer auf die Rückmeldung warten muss, dann kann das die App nun verarbeiten.

NVXCFT 1.1.5.0

ab Business Central 18
2023/06/21

  • Verbesserungen

    • Beim automatischen Import von Dateien kann jetzt ein Verwendungszweck mitgegeben werden.

NVXCFT 1.1.4.0

ab Business Central 18
2023/04/17

  • Fehlerbehebungen

    • Beim Import von Dateien über die page CFT Import Datei (CFTImportFileNVX) wurde das Feld Übertragungsrichtung nicht befüllt.

NVXCFT 1.1.3.0

ab Business Central 18
2023/05/01

  • Verbesserungen

    • Die Tabelle Webservice Aggregate wurde echt und nicht temporär verwendet.

NVXCFT 1.1.2.0

ab Business Central 18
2022/03/10

  • Verbesserungen

    • Beim erstellen einer neuen Sandbox Umgebund in der Cloud werden die URLs in der CFT Einrichtung nun gelöscht.

NVXCFT 1.1.1.0

ab Business Central 16

  • Fehlerbehebungen

    • Die CFT Usage wird nun als Name übertragen und nicht mehr dessen Caption. Dadurch ist diese Sprachenunabhängig und die Caption muss nicht mehr dem Namen entsprechen

NVXCFT 1.1.0.0

ab Business Central 16

  • Ursprungsversion

  Handbuch als PDF speichern oder drucken  
DE|EN Impressum