Freigeben über

Durchsuchen, Suchen und Abrufen von Metadaten für IDOC-Vorgänge in SAP

  • Artikel

Dieser Abschnitt enthält Anweisungen zum Durchsuchen, Suchen und Abrufen von Metadaten aus SAP for IDOC-Vorgängen mithilfe des Add Adapter Service Reference Plug-Ins, Add Adapter Metadata Wizard oder Using Adapter Service Add-In. Die meisten Anweisungen sind für alle drei Benutzeroberfläche identisch. Sofern zutreffend, werden separate Verfahren für die jeweilige Benutzeroberfläche bereitgestellt.

Bevor Sie die in den folgenden Abschnitten beschriebenen Schritte ausführen, müssen Sie folgendes haben:

Durchsuchen von IDOCs in einem SAP-System

Beim Durchsuchen von Metadaten mithilfe des Add-Ins "Adapterdienst nutzen", "Assistent zum Hinzufügen von Adaptermetadaten" oder "Add Adapter Service Reference Plug-In" werden vom SAP-Adapter getrennte Vorgänge zum Senden und Empfangen von IDOCs von einem SAP-System getrennt.

  • Senden und Empfangen. Adapterclients können diese Vorgänge verwenden, um IDOCs von einem SAP-System mit einem stark typisierten Schema zu senden und zu empfangen. Der Adapter stellt diese Vorgänge separat für jedes IDOC bereit und ist unter dem jeweiligen IDOC-Knoten verfügbar.

  • SendIdoc und ReceiveIdoc. Adapterclients können diese Vorgänge verwenden, um IDOCs von einem SAP-System mit einem schwach typisierten Schema zu senden und zu empfangen. Der SAP-Adapter zeigt nur einen SendIdoc - und ReceiveIdoc-Vorgang für alle IDOCs an. Diese Vorgänge sind direkt unter dem IDOC-Knoten verfügbar.

    Führen Sie die folgenden Schritte aus, um IDOCs in einem SAP-System zu durchsuchen, indem Sie das Add-In Zum Verwenden des Adapterdiensts, den Assistenten zum Hinzufügen von Adaptermetadaten oder das Add Adapter Service Reference Plug-In verwenden.

So durchsuchen Sie IDOCs in einem SAP-System

  1. Stellen Sie eine Verbindung mit einem SAP-Server her, indem Sie das Add-In Zum Verwenden des Adapterdiensts, den Assistenten zum Hinzufügen von Adaptermetadaten oder das Add Adapter Service Reference Plug-In verwenden. Anweisungen finden Sie unter Herstellen einer Verbindung mit dem SAP-System in Visual Studio .

  2. Wählen Sie in der Dropdownliste Vertragstyp auswählen den Vertragstyp aus, je nachdem, ob Sie eingehende oder ausgehende Vorgänge mit dem Adapter ausführen.

  3. Klicken Sie im Feld Kategorie auswählen auf den Knoten IDOC, um die IDOC-Nachrichtentypen im Feld Verfügbare Kategorien und Vorgänge anzuzeigen. Alternativ können Sie auch die IDOC-Nachrichtentypen anzeigen, indem Sie den IDOC-Knoten erweitern.

    Tipp

    Sie können direkt zum "unmittelbaren" Kategorieknoten oder zum Unterkategorieknoten in der Struktur wechseln, indem Sie den Namen des Artefakts eingeben, während der Fokus auf der Strukturansicht im Feld Kategorie auswählen liegt. Um beispielsweise zum ACC_BILLING IDOC-Nachrichtentyp zu wechseln, behalten Sie den Fokus auf dem IDOC-Knoten , und geben Sie dann ein ACC_BILLING.

    Die folgende Abbildung zeigt das Add-In "Adapterdienst nutzen", das die IDOC-Nachrichtentypen auflistet. Der IDOC-Stammknoten zeigt auch eine SendIdoc-Option zum Senden schwach typisierter IDOCs an das SAP-System an.

    Durchsuchen von Nachrichtentypen in einem IDOC

    Hinweis

    In einem Eingehenden Szenario zeigt der IDOC-Stammknoten einen ReceiveIdoc-Vorgang an, um schwach typisierte IDOCs zu empfangen.

  4. Klicken Sie auf die IDOC-Nachrichtentypen, um den relevanten IDOC-Typ anzuzeigen. Die folgende Abbildung zeigt das Add-In "Adapterdienst nutzen" mit dem IDOC-Typ unter einem bestimmten IDOC-Nachrichtentyp.

  5. Klicken Sie auf die IDOC-Typen, um die verschiedenen Versionen für einen IDOC-Typ anzuzeigen. Die folgende Abbildung zeigt das Add-In "Adapterdienst nutzen" mit den Versionen für einen bestimmten IDOC-Typ.

    Durchsuchen von Versionen eines IDOC-Typs

  6. Klicken Sie auf die Version eines IDOC-Typs, um die unterstützten Vorgänge für diesen IDOC-Typ anzuzeigen. Die folgende Abbildung zeigt das Add-In "Adapterdienst nutzen" mit dem Vorgang, der für eine bestimmte IDOC-Typversion unterstützt wird.

    Browservorgänge für einen IDOC-Typ

