Konfigurieren des Dateiadapters

Artikel
10/14/2023

Konfigurieren des Dateiadapters, Lesen der Sicherheitsempfehlungen und Anzeigen der erforderlichen Berechtigungen

Sie können einen Empfangsspeicherort erstellen und einen Port senden, indem Sie BizTalk Server-Verwaltung oder programmgesteuert verwenden. Dieses Thema konzentriert sich auf die BizTalk Server-Verwaltungskonsole. Für die programmgesteuerten Schritte wechseln Sie zu Erstellen des Empfangsspeicherorts oder programmgesteuertes Senden von Port.

Wichtig

Ab BizTalk Server 2016 können Sie mithilfe des Dateiadapters eine Verbindung mit einer Azure-Dateifreigabe herstellen. Das Azure-Speicherkonto muss auf Ihrem BizTalk Server eingebunden werden. Erste Schritte mit Azure File Storage unter Windows enthält die Bereitstellungsschritte.

Sicherheitsempfehlungen

Der Dateiadapter überträgt Dateien in und aus BizTalk Server aus einem und in ein Verzeichnis. Sie sollten die folgenden Richtlinien für das Sichern und Bereitstellen des Dateiadapters in Ihrer Umgebung beachten:

Öffnen Sie keine Ports, um eine Verbindung mit einer Dateifreigabe im Umkreisnetzwerk herzustellen. Sie sollten den Dateiadapter in Umgebungen mit einer hohen Vertrauensebene einsetzen, z. B. in einem Intranet.
Legen Sie strenge diskretionäre Zugriffssteuerungslisten (DACL) in den Ablageverzeichnissen des Empfangsspeicherorts fest. So müssen Sie beispielsweise für das Verzeichnis, aus dem der Dateiempfangsspeicherort Nachrichten abruft, über Berechtigungen zum Lesen, Schreiben und Löschen von Dateien sowie zum Löschen von Unterordnern und Dateien verfügen, damit dort nur autorisierte Benutzer Nachrichten ablegen können.
Wenn kritische Daten mithilfe des Dateiadapters abgerufen werden, wird empfohlen, IPSec (Internet Protocol Security) zu verwenden.

Erforderliche Berechtigungen

Adapterhandler werden unter dem Sicherheitskontext des Hosts ausgeführt instance für den Adapterhandler ausgewählt. Der Host instance verwendet die Logon Eigenschaft im Hostnamen – Hostinstanzeigenschaften in der BizTalk-Verwaltung. Dieses Logon Konto muss über spezifische Berechtigungen für alle Ordner oder Freigaben verfügen, die vom Dateiadapter verwendet werden.

Der Host instance Benutzerkonto, das vom Handler verwendet wird, erfordert die folgenden Berechtigungen. A ✔ bedeutet, dass die Berechtigung erforderlich ist. Ein leerer Eintrag bedeutet, dass die Berechtigung nicht erforderlich ist.

Berechtigungen	Empfangshandler	Sendehandler
Vollzugriff	✔ auf Freigabeebene (beim Zugriff auf eine Dateifreigabe)
Ordner durchsehen/Datei ausführen		✔ auf Dateiebene
Ordner auflisten/Daten lesen	✔ auf Dateiebene	✔ auf Dateiebene
Attribute lesen		✔ auf Dateiebene
Erweiterte Attribute lesen		✔ auf Dateiebene
Erstellen von Dateien/Schreiben von Daten		✔ auf Dateiebene
Erstellen von Ordnern/Anfügen von Daten		✔ auf Dateiebene
Löschen von Unterordnern und Dateien	✔ auf Dateiebene	✔ auf Dateiebene
Leseberechtigungen		✔ auf Dateiebene
Change		✔ auf Freigabeebene (beim Zugriff auf eine Dateifreigabe)

Tipp

Öffnen Sie auf Dateiebene die erweiterten Berechtigungen für die Datei oder den Ordner, um diese Berechtigungen anzuzeigen.

Hinweis

Jeder Host kann nur einem Empfangshandler zugeordnet sein.

Konfigurieren des Empfangsspeicherorts

Hinweis

Bevor Sie das folgende Verfahren ausführen, müssen Sie bereits einen unidirektionalen Empfangsport hinzugefügt haben. Weitere Informationen finden Sie unter Erstellen eines Empfangsports.

