OrchestrationBinding (exemple BizTalk Server)

Article
10/14/2023

L'exemple de liaison d'orchestration illustre l'utilisation des objets d'administration de Microsoft.BizTalk.ExplorerOM pour configurer et gérer les orchestrations.

Prérequis

Cet exemple nécessite que l’exemple HelloWorld soit déployé en exécutant setup.bat situé dans le < répertoire Samples Path>\Orchestrations\HelloWorld.
Vous devez disposer BizTalk Server privilèges d’administration pour utiliser les objets administratifs de cet exemple.
L'exemple de script Windows PowerShell requiert que la stratégie d'exécution de Windows PowerShell autorise l'exécution des scripts. Pour plus d'informations, consultez la page Examen de la stratégie d'exécution.

Fonctions de l'exemple

Cet exemple présente l'utilisation des objets d'administration dans l'espace de noms Microsoft.BizTalk.ExplorerOM en vue de gérer les orchestrations. L'exemple illustre les opérations suivantes utilisant les objets ExplorerOM :

connexion à la base de données de gestion BizTalk à l'aide de la classeMicrosoft.BizTalk.ExplorerOM.BtsCatalogExplorer ;
arrêt et démarrage des orchestrations en changeant la propriété État de la classe Microsoft.BizTalk.ExplorerOM.BtsOrchestration ;
inscription et désinscription des orchestrations en changeant la propriété État de la classe Microsoft.BizTalk.ExplorerOM.BtsOrchestration ;
liaison et annulation de liaison des orchestrations à l'aide de la collection Ports de la classe Microsoft.BizTalk.ExplorerOM.BtsOrchestration .

Accès à l'exemple

L'exemple se trouve dans l'emplacement SDK suivant :

<Chemin d’accès> des exemples\Administration\ExplorerOM\OrchestrationBinding

Le tableau suivant présente les fichiers de cet exemple et décrit leur fonction.

Fichier(s)	Description
OrchestrationBinding.cs	Fichier source Visual C# pour les opérations illustrées dans cet exemple.
OrchestrationBinding.sln, OrchestrationBinding.csproj, OrchestrationBinding.suo	Fichiers de projet et de solution de l'exemple.

Générer cet exemple

Assurez-vous d'avoir effectué les étapes de création et d'initialisation de l'exemple HelloWorld. Ces étapes sont fournies dans HelloWorld (BizTalk Server Sample).
Dans Visual Studio, ouvrez le fichier solution OrchestrationBinding.sln.
Dans le menu Générer, cliquez sur Générer la solution.

Exécuter cet exemple

Ouvrez une fenêtre de commande, puis accédez au dossier suivant :

<Chemin d’accès> des exemples\Administration\ExplorerOM\OrchestrationBinding\bin\Debug
Exécutez le fichier OrchestrationBinding.exe et suivez les instructions de l'exemple.

Exemple de script Windows PowerShell

L'exemple de script Windows PowerShell suivant permet d'illustrer les mêmes fonctionnalités des classes ExplorerOM .


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

Voici un exemple de sortie généré par l'exécution du script Windows PowerShell.

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

Voir aussi

Administration-ExplorerOM (dossier d’exemples BizTalk Server)HelloWorld (exemple BizTalk Server)

Partager via