Freigeben über

Ausführen von Vorgängen für Geschäftskomponenten mit MVG-Feldern mithilfe von BizTalk Server und dem Siebel-Adapter

  • Artikel

Dieser Abschnitt enthält Anweisungen zum Ausführen von Vorgängen für eine Geschäftskomponente, die mehrwertige Felder enthält. Um einen End-to-End-Vorgang für solche Geschäftskomponenten zu veranschaulichen, müssen Sie Folgendes ausführen:

  • Ein INSERT-Vorgang für eine übergeordnete Geschäftskomponente

  • Ein INSERT-Vorgang für eine untergeordnete Geschäftskomponente

  • Ein ASSOCIATE-Vorgang für die mehrwertigen Verbindungen zwischen der übergeordneten und untergeordneten Geschäftskomponente

  • Ein Query_[MVG_Child_Business_Comp]-Vorgang für einen Datensatz der übergeordneten Geschäftskomponente

    Weitere Informationen dazu, wie der Siebel-Adapter Vorgänge für Geschäftskomponenten unterstützt, finden Sie unter Vorgänge für Geschäftskomponenten. Weitere Informationen zur Struktur von SOAP-Nachrichten zum Ausführen dieser Vorgänge finden Sie unter Nachrichtenschemas für Geschäftskomponentenvorgänge.

Wie führt man Vorgänge für eine Geschäftskomponente mit mehrwertigen Feldern aus?

Das Ausführen eines Vorgangs auf einem Siebel-System mithilfe des Siebel-Adapters mit BizTalk Server umfasst prozedurale Aufgaben, die unter Bausteine zum Erstellen von Siebel-Anwendungen beschrieben sind. Um einen Vorgang für eine Geschäftskomponente auszuführen, sind die folgenden Aufgaben:

  1. Erstellen Sie ein BizTalk-Projekt, und generieren Sie ein Schema für alle Vorgänge, die Sie für die Geschäftskomponente aufrufen möchten. Wie weiter oben beschrieben, müssen Sie zum Ausführen von Vorgängen für eine Geschäftskomponente mit mehrwertigen Feldern ein Schema für den Einfügevorgang für die übergeordneten und untergeordneten Geschäftskomponenten, den Vorgang Zuordnen für die mehrwertigen Verbindungen zwischen den übergeordneten und untergeordneten Geschäftskomponenten und einen Abfragevorgang für die übergeordnete Geschäftskomponente generieren.

  2. Erstellen Sie Nachrichten im BizTalk-Projekt zum Senden und Empfangen von Nachrichten aus dem Siebel-System.

  3. Erstellen Sie Orchestrierung, um die verschiedenen Vorgänge im Siebel-System aufzurufen.

  4. Erstellen und Bereitstellen des BizTalk-Projekts.

  5. Konfigurieren Sie die BizTalk-Anwendung, indem Sie physische Sende- und Empfangsports erstellen.

  6. Starten Sie die BizTalk-Anwendung.

    Dieses Thema enthält Anweisungen zum Ausführen dieser Aufgaben.

Beispiel basierend auf diesem Thema

Ein Beispiel, MVLDemo, das auf diesem Thema basiert, wird ebenfalls mit dem BizTalk-Adapterpaket bereitgestellt. Weitere Informationen finden Sie unter Beispiele für den Siebel-Adapter.

Generieren eines Schemas

In diesem Thema wird das Schema für Folgendes generiert, um zu veranschaulichen, wie die übergeordnete Geschäftskomponente Konto einer untergeordneten Geschäftskomponente, Kontakt, zugeordnet wird:

Definieren von Nachrichten und Nachrichtentypen

Das zuvor generierte Schema beschreibt die "Typen", die für die Nachrichten in der Orchestrierung erforderlich sind. Eine Nachricht ist in der Regel eine Variable, deren Typ durch das entsprechende Schema definiert wird. Sie müssen das Schema, das Sie im ersten Schritt generiert haben, mit den Nachrichten aus der Orchestrierungsansicht des BizTalk-Projekts verknüpfen.