Erweitern Sie in der BizTalk Server Verwaltungskonsole BizTalk Server-Verwaltung, BizTalk-Gruppe, Anwendungen, und erweitern Sie dann die Anwendung, unter der Sie einen Empfangsspeicherort erstellen möchten.
Klicken Sie im linken Bereich auf den Knoten Empfangsports . Klicken Sie anschließend im rechten Bereich mit der rechten Maustaste auf den Empfangsport, der einem vorhandenen Empfangsspeicherort zugeordnet ist oder den Sie einem neuen Empfangsspeicherort zuordnen möchten, und klicken Sie dann auf Eigenschaften.
Wählen Sie im linken Bereich des Dialogfelds Eigenschaften des Empfangsportsdie Option Empfangsspeicherorte aus, und doppelklicken Sie im rechten Bereich auf einen vorhandenen Empfangsspeicherort, oder klicken Sie auf Neu , um einen neuen Empfangsspeicherort zu erstellen.
Wählen Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts im Abschnitt Transport die Option DATEItyp aus der Dropdownliste aus, und klicken Sie dann auf Konfigurieren , um die Transporteigenschaften für den Empfangsspeicherort zu konfigurieren.

Gehen Sie auf der Registerkarte Allgemein wie folgt vor:

Option	Aufgabe
Empfangsordner	Erforderlich. Geben Sie den Pfad zu einem Ordner im Dateisystem, der Netzwerkfreigabe oder der Azure-Dateifreigabe ein, in der der Datei empfangene Handler Dateien liest. Sie können den Pfad direkt in das Textfeld Ordner empfangen eingeben oder ihn über die Schaltfläche Durchsuchen im Dateisystem auswählen. Wenn Sie nach dem Ordner suchen, können Sie auch einen neuen Ordner erstellen, indem Sie neuen Ordner erstellen. Wenn Sie eine Azure-Dateispeicherfreigabe verwenden, geben Sie ein `\\yourfilestoragename.file.core.windows.net\yourfilesharename`. Typ: Schnur Hinweis: Legen Sie die Eigenschaft Des Empfangsordners nicht auf einen Ordner fest, der das NT Distributed File System mit einem symbolischen Link verwendet. Wenn Sie ein verteiltes NT-Dateisystem verwenden, können Sie nur Ordner mit geraden Netzwerkpfaden in Dateiadapter-Empfangsspeicherorten verwenden. Einschränkungen für diese Eigenschaft finden Sie unter Einschränkungen beim Konfigurieren des Dateiadapters. Hinweis: Der URI für einen Sendeport oder Empfangsspeicherort darf nicht länger als 256 Zeichen sein.
Dateimaske	Erforderlich. Geben Sie die Maske für die Dateien an. Diese Maske darf den Standardplatzhalter () enthalten. Standardwert:* .xml Typ:* Schnur Einschränkungen für diese Eigenschaft finden Sie unter Einschränkungen beim Konfigurieren des Dateiadapters.
Öffentliche Adresse	Geben Sie die öffentliche Adresse des Speicherorts an. BizTalk Server stellt diese Adresse externen Partnern zur Verfügung. Wird diese Eigenschaft nicht angegeben, wird sie von der Runtime-Engine wie folgt ersetzt: < file:// Receive-Ordner>/<Dateimaske> Für den Wert dieser Eigenschaft ist ein Adapterpräfix erforderlich. Typ: Schnur Mindestlänge: 0 Maximale Länge: 256
Anzahl der Wiederholungen	Geben Sie an, wie oft versucht werden soll, auf den vorübergehend nicht verfügbaren Empfangsspeicherort in einer Netzwerkfreigabe zuzugreifen. Standardwert: 5 Typ: Lange Mindestwert: 0 Maximaler Wert: MAX_LONG
Wiederholungsintervall (Min.)	Geben Sie an, in welchem Intervall (in Minuten) versucht werden soll, auf den vorübergehend nicht verfügbaren Empfangsspeicherort in der Netzwerkfreigabe zuzugreifen. Standardwert: 5 Minuten Typ: Lange Mindestwert: 0 Maximaler Wert: MAX_LONG

Gehen Sie auf der Registerkarte Authentifizierung wie folgt vor:

Option	Aufgabe
Diese Anmeldeinformationen verwenden, wenn der Host keinen Zugriff auf Netzwerkfreigaben hat	Nur erforderlich, wenn Sie eine Netzwerkfreigabe oder eine Azure-Dateifreigabe verwenden. Standardwert: FALSE Typ: Boolean
Benutzername	Wenn Sie eine Netzwerkfreigabe verwenden, geben Sie den Benutzernamen ein, der Zugriff auf die Freigabe hat. Wenn Sie eine Azure-Dateispeicherfreigabe verwenden, geben Sie den Namen Ihres Speicherkontos ein. Typ: Schnur Hinweis: Wenn mehrere Empfangsspeicherorte, die derselben Netzwerkfreigabe zugeordnet sind, mit alternativen Anmeldeinformationen konfiguriert sind, müssen dieselben Anmeldeinformationen für alle Empfangsspeicherorte verwendet werden. Windows lässt nicht mehrere Verbindungen zu einem freigegebenen Netzwerkserver vom selben Computer aus zu, wenn Sie versuchen, mehrere Sätze von Anmeldeinformationen zu verwenden.
Kennwort	Wenn Sie eine Netzwerkfreigabe verwenden, geben Sie das Kennwort für das Konto ein, das Zugriff auf die Netzwerkfreigabe hat. Wenn Sie eine Azure-Dateispeicherfreigabe verwenden, geben Sie den Zugriffsschlüssel des Speicherkontos ein. die im Azure-Portal aufgeführt ist. Typ: Schnur

