Come aggiungere functoid Esecuzione script a una mappa
Il functoid Scripting consente di usare script o codice personalizzato in fase di esecuzione per eseguire funzioni altrimenti non disponibili. Ad esempio, è possibile chiamare un oggetto COM in fase di esecuzione usando il functoid Scripting e scrivendo uno script personalizzato.
Per informazioni concettuali sul functoid Scripting, vedere Scripting Functoid.For conceptual information about the Scripting functoid, see Scripting Functoid.
Per aggiungere il functoid Esecuzione script a una mappa e configurarlo
Con la casella degli strumenti di Visual Studio attiva, fare clic sulla scheda Functoid avanzati per selezionare tale categoria di functoid.
Verrà visualizzato l'elenco di functoid avanzati della categoria selezionata.
Trascinare il functoid Scripting
dalla casella degli strumenti alla posizione appropriata in una pagina della griglia.Nota
Il functoid verrà posizionato sulla pagina della griglia visualizzata. Se si desidera inserire il functoid in una pagina della griglia diversa, sarà necessario visualizzare prima la pagina della griglia specifica.
Nota
Se si sta costruendo una mappa utilizzando più di un functoid, è necessario considerare la posizione relativa da sinistra a destra dei functoid. I functoid vengono eseguiti da sinistra a destra. L'output di un functoid può essere immesso solo in un altro functoid più a destra.
Selezionare il functoid Scripting appena aggiunto alla pagina della griglia visualizzata.
Nel Finestra Proprietà di Visual Studio fare clic sul pulsante con i puntini di sospensione (...) associato alla proprietà Script.
Nota
In alternativa, è possibile fare clic con il pulsante destro del mouse sul functoid e quindi scegliere Configura script functoid nel menu di scelta rapida. Viene visualizzata la finestra di dialogo Configura functoid Scripting con la scheda Configurazione functoid Script selezionata.
Nell'elenco a discesa Seleziona tipo di script della finestra di dialogo Configura functoid script selezionare il tipo di script.
Nota
I diversi subset dei campi rimanenti della finestra di dialogo vengono attivati e disattivati a seconda del tipo di script selezionato.
Se è stato selezionato Assembly esterno come tipo di script, utilizzare gli elenchi a discesa Assembly script, Classe script e Metodo Script , in tale ordine, per selezionare rispettivamente l'assembly, la classe e il metodo per associare questo functoid scripting .
Avviso
Il codice dell'assembly esterno deve essere indipendente dai thread. In condizioni di utilizzo intensivo è possibile che più istanze di una mappa vengano eseguite contemporaneamente.
Nota
Dopo aver selezionato un assembly, l'elenco a discesa Classe script verrà popolato con le classi in tale assembly. Analogamente, dopo aver selezionato una classe, l'elenco a discesa Metodo script verrà popolato con i metodi in tale classe.
Nota
La casella di testo Script inline è disabilitata quando si seleziona Assembly esterno come tipo di script.
Se è stato selezionato un elemento diverso da Assembly esterno come tipo di script (una delle opzioni inline), usare la casella di testo Script inline per immettere lo script nel linguaggio selezionato.
Nota
Le opzioni del linguaggio inline per il functoid Scripting includono C# .NET, JScript.NET, Visual Basic .NET, XSLT e XSLT Call Template.
Lo script che utilizza C# non consente istruzioni "using". Se lo script deve utilizzare classi .Net speciali, gli assembly corrispondenti e i relativi assembly dipendenti devono essere aggiunti nella sezione "Riferimenti" del progetto BizTalk e il codice di script deve utilizzare nomi completi. Se si scrive uno script per eseguire una conversione in lettere minuscole con distinzione delle impostazioni cultura, il frammento del codice corrispondente deve essere scritto come indicato di seguito. Limitazioni analoghe si applicano a tutti i linguaggi di script supportati.
string x = y.ToLower(System.Globalization.CultureInfo.CurrentCulture);Nello script, per utilizzare classi da qualsiasi assembly, assicurarsi di aggiungere l'assembly corrispondente e i relativi assembly dipendenti nella sezione "Riferimenti" del progetto BizTalk contenente la propria mappa.
Nota
È possibile creare lo script personalizzato direttamente nella casella di testo Script inline oppure creare lo script altrove e incollarlo nella casella di testo Script inline .
Nota
Gli elenchi a discesa Script assembly, Classe Script e Metodo script vengono disabilitati quando si seleziona una delle scelte inline (diverso da Assembly esterno) come tipo di script.
Importante
Se si crea uno script contenente più funzioni, la prima funzione verrà considerata come funzione principale o primaria, mentre le altre funzioni vengono chiamate solo durante l'esecuzione della funzione primaria.
Fare clic su OK.
Se lo script o il metodo associato in un assembly esterno richiede parametri di input, creare il numero e il tipo di collegamenti di input appropriati come per un functoid di base.
Nella maggior parte dei casi, il functoid Scripting produrrà un valore di output usato per popolare un campo nello schema di destinazione o come input in un altro functoid, in modo analogo a quello dei functoid di base.