Come aggiungere functoids di scripting 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.

Per aggiungere il functoid Scripting a una mappa e configurarlo

1. Con la Toolbox di Visual Studio attiva, fare clic sulla scheda Functoid Avanzati per selezionare questa categoria di functoid.

   Viene visualizzato l'elenco dei functoid avanzati nella categoria scelta.

2. Trascinare il functoid Scripting dalla casella degli strumenti alla posizione appropriata su una pagina della griglia.

   Annotazioni

   Il functoid verrà posizionato nella pagina della griglia visualizzata. Se vuoi inserire il functoid in una pagina griglia diversa, devi prima visualizzare l'altra pagina della griglia.

   Annotazioni

   Se si costruisce una mappa utilizzando più functoid, è necessario considerare il loro posizionamento relativo da sinistra a destra. I functoid vengono eseguiti da sinistra a destra. L'output di un functoid può essere immesso solo in un altro functoid situato più a destra.

3. Selezionare sulla pagina della griglia visualizzata il functoid Scripting che hai appena aggiunto.

4. Nella finestra Proprietà di Visual Studio fare clic sul pulsante con i puntini di sospensione (...) associato alla proprietà Script .

   Annotazioni

   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 Script Functoid Configuration selezionata.

5. Nella finestra di dialogo Configura functoid Scripting, nell'elenco a discesa Seleziona tipo di script, selezionare il tipo di script.

   Annotazioni

   A seconda della selezione del tipo di script, verranno abilitati e disabilitati subset diversi dei campi rimanenti della finestra di dialogo.

6. Se hai selezionato Assembly esterno come tipo di script, utilizza gli elenchi a discesa Script assembly, Script class e Script method, in quest'ordine, per selezionare rispettivamente l'assembly, la classe e il metodo da associare a questo functoid di Scripting.

   Avvertimento

   Il codice nell'assembly esterno deve essere sicuro per i thread. In condizioni di stress, più istanze di una mappa possono essere eseguite simultaneamente.

   Annotazioni

   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.

   Annotazioni

   La casella di testo Script inline è disabilitata quando si seleziona Assembly esterno come tipo di script.

   Se è stata selezionata un'opzione diversa da Assembly esterno come tipo di script (una delle scelte inline), usare la casella di testo Script inline per immettere lo script nel linguaggio selezionato.

   Annotazioni

   Le scelte del linguaggio inline per il functoid Scripting includono C# .NET, JScript.NET, Visual Basic .NET, XSLT e XSLT Call Template.

   Lo scripting con C# non consente istruzioni "using". Se lo script deve usare classi .Net speciali, gli assembly corrispondenti e i relativi assembly dipendenti devono essere aggiunti a "Riferimenti" nel progetto BizTalk e il codice script deve usare nomi completi. Se si scrive uno script per eseguire una conversione minuscola sensibile alla cultura, il frammento di codice corrispondente deve essere scritto come indicato di seguito. Le limitazioni simili si applicano a tutti i linguaggi di scripting supportati.

   string x = y.ToLower(System.Globalization.CultureInfo.CurrentCulture);  
   

   Nello script, per usare classi da qualsiasi assembly, assicurarsi di aggiungere l'assembly corrispondente e i relativi assembly dipendenti a "Riferimenti" nel progetto di BizTalk contenente la mappa.

   Annotazioni

   È 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 .

   Annotazioni

   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 la funzione principale o primaria; altre funzioni vengono chiamate solo se vengono chiamate nell'esecuzione della funzione primaria.

   Fare clic su OK.

7. Se lo script o il metodo associato in un assembly esterno richiede parametri di input, creare il numero e il tipo appropriati di collegamenti di input come si farebbe per un functoid di base.

8. 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.

Vedere anche

Aggiunta di functoid avanzati a una mappa