Führen Sie auf der Registerkarte Batching die folgenden Schritte aus:

Option	Aufgabe
Anzahl der Nachrichten in einem Batch	Geben Sie an, wie viele Nachrichten maximal in einem Batch übermittelt werden können. Standardwert: 5 Typ: Int Mindestwert: 1 Maximalwert: 256
Maximale Batchgröße (in Byte)	Geben Sie die maximale Gesamtanzahl von Bytes für einen Batch an. Standardwert: 102400 Typ: Int Mindestwert: 1024 Maximaler Wert: MAX_LONG

Der Dateiadapter begrenzt den Batch auf den Wert, der zuerst erreicht wird: maximale Anzahl von Nachrichten oder maximal zulässige Bytes.

Klicken Sie auf OK.
Geben Sie die entsprechenden Werte in das Dialogfeld Eigenschaften des Empfangsspeicherorts ein, um die Konfiguration des Empfangsspeicherorts abzuschließen, und klicken Sie auf OK , um die Einstellungen zu speichern. Informationen zum Dialogfeld Eigenschaften für Empfangsspeicherort finden Sie unter Erstellen eines Empfangsspeicherorts.

Konfigurieren des Sendeports

Erstellen Sie in der BizTalk Server-Verwaltungskonsole einen neuen Sendeport, oder doppelklicken Sie auf einen vorhandenen Sendeport, um diesen zu ändern. Weitere Informationen finden Sie unter Erstellen eines Sendeports. Konfigurieren Sie alle Sendeportoptionen, und geben Sie FILE für die Option Typ im Abschnitt Transport der Registerkarte Allgemein an.
Wählen Sie die Schaltfläche Konfigurieren neben Typ aus.

Gehen Sie auf der Registerkarte Allgemein wie folgt vor:

Option	Aufgabe
Zielort	Erforderlich. Geben Sie den Pfad zum Speicherort im Dateisystem, der öffentlichen Freigabe oder der Azure-Dateifreigabe ein, um die Ausgabenachrichten zu schreiben. Sie können den Pfad direkt im Zielspeicherort eingeben oder ihn über die Schaltfläche Durchsuchen im Dateisystem auswählen. Wenn Sie im Dialogfeld Nach Ordner suchen nach dem Ordner suchen, können Sie auch einen neuen Ordner erstellen, indem Sie auf Neuen Ordner erstellen klicken. Wenn Sie eine Azure-Dateispeicherfreigabe verwenden, geben Sie ein `\\yourfilestoragename.file.core.windows.net\yourfilesharename`. Typ: Schnur Hinweis: Der URI für einen Sendeport oder Empfangsspeicherort darf nicht länger als 256 Zeichen sein.
Dateiname	Geben Sie den Namen der Datei an, in die der Dateisendehandler die Nachricht schreibt. Einschränkungen für diese Eigenschaft, einschließlich der Verwendung von Makros im Dateinamen, finden Sie unter Einschränkungen beim Konfigurieren des Dateiadapters.
Kopiermodus	Legen Sie den Kopiermodus fest, der beim Schreiben einer Meldung in eine Datei verwendet wird. Gültige Werte sind: Anfügen. Der Dateisendehandler öffnet, sofern vorhanden, eine Datei und fügt eine Nachricht an deren Ende an. Wenn die Datei nicht vorhanden ist, erstellt der Dateisendehandler eine neue Datei. Überschreiben. Der Dateisendehandler öffnet, sofern vorhanden, eine Datei und überschreibt deren Inhalt. Wenn die Datei nicht vorhanden ist, erstellt der Dateisendehandler eine neue Datei. Neu erstellen. Ist keine Datei vorhanden, erstellt der Dateisendehandler eine neue Datei und schreibt in diese. Ist bereits eine Datei vorhanden, meldet der Dateisendehandler einen Fehler und folgt dann der normalen Adapterwiederholungsversuch-Logik für Sendeports. Hierbei handelt es sich um den Standardkopiermodus für den Dateisendehandler.
Zwischenspeichern beim Schreiben erlauben	Legen Sie fest, ob beim Schreiben einer Nachricht in eine Datei der Dateisystemcache verwendet werden soll. Folgende Optionen sind gültig: FALSE Verwenden Sie nicht den Dateisystemcache. STIMMT Verwenden Sie den Dateisystemcache. Standardwert: False Wichtig: Wenn Sie diese Eigenschaft auf True festlegen, kann die Leistung des Dateiadapters erhöht werden, wenn das Risiko eines potenziellen Datenverlusts besteht, wenn ein Stromausfall auftritt und nicht alle Daten auf den Datenträger geschrieben werden.
Beim Schreiben temporäre Datei verwenden	Definiert, ob die Ausgabedatei zunächst in eine temporäre Datei geschrieben und diese nach Abschluss des Schreibvorgangs umbenannt werden soll. Wenn diese Option aktiviert ist, wird die temporäre Datei mit der Erweiterung BTS-WIP erstellt. Gültige Optionen: STIMMT Der Dateiadapter erstellt beim Schreiben in den Zielordner eine temporäre Datei. FALSE Der Dateiadapter erstellt beim Schreiben in den Zielordner keine temporäre Datei. Standardwert: Falscher Hinweis: Diese Option ist nur verfügbar, wenn die CopyMode-Eigenschaft auf einen Wert von Create new festgelegt ist.

