Compartir a través de


Cómo agregar functoids de secuencia de comandos a una asignación

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 , vea Scripting Functoid.

Para agregar el functoid de secuencia de comandos a una asignación 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 de la categoría seleccionada.

  2. Arrastre el functoid Scripting Image que representa el functoid Scripting. desde el Cuadro 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 mostrada. Si desea colocar el functoid en otra página de cuadrícula, 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 la entrada a otro functoid que esté situado más a la derecha.

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

  4. En el 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 Configurar functoid scripting con la pestaña Configuración del functoid script 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

    Según el tipo de secuencia de comandos que elija, se habilitarán y deshabilitará distintos subconjuntos de los demás campos del cuadro de diálogo.

  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 asociarlo a este functoid scripting .

    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.

    Nota

    Después de seleccionar un ensamblado, la lista desplegable Clase 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 de 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 plantilla de llamada XSLT.

    Los scripts que usan C# no permiten declaraciones "using". Si el script debe usar alguna clase .Net especial. A continuación, los ensamblados correspondientes y sus ensamblados dependientes debe agregarse a "Referencias" en el proyecto de BizTalk y el código del script debe usar nombres completos. Si escribe un script para realizar la conversión de minúsculas sensible a cultura, el fragmento de código correspondiente debe escribirse tal como se indica a continuación. Se aplican limitaciones similares a todos los lenguajes de script 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 la asignación.

    Nota

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

    Nota

    Las listas desplegables Ensamblado de script, Clase script y Método script están deshabilitadas al seleccionar una de las opciones insertadas (algo distinto del ensamblado externo) como tipo de script.

    Importante

    Si crea una secuencia de comandos que contenga varias funciones, la primera función se considerará como la principal o primaria; las demás solo se llamarán si son necesarias para la ejecución de la función principal.

    Haga clic en OK.

  7. Si la secuencia de comandos o el método asociado en un ensamblado externo requieren parámetros de entrada, cree el número y el tipo de vínculos de entrada apropiados de igual modo que para un functoid básico.

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

Consulte también

Agregar functoids avanzados a una asignación