Suchen nach IDOCs in einem SAP-System

Bei der Suche nach Metadaten nach IDOCs in einem SAP-System mithilfe des Add-Ins "Adapterdienst-Add-In", "Add Adapter Metadata Wizard" und "Add Adapter Service Reference Plug-In" (Adapterdienstreferenz-Plug-In hinzufügen) wird der SAP-Adapter verwendet:

  • Unterstützt Feldhalterzeichen im Suchausdruck.

  • Aktiviert die Suche sofort unter dem Knoten, auf dem der Suchvorgang ausgeführt wird.

    In der folgenden Tabelle sind die Sonderzeichen aufgeführt, die für die Suche und deren Interpretation durch den SAP-Adapter verwendet werden können.

Sonderzeichen Interpretation
+ (Plus) Entspricht genau einem Zeichen.

A+ entspricht z. B. AB, AC, AD
* (Sternchen) Entspricht null oder mehr Zeichen.

Beispielsweise stimmt A* mit A, AB, ABC überein.

Weitere Informationen zu den vom Adapter unterstützten Sonderzeichen finden Sie unter Verfügbarmachen von Adaptereinstellungen als Bindungseigenschaft mithilfe des WCF LOB Adapter SDK.

Führen Sie die folgenden Schritte aus, um IDOCs in einem SAP-System mithilfe des Adapterdienst-Add-Ins Nutzen, Assistenten zum Hinzufügen von Adaptermetadaten und Hinzufügen des Adapterdienstverweis-Plug-Ins zu durchsuchen.

So suchen Sie IDOCs in einem SAP-System

  1. Stellen Sie eine Verbindung mit einem SAP-Server her, indem Sie das Add-In Zum Verwenden des Adapterdiensts, den Assistenten zum Hinzufügen von Adaptermetadaten oder das Add Adapter Service Reference Plug-In verwenden. Anweisungen finden Sie unter Herstellen einer Verbindung mit dem SAP-System in Visual Studio .

  2. Wählen Sie in der Dropdownliste Vertragstyp auswählen den Vertragstyp aus, je nachdem, ob Sie mit dem Adapter nach eingehenden oder ausgehenden Vorgängen suchen.

  3. Klicken Sie im Feld Kategorie auswählen auf den Knoten IDOC.

    Wichtig

    Sie können nur auf Stammebene nach IDOCs suchen.

  4. Geben Sie im Textfeld Kategorie suchen einen Suchausdruck ein, um nach einem bestimmten IDOC-Nachrichtentyp zu suchen. Um beispielsweise nach IDOCs zu suchen, die "MATMAS" in ihren Namen enthalten, geben Sie *MATMAS* in das Textfeld ein.

  5. Klicken Sie auf die Schaltfläche mit dem Rechtspfeilsymbol, um die Suche zu starten. Nach Abschluss der Suche werden im Feld Verfügbare Kategorien und Vorgänge die IDOCs aufgelistet, die die Suchkriterien erfüllen.

    Die folgende Abbildung zeigt das Add-In "Adapterdienst nutzen", das das IDOC-Suchergebnis auflistet.

    Durchsuchen von IDOCs in einem SAP-System

Generieren eines Schemas für BizTalk-Projekte

Sie können das Add-In Zum Verbrauchen des Adapterdiensts oder den Assistenten zum Hinzufügen von Adaptermetadaten verwenden, um ein Schema für ausgewählte SAP-Artefakte zu generieren. Nachdem Sie nach den Artefakten gesucht haben, die Sie aufrufen möchten, können Sie ein Schema für diese Artefakte generieren und dem Schema entsprechende Nachrichten an das SAP-System senden.

Hinweis

Sie können Kategorieknoten auswählen, um alle Vorgänge in der Unterstruktur dieser Kategorie zurückzugeben. Sie können z. B. einen IDOC-Typ auswählen (zum Generieren eines Schemas für alle Versionen von IDOCs in dieser Gruppe) oder eine bestimmte Version von IDOC auswählen, um das Schema nur für diese Version von IDOC zu generieren. Weitere Informationen zu den Knoten finden Sie unter Metadatenknoten-IDs.

