Come configurare un indirizzo di ricezione SOAP
È possibile configurare una posizione di ricezione SOAP a livello di codice o tramite la console di amministrazione BizTalk Server.
Come configurare un indirizzo di ricezione SOAP a livello di codice
Il modello a oggetti di BizTalk Explorer consente di creare e configurare indirizzi di ricezione a livello di codice. Il modello a oggetti BizTalk Explorer espone l'interfaccia di configurazione della posizione di ricezioneIReceiveLocation con una proprietà di lettura/scrittura TransportTypeData . Questa proprietà accetta un elenco di proprietà di configurazione degli indirizzi di ricezione SOAP sotto forma di coppia nome-valore di stringhe XML. Per impostare questa proprietà nel modello a oggetti BizTalk Explorer, è necessario impostare la proprietà InboundTransportLocation dell'interfaccia IReceiveLocation .
La proprietà TransportTypeData dell'interfaccia IReceiveLocation non deve essere impostata. in modo che l'adapter SOAP utilizzi i valori predefiniti per la configurazione degli indirizzi di ricezione SOAP come indicato nella tabella seguente.
Nella tabella seguente sono illustrate le proprietà di configurazione che è possibile impostare nel modello a oggetti di BizTalk Explorer per l'indirizzo di ricezione SOAP.
| Nome proprietà | Type | Descrizione |
|---|---|---|
| URI | string | Directory virtuale contenente il servizio Web nel server di distribuzione. |
| AddressableURI | string | Campo di indirizzo pubblico contenente l'intero URL disponibile per la chiamata. Valore predefinito: vuoto |
| UseSSO | Boolean | Specifica se l'adapter SOAP rilascia il ticket Single Sign-On ai messaggi che giungono all'indirizzo di ricezione. Valore predefinito: False |
Per impostare le proprietà, utilizzare il seguente formato:
receiveLocation.TransportTypeData = "<CustomProps><UseSSO vt=\"11\">-1</UseSSO></CustomProps>";
Le proprietà URI e AddressableURI vengono impostate usando le proprietà Address e PublicAddress dell'oggetto location di ricezione.
Nel frammento di codice riportato di seguito viene descritto come creare un indirizzo di ricezione SOAP:
// Use BizTalk Explorer object model to create new SOAP receive location.
string server = System.Environment.MachineName;
string database = "BizTalkMgmtDb";
string connectionString = string.Format("Server={0};Database={1};Integrated Security=true", server, database);
//requires project reference to \Program Files\Microsoft BizTalk Server 2009\Developer Tools\Microsoft.BizTalk.ExplorerOM.dll
BtsCatalogExplorer explorer = new Microsoft.BizTalk.ExplorerOM.BtsCatalogExplorer();
explorer.ConnectionString = connectionString;
// Add a new Request-Response port
ReceivePort receivePort = explorer.AddNewReceivePort(true);
receivePort.Name = "SampleReceivePort";
receivePort.SendPipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruTransmit"];
// Add primary SOAP receive location
ReceiveLocation receiveLocation = receivePort.AddNewReceiveLocation();
receiveLocation.Name = "SampleReceiveLocation";
receiveLocation.Address = "/PurchaseOrder/POOrchestration.asmx";
receiveLocation.TransportType = explorer.ProtocolTypes["SOAP"];
receiveLocation.TransportTypeData = "<CustomProps><UseSSO vt=\"11\">-1</UseSSO></CustomProps>";
receiveLocation.ReceivePipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruReceive"];
foreach (ReceiveHandler receiveHandler in explorer.ReceiveHandlers)
{
if (receiveHandler.TransportType.Name == receiveLocation.TransportType.Name)
{
receiveLocation.ReceiveHandler = receiveHandler;
}
}
// Save
explorer.SaveChanges();
Come configurare un indirizzo di ricezione SOAP con la Console di amministrazione BizTalk Server
È possibile impostare le variabili dell'adattatore di posizione SOAP nella console di amministrazione di BizTalk Server. Se non vengono impostate proprietà nell'indirizzo di ricezione, verranno utilizzati i valori del gestore di ricezione predefinito impostati nella Console di amministrazione BizTalk Server.
Nota
Prima di completare le procedure riportate di seguito, è necessario avere già aggiunto una porta di ricezione. Per altre informazioni, vedere Come creare una porta di ricezione.
Per configurare le variabili per un indirizzo di ricezione SOAP
Nella console di amministrazione di BizTalk Server espandere amministrazione BizTalk Server, espandere Gruppo BizTalk, espandere Applicazioni e quindi espandere l'applicazione in cui si vuole creare un percorso di ricezione.
Nel riquadro sinistro della console di amministrazione BizTalk Server fare clic sul nodo Porta di ricezione. Nel riquadro destro fare quindi clic con il pulsante destro del mouse sulla porta di ricezione associata a un indirizzo di ricezione esistente o che si desidera associare a un nuovo indirizzo di ricezione e scegliere Proprietà.
Nella finestra di dialogo Proprietà porta di ricezione, nel riquadro sinistro selezionare Posizioni di ricezione e quindi nel riquadro destro fare doppio clic su un percorso di ricezione esistente o fare clic su Nuovoper creare una nuova posizione di ricezione.
Nella finestra di dialogo Proprietà percorso di ricezione , nella sezione Trasporto accanto a Tipo selezionare SOAP dall'elenco a discesa e quindi fare clic su Configura.
Nella finestra di dialogo Proprietà trasporto SOAP eseguire le operazioni seguenti:
Usare Per Directory virtuale più file ASMX servizio Web Indicare il file con estensione asmx creato dalla Pubblicazione guidata servizi Web BizTalk.
Il formato del messaggio è simile al seguente:
/PurchaseOrder/POOrchestration.asmx
Dove il percorso completo del file asmx è http://localhost/PurchaseOrder/POOrchestration.asmx. Nota: L'URI per una porta di invio o una posizione di ricezione non può superare i 256 caratteri.Indirizzo pubblico Specificare l'URI completo dell'indirizzo di ricezione. Il valore di questa proprietà è una combinazione del nome del server e della directory virtuale. L'URI specificato deve designare l'URL del sito Web pubblico a cui i partner commerciali devono connettersi per inviare messaggi a BizTalk Server.
Queste informazioni sono facoltative e non vengono utilizzate da BizTalk Server. Questo parametro viene reso disponibile per consentire agli amministratori di documentare l'URL pubblico a cui l'indirizzo di ricezione è associato.Usare Single Sign-On Indicare che l'adapter SOAP utilizza Enterprise Single Sign-On. Nota: La Pubblicazione guidata servizi Web BizTalk consente di usare SharePoint Portal Server Single Sign-On. Questa proprietà abilita solo Enterprise Single Sign-On. Fare clic su OK.
Nella finestra di dialogo Proprietà percorso di ricezione immettere i valori appropriati per completare la configurazione della posizione di ricezione e quindi fare clic su OK per salvare le impostazioni. Per informazioni sulla finestra di dialogo Proprietà indirizzo di ricezione , vedere Come creare un indirizzo di ricezione.
Le impostazioni di sicurezza utilizzate dall'indirizzo di ricezione SOAP sono impostate in IIS. Per impostazione predefinita, l'indirizzo di ricezione SOAP non è impostato per l'utilizzo dell'autenticazione anonima.
Mentre il client SOAP chiama il servizio Web, l'adapter SOAP lo autentica mediante autenticazione anonima, di base, del digest o integrata di Windows. Se l'utente viene verificato, il contesto dell'utente viene passato al gestore di ricezione.
Nota
Le configurazioni di IIS che consentono a SOAP e HTTP di condividere lo stesso processo non sono valide. È consentito un solo ricevitore isolato per processo.
Per aggiornare una directory virtuale per l'utilizzo di ASP.NET 4.0
Avviare Gestione Internet Information Services (IIS). Fare clic su Start, fare clic su Tutti i programmi e fare clic su Gestione Internet Information Services (IIS).
Se è necessario connettersi a un server IIS remoto, fare clic con il pulsante destro del mouse sul nodo Internet Information Services e quindi scegliere Connetti.
Digitare il nome computer del server IIS remoto e le credenziali, se necessario.
Espandere il nome del server che ospita il sito Web o la directory virtuale da aggiornare.
Espandere Siti.
Espandere Sito Web predefinito.
Espandere il sito Web predefinito per visualizzare le directory virtuali sottostanti.
Fare clic con il pulsante destro del mouse sulla directory virtuale da aggiornare per usare ASP.NET 4.0, scegliere Gestisci applicazione e quindi fare clic su Impostazioni avanzate. Il campo Pool di applicazioni visualizza il pool di applicazioni impostato per la directory virtuale selezionata. Fare clic su OK.
Nella finestra Gestione Internet Information Services (IIS) fare clic su Pool di applicazioni. Nel riquadro dei dettagli verrà visualizzato un elenco di pool di applicazioni presenti sul server.
Fare clic con il pulsante destro del mouse sul pool di applicazioni impostato nel passaggio 8 e quindi scegliere Impostazioni di base.
Nella finestra di dialogo Modifica pool di applicazioni modificare quanto segue:
Versione di .NET Framework alla versione 4.0
Modalità pipeline gestita in versione classica
Fare clic su OK applicare le modifiche.
Vedere anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per