Referenz zu den Eigenschaften des Windows SharePoint Services-Adapters
Die folgenden Windows SharePoint Services-Adaptereigenschaften werden in BizTalk Server höher gestuft bzw. verwendet, um Optionen für die Konfiguration von Sendeports für ausgehende Nachrichten anzugeben. Die Eigenschaften können für den Zugriff auf Windows SharePoint Services-Informationen zur Nachricht oder zum Bereitstellen von Informationen für den Windows SharePoint Services-Adapter über die Orchestrierung verwendet werden.
Rangfolge von Nachrichteneigenschaften
Es gibt eine Rangfolge für das Außerkraftsetzen der Nachrichteneigenschaften, die in Orchestrierungen und Sendeports definiert sind.
Es gilt folgende Rangfolge:
In der Orchestrierung innerhalb von PropertiesXML definierte Eigenschaft
In der Orchestrierung definierte Eigenschaft
Auf Sendeportebene innerhalb der Eigenschaftsnamen- oder Eigenschaftsquellenauflistung definierte Eigenschaft
Auf Sendeportebene definierte Eigenschaft
Überlegungen und bekannte Probleme
Bei den Windows SharePoint Services-Adaptereigenschaften muss Folgendes beachtet werden:
- Die Liste der Eigenschaften in Orchestrierungen wird mit den Eigenschaften zusammengeführt, die vom Port basierend auf der Eigenschaftsposition definiert werden. Bei Konflikten setzt die Orchestrierungseigenschaft die Sendeporteigenschaft außer Kraft.
Eigenschaftentypen
Eigenschaftstyp | BESCHREIBUNG |
---|---|
IN | IN-Eigenschaften sind BizTalk Server-Eigenschaften, die ihren Wert von Windows SharePoint Services erhalten. Hinweis: Sie sollten diese Eigenschaften nicht innerhalb von Orchestrierungen ändern. |
CONFIG | CONFIG-Eigenschaften erhalten ihren Wert von BizTalk-Orchestrierungen oder benutzerdefinierten Pipelines. Dieser Wert wird vom Windows SharePoint Services-Adapter zum Bestimmen des Ziels ausgehender Nachrichten bestimmt. CONFIG-Eigenschaften ermöglichen das Angeben des Werts einiger der Eigenschaften innerhalb einer Orchestrierung oder benutzerdefinierten Pipeline, die Sie andernfalls für den Sendeport definieren müssten. Eigenschaften, die nicht mit IN oder CONFIG beginnen, sind sowohl IN als auch CONFIG (mit Ausnahme der URL-Eigenschaft). |
GEFÖRDERT | PROMOTED-Eigenschaften können vom inhaltsbasierten Routing verwendet werden. Eigenschaften, die nicht als PROMOTED markiert sind, können nicht vom inhaltsbasierten Routing verwendet werden. Hinweis: Obwohl alle Adaptereigenschaften im CBR-Filter-Editor angezeigt werden, können nur die heraufgestuften Eigenschaften für CBR verwendet werden. |
BESONDERE | – |
Hinweis
Alle Eigenschaften sind unter dem http://schemas.microsoft.com/BizTalk/2006/WindowsSharePointServices-properties
Namespace vorhanden und können über einen Orchestrierungs- oder Sendeportfilter mithilfe der WSS.<WSS_Property_Name>
Syntax zugegriffen werden.
Eigenschaftsliste
Windows SharePoint Services-Standardspalte | Windows SharePoint Services-Eigenschaftsname und -typ | Typ | BESCHREIBUNG | Eigenschaftstyp |
---|---|---|---|---|
Name | Dateiname | xs:string | Der Dateiname mit der Erweiterung der Windows SharePoint Services-Datei. In einer Dokumentbibliothek sind Dateinamen einschließlich Erweiterungen eindeutig. | IN/CONFIG/PROMOTED |
– | url | xs:string | Die URL der Datei. | IN/PROMOTED |
– | TransmittedFileLocation | – | Diese Eigenschaft wird von der Geschäftsaktivitätsüberwachung (Business Activity Monitoring, BAM) für Integrationszwecke genutzt und steht in Orchestrierungen nicht zur Verfügung. | SPECIAL |
– | InArchivedMsgUrl | xs:string | Die URL der Datei in der Archivdokumentbibliothek. Diese Eigenschaft ist nicht verfügbar, wenn der Empfangsspeicherort die Nachricht nicht archiviert. | IN/PROMOTED |
Typ | InIconUrl | xs:string | Die URL des Windows SharePoint Services-Symbols zum Abbilden des Dokuments. | IN |
Titel | InTitle | xs:string | Der Titel der Windows SharePoint Services-Datei. Dieser unterscheidet sich vom Dateinamen. Titel müssen in einer Dokumentbibliothek nicht eindeutig sein. | IN/PROMOTED |
Geändert | InLastModified | xs:dateTime | Das Datum der letzten Änderung der Windows SharePoint Services-Datei. | IN/PROMOTED |
Geändert von | InLastModifiedBy | xs:string | Der Name des Benutzers, der die Datei zuletzt geändert hat. | IN/PROMOTED |
ID | InItemId | xs:int | Die ID der Datei. Dies ist eine in der Dokumentbibliothek eindeutige ganze Zahl, über die auf die Datei zugegriffen werden kann. | IN |
Bearbeiten | InEditUrl | xs:string | Die URL, auf die zugegriffen werden kann, um die Eigenschaften der Datei zu bearbeiten. | IN |
Erstellt | InCreated | xs:dateTime | Das Datum, an dem die Windows SharePoint Services-Datei erstellt wurde. | IN/PROMOTED |
Erstellt von | InCreatedBy | xs:string | Der Benutzer, der die Datei erstellt hat. | IN/PROMOTED |
Dateigröße | InFileSize | xs:int | Die Größe der Windows SharePoint Services-Datei. | IN |
– | InListName | xs:string | Der Name der Dokumentbibliothek, in der sich diese Datei befindet. | IN/PROMOTED |
– | InListUrl | xs:string | Die URL der Dokumentbibliothek oder der Dokumentbibliotheksordner, in der/dem sich diese Datei befindet. | IN |
– | InPropertiesXml | xs:string | Ein einfaches XML-Dokument, das alle standardmäßigen und benutzerdefinierten Windows SharePoint Services-Spalten enthält. Es ermöglicht in einer Orchestrierung den Zugriff auf Windows SharePoint Services-Spaltenwerte, so auch auf die Werte der benutzerdefinierten Spalten. Hinweis: Es gibt keine 16-Spalten-Einschränkung. Hinweis: Sehen Sie sich den InPropertiesXml-Beispielwert im nächsten Abschnitt dieses Themas an. | IN |
– | InOfficeIntegration | xs:string | Basiert auf dem Wert des Empfangsspeicherorts. Dies ist entweder yes , no oder optional . |
IN |
– | ConfigOverwrite | xs:string | Bei „Yes“ werden bereits vorhandene Dateien mit demselben Namen überschrieben. Bei „No“ wird ein Fehler ausgelöst, wenn eine Datei mit demselben Namen vorhanden ist. Bei „Rename“ ändert sich der Dateiname in einen eindeutigen Namen, indem an den Dateinamen eine eindeutige Sequenz angefügt wird. Hinweis: Dies ähnelt dem Feld "Überschreiben" für physische Sendeports. Hinweis: "Orchestrierung" ist kein gültiger Wert für dieses Feld. | CONFIG |
– | ConfigNamespaceAliases | xs:string | Die Aliasdefinitionen der XPATHs. | CONFIG |
– | ConfigOfficeIntegration | xs:string | „Yes“, wenn OfficeImporters aufgerufen werden soll. „No“, um die Nachricht wie vorhanden zu verarbeiten. „Optional“ resultiert in „Yes“, falls eine IP-Lösung gefunden wird. Andernfalls „No“. Hinweis: Dies ähnelt dem Feld "Microsoft Office-Integration" für physische Sendeports. Hinweis: "Orchestrierung" ist kein gültiger Wert für dieses Feld. | CONFIG |
– | ConfigTemplatesDocLib | xs:string | Der Name der Fallbackdokumentbibliothek. Dies ist der zweite Speicherort, der durchsucht wird. Hinweis: Dies ähnelt dem Feld Vorlagenfallbackdokumentbibliothek für physische Sendeports. | CONFIG |
– | ConfigTemplatesNamespaceCol | xs:string | Name der Namespacespalte für die Fallbackdokumentbibliothek. Hinweis: Dies ähnelt dem Feld "Templates Fallback Namespace Column" für physische Sendeports. | CONFIG |
– | ConfigCustomTemplatesDocLib | xs:string | Der Name der primären Dokumentbibliothek. Dies ist der erste Speicherort, der durchsucht wird. Hinweis: Dies ähnelt dem Feld Vorlagendokumentbibliothek für physische Sendeports. | CONFIG |
– | ConfigCustomTemplatesNamespaceCol | xs:string | Name der Namespacespalte für die primäre Dokumentbibliothek. Hinweis: Dies ähnelt dem Feld Vorlagennamespacespalte für physische Sendeports. | CONFIG |
– | ConfigPropertiesXml | xs:string | Ein einfaches XML-Dokument, das alle folgenden Windows SharePoint Services-Spaltennamen und -werte enthält, die in Windows SharePoint Services aktualisiert werden sollen. Es ermöglicht einem Orchestrierungsentwickler das Festlegen der SharePoint-Spaltenwerte für die anschließend in SharePoint zu erstellende Nachricht. Hinweis: Dies ähnelt der Funktionalität, die über die Felder Column n und Column n Value für physische Sendeports verfügbar ist. Hinweis: Es hat eine Einschränkung von 16 Spalten. Hinweis: Siehe den Beispielwert ConfigPropertiesXml weiter unten in diesem Thema. | CONFIG |
– | ConfigTimeout | xs:int | Timeoutwert in Millisekunden für Webdienstaufrufe. | CONFIG |
– | ConfigAdapterWSPort | xs:int | Port oder Internetinformationsdienste-Website, in dem/der der Adapter installiert und konfiguriert wurde. Hinweis: Ein ungültiger Portkonfigurationswert in einer Orchestrierung hält die Nachricht an, auch wenn der wert des physischen Sendeports den definierten Orchestrierungswert außer Kraft setzt. | CONFIG |
Sample InPropertiesXml
Es folgt ein XML-Beispiel für InPropertiesXml.
<InPropertiesXml>
<Property name="InItemId">2</Property>
<Property name="Created">12/14/2004 1:30:31 PM</Property>
<Property name="Author">3;#John Doe</Property>
<Property name="Modified">12/14/2004 1:30:31 PM</Property>
<Property name="Editor">3;#John Doe</Property>
<Property name="_ModerationStatus">0</Property>
<Property name="_ModerationComments" />
<Property name="FileRef">/sites/BASSite/SourceLibrary/PO1.xml</Property>
<Property name="FileDirRef">2;#sites/BASSite/SourceLibrary</Property>
<Property name="InLastModified">2004-12-14 13:30:31</Property>
<Property name="InCreated">2004-12-14 13:30:31</Property>
<Property name="InFileSize">7338</Property>
<Property name="FSObjType">0</Property>
<Property name="CheckedOutUserId">2;#3</Property>
<Property name="Filename">PO1.xml</Property>
<Property name="VirusStatus">2;#7338</Property>
<Property name="CheckedOutTitle">2;#John Doe</Property>
<Property name="LinkCheckedOutTitle">John Doe</Property>
<Property name="InLastModifiedBy">MyDomain\jdoe</Property>
<Property name="InCreatedBy">MyDomain\jdoe</Property>
<Property name="owshiddenversion">1</Property>
<Property name="File_x0020_Type">xml</Property>
<Property name="HTML_x0020_File_x0020_Type" />
<Property name="_SourceUrl" />
<Property name="_SharedFileIndex" />
<Property name="LinkFilenameNoMenu">PO1.xml</Property>
<Property name="LinkFilename">PO1.xml</Property>
<Property name="SelectTitle">2</Property>
<Property name="SelectFilename">2</Property>
<Property name="Edit">xml</Property>
<Property name="InIconUrl">/sites/BASSite/SourceLibrary/PO1.xml</Property>
<Property name="Url">http://localhost:80/sites/BASSite/SourceLibrary/PO1.xml</Property>
<Property name="EncodedAbsUrl">PO1</Property>
<Property name="BaseName">7338</Property>
<Property name="FileSizeDisplay" />
<Property name="InstanceID">200</Property>
<Property name="Order" />
<Property name="InTitle" />
<Property name="ColumnOne" />
<Property name="ColumnTwo" />
<Property name="ColumnThree" />
<Property name="ColumnFour" />
<Property name="InListName">SourceLibrary</Property>
<Property name="InListUrl">http://localhost:80/sites/BASSite/SourceLibrary</Property>
<Property name="InEditUrl">http://localhost:80/sites/BASSite/SourceLibrary/Forms/EditForm.aspx?ID=2</Property>
<Property name="InOfficeIntegration">yes</Property>
</InPropertiesXml>
Sample ConfigPropertiesXml
Es folgt ein XML-Beispiel für ConfigPropertiesXml.
<ConfigPropertiesXml>
<PropertyName1>PO number</PropertyName1>
<PropertySource1>%XPATH=//orchns:PurchaseOrder/orchns:Header/orchns:ID%</PropertySource1>
<PropertyName2>Charge To</PropertyName2>
<PropertySource2>%XPATH=//orchns:PurchaseOrder/orchns:orderBody/orchns:chargeTo%</PropertySource2>
<PropertyName3>PO Priority</PropertyName3>
<PropertySource3>%XPATH=//orchns:PurchaseOrder/orchns:orderBody/orchns:priority%</PropertySource3>
<PropertyName4>Order Date</PropertyName4>
<PropertySource4>%XPATH=//orchns:PurchaseOrder/orchns:orderBody/orchns:dateOrdered%</PropertySource4>
</ConfigPropertiesXml>
Weitere Informationen
Konfigurieren eines Windows SharePoint Services-Empfangsspeicherorts
Konfigurieren eines Windows SharePoint Services-Sendehandlers
Konfigurieren eines Windows SharePoint Services-Sendeports
Erstellen eines Sendeports
Ausdrücke für den Windows SharePoint Services-Adapter
Unterstützte Windows SharePoint Services-Spaltentypen