Für dieses Thema müssen Sie vier Sätze von Anforderungs- und Antwortnachrichten erstellen, einen für jeden Vorgang, den Sie auf dem Siebel-System aufrufen. Jede Gruppe muss über eine Anforderungsnachricht und eine Antwortnachricht verfügen. Das folgende Verfahren enthält beispielsweise Anweisungen zum Erstellen einer Anforderungs- und Antwortnachricht für den Vorgang Zuordnen. Sie müssen ähnliche Schritte ausführen, um Nachrichten für andere Vorgänge zu erstellen.

Führen Sie die folgenden Schritte aus, um Nachrichten zu erstellen und sie mit dem Schema zu verknüpfen:

  1. Öffnen Sie die Orchestrierungsansicht des BizTalk-Projekts, falls noch nicht geöffnet. Klicken Sie auf Ansicht, zeigen Sie auf Andere Fenster, und klicken Sie auf Orchestrierungsansicht.

  2. Klicken Sie in der Orchestrierungsansicht mit der rechten Maustaste auf Nachrichten, und klicken Sie dann auf Neue Nachricht.

  3. Klicken Sie mit der rechten Maustaste auf die neu erstellte Nachricht, und wählen Sie Eigenschaftenfenster aus.

  4. Führen Sie im Bereich Eigenschaften für Message_1 die folgenden Schritte aus:

    Option Aufgabe
    Bezeichner Geben Sie AccountAssociate_Request ein.
    Nachrichtentyp Erweitern Sie in der Dropdownliste Schemas, und wählen Sie MVLDemo.SiebelBindingSchema.Associate aus, wobei MVLDemo der Name Ihres BizTalk-Projekts ist. SiebelBindingSchema ist das Schema, das für den Aufruf des Vorgangs Zuordnen für konto generiert wird.

  5. Wiederholen Sie den vorherigen Schritt, um eine neue Nachricht zu erstellen. Gehen Sie im Bereich Eigenschaften für die neue Nachricht wie folgt vor:

    Option Aufgabe
    Bezeichner Geben Sie AccountAssociate_Response ein.
    Nachrichtentyp Erweitern Sie in der Dropdownliste Schemas, und wählen Sie MVLDemo.SiebelBindingSchema.AssociateResponse aus.

Einrichten der Orchestrierungen

Sie müssen jetzt Orchestrierungen einrichten, um BizTalk Server für die Ausführung von Vorgängen für die Geschäftskomponenten Konto und Kontakt zu verwenden.

  • Richten Sie eine Orchestrierung ein, um einen INSERT-Vorgang für die Geschäftskomponente Konto auszuführen. Weitere Informationen finden Sie unter Ausführen von Vorgängen für Geschäftskomponenten mit BizTalk Server und dem Siebel-Adapter.

  • Richten Sie eine Orchestrierung ein, um einen INSERT-Vorgang für die Geschäftskomponente Contact auszuführen. Dies ähnelt dem INSERT-Vorgang für die Geschäftskomponente Konto .

  • Richten Sie eine Orchestrierung ein, um einen ASSOCIATE-Vorgang für die Geschäftskomponente Konto auszuführen.

  • Richten Sie eine Orchestrierung ein, um einen QUERY_CONTACT Vorgang für die Geschäftskomponente Konto auszuführen.

    In diesem Thema wird veranschaulicht, wie Sie eine Orchestrierung für den ASSOCIATE-Vorgang für die Geschäftskomponente Konto einrichten. Sie müssen ähnliche Aufgaben ausführen, um auch die verbleibenden Orchestrierungen einzurichten.

    Die Orchestrierung für den ASSOCIATE-Vorgang für die Geschäftskomponente Konto sieht wie folgt aus:

    Orchestrierung für die Arbeit mit MVL in Siebel

    Der folgende Abschnitt enthält Informationen zum Einrichten dieser Orchestrierung durch Löschen von Nachrichtenformen, Ports, Verknüpfen von Nachrichten mit Schemas usw. Sie müssen ähnliche Aufgaben ausführen, um auch die anderen Orchestrierungen einzurichten.

Hinzufügen von Nachrichten-Shapes

Stellen Sie sicher, dass Sie die folgenden Eigenschaften für die einzelnen Nachrichtenformen angeben. Die in der Spalte Shape aufgeführten Namen sind die Namen der Nachrichtenformen, wie in der Orchestrierung oben angezeigt.

