Verarbeitungsanweisungen in der Pipelinekomponente des XML-Assemblers
Verarbeitungsanweisungen liefern Informationen für die Anwendung, die ein XML-Dokument verarbeitet. Solche Informationen können Anweisungen enthalten, wie das jeweilige Dokument verarbeitet werden soll, wie es angezeigt werden soll usw.
Verarbeitungsanweisungen werden einem XML-Dokument durch die Eigenschaft Verarbeitungsanweisungen hinzufügen (oder die entsprechende XMLNorm.ProcessingInstructionOption-Eigenschaft im Nachrichtenkontext) hinzugefügt. Verarbeitungsanweisungstext wird mit der Texteigenschaft Verarbeitungsanweisungen hinzufügen (oder der entsprechenden XMLNorm.ProcessingInstruction-Eigenschaft im Nachrichtenkontext) angegeben.
Die Eigenschaft Verarbeitungsanweisungen hinzufügen (oder XMLNorm.ProcessingInstructionOption ) weist drei mögliche Werte auf, die in der folgenden Tabelle beschrieben werden.
Wert | Wert | BESCHREIBUNG |
---|---|---|
Anfügen | 0 | Neue Verarbeitungsanweisungen aus dem XML-Assembler werden an die Verarbeitungsanweisungen am Anfang des Dokuments angehängt. |
Neu erstellen | 1 | Neue Verarbeitungsanweisungen aus dem XML-Assembler überschreiben vorhandene Verarbeitungsanweisungen am Anfang des Dokuments. |
Ignorieren | 2 | Verarbeitungsanweisungen am Anfang des Dokuments werden entfernt. |
Das Paar von Verarbeitungsanweisungen (oder Nachrichtenkontexteigenschaften), das in einem Nachrichtenkontext angegeben wird, hat Vorrang vor dem Eigenschaftspaar, das in Pipeline-Designer angegeben wird. Wenn beispielsweise XMLNorm.ProcessingInstructionOption als Create new (1) und XMLNorm.ProcessingInstruction nicht angegeben ist, ersetzt eine leere Verarbeitungsanweisung eine vorhandene Verarbeitungsanweisung.
Ein weiteres Beispiel: Wenn XMLNorm.ProcessingInstruction angegeben wird, xmlNorm.ProcessingInstructionOption jedoch nicht, wird keine der Eigenschaften aus dem Nachrichtenkontext verwendet. In diesem Fall werden die Verarbeitungsanweisungen aus Pipeline-Designer verwendet.
Verarbeitungsanweisungen hinzufügen ist standardmäßig auf Anfügen festgelegt, und Verarbeitungsanweisungen hinzufügen ist leer.
Verarbeiten von Eigenschaften und Umschlägen
Da Verarbeitungsanweisungen bei den Umschlägen nicht beibehalten werden, führt die folgende Kombination von Flatfile-Assemblereinstellungen dazu, dass nur der äußerste Umschlag die Verarbeitungsanweisung besitzt:
Die Eigenschaft des Verarbeitungsanweisungsbereichs ist auf "Envelope" festgelegt.
Fügen Sie die Verarbeitungsanweisungen-Eigenschaft hinzu, die auf "Append" festgelegt ist.
Der Umschlag würde die Verarbeitungsanweisung verwenden, die in der Texteigenschaft Verarbeitungsanweisungen hinzufügen des Assemblers angegeben ist.
Keine der in den äußeren oder inneren Umschlägen (wie in der eingehenden Nachricht angegeben) vorhandenen Verarbeitungsanweisungen wird in den Ausgabenachrichten vorhanden sein.
Weitere Informationen
XML-Assembler – Pipelinekomponente
Konfigurieren der Pipelinekomponente des XML-Assemblers
Pipelines-AssemblerDisassembler (Ordner für BizTalk Server-Beispiele)