Secuencias de comandos (functoid)

  • Artículo

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 ensamblado de .NET en tiempo de ejecución mediante el functoid Scripting y escribir sus propias funciones personalizadas.

El functoid Scripting admite los siguientes lenguajes:

  • C# .NET

  • JScript .NET

  • Visual Basic .NET

  • Transformación de lenguaje de hojas de estilo extensible (XSLT)

  • Plantillas de llamada de XSLT

    Otra diferencia significativa entre el functoid de scripting actual y las versiones anteriores es que el script ya no se necesita crear y almacenar en el functoid en sí. En su lugar, puede crear el script en un ensamblado de .NET independiente y hacer referencia al ensamblado a través de la propiedad Script . Al tener la secuencia de comandos en un ensamblado distinto se puede utilizar la misma secuencia de comandos en más de una asignación. Además, es posible que pueda comprar ensamblados functoid de scripting de proveedores de terceros.

    Puede usar functoids de scripting creados en versiones anteriores del asignador de BizTalk con la versión actual del asignador de BizTalk. Sin embargo, es necesario que migre primero los functoids. Para obtener más información sobre cómo migrar functoids de scripting , consulte Migración de functoids.

    Al agregar un functoid scripting a un mapa, debe configurar el script que usa el functoid. Si selecciona un functoid scripting , la propiedad Script está habilitada en la ventana Propiedades . Si hace clic en el botón de puntos suspensivos (...) de esta propiedad, se abre el cuadro de diálogo Configurar functoid de scripting . Como alternativa, puede hacer doble clic en el functoid Scripting .

    La siguiente tabla muestra los campos de este cuadro de diálogo.

Campo de cuadro de diálogo Configurar functoid de script Descripción
Seleccionar tipo de script Use este campo para seleccionar el tipo de script que desea usar en este functoid scripting .

Valores:

- Ensamblado externo. Use este valor si desea asociar el functoid scripting a un ensamblado en la caché global de ensamblados (GAC). Advertencia: El código del ensamblado externo debe ser seguro para subprocesos. En condiciones de sobrecarga, pueden ejecutarse simultáneamente varias instancias de una asignación.
- C# insertado. Use este valor si desea asociar el functoid scripting con código de C# en el búfer de script en línea .
- JScript insertado .NET. Use este valor si desea asociar el functoid Scripting con el script .NET de JScript en el búfer de script en línea .
- Visual Basic .NET insertado. Use este valor si desea asociar el functoid Scripting con el código .NET de Visual Basic en el búfer de script en línea .
- XSLT insertado. Use este valor si desea asociar el functoid scripting con XSLT en el búfer de script en línea .
- Plantilla de llamada XSLT insertada. Use este valor si desea asociar el functoid Scripting con plantillas de llamada XSLT en el búfer de script en línea .
Ensamblado de script Seleccione el ensamblado que se va a asociar al functoid Scripting . Sólo los ensamblados a los que se hace referencia en la ventana Proyecto aparecen en esta lista. Asimismo, tenga en cuenta que debe registrar los ensamblados en la GAC.

Este campo solo está disponible cuando Seleccionar tipo de script está establecido en Ensamblado externo.
Clase de script Seleccione la clase dentro del ensamblado elegido que desea que use este functoid scripting .

Este campo solo está disponible cuando Seleccionar tipo de script está establecido en Ensamblado externo.
Método de script Seleccione el método dentro de la clase elegida que desea que use este functoid scripting . Nota: Asegúrese de que el número de parámetros de entrada esperados por el método coincide con el número de parámetros de entrada especificados en el cuadro de diálogo Configurar functoid de scripting .
Script insertado Escriba o copie la secuencia de comandos en línea que se va a utilizar en este cuadro de texto. Entre los lenguajes y scripts válidos se incluyen: C#, JScript .NET, Visual Basic .NET, XSLT y plantillas de llamada XSLT.

Este campo solo está disponible cuando Select script type (Seleccionar tipo de script ) está establecido en uno de los valores insertados . Precaución: Evite usar la misma firma de método más de una vez. Cuando varios functoids de secuencia de comandos tienen la misma firma de método, BizTalk selecciona la primera implementación y descarta las otras.

En la ilustración siguiente se muestra cómo aparece el functoid Scripting en un mapa mediante el script .Net de C# para volver a formatear un número de teléfono.

Asigne mediante C# para dar formato a un número de teléfono.
Asignación de functoid de secuencia de comandos

En esta sección