DeleteParty (esempio di BizTalk Server)

Articolo
10/14/2023

Nell'esempio DeleteParty viene illustrato come eliminare un'entità specificata.

Avviso

Dopo la distribuzione, rimuovere gli script di distribuzione se non sono necessari. Gli script di amministrazione e gli altri script da non rimuovere devono essere protetti mediante elenchi di controllo di accesso (ACL, Access Control List) e accuratamente monitorati.

Nota

Prima di poter eliminare un'entità, è innanzitutto necessario crearla. Un modo per eseguire questa operazione consiste nell'eseguire l'esempio PartyResolution (BizTalk Server Sample).

Prerequisiti

È necessario disporre di BizTalk Server privilegi amministrativi per usare gli oggetti amministrativi in questo esempio.
L'esecuzione dello script di Windows PowerShell richiede i criteri di esecuzione di Windows PowerShell. Per altre informazioni, vedere about_Execution_Policies.

Scopo dell'esempio

Questo esempio, scritto in Microsoft Visual C#, consente di eseguire le operazioni riportate di seguito utilizzando oggetti del modello a oggetti di BizTalk Explorer (ExplorerOM):

Esecuzione di una query per una determinata entità.
Eliminazione dell'entità.
Gestire gli eventuali errori in modo che all'utente vengano restituite informazioni significative.

Percorso dell'esempio

L'esempio è disponibile nel percorso SDK seguente:

<Percorso esempi>\Amministrazione\ExplorerOM\DeleteParty\

Nella seguente tabella sono riportati i file inclusi nell'esempio e ne viene descritto lo scopo.

File	Descrizione
App.ico, AssemblyInfo.cs, DeleteParty.csproj, DeleteParty.sln, DeleteParty.cs	File di progetto, di soluzione e di origine per la compilazione di un'applicazione da riga di comando di Visual C# che rimuove un'entità specificata.

Per compilare e inizializzare l'esempio

In Visual Studio aprire il file di soluzione DeleteParty.sln.
Nel menu Compila scegliere Compila soluzione.

Per eseguire questo esempio

In una finestra di comando passare alla seguente cartella:

<Percorso esempi>\Amministrazione\ExplorerOM\DeleteParty\bin\Debug\
Eseguire il file DeleteParty.exe passando uno dei due argomenti della riga di comando seguenti:
- <PartyName>. Nome di una parte da eliminare. Se il nome contiene spazi, racchiuderlo tra virgolette.
- /?. Visualizza la Guida.
  
  Ad esempio:
```
DeleteParty "My Party #3"
```
-OPPURE-
```
DeleteParty /?
```

Esempio di script di Windows PowerShell

Per illustrare le stesse funzionalità delle classi ExplorerOM, è possibile usare il frammento di script seguente Windows PowerShell:


#===================#
#=== 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"

#=======================================#
#=== If no party name is specified   ===#
#=== just list the parties.          ===#
#=======================================#

if ($args[0] -eq $null)
{
  Write-Host `r`nNo party name provided for delete operation.`r`n`r`nListing Parties on local Biztalk Server:

  $Catalog.Parties | Format-List Name
}

#==========================================#
#=== Delete the specified party by name ===#
#==========================================#

else
{
  $party = $Catalog.Parties[$args[0]]
  Write-Host `r`nRemoving Party named `"($args[0])`"`r`n
  $catalog.RemoveParty($party)
  $catalog.SaveChanges()
}

L'esempio di script prevede un unico nome di entità da passare come argomento della riga di comando. L'entità verrà cercata in base al nome e dopo averla trovata si tenterà di eliminarla. Se non viene passato alcun argomento della riga di comando allo script, verranno elencate tutte le entità presenti nel server Biztalk locale. Di seguito è riportato l'output dello script di esempio:

PS C:\> .\DeletePart.ps1

No party name provided for delete operation.

Listing Parties on local Biztalk Server:

Name : Party1

Name : Party3

Name : Party2

PS C:\> .\DeletePart.ps1 Party3

Removing Party named " Party3 "

PS C:\> .\DeletePart.ps1

No party name provided for delete operation.

Listing Parties on local Biztalk Server:

Name : Party1

Name : Party2

Vedere anche

Admin-ExplorerOM (cartella di esempi di BizTalk Server)

Condividi tramite