Entwerfen von Metadatenartefakten für Hostdateien
In diesem Leitfaden erfahren Sie, wie Sie Metadatenartefakte für Hostdateien entwerfen. Anschließend können Sie diese Metadatenartefakte als HIDX-Dateien (Host Integration Server Definition XML) speichern, um sie mit dem integrierten Dienstanbieter-basierten Hostdateien-Connector in Azure Logic Apps zu verwenden.
Voraussetzungen
Herunterladen und Installieren von Visual Studio. Stellen Sie nach der Installation sicher, dass Sie auch die Workload mit dem Namen Desktopentwicklung mit C++ in Visual Studio installieren. Andernfalls erhalten Sie den Fehler Ausnahme von HRESULT 0x800A007C.
Laden Sie die HIS-Designer für Azure Logic Apps herunter, und installieren Sie sie. Die einzige Voraussetzung ist Microsoft .NET Framework 4.8.
Aktivieren Sie die Visual Studio-Unterstützung für den Flatfileprozessor in Azure Logic Apps. Führen Sie diese Aufgabe in folgenden Schritten aus:
Öffnen Sie Visual Studio. Öffnen Sie auf der Symbolleiste das Menü Extras , und wählen Sie Optionen aus.
Erweitern Sie in der Liste Optionen den Eintrag Host Integration Server, und wählen Sie Hostdateien aus.
Wählen Sie auf der Registerkarte Hostumgebungdie Option Unterstützung für Flatfileprozessor und Logik-Apps einschließen aus.
Erstellen eines Hostdateiprojekts
In Visual Studio können Sie die Projektvorlage Hostdatei verwenden, um Metadatenartefakte zu erstellen. Sie können diese Artefakte dann mit dem integrierten Dienstanbieter-basierten Hostdateien-Connector in Standardworkflows für Azure Logic Apps verwenden. Führen Sie die folgenden Schritte aus, um ein neues Hostdateiprojekt zu erstellen:
Wählen Sie in Visual Studio im Menü Datei die Option Neues>Neues Projekt aus.
Wählen Sie in der Liste der Projektvorlagen die Option Hostdatei>Weiter aus.
Ändern Sie im Feld Neues Projekt konfigurieren die gewünschten Details, und wählen Sie Erstellen aus.
Hinzufügen einer Hostdateidefinition
Um den Hostdateien-Connector in Azure Logic Apps zu unterstützen, müssen Sie eine Hostdateidefinition hinzufügen.
Öffnen Sie in Projektmappen-Explorer das Kontextmenü des neuen Hostdateiprojekts, und wählen SieHostdateidefinition hinzufügen> aus.
Wenn das Feld Neues Element hinzufügen angezeigt wird, geben Sie in der Eigenschaft Name einen Namen für die Hostdateidefinition an, und wählen Sie Hinzufügen aus.
Diese Schritte werden mit dem Beispielnamen HostFileDefinition1 fortgesetzt.
Nachdem der Assistent für die Hostdateidefinition gestartet wurde, wählen Sie im Feld Hostumgebung die Hostumgebung und die Hostsprache basierend auf der folgenden Tabelle aus:
Hostumgebung Hostsprache Hostdatei für System z (IBM Mainframesysteme der z-Serie) COBOL Hostdatei für System i (IBM Midrange-Systeme der i-Serie) COBOL oder RPG Wählen Sie Erstellen, wenn Sie fertig sind.
Nachdem Sie den Assistenten abgeschlossen haben, wird die Standard Entwurfsansicht angezeigt, in der Sie Metadatenartefakte manuell erstellen oder importieren können. Fahren Sie für diese Aufgabe mit dem nächsten Abschnitt fort.
Entwerfen eines Metadatenartefakts
In diesem Abschnitt wird gezeigt, wie Sie manuell ein Metadatenartefakt erstellen. Informationen zum Importieren einer Hostdefinition finden Sie unter Importieren von Hostdefinitionen.
In der folgenden Tabelle sind die Komponenten der Standard Entwurfsansicht aufgeführt:
| Komponente | Beschreibung |
|---|---|
| Ordner "Tabellen" | Tabellen definieren die Zuordnung zwischen einer Hostdatei und einem Schema. Der Ordner Tabellen gruppiert Datentabellen in der Assembly. |
| Ordner "Schemas" | Schemas definieren die Zuordnung zwischen den Feldern des Hostdateidatensatzes und den .NET-Datentypen. Der Ordner Schemas gruppiert Variablen mit freigegebenen Attributen. |
| Ordner "Unions" | Gewerkschaften können je nach Typ Sätze von Regeln anwenden. Der Ordner Unions enthält die Entsprechungen von COBOL-Unions. |
Hinzufügen einer Tabelle
Öffnen Sie in der Entwurfsansicht Standard das Kontextmenü Tabellen, und wählen Sie Tabelle hinzufügen aus.
Öffnen Sie das Kontextmenü der neuen Tabelle, und wählen Sie Eigenschaften aus. Geben Sie Werte für die Eigenschaften jeder Spalte basierend auf der folgenden Tabelle an:
Eigenschaft Beschreibung oder Wert Alias Ein gültiger Alias, der mit [A-Za-z] beginnt, gefolgt von alphanumerischen Zeichen mit einer maximalen Länge von 256, z. B. CUSTOMER Hostname Ein Mainframedateiname besteht aus bis zu 22 Teilen, die durch einen Punkt (.) getrennt sind. Jeder Teil ist auf 10 Zeichen beschränkt. Die maximale Gesamtgröße beträgt 44 Zeichen, z. B . HISDEMO. NWIND. KUNDE Schema Stellt die Struktur der Hostdatei einschließlich Datentypen dar. 
Hinzufügen eines Schemas
Öffnen Sie in der Entwurfsansicht Standard das Kontextmenü Schemas, und wählen Sie Schema hinzufügen aus.
Der Designer erstellt ein Schema mit einem Feld.
Um ein weiteres Feld hinzuzufügen, öffnen Sie das Kontextmenü des neuen Schemas, und wählen Sie Feld hinzufügen aus. Wiederholen Sie diesen Schritt nach Bedarf.
Öffnen Sie das Kontextmenü des neuen Felds, und wählen Sie Eigenschaften aus. Geben Sie Werte für die Eigenschaften jedes Felds basierend auf der folgenden Tabelle an:
Eigenschaft Beschreibung oder Wert Is Array Wenn true, müssen Sie die Arraydimensionen festlegen, die Arrays mit bis zu 7 Dimensionen und 16.777.215 Elementen unterstützen. Sie müssen auch Werte für die Arrayeigenschaften Eintrittsanzahl in und Tritt abhängig von eingeben. Datentyp Der .NET-Datentyp des Felds Name Der Name des Felds Fehlerbehandlung Lösen Sie einen Fehler aus, runden oder abschneiden. Hostdatentyp Der COBOL- oder RPG-Datentyp des Felds Größe Eine 32-Bit-Ganzzahl. Zeichenfolgentrennzeichen Null beendet oder Leerzeichen aufgefüllt Nachgestellter Filler Für Felder, deren Länge kleiner als der angegebene Höchstwert ist, müssen Sie die Füllgröße angeben. 
Hinzufügen einer Union
Öffnen Sie in der Entwurfsansicht Standard das Kontextmenü Unions, und wählen Sie Union hinzufügen aus.
Der Designer erstellt eine Union mit zwei Membern.
Um ein weiteres Mitglied hinzuzufügen, öffnen Sie das Kontextmenü der neuen Union, und wählen Sie Union-Mitglied hinzufügen aus. Wiederholen Sie diesen Schritt nach Bedarf.
Öffnen Sie das Kontextmenü des Mitglieds, und wählen Sie Eigenschaften aus. Geben Sie Werte für die Eigenschaften jedes Elements basierend auf der folgenden Tabelle an:
Eigenschaft Beschreibung oder Wert Is Array Wenn true, müssen Sie die Arraydimensionen festlegen, die Arrays mit bis zu 7 Dimensionen und 16.777.215 Elementen unterstützen. Sie müssen auch Werte für die Arrayeigenschaften Eintrittsanzahl in und Tritt abhängig von eingeben. Datentyp Der .NET-Datentyp des Members. Dieser Wert kann Strukturen enthalten, die im vorherigen Abschnitt definiert wurden. Name Der Name des Mitglieds Fehlerbehandlung Lösen Sie einen Fehler aus, runden oder abschneiden. Hostdatentyp Der COBOL- oder RPG-Datentyp des Members Größe Eine 32-Bit-Ganzzahl. Zeichenfolgentrennzeichen Null beendet oder Leerzeichen aufgefüllt Nachgestellter Filler Für Member, deren Länge kleiner als der angegebene Höchstwert ist, müssen Sie die Füllgröße angeben. 
Wenn Sie fertig sind, fahren Sie mit dem nächsten Abschnitt fort, um die Bibliothek zu erstellen, in der der Entwurf der Metadaten gespeichert wird.
Erstellen des Host Integration Definition XML (HIDX) oder Metadatenartefakts
In diesem Abschnitt wird beschrieben, wie Sie die Bibliothek erstellen, in der der Entwurf des Metadatenartefakts gespeichert wird.
Um das Metadatenartefakt zu generieren, wählen Sie im Menü oder in der Symbolleiste von Visual Studio alle speichern aus. (Tastatur: Drücken Sie STRG+UMSCHALT+S)
Um die generierte HIDX-Datei zu finden, wechseln Sie zum Ordner Ihrer Hostdatei.