Form Formtyp Eigenschaften
AccountAssociateXML Empfangen – Legen Sie Name auf AccountAssociateXML fest.
– Legen Sie Aktivieren auf True fest.
SendToLOB Send – Name aufSendToLOB festlegen
ReceiveResponse Empfangen – Name aufReceiveResponse festlegen
– Legen Sie Aktivieren auf False fest.
SendResponse Send – Name aufSendResponse festlegen

Hinzufügen von Ports

Stellen Sie sicher, dass Sie die folgenden Eigenschaften für jeden der logischen Ports angeben. Die in der Spalte Port aufgeführten Namen sind die Namen der Ports, die in der Orchestrierung angezeigt werden.

Port Eigenschaften
FileIn_AccountAssociate – Bezeichner auf FileIn_AccountAssociate festlegen
– Legen Sie Type auf FileInAccountAssociateType fest.
– Festlegen des Kommunikationsmusters auf Unidirektionale
– Festlegen der Kommunikationsrichtung auf "Empfangen"
LOBPort_AccountAssociate – Bezeichner auf LOBPort_AccountAssociate festlegen
– Legen Sie Type auf LOBPortAccountAssociateType fest.
– Festlegen des Kommunikationsmusters auf Request-Response
– Festlegen der Kommunikationsrichtung auf Senden/Empfangen
SaveResponse_AccountAssociate – Bezeichner auf SaveResponse_AccountAssociate festlegen
– Legen Sie Type auf SaveResponseAccountAssociateType fest.
– Festlegen des Kommunikationsmusters auf Unidirektionale
– Kommunikationsrichtung auf Senden festlegen

Angeben von Nachrichten für Aktions-Shapes und Herstellen einer Verbindung mit Ports

In der folgenden Tabelle sind die Eigenschaften und deren Werte angegeben, die festgelegt werden sollen, um Meldungen für Aktions-Shapes anzugeben und sie mit den Ports zu verknüpfen. Die in der Spalte Shape aufgeführten Namen sind die Namen der Meldungs-Shapes, wie in der obigen Orchestrierung angezeigt.

Form Eigenschaften
AccountAssociateXML – Nachricht aufAccountAssociate_Request festlegen
– Festlegen von Operation auf FileIn_AccountAssociate.Associate.Request
SendToLOB – Nachricht aufAccountAssociate_Request festlegen
– Legen Sie Operation auf LOBPort_AccountAssociate.Associate.Request fest.
ReceiveResponse – Nachricht aufAccountAssociate_Response festlegen
– Festlegen von Operation auf LOBPort_AccountAssociate.Associate.Response
SendResponse – Nachricht aufAntwort festlegen
– Legen Sie Operation auf SaveResponse_AccountAssociate.Associate.Request fest.

Nachdem Sie diese Eigenschaften angegeben haben, werden die Nachrichtenformen und Ports verbunden, und Die Orchestrierung ist abgeschlossen.

Sie müssen nun die BizTalk-Lösung erstellen und in einem BizTalk Server bereitstellen. Weitere Informationen finden Sie unter Erstellen von Orchestrierungen und Bereitstellen von BizTalk-Assemblys aus Visual Studio in einer BizTalk-Anwendung.

Konfigurieren der BizTalk-Anwendung

Nachdem Sie das BizTalk-Projekt bereitgestellt haben, wird die zuvor erstellte Orchestrierung in der BizTalk Server Verwaltungskonsole im Bereich Orchestrierungen aufgeführt. Sie müssen die BizTalk Server-Verwaltungskonsole verwenden, um die Anwendung zu konfigurieren. Weitere Informationen zum Konfigurieren einer Anwendung finden Sie unter Erstellen einer Anwendung.

