Migrar functoids

Al migrar un mapa de versiones anteriores de BizTalk Server a BizTalk Server, también se migran los functoids incluidos en el mapa. Si los functoids que migra no incluyen functoids de scripting , no se requieren tareas de migración adicionales. Sin embargo, si el mapa incluye functoids de scripting o functoids personalizados, es posible que tenga pasos adicionales para realizar.

En versiones anteriores de BizTalk Server, todos los scripts personalizados incluidos con un functoid scripting se escribieron insertados. Es decir, que cuando creó el functoid, todas las secuencias de comandos a las que llamó durante el tiempo de ejecución se almacenaron con el functoid. Si quiere usar el mismo script con un functoid diferente, copió y pegó de un functoid scripting a otro, o reescribirá el script desde cero.

BizTalk Server copia los scripts insertados existentes con los functoids al migrar un mapa. Sin embargo, no todos los scripts pueden funcionar correctamente. BizTalk Server usa Visual Basic .NET y JScript .NET en lugar de VBScript y JScript usados en versiones anteriores. Las versiones .NET de los lenguajes incluyen algunos cambios en la sintaxis.

Nota

Asegúrese de probar los functoids scripting después de la migración.

Tendrá que volver a escribir functoids personalizados. BizTalk Server espera que los functoids personalizados usen .NET Framework. No puede utilizar los antiguos functoids personalizados basados en COM. Los functoids personalizados se pueden escribir para que utilicen .NET Framework. Para ver el código de ejemplo de un functoid personalizado, consulte Functoid personalizado (BizTalk Server ejemplo) .

Una alternativa es ajustar la funcionalidad del functoid personalizado en un ensamblado externo y llamar a este ensamblado a través de un functoid scripting . En la sección siguiente se describe este proceso.

Para migrar los functoids personalizados

1. Vuelva a crear la funcionalidad de un functoid en un lenguaje .NET, por ejemplo, Microsoft Visual Basic .NET, JScript .NET o Microsoft Visual C# .NET.

2. Cree un ensamblado que contenga la nueva funcionalidad.

3. Registre el ensamblado en la caché de ensamblados global (GAC).

   Nota

   Para registrar los ensamblados en la caché de ensamblados global, deben tener nombres seguros y estar firmados. Para obtener más información sobre el registro de ensamblados, vea "Caché global de ensamblados" en la colección combinada de Visual Studio.

4. Cree una referencia entre el mapa que contiene el functoid Scripting y el ensamblado que contiene la funcionalidad reescrita.

5. Configure la propiedad Script para el functoid Scripting . Esta propiedad determina qué script llama el functoid scripting durante el tiempo de ejecución. Debe hacer coincidir el valor de esta propiedad con el lenguaje al que convirtió la secuencia de comandos personalizada. Para obtener más información sobre cómo configurar la propiedad Script, vea Editar propiedades functoid y parámetros de entrada. Consulte también Scripting Functoid.

6. Compile el proyecto de BizTalk que contiene el mapa con el functoid Scripting .

7. Valide y pruebe la asignación.

Consulte también

Editar propiedades de functoid y parámetros de entrada
Functoid de scripting