Gehen Sie auf der Registerkarte Authentifizierung wie folgt vor:

Option	Aufgabe
Diese Anmeldeinformationen verwenden, wenn der Host keinen Zugriff auf Netzwerkfreigaben hat	Nur bei Verwendung einer Netzwerkfreigabe oder einer Azure-Dateifreigabe erforderlich. Standardwert: FALSE Typ: Boolean
Benutzername	Wenn Sie eine Netzwerkfreigabe verwenden, geben Sie den Benutzernamen ein, der Zugriff auf die Freigabe hat. Wenn Sie eine Azure-Dateispeicherfreigabe verwenden, geben Sie den Namen Ihres Speicherkontos ein. Typ: Schnur
Kennwort	Wenn Sie eine Netzwerkfreigabe verwenden, geben Sie das Kennwort für das Konto ein, das Zugriff auf die Netzwerkfreigabe hat. Wenn Sie eine Azure-Dateispeicherfreigabe verwenden, geben Sie den Zugriffsschlüssel für das Speicherkonto ein. die in der Azure-Portal aufgeführt ist. Typ: Schnur

Klicken Sie auf OK, um die Einstellungen zu speichern.

Festlegen der Eigenschaften für einen dynamischen Sendeport

Ein dynamischer Sendeport stellt keine Transportkonfigurationsoptionen in der BizTalk Server-Verwaltungskonsole zur Verfügung, weil erwartet wird, dass diese Eigenschaften mit den der Nachricht zugehörigen Kontexteigenschaften bereitgestellt werden. Diese Eigenschaften können in einer benutzerdefinierten Pipeline oder in einer Orchestrierung festgelegt werden. Um Nachrichtenkonfigurationseigenschaften in einer Orchestrierung festzulegen, können Sie die folgenden Schritte ausführen:

Fügen Sie ihrer Orchestrierung ein Shape "Nachricht konstruktieren " hinzu.
Konfigurieren Sie das Shape Nachricht konstruieren , um eine neue Nachricht zu erstellen. (Beispiel: Message_2)
Fügen Sie dem Shape Nachricht konstruktieren ein Nachrichtenzuweisungs-Shape hinzu.
Fügen Sie dem Shape Nachrichtenzuweisung Code hinzu, um die erstellte Nachricht zu initialisieren und die entsprechenden Konfigurationseigenschaften für die Nachricht festzulegen. Mit dem folgenden Code wird eine Nachricht mit dem Namen Message_2 initialisiert, die mit dem Shape Message construct erstellt wurde, und legt dann zwei Konfigurationseigenschaften für die Nachricht fest. In diesem Szenario wurde Message_1 ursprünglich von der Orchestrierung empfangen:
```
Message_2=Message_1;  
Message_2(FILE.CopyMode)= 0; //0=Append  
Message_2(FILE.AllowCacheOnWrite)= true;  
Message_2(FILE.UseTempFileOnWrite)= true;  
```

Konfigurieren des Empfangs- oder Sendehandlers

Erweitern Sie in der BizTalk Server Verwaltungskonsole BizTalk Server Verwaltung, BizTalk-Gruppe, Plattformeinstellungen, und klicken Sie dann auf Adapter.
Klicken Sie in der erweiterten Liste der Adapter auf DATEI, und klicken Sie im rechten Bereich mit der rechten Maustaste auf den Empfangs- oder Sendehandler, den Sie konfigurieren möchten. Wählen Sie Eigenschaften aus.
Wählen Sie in der Liste Hostname den Host aus, um den Handler auszuführen.
Klicken Sie auf OK.