OrchestrationBinding (BizTalk Server-Beispiel)

Das Orchestration Binding-Beispiel veranschaulicht die Verwendung der administrativen Objekte von Microsoft.BizTalk.ExplorerOM zum Konfigurieren und Verwalten von Orchestrierungen.

Voraussetzungen

• Für dieses Beispiel muss das HelloWorld-Beispiel bereitgestellt werden, indem setup.bat im Verzeichnis <Samples Path>\Orchestrations\HelloWorld ausgeführt wird.

• Sie müssen über Administratorrechte von BizTalk Server verfügen, um die administrativen Objekte in diesem Beispiel zu verwenden.

• Das Windows PowerShell-Skriptbeispiel erfordert die Windows PowerShell-Ausführungsrichtlinie, um die Skriptausführung zuzulassen. Weitere Informationen finden Sie unter Untersuchen der Ausführungsrichtlinie.

Funktionsweise dieses Beispiels

In diesem Beispiel wird die Verwendung der administrativen Objekte im Microsoft.BizTalk.ExplorerOM-Namespace zum Verwalten von Orchestrierungen veranschaulicht. Das Beispiel veranschaulicht die folgenden Vorgänge mit den ExplorerOM-Objekten :

• Herstellen einer Verbindung mit der BizTalk Management-Datenbank mithilfe derMicrosoft.BizTalk.ExplorerOM.BtsCatalogExplorer-Klasse .

• Beenden und Starten von Orchestrierungen durch Ändern der Status-Eigenschaft der Microsoft.BizTalk.ExplorerOM.BtsOrchestration-Klasse .

• Registrierung und Deregistrierung von Orchestrierungen durch Ändern der Status-Eigenschaft der Microsoft.BizTalk.ExplorerOM.BtsOrchestration-Klasse.

• Binden und Aufheben der Bindung von Orchestrierungen mithilfe der Ports-Auflistung in der Microsoft.BizTalk.ExplorerOM.BtsOrchestration-Klasse .

Wo finden Sie dieses Beispiel?

Das Beispiel befindet sich am folgenden SDK-Speicherort:

< Beispielpfad>\Admin\ExplorerOM\OrchestrationBinding

Die folgende Tabelle zeigt die Dateien in diesem Beispiel und beschreibt deren Zweck.

Dieses Beispiel erstellen

1. Stellen Sie sicher, dass Sie die Schritte zum Erstellen und Initialisieren des HelloWorld-Beispiels abgeschlossen haben. Diese Schritte werden in HelloWorld (BizTalk Server-Beispiel) bereitgestellt.

2. Öffnen Sie in Visual Studio die Projektmappendatei OrchestrationBinding.sln.

3. Klicken Sie im Menü Erstellen auf Lösung erstellen.

Dieses Beispiel ausführen

1. Öffnen Sie ein Befehlsfenster, und navigieren Sie zum folgenden Ordner:

   < Pfad für Beispiele>\Admin\ExplorerOM\OrchestrationBinding\bin\Debug

2. Führen Sie die Datei OrchestrationBinding.exe aus, und folgen Sie den Anweisungen des Beispiels.

Windows PowerShell-Skriptbeispiel

Das folgende Windows PowerShell-Skript kann verwendet werden, um die gleichen Features der ExplorerOM-Klassen zu veranschaulichen.

Function RefreshPrompt($oldstatus,$newstatus)
{
  Write-Host Orchestration Status should now be `"$oldstatus`"
  Write-Host Press F5 in the Orchestrations view of BizTalk Server Administration Console to refresh and verify

  if ($newstatus)
  {
    Write-Host Pressing `<Enter`> now will $newstatus the orchestration using ExplorerOM`.`.`.
    Read-Host
    Write-Host "=== Please wait, attempting to $newstatus the orchestration... ===`r`n"
  }
  else
  {
    write-host `r`n
  }
}

#===================#
#=== Main Script ===#
#===================#

#=== Make sure the ExplorerOM assembly is loaded ===#

[void] [System.reflection.Assembly]::LoadWithPartialName("Microsoft.BizTalk.ExplorerOM")

#=== Connect to the BizTalk Management database ===#

$Catalog = New-Object Microsoft.BizTalk.ExplorerOM.BtsCatalogExplorer
$Catalog.ConnectionString = "SERVER=.;DATABASE=BizTalkMgmtDb;Integrated Security=SSPI"

#=== This sample expects the HelloWorld sample orchestration to be using the ===#
#=== default name "Biztalk Application 1"                                    ===#

$HelloWorldApp = $Catalog.Applications["Biztalk Application 1"]
$orch = $HelloWorldApp.orchestrations["Microsoft.Samples.BizTalk.HelloWorld.HelloSchedule"]

#==================================================================#
#=== Register a trap handler to discard changes on exceptions   ===#
#=== Execution will continue in the event we need to re-enlist, ===#
#=== re-bind, or restart the orchestration.                     ===#
#==================================================================#

$ErrorActionPreference="silentlycontinue"
trap { "Exception encountered:`r`n"; $_; "`r`nDiscarding Changes and continuing execution...`r`n";$Catalog.DiscardChanges();}

write-host `r`nMake sure the "HelloWorld" sample application is deployed and running.
write-host By default it will be listed in the BizTalk Server Administration Console
write-host with the application name: `"BizTalk.Application.1`"`r`n

#==========================================================#
#=== Change orchestration state from Started to stopped ===#
#==========================================================#

RefreshPrompt Started stop
$orch.Status = [Microsoft.BizTalk.ExplorerOM.OrchestrationStatus] "Enlisted"
$Catalog.SaveChanges()

#=============================================================#
#=== Change orchestration state from stopped to unenlisted ===#
#=============================================================#

RefreshPrompt Stopped unenlist
$orch.Status = [Microsoft.BizTalk.ExplorerOM.OrchestrationStatus] "Unenlisted"
$Catalog.SaveChanges()

#=============================================================#
#=== Change orchestration state from unenlisted to unbound ===#
#=============================================================#

RefreshPrompt Unenlisted unbind
$orch.Ports["SendInvoicePort"].SendPort = $null
$orch.Ports["ReceivePOPort"].ReceivePort = $null;
$orch.Host = $null
$Catalog.SaveChanges()

#==================================================================#
#=== Change orchestration state from unbound back to unenlisted ===#
#==================================================================#

RefreshPrompt Unenlisted`(Unbound`) re-bind
$orch.Ports["SendInvoicePort"].SendPort = $Catalog.SendPorts["HelloWorldSendPort"]
$orch.Ports["ReceivePOPort"].ReceivePort = $Catalog.ReceivePorts["HelloWorldReceivePort"]
$orch.Host = $Catalog.Hosts["BizTalkServerApplication"]
$Catalog.SaveChanges()

#==================================================================#
#=== Change orchestration state from unenlisted back to stopped ===#
#==================================================================#

RefreshPrompt Unenlisted enlist
$orch.Status = [Microsoft.BizTalk.ExplorerOM.OrchestrationStatus] "Enlisted"
$Catalog.SaveChanges()

#===============================================================#
#=== Change orchestration state from stopped back to started ===#
#===============================================================#

RefreshPrompt Stopped restart
$orch.Status = [Microsoft.BizTalk.ExplorerOM.OrchestrationStatus] "Started"
$Catalog.SaveChanges()

RefreshPrompt Started

Hier ist eine Beispielausgabe aus der Ausführung des Windows PowerShell-Skripts.

PS C:\> .\OrchestrationBind.ps1

Make sure the HelloWorld sample application is deployed and running.
By default it will be listed in the BizTalk Server Administration Console
with the application name: "BizTalk.Application.1"

Orchestration Status should now be "Started"
Press F5 in the Orchestrations view of BizTalk Server Administration Console to refresh and verify
Pressing <Enter> now will stop the orchestration using ExplorerOM...

=== Please wait, attempting to stop the orchestration... ===

Orchestration Status should now be "Stopped"
Press F5 in the Orchestrations view of BizTalk Server Administration Console to refresh and verify
Pressing <Enter> now will unenlist the orchestration using ExplorerOM...

=== Please wait, attempting to unenlist the orchestration... ===

Orchestration Status should now be "Unenlisted"
Press F5 in the Orchestrations view of BizTalk Server Administration Console to refresh and verify
Pressing <Enter> now will unbind the orchestration using ExplorerOM...

=== Please wait, attempting to unbind the orchestration... ===

Orchestration Status should now be "Unenlisted(Unbound)"
Press F5 in the Orchestrations view of BizTalk Server Administration Console to refresh and verify
Pressing <Enter> now will re-bind the orchestration using ExplorerOM...

=== Please wait, attempting to re-bind the orchestration... ===

Orchestration Status should now be "Unenlisted"
Press F5 in the Orchestrations view of BizTalk Server Administration Console to refresh and verify
Pressing <Enter> now will enlist the orchestration using ExplorerOM...

=== Please wait, attempting to enlist the orchestration... ===

Orchestration Status should now be "Stopped"
Press F5 in the Orchestrations view of BizTalk Server Administration Console to refresh and verify
Pressing <Enter> now will restart the orchestration using ExplorerOM...

=== Please wait, attempting to restart the orchestration... ===

Orchestration Status should now be "Started"
Press F5 in the Orchestrations view of BizTalk Server Administration Console to refresh and verify

Siehe auch

Admin-ExplorerOM (BizTalk Server Samples Folder)HelloWorld (BizTalk Server-Beispiel)