Condividi tramite


Selezionare uno schema URI e un formato di indirizzamento quando si usa WCF LOB Adapter SDK

Un URI (Uniform Resource Identifier) identifica in modo univoco le risorse come un servizio Web o, nel caso di un adattatore sviluppato con WCF LOB Adapter SDK, il sistema a cui connettersi e l'azione da eseguire. In questa sezione viene fornito un suggerimento su come costruire un URI per descrivere in modo univoco l'indirizzo dell'endpoint e l'azione per l'adattatore.

Anatomia di un URI

Un URI è costituito dai tre componenti seguenti:

  • Il nome dello schema è la parte iniziale della stringa URI ed è il primo livello della struttura di denominazione; gli esempi includono http, urn e contoso.

  • La parte gerarchica è costituita da informazioni in genere gerarchici e che possono contenere informazioni facoltative su autorità, nome host e porta. Gli esempi includono www.microsoft.com e UserName=User@microsoft.com:4099.

  • La query contiene informazioni facoltative contrassegnate con un punto interrogativo (?) e in genere raggruppate come coppie chiave/valore separate da una e commerciale (&). Ad esempio, contoso://microsoft.com/functions?name=Find.

  • Il frammento viene usato per archiviare informazioni di identificazione aggiuntive che potrebbero essere necessarie per l'adattatore. Il frammento è separato da un hash (#); ad esempio, contoso://microsoft.com/functions?name=Find#public.

    È possibile che non si usino tutte le funzionalità fornite dalla sintassi dell'URI.

Progettazione dell'URI

Gli sviluppatori di adattatori dovranno definire un URI appropriato per il sistema line-of-business di destinazione. Quando si progetta l'URI, è importante renderlo univoco e significativo.

Un URI univoco è uno che non è in conflitto con gli URI esistenti all'interno di un'organizzazione e tra altre aziende e Internet. Ad esempio, la scelta di un nome di schema come "http" o "afs" che può essere attualmente riconosciuta o già in uso a livello di rete potrebbe causare problemi di connessione o operativi perché le richieste potrebbero essere instradate a un sistema diverso e non all'adattatore.

Un altro aspetto importante della progettazione dell'URI è che lo rende significativo per i destinatari degli sviluppatori che usano la scheda. Ad esempio, se si scrive un adattatore per un sistema di elaborazione delle attestazioni mediche, è possibile progettare uno schema URI che include il nome della società, il nome del sistema di elaborazione delle attestazioni di destinazione e la versione di sistema: northwind.contoso.cps.v1.0://.

Connessione al sistema di destinazione

Le stringhe di connessione hanno la sintassi seguente:

<scheme>://[userinfo "@"]<Stringa di connessione LOB>

Ad esempio, è possibile connettersi al sistema di ordinamento del catalogo contoso (un'applicazione line-of-business di esempio) usando quanto segue:

northwind.contoso.v1.0://<nomeserver>? Catalog=Contoso&Integrated Security=True

È anche possibile fornire informazioni facoltative sull'autorità nell'URI, inclusi nome utente e password e altre credenziali importanti. Tuttavia, questo può presentare un rischio per la sicurezza.

Attenzione

Non passare le credenziali utente e altre informazioni riservate nell'URI. Queste informazioni potrebbero essere intercettate e visualizzate da utenti non autorizzati.

Vedere anche

Pianificare e progettare un adattatore usando WCF LOB Adapter SDK