So rufen Sie Metadaten für IDOCs ab

  1. Stellen Sie eine Verbindung mit einem SAP-Server her, indem Sie das Add-In "Adapterdienst nutzen" oder den Assistenten zum Hinzufügen von Adaptermetadaten verwenden. Anweisungen finden Sie unter Herstellen einer Verbindung mit dem SAP-System in Visual Studio .

  2. Wählen Sie in der Dropdownliste Vertragstyp auswählen den Vertragstyp aus, je nachdem, ob Sie eingehende oder ausgehende Vorgänge mit dem Adapter ausführen.

  3. Klicken Sie im Feld Kategorie auswählen auf den IDOC-Nachrichtentyp oder den IDOC-Typ, für den Sie Metadaten generieren möchten.

  4. Wählen Sie im Feld Verfügbare Kategorien und Vorgänge den IDOC-Typ oder die unterstützten Vorgänge aus, für die Sie Metadaten generieren möchten, und klicken Sie auf Hinzufügen. Die ausgewählten IDOC-Typen oder -Vorgänge werden im Feld Hinzugefügte Kategorien und Vorgänge aufgeführt.

    Die folgende Abbildung zeigt das Add-In "Adapterdienst nutzen", in dem die ausgewählten IDOCs aufgelistet sind.

    Abrufen von Metadaten für IDOCs

    Wenn Sie ein Schema für mehrere Vorgänge generieren möchten, gibt es möglicherweise einige doppelte Elementdefinitionen unter diesen Schemas, die bei der Kompilierung des BizTalk-Projekts einen Fehler verursachen können. Betrachten Sie beispielsweise ein Szenario, in dem Sie ein Schema für einen Vorgang "Op1" generieren. Das Schema für "Op1" enthält einen Parameter des komplexen Datentyps "CT1". Nachdem Sie das Schema für "Op1" generiert haben, schließen Sie das Add-In "Adapterdienst nutzen" und öffnen es erneut, um das Schema für einen anderen Vorgang "Op2" zu generieren. Angenommen, "Op2" enthält auch einen Parameter des komplexen Datentyps "CT1". Nachdem Sie das Add-In "Adapterdienst nutzen" beendet und das Projekt kompiliert haben, erhalten Sie Kompilierungsfehler, da der komplexe Datentyp "CT1" zweimal in verschiedenen XSD-Dateien definiert ist. In solchen Situationen empfehlen wir Folgendes:

    • Generieren Sie ein Schema für alle Vorgänge in einer einzelnen Ausführung des Add-Ins "Adapterdienst nutzen". Dadurch wird sichergestellt, dass das Add-In Zum Verbrauchen des Adapterdiensts nur eine Definition für den komplexen Datentyp "CT1" generiert.

    • Wenn Sie ein Schema für mehrere Vorgänge für verschiedene Ausführungen des Add-Ins "Adapterdienst nutzen" generieren möchten, müssen Sie das Kontrollkästchen Eindeutige Schematypen generieren aktivieren, damit die generierten XSD-Dateien eindeutige Namespaces für den komplexen Datentyp "CT1" enthalten.

  5. Klicken Sie auf OK. Die Schemadatei wird mit der Erweiterung .xsd am gleichen Speicherort wie das IDOC-Projekt gespeichert.

    Hinweis

    Wenn Sie das Add-In zum Verbrauch des Adapterdiensts verwenden, werden die Dateien standardmäßig mit der Namenskonvention "SAPBinding<n.xsd>" erstellt, wobei "n" je nach Anzahl der erstellten Schemadateien 1, 2 usw. sein kann. Alternativ können Sie einen benutzerdefinierten Namen für die Schemadateien angeben, indem Sie einen Namen in das Textfeld Dateipräfix eingeben. Das Add-In Adapterdienst nutzen erstellt jetzt Schemadateien mit dem Dateinamenpräfix><n.xsd> der Namenskonvention<.

    Hinweis

    Das Add-In Adapter-Dienst nutzen erstellt auch eine Bindungsdatei (eine XML-Datei), die die Bindungseigenschaften enthält, die Sie beim Generieren des Schemas für einen Vorgang und die SOAP-Aktion zum Aufrufen des Vorgangs angegeben haben. Sie können diese Bindungsdatei in die BizTalk Server-Verwaltungskonsole importieren, um einen WCF-Custom Port mit dem Verbindungs-URI, den Bindungseigenschaften und dem SOAP-Aktionssatz zu erstellen. Weitere Informationen finden Sie unter Konfigurieren einer physischen Portbindung mithilfe einer Portbindungsdatei für SAP.

  6. Klicken Sie im Menü Datei auf Alle speichern.

