Freigeben über

Verwenden das ServiceModel Metadata Utility-Tools mit dem BizTalk-Adapter für Siebel eBusiness-Anwendungen

  • Artikel

Sie können das ServiceModel Metadata Utility Tool (svcutil.exe) verwenden, um eine WCF-Clientklasse für Vorgänge zu generieren, die vom Microsoft BizTalk-Adapter für Siebel eBusiness-Anwendungen verfügbar gemacht werden. Nachdem Sie svcutil.exe ausgeführt haben, um eine WCF-Clientklasse zu generieren, können Sie die generierte Datei in Ihren Code einschließen und Instanzen der WCF-Clientklasse erstellen, um Vorgänge auf dem Siebel-System auszuführen.

Wenn Sie svcutil.exe verwenden, müssen Sie einen Verbindungs-URI angeben, der Anmeldeinformationen enthält. Da der Siebel-Adapter standardmäßig Anmeldeinformationen im Verbindungs-URI deaktiviert, müssen Sie svcutil.exe so konfigurieren, dass eine nicht standardmäßige Bindung für den Siebel-Adapter verwendet wird. Sie können auch andere Bindungseigenschaften in der nicht standardmäßigen Bindung konfigurieren.

In den folgenden Abschnitten erfahren Sie, wie Sie svcutil.exe konfigurieren und svcutil.exe verwenden, um WCF-Clientcode mit dem Siebel-Adapter zu generieren.

Konfigurieren svcutil.exe für eine nicht standardmäßige Bindung

Um svcutil.exe für die Verwendung einer nicht standardmäßigen Bindung zu konfigurieren, müssen Sie eine lokale Kopie von svcutil.exe erstellen und dann eine lokale Kopie der svcutil.exe.config-Konfigurationsdatei erstellen oder ändern.

  1. Erstellen Sie einen Ordner, und kopieren Sie svcutil.exe in den neuen Ordner. In der Regel finden Sie svcutil.exe am Windows SDK-Installationsspeicherort, insbesondere C:\Programme\Microsoft SDKs\Windows\v6.0\Bin.

  2. Erstellen Sie eine Datei namens svcutil.exe.config im neuen Ordner.

  3. Fügen Sie der datei svcutil.exe.config eine Bindung und einen Clientendpunkt hinzu. Sie müssen svcutil.exe aus dem neuen Ordner ausführen, um sicherzustellen, dass die richtige Konfiguration verwendet wird.

    Wichtig

    Das name-Attribut des Clientendpunkts muss das schema angeben, das im Verbindungs-URI verwendet wird. Bei diesem Wert wird die Groß-/Kleinschreibung beachtet.

    <configuration>
  <system.serviceModel>
    <client>
      <!-- the name should match the required scheme of the Metadata Exchange endpoint
      and the contract should be "IMetadataExchange" -->
      <endpoint name="siebel"
        binding="siebelBinding"
        bindingConfiguration="SiebelBinding"
        contract="IMetadataExchange" />
    </client>
    <bindings>
      <siebelBinding>
        <binding name="SiebelBinding" acceptCredentialsInUri="true" />
      </siebelBinding>
    </bindings>

  </system.serviceModel>

</configuration>

Hinweis

Sie können jede der Bindungseigenschaften des Siebel-Adapters in der Bindungskonfiguration festlegen.

Weitere Informationen zum Konfigurieren einer nicht standardmäßigen Bindung für svcutil.exe finden Sie im Thema "Benutzerdefinierter Endpunkt für sichere Metadaten" in der WCF-Dokumentation unter https://go.microsoft.com/fwlink/?LinkId=96077.

Erstellen einer WCF-Clientklasse mit svcutil.exe

Um svcutil.exe zum Generieren von WCF-Clientcode für den Siebel-Adapter zu verwenden, müssen Sie einen Verbindungs-URI angeben, der einen IMetadataExchange-Endpunkt (mex) und den Vorgang oder die Vorgänge angibt, für die bzw. die Sie code generieren svcutil.exe möchten. Außerdem müssen Sie im Verbindungs-URI Die Anmeldeinformationen für das Siebel-System angeben.

Hinweis

Bevor Sie svcutil.exe mit dem Siebel-Adapter verwenden können, müssen Sie ihn für die Verwendung einer nicht standardmäßigen Bindung konfigurieren. Weitere Informationen dazu finden Sie unter Konfigurieren von svcutil.exe für den Siebel-Adapter.

Sie geben einen mex-Endpunkt und Zielvorgänge im Siebel-Adapterverbindungs-URI auf folgende Weise an:

  • Sie müssen den Parameter "wsdl" in die query_string einschließen. Wenn es sich um den ersten Parameter im query_string handelt, wird er direkt nach dem Fragezeichen (?) angegeben. Wenn es sich nicht um den ersten Parameter handelt, sollte ihm ein ampersand (&) vorangestellt werden.

  • Sie müssen dem Parameter "wsdl" durch einen oder mehrere "op"-Parameter folgen. Jedem op-Parameter wird ein ampersand (&) vorangestellt und gibt die Knoten-ID eines Zielvorgangs an.

    Die folgenden beiden Beispiele zeigen, wie verschiedene Vorgänge mithilfe von svcutil.exe als Ziel verwendet werden.

    In diesem Beispiel wird eine WCF-Clientklasse für einen Einfügevorgang für das Geschäftsobjekt ACCOUNT\ACCOUNT erstellt.

    .\svcutil "siebel://Username=YourUserName; Password=YourPassword@Siebel_server:1234? SiebelEnterpriseServer=ent_server&SiebelObjectManager=obj_mgr&Language=enu&wsdl&op=http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert"

    In diesem Beispiel wird eine WCF-Clientklasse sowohl für einen Einfügevorgang als auch für einen Löschvorgang für das Geschäftsobjekt ACCOUNT\ACCOUNT erstellt.

    .\svcutil " siebel://Username=YourUserName; Password=YourPassword@Siebel_server:1234? SiebelEnterpriseServer=ent_server&SiebelObjectManager=obj_mgr&Language=enu&wsdl&op=http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert& op=http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Delete"

Wichtig

Sie müssen den Verbindungs-URI in Anführungszeichen in der Befehlszeile platzieren. Andernfalls versucht svcutil.exe, Metadaten für Vorgänge abzurufen, die vom Siebel-Adapter nicht unterstützt werden. Die Ergebnisse eines solchen Versuchs sind undefiniert.

Standardmäßig platziert svcutil.exe den generierten Code in der output.cs-Datei. Sie können jedoch den Namen der Ausgabedatei und viele andere Optionen ändern, die svcutil.exe verwendet, indem Sie Befehlszeilenoptionen festlegen.

Svcutil.exe bietet nicht die Möglichkeit, nach Vorgängen zu suchen (z. B. mithilfe von Wildcardzeichen). Sie müssen explizit Knoten-IDs für die spezifischen Vorgänge angeben, auf die Sie abzielen möchten. Sie können keine Knoten-IDs angeben, die nur auf Kategorien verweisen. Weitere Informationen zu den Knoten-IDs, die vom Siebel-Adapter angezeigt werden, finden Sie unter Metadatenknoten-IDs.

Das Visual Studio-Plug-In "Adapterdienstverweis hinzufügen" bietet erweiterte Such- und Suchfunktionen, die das Generieren einer WCF-Clientklasse erheblich vereinfachen können. Weitere Informationen zum Add Adapter Service Reference Plug-In finden Sie unter Generieren eines WCF-Clients oder eines WCF-Dienstvertrags für Siebel-Lösungsartefakte.