Functoid Esecuzione script
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
Extensible Stylesheet Language Transformations (XSLT)
Modelli 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 creazione dello script in un assembly separato consente di utilizzare lo stesso script in più mappe. 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. È necessario tuttavia eseguire prima la migrazione dei functoid. Per altre informazioni su come eseguire la migrazione dei functoid di scripting , vedere Migrazione di functoid.
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 Configura functoid Esecuzione script | Descrizione |
|---|---|
| Seleziona tipo di script | Usare questo campo per selezionare il tipo di script da usare in questo functoid scripting . Valori: - Assembly esterno. Usare questo valore se si desidera associare il functoid Scripting a un assembly nella Global Assembly Cache (GAC). Avviso: Il codice nell'assembly esterno deve essere thread-safe. In condizioni di utilizzo intensivo è possibile che più istanze di una mappa vengano eseguite contemporaneamente. - Inline C#. Usare questo valore se si vuole associare il functoid Scripting al codice C# nel buffer di script inline . - Inline JScript .NET. Usare questo valore se si vuole associare il functoid Scripting allo script .NET JScript nel buffer di 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 di script inline . - Modello di chiamata XSLT inline. Usare questo valore se si vuole associare il functoid Scripting ai modelli di chiamata XSLT nel buffer di script inline . |
| Assembly script | Selezionare l'assembly da associare al functoid Scripting . In questo elenco vengono visualizzati solo gli assembly a cui si fa riferimento nella finestra Progetto. È necessario inoltre 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 questo functoid Scripting . Questo campo è disponibile solo quando Select script type è impostato su Assembly esterno. |
| Metodo script | Selezionare il metodo all'interno della classe scelta che si vuole usare questo functoid Scripting . 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 inline | Scrivere o copiare lo script inline script da utilizzare 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 . Attenzione: Evitare di usare più volte la stessa firma del metodo. Quando diversi functoid Esecuzione script hanno la stessa firma di metodo, in BizTalk viene selezionata la prima implementazione e le altre vengono ignorate. |
Nella figura seguente viene illustrato come viene visualizzato il functoid Scripting in una mappa usando lo script C# .NET per riformattare un numero di telefono.
Mappa con functoid Esecuzione script