Generieren eines WCF-Clients für IDOC-Vorgänge mithilfe des Add Adapter Service Reference Plug-In

Sie können das Add Adapter Service Reference Plug-In verwenden, um entweder WCF-Clientcode zum Senden von IDOCs an ein SAP-System oder einen WCF-Dienstvertrag zum Empfangen von IDOCs von einem SAP-System zu generieren.

So generieren Sie einen WCF-Client oder einen WCF-Dienstvertrag für IDOCs

  1. Wählen Sie im Add Adapter Service Reference Plug-In (Adapterdienstverweis-Plug-In hinzufügen) in der Dropdownliste Vertragstyp auswählen den Vertragstyp aus, je nachdem, ob Sie eingehende (empfangende IDOCs) oder ausgehende Vorgänge (sendende IDOCs) ausführen.

  2. Erweitern Sie im Feld Kategorie auswählen den Knoten IDOC, und suchen Sie dann nach dem IDOC-Nachrichtentyp oder dem IDOC-Typ, den Sie senden oder empfangen möchten.

  3. Wählen Sie im Feld Verfügbare Kategorien und Vorgänge den IDOC-Typ oder die unterstützten Vorgänge aus, für die Sie einen WCF-Client (oder WCF-Dienstvertrag) generieren möchten, und klicken Sie dann auf Hinzufügen. Die ausgewählten Vorgänge werden im Feld Hinzugefügte Kategorien und Vorgänge aufgeführt. Sie können einen beliebigen Knoten auswählen, der im Feld Verfügbare Kategorien und Vorgänge aufgeführt ist. Wenn Sie einen Kategorieknoten auswählen, werden alle unter diesem Knoten und seinen Unterknoten verfügbaren Vorgänge hinzugefügt.

    Wichtig

    Das Add Adapter Service Reference Plug-In generiert eine eindeutige WCF-Clientklasse (oder einen WCF-Dienstvertrag) für jeden IDOC-Typ. Abhängig von den von Ihnen ausgewählten Kategorien und Vorgängen können mehrere WCF-Clientklassen generiert werden. Weitere Informationen finden Sie unter Generieren eines WCF-Clients oder eines WCF-Dienstvertrags für SAP-Lösungsartefakte.

  4. Für die meisten Szenarien sind die Standardserialisierungsoptionen ausreichend. Bei Bedarf können Sie jedoch mehrere Aspekte des generierten Codes und des verwendeten Serialisierungstyps steuern. So legen Sie diese Optionen fest:

    1. Klicken Sie auf Erweiterte Optionen , um das Feld Erweiterte Optionen zu öffnen.

    2. Wählen Sie im Feld Erweiterte Optionen unter Optionen für generierten Proxy auswählen die gewünschten Optionen aus. Sie können beispielsweise auswählen, ob asynchrone Methoden für den WCF-Client generiert werden, oder die Generierung einer Konfigurationsdatei deaktivieren.

    3. Wählen Sie unter Serialisierungsprogramm das Serialisierungsprogramm aus, das verwendet werden soll.

      Die folgende Abbildung zeigt das Feld Erweiterte Optionen mit der Standardauswahl (Auto ist für das Serialisierungsprogramm ausgewählt, und es sind keine anderen Optionen ausgewählt).

      Die Standardeinstellungen des Felds

      Die Optionen, die Sie im Feld Erweiterte Optionen konfigurieren können, entsprechen einigen der Verfügbaren Optionen, wenn Sie das ServiceModel Metadata Utility Tool (svcutil.exe) verwenden. Weitere Informationen zu diesen Optionen finden Sie unter ServiceModel Metadata Utility Tool (Svcutil.exe).

  5. Klicken Sie auf OK. Das Add Adapter Service Reference Plug-In speichert die WCF-Clientklasse (oder WCF-Dienstschnittstelle) und den Hilfscode für die Vorgänge und Kategorien, die Sie in Ihrem Projektverzeichnis ausgewählt haben. Standardmäßig wird auch eine Konfigurationsdatei gespeichert. Für eingehende und ausgehende Vorgänge werden geringfügig unterschiedliche Dateien generiert. Weitere Informationen finden Sie unter Generieren eines WCF-Clients oder eines WCF-Dienstvertrags für SAP-Lösungsartefakte.

Weitere Informationen

Abrufen von Metadaten für SAP-Vorgänge in Visual Studio