Cómo agregar functoids de scripting a un mapa

El functoid Scripting permite usar código o script personalizado en tiempo de ejecución para realizar funciones que, de lo contrario, no están disponibles. Por ejemplo, puede llamar a un objeto COM en tiempo de ejecución mediante el functoid Scripting y escribir su propio script personalizado.

Para obtener información conceptual sobre el functoid Scripting , consulte Scripting Functoid.

Para agregar el functoid scripting a un mapa y configurarlo

1. Con el cuadro de herramientas de Visual Studio activo, haga clic en la pestaña Functoids avanzados para seleccionar esa categoría de functoids.

   Aparece la lista de functoids avanzados en la categoría elegida.

2. Arrastre el functoid Scripting desde la Caja de herramientas hasta la ubicación adecuada en una página de cuadrícula.

   Nota:

   El functoid se colocará en la página de cuadrícula que se muestra. Si desea colocar el functoid en una página de cuadrícula diferente, primero debe mostrar esa otra página de cuadrícula.

   Nota:

   Si va a construir un mapa con más de un functoid juntos, debe tener en cuenta su ubicación relativa de izquierda a derecha. Los functoids se ejecutan de izquierda a derecha. La salida de un functoid solo puede ser entrada a otro functoid que esté más a la derecha.

3. Seleccione el functoid Scripting que acaba de agregar a la página de cuadrícula mostrada.

4. En la ventana Propiedades de Visual Studio, haga clic en el botón de puntos suspensivos (...) asociado a la propiedad Script .

   Nota:

   Como alternativa, puede hacer clic con el botón derecho en el functoid y, a continuación, hacer clic en Configurar script functoid en el menú contextual. Aparece el cuadro de diálogo Configuración de scripting de functoid con la pestaña Configuración de scripting de functoid seleccionada.

5. En el cuadro de diálogo Configurar functoid scripting , en la lista desplegable Seleccionar tipo de script , seleccione el tipo de script.

   Nota:

   Dependiendo de la selección del tipo de script, se habilitarán y deshabilitarán distintos subconjuntos de los campos del cuadro de diálogo restantes.

6. Si seleccionó Ensamblado Externo como tipo de script, use las listas desplegables Ensamblado de script, Clase de script y Método de script, en ese orden, para seleccionar el ensamblado, la clase y el método, respectivamente, para asociarlos a este functoid de Scripting.

   Advertencia

   El código del ensamblado externo debe ser seguro para subprocesos. En condiciones de estrés, es posible que varias instancias de un mapa se ejecuten simultáneamente.

   Nota:

   Después de seleccionar un ensamblado, la lista desplegable Clase de script se rellenará con las clases de ese ensamblado. Del mismo modo, después de seleccionar una clase, la lista desplegable Método de script se rellenará con los métodos de esa clase.

   Nota:

   El cuadro de texto Script insertado está deshabilitado al seleccionar Ensamblado externo como tipo de script.

   Si seleccionó algo distinto del ensamblado externo como tipo de script (una de las opciones insertadas), use el cuadro de texto Script en línea para escribir el script en el idioma seleccionado.

   Nota:

   Las opciones de lenguaje insertado para el functoid Scripting incluyen C# .NET, JScript.NET, Visual Basic .NET, XSLT y XSLT Call Template.

   El scripting mediante C# no permite instrucciones "using". Si el script necesita usar alguna clase especial de .NET, los ensamblajes correspondientes y sus ensamblajes dependientes deben añadirse a "Referencias" en el proyecto de BizTalk, y el código de script debe usar nombres completamente calificados. Si escribe un script para realizar la conversión a minúsculas sensible a la cultura, el fragmento de código correspondiente debe escribirse como se muestra a continuación. Se aplican limitaciones similares a todos los lenguajes de scripting admitidos.

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

   En el script, para usar clases de cualquier ensamblado, asegúrese de agregar el ensamblado correspondiente y sus ensamblados dependientes a "Referencias" en el proyecto de BizTalk que contiene el mapa.

   Nota:

   Puede crear el script personalizado directamente en el cuadro de texto Script insertado , o bien puede crear el script en otro lugar y pegarlo en el cuadro de texto Script insertado .

   Nota:

   Las listas desplegables Script Assembly, Clase Script y Método Script están deshabilitadas al seleccionar una de las opciones en línea (algo distinto de External Assembly) como tipo de script.

   Importante

   Si crea un script que contiene varias funciones, la primera función se tratará como la función principal; solo se llaman a otras funciones si son invocadas en la ejecución de la función principal.

   Haz clic en Aceptar.

7. Si el script o el método asociado de un ensamblado externo requieren parámetros de entrada, cree el número adecuado y el tipo de vínculos de entrada como lo haría para un functoid básico.

8. En la mayoría de las circunstancias, el functoid scripting generará un valor de salida que se usa para rellenar un campo en el esquema de destino, o como entrada en otro functoid, de la misma manera que lo hacen los functoids básicos.

Véase también

Adicionar functoids avanzados a un mapa