Das Konfigurieren einer Anwendung umfasst Folgendes:

  • Auswählen eines Hosts für die Anwendung.

  • Zuordnen der Ports, die Sie in Ihrer Orchestrierung erstellt haben, zu physischen Ports in der BizTalk Server-Verwaltungskonsole. Für diese Orchestrierung müssen Sie:

    • Definieren Sie einen Speicherort auf der Festplatte und einen entsprechenden Dateiport, an dem Sie eine Anforderungsnachricht ablegen. Die BizTalk-Orchestrierung nutzt die Anforderungsnachricht und sendet sie an das Siebel-System. Sie können über denselben Port für alle vier Orchestrierungen verfügen.

    • Definieren Sie einen Speicherort auf der Festplatte und einen entsprechenden Dateiport, an dem die BizTalk-Orchestrierung die Antwortnachricht mit der Antwort aus dem Siebel-System abgibt. Sie können über denselben Port für alle vier Orchestrierungen verfügen.

    • Definieren Sie physische WCF-Custom oder WCF-Siebel Sendeports, um Nachrichten an das Siebel-System zu senden. Sie müssen die Aktion auch im Sendeport angeben. Informationen zum Erstellen von Ports finden Sie unter Manuelles Konfigurieren einer physischen Portbindung an den Siebel-Adapter. Sie müssen über unterschiedliche Ports für alle vier Orchestrierungen verfügen.

      Hinweis

      Beim Generieren des Schemas mithilfe des BizTalk-Projekt-Add-Ins "Consume Adapter Service" wird auch eine Bindungsdatei erstellt, die Informationen zu den Ports und den aktionen enthält, die für diese Ports festgelegt werden sollen. Sie können diese Bindungsdatei aus der BizTalk-Verwaltungskonsole importieren, um Sendeports (für ausgehende Aufrufe) zu erstellen. Weitere Informationen finden Sie unter Konfigurieren einer physischen Portbindung mithilfe einer Portbindungsdatei für Siebel.

Starten der Anwendung

Sie müssen die BizTalk-Anwendung starten, um der untergeordneten Geschäftskomponente eine übergeordnete Geschäftskomponente zuzuordnen. Anweisungen zum Starten einer BizTalk-Anwendung finden Sie unter Starten einer BizTalk-Anwendung oder Starten einer Orchestrierung.

Stellen Sie in dieser Phase Folgendes sicher:

  • Der FILE-Empfangsport zum Empfangen von Anforderungsmeldungen für die Orchestrierung wird ausgeführt.

  • Der FILE-Sendeport zum Empfangen der Antwortnachrichten von der Orchestrierung wird ausgeführt.

  • Die vier WCF-Custom oder WCF-Siebel Sendeports, jeweils einer zum Senden von Nachrichten an das Siebel-System, werden ausgeführt.

  • Die vier BizTalk-Orchestrierungen für die verschiedenen Vorgänge werden ausgeführt.

Ausführen des Vorgangs

Sie müssen die Anforderungsnachrichten am FILE-Empfangsport ablegen. Das Schema für die Anforderungsmeldungen muss dem Schema entsprechen, das Sie zuvor im Thema generiert haben. Weitere Informationen zum Schema für die Anforderungsnachricht für verschiedene Vorgänge finden Sie unter Nachrichtenschemas für Geschäftskomponentenvorgänge . Sie müssen die Anforderungsmeldungen in der folgenden Reihenfolge ablegen:

  • Löschen Sie eine Anforderungsnachricht, um einen Datensatz in die Geschäftskomponente Konto einzufügen. Die Anforderungsnachricht ähnelt der Nachricht, die zum Einfügen eines Datensatzes in die Geschäftskomponente Konto im Thema Ausführen von Vorgängen für Geschäftskomponenten mit BizTalk Server und dem Siebel-Adapter abgelegt wurde. Die Orchestrierung nutzt die Nachricht und sendet sie an das Siebel-System. Die Antwort des Siebel-Systems wird am anderen FILE-Speicherort gespeichert, der als Teil der Orchestrierung definiert ist.

  • Löschen Sie eine Anforderungsnachricht, um einen Datensatz in die Geschäftskomponente Kontakt einzufügen. Die Anforderungsnachricht ähnelt der Nachricht, die zum Einfügen eines Datensatzes in die Geschäftskomponente Konto im Thema Ausführen von Vorgängen für Geschäftskomponenten mit BizTalk Server und dem Siebel-Adapter abgelegt wurde. Die Orchestrierung nutzt die Nachricht und sendet sie an das Siebel-System. Die Antwort des Siebel-Systems wird am anderen FILE-Speicherort gespeichert, der als Teil der Orchestrierung definiert ist.

  • Löschen Sie eine Anforderungsnachricht, um einen ASSOCIATE-Vorgang für die Geschäftskomponente Konto auszuführen. Dadurch werden die übergeordneten und untergeordneten Geschäftskomponenten basierend auf dem Suchausdruck und dem Namen des mehrwertigen Felds zugeordnet, das Sie in der Eingabe-XML angeben. Beachten Sie dabei Folgendes:

    • Der übergeordnete Suchausdruck im ASSOCIATE-Vorgang muss mit einem eindeutigen Datensatz in der übergeordneten Tabelle übereinstimmen.

    • Der untergeordnete Suchausdruck im ASSOCIATE-Vorgang muss mit einem eindeutigen Datensatz in der untergeordneten Tabelle übereinstimmen.

      Die Anforderungsnachricht zum Ausführen eines Zuordnensvorgangs für die Geschäftskomponente Konto lautet beispielsweise:

    <Associate xmlns="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Operation">  
  <ViewMode>3</ViewMode>  
  <ParentSearchExpr>[Name] LIKE "SampleName1"</ns0:ParentSearchExpr>   
  <ParentMVGField>Bill To First Name</ns0:ParentMVGField>   
  <ChildSearchExpr>[First Name] LIKE "SampleName2"</ns0:ChildSearchExpr>   
</Associate>

    Die Orchestrierung nutzt die Nachricht und sendet sie an das Siebel-System. Die Antwort des Siebel-Systems wird am anderen FILE-Speicherort gespeichert, der als Teil der Orchestrierung definiert ist. Die Antwort für die obige Anforderungsnachricht lautet beispielsweise:

    <?xml version="1.0" encoding="utf-8"?>  
<AssociateResponse xmlns="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Operation">  
  <AssociateResult>  
    <ChildID xmlns="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects">1-8AO09</ChildID>  
    <ParentID xmlns="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects">1-8ANZ5</ParentID>  
  </AssociateResult>  
</AssociateResponse>

  • Löschen Sie eine Anforderungsnachricht, um einen QUERY_CONTACT Vorgang für die Geschäftskomponente Konto auszuführen. Beispielsweise lautet die Anforderungsmeldung für einen QUERY_CONTACT Vorgang:

    <Query_Contact xmlns ="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Operation">  
  <ViewMode>3</ViewMode>   
  <ParentSearchExpr>[Name] LIKE "SampleName1"</ParentSearchExpr>   
  <ParentMVGField>Bill To First Name</ParentMVGField>   
  <ContactQueryInputRecord>  
    <SearchExpr xmlns:ns1="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects">[Id] LIKE '*'</SearchExpr>   
  </ContactQueryInputRecord>  
</Query_Contact>

    Die Orchestrierung nutzt die Nachricht und sendet sie an das Siebel-System. Die Antwort des Siebel-Systems wird am anderen FILE-Speicherort gespeichert, der als Teil der Orchestrierung definiert ist.

    Weitere Informationen zum Schema für die Anforderungsnachricht finden Sie unter Nachrichtenschemas für Geschäftskomponentenvorgänge .

Mögliche Ausnahmen

Informationen zu den Ausnahmen, die beim Ausführen eines Vorgangs für eine Geschäftskomponente mit mehrwertigen Feldern mithilfe von BizTalk Server auftreten können, finden Sie unter Ausnahmen und Fehlerbehandlung.

Bewährte Methoden

Nachdem Sie das BizTalk-Projekt bereitgestellt und konfiguriert haben, können Sie Konfigurationseinstellungen in eine XML-Datei exportieren, die als Bindungsdatei bezeichnet wird. Nachdem Sie eine Bindungsdatei generiert haben, können Sie die Konfigurationseinstellungen aus der Datei importieren, sodass Sie die Sendeports, Empfangsports usw. für dieselbe Orchestrierung nicht erstellen müssen. Weitere Informationen zu Bindungsdateien finden Sie unter Wiederverwenden von Adapterbindungen.

Weitere Informationen

Entwickeln von BizTalk-Anwendungen