Pipelinekomponente zur Nachrichtenüberprüfung
Mithilfe dieser Pipelinekomponente können Sie alle Teile einer mehrteiligen Nachricht und den Nachrichtenkontext untersuchen, um zu ermitteln, ob bei der Nachricht ein Problem vorliegt. Sie verwenden diese Komponente zur Problembehandlung.
Die Pipelinekomponente legt die XML-Dateien in einem von Ihnen angegebenen Verzeichnis ab. Jede dieser Dateien enthält einen der vier Teile einer RNIFv2.0-Nachricht (Präambelheader, Übermittlungsheader, Dienstheader und Dienstinhalt) oder einen der drei Teile einer RNIFv1.1-Nachricht (Präambelheader, Dienstheader und Dienstinhalt). Eine weitere XML-Datei enthält den Nachrichtenkontext.
Sie erstellen diese Komponente in einer benutzerdefinierten Pipeline und fügen sie an einen Sendeport an. Sie erstellen einen Filter im Sendeport, um die Nachrichten zu abonnieren, die Sie überwachen möchten. Diese Problembehandlung tritt zusätzlich zur Standardverarbeitung auf, die Microsoft® BizTalk Accelerator for RosettaNet (BTARN) bereits ausführt.
Erstellen einer benutzerdefinierten Pipeline mithilfe der Pipelinekomponente zur Nachrichtenprüfung
Damit Sie die Pipelinekomponente zur Nachrichtenprüfung verwenden können, müssen Sie eine benutzerdefinierte Pipeline erstellen und bereitstellen, die diese Komponente enthält. Weitere Informationen finden Sie unter Erstellen von Pipelines mit Designer in BizTalk Server Hilfe.
So stellen Sie die Pipelinekomponente zur Nachrichtenprüfung bereit
Starten Sie Visual Studio.
Zeigen Sie im Menü Datei auf Öffnen, und klicken Sie dann auf Projekt.
Wechseln Sie zu C:\Programme (x86)\Microsoft BizTalk <Version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component, wählen Sie MessageInspector.csproj aus, und klicken Sie dann auf Öffnen.
Öffnen Sie die Visual Studio-Eingabeaufforderung.
Wechseln Sie an der Eingabeaufforderung zu C:\Programme (x86)\Microsoft BizTalk <Version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug.
Geben Sie an der Eingabeaufforderung sn -k MessageInspector.snk ein, um einen Schlüssel zu erstellen, und drücken Sie dann die EINGABETASTE.
Klicken Sie in Visual Studio in Projektmappen-Explorer mit der rechten Maustaste auf MessageInspector, und klicken Sie dann auf Eigenschaften.
Klicken Sie auf der Seite MessageInspector-Eigenschaft auf die Registerkarte Signatur , und klicken Sie dann auf Das Kontrollkästchen Assembly signieren .
Navigieren Sie in der Dropdownliste Schlüsseldatei mit starkem Namen auswählen zu C:\Programme (x86)\Microsoft BizTalk <Version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug, wählen Sie MessageInspector.snk aus, und klicken Sie dann auf Öffnen.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf MessageInspector, und klicken Sie anschließend auf Erstellen. Überprüfen Sie im Ausgabebereich, ob der Build erfolgreich erstellt wurde.
Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf Zubehör, und klicken Sie dann auf Windows Explorer.
Wechseln Sie in Windows Explorer zu C:\Programme (x86)\Microsoft BizTalk <Version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug, klicken Sie mit der rechten Maustaste auf Microsoft.Solutions.BTARN.SDK.MessageInspector.dll, und klicken Sie dann auf Kopieren.
Wechseln Sie zu C:\Programme (x86)\Microsoft BizTalk <Version> Accelerator for RosettaNet\Pipeline Components, klicken Sie mit der rechten Maustaste auf Pipelinekomponenten, und klicken Sie dann auf Einfügen.
Zeigen Sie in Visual Studio im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Wählen Sie im Dialogfeld Neues Projekt im Vorlagenbereich die Option Leeres BizTalk Server-Projektaus, und geben Sie im Feld Name einen Namen für das Projekt ein. Wechseln Sie im Feld Speicherort zum Ordner, in dem Sie das Projekt speichern möchten, und klicken Sie dann auf OK.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektnamen, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Neues Element hinzufügen.
Wählen Sie im Dialogfeld Neues Element hinzufügen die Option Sendepipelineaus, geben Sie im Feld Name einen Namen für die benutzerdefinierte Pipelinedatei ein, und klicken Sie dann auf Öffnen.
Hinweis
Fügen Sie die Pipelinekomponente für die Nachrichtenprüfung nur zu den Sendeports und nicht zu den Empfangsports hinzu.
Klicken Sie mit der rechten Maustaste in den Bereich „BizTalk-Pipelinekomponenten“ der Toolbox, und klicken Sie dann auf Elemente hinzufügen/entfernen.
Wählen Sie im Dialogfeld Toolbox anpassen auf der Registerkarte BizTalk-Pipelinekomponenten die Komponente für die BTARN-Nachrichtenprüfungaus, und klicken Sie dann auf OK.
Klicken Sie im Bereich Toolbox im Bereich BizTalk-Pipelinekomponenten auf BTARN-Nachrichteninspektorkomponente, und halten Sie sie gedrückt, und ziehen Sie die Komponente dann in ein Feld Hier ablegen!
Klicken Sie in Visual Studio in Projektmappen-Explorer mit der rechten Maustaste auf den Namen des Pipelineprojekts, und klicken Sie dann auf Eigenschaften.
Klicken Sie im Dialogfeld Eigenschaftenseiten auf Allgemeine Eigenschaften, und klicken Sie dann auf Assembly.
Klicken Sie im rechten Bereich im Textfeld, das der Assemblyschlüsseldatei zugeordnet ist, auf die Auslassungspunkte, wechseln Sie zu C:\Programme (x86)\Microsoft BizTalk <Version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug, wählen Sie MessageInspector.snk aus, und klicken Sie dann auf OK.
Wählen Sie in Visual Studio Pipeline Designer das Shape BTARN Message Inspector Component aus.
Geben Sie in Visual Studio Eigenschaftenfenster im Feld Verzeichnis den Namen des Verzeichnisses ein, in das Sie die XML-Dateien ablegen möchten.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Namen des Projekts, und klicken Sie dann auf Erstellen. Stellen Sie sicher, dass der Erstellungsvorgang erfolgreich abgeschlossen wurde.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Namen des Projekts, und klicken Sie dann auf Bereitstellen. Stellen Sie sicher, dass die Bereitstellung erfolgreich ist.
Klicken Sie in Visual Studio im Menü Ansicht auf BizTalk Explorer.
Klicken Sie mit der rechten Maustaste auf Sendeports, und klicken Sie dann auf Sendeport hinzufügen.
Klicken Sie im Dialogfeld Neuen Sendeport erstellen auf OK.
Geben Sie im Dialogfeld Eigenschaften für Sendeport im Feld Name einen Namen für den Sendeport ein. Während Primär im linken Bereich aktiviert ist, klicken Sie im rechten Bereich auf Transporttyp , und wählen Sie dann DATEIaus.
Klicken Sie im Dialogfeld Eigenschaften für Sendeport im Feld Adresse (URI) auf die Schaltfläche mit den Auslassungspunkten (...).
Geben Sie im Feld DATEI-Transporteigenschaften den Ordnernamen für das Ziel ein, klicken Sie im linken Bereich auf Senden , und wählen Sie dann für die Sendepipeline im rechten Bereich die benutzerdefinierte Pipeline aus, die Sie soeben erstellt haben.
Klicken Sie im linken Bereich auf Filter & Zuordnungen , und klicken Sie dann auf Filter.
Geben Sie im rechten Bereich einen Filterausdruck ein, der den Typ der Dateien bestimmt, für den die Pipeline XML-Dateien ablegen soll. Wenn Sie z. B. Dateien für alle RNIF v1.1-Nachrichten ablegen möchten, würden Sie für Eigenschaft „Microsoft.Solutions.BTARN.Schemas.RNIFv11.GlobalBusinessAction“ und für Operator „Vorhanden“ auswählen und dann auf OKklicken.
Klicken Sie in BizTalk-Explorer mit der rechten Maustaste auf den Sendeport, den Sie gerade erstellt haben, und klicken Sie dann auf Eintragen. Klicken Sie dann erneut mit der rechten Maustaste auf den Sendeport, und klicken Sie anschließend auf Starten.
Hinweise
Bei der normalen Verarbeitung können Sie jeweils nur eine der Nachrichtenkomponenten zur Zeit untersuchen (die Komponente, die Sie bei der Orchestrierung als Nachrichtentext festgelegt haben). Daher können Sie nur einen der Teile in der BizTalk-Verwaltungskonsole untersuchen, und Ihre Möglichkeiten zur Problembehandlung sind eingeschränkt. Die Pipelinekomponente für die Nachrichtenprüfung hilft Ihnen dabei, diese Einschränkung zu umgehen.