Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 assembly .NET in fase di esecuzione usando il functoid Scripting e scrivendo funzioni personalizzate.
Il functoid Scripting supporta le lingue seguenti:
C# .NET
JScript .NET
Visual Basic .NET
Trasformazioni del Linguaggio di Stile Estensibile (XSLT)
Modelli di chiamata XSLT
Un'altra differenza significativa tra il functoid scripting corrente e le versioni precedenti è che lo script non deve più essere creato e archiviato nel functoid stesso. È invece possibile creare lo script in un assembly .NET separato e fare riferimento all'assembly tramite la proprietà Script . La presenza dello script in un assembly separato consente di usare lo stesso script in più di una mappa. È inoltre possibile acquistare assembly functoid di scripting da fornitori di terze parti.
È possibile usare functoid scripting creati nelle versioni precedenti di BizTalk Mapper con la versione corrente di BizTalk Mapper. Tuttavia, è necessario eseguire prima la migrazione dei functoid. Per ulteriori informazioni su come migrare i functoid Scripting, consultare Migrating Functoids.
Quando si aggiunge un functoid scripting a una mappa, è necessario configurare lo script usato dal functoid. Se si seleziona un functoid Scripting , la proprietà Script viene abilitata nella finestra Proprietà . Se si fa clic sul pulsante con i puntini di sospensione (...) per questa proprietà, verrà visualizzata la finestra di dialogo Configura functoid Scripting . In alternativa, è possibile fare doppio clic sul functoid Scripting.
Nella tabella seguente vengono illustrati i campi di questa finestra di dialogo.
| Campo della finestra di dialogo Scripting Functoid Configura | Descrizione |
|---|---|
| Selezionare il tipo di script | Usare questo campo per selezionare il tipo di script da usare in questo functoid Scripting . Valori: - Assemblaggio esterno. Usare questo valore se si desidera associare il functoid Scripting a un assembly nella Global Assembly Cache (GAC). Avvertimento: Il codice nell'assembly esterno deve essere thread-safe. In condizioni di stress, più istanze di una mappa possono essere eseguite simultaneamente. - Inline C#. Usa questo valore se vuoi associare il functoid Scripting al codice C# nel buffer script inline. - Inline JScript .NET. Usare questo valore se si desidera associare il functoid Scripting allo script JScript .NET nel buffer script inline. - Inline Visual Basic .NET. Usare questo valore se si desidera associare il functoid Scripting al codice .NET di Visual Basic nel buffer di script Inline . - XSLT inline. Usare questo valore se si desidera associare il functoid Scripting a XSLT nel buffer Script inline. - Modello di chiamata XSLT inline. Usare questo valore se si desidera associare il functoid Scripting ai modelli di chiamata XSLT nel buffer di script inline . |
| Assembly di script | Selezionare l'assembly da associare al functoid di Scripting. In questo elenco vengono visualizzati solo gli assembly a cui si fa riferimento nella finestra Progetto. Si noti inoltre che è necessario registrare gli assembly nella GAC. Questo campo è disponibile solo quando Select script type è impostato su Assembly esterno. |
| Classe Script | Selezionare la classe all'interno dell'assembly scelto che si vuole usare per questo functoid Scripting. Questo campo è disponibile solo quando Seleziona tipo di script è impostato su Assembly esterno. |
| Metodo script | Selezionate il metodo all'interno della classe scelta che questo functoid Scripting deve utilizzare. Nota: Assicurarsi che il numero di parametri di input previsti dal metodo corrisponda al numero di parametri di input specificati nella finestra di dialogo Configura functoid scripting . |
| Script in linea | Scrivere o copiare lo script inline da usare in questa casella di testo. I linguaggi e gli script validi includono: C#, JScript .NET, Visual Basic .NET, XSLT e modelli di chiamata XSLT. Questo campo è disponibile solo quando Select script type è impostato su una delle impostazioni Inline . Cautela: Evitare di usare più volte la stessa firma del metodo. Quando diversi functoid di scripting hanno la stessa firma del metodo, BizTalk seleziona la prima implementazione e ignora le altre. |
La figura seguente mostra come viene visualizzato il functoid Scripting in una mappa usando lo script C# .NET per riformattare un numero di telefono.
Mappa di Functoid di Scripting