Configuración de Custom Functions
Para agregar una Custom Function se debe arrastrar la función seleccionada sobre un mapeo ya existente. Existen funciones que admiten más de un origen. En ese caso se debe arrastrar la función en el mapeo y luego arrastrar los otros orígenes hacia la función.
1 – Arrastrar una Custom Function hacia un mapeo
Mientras se realiza el drag & drop, el mapeo que recibe la función se pinta de rojo.
2 – Custom Function agregada.
En el caso de arriba se aplicó una función que obtiene el valor del mapeo de origen y extrae el día de la fecha.
Es responsabilidad del diseñador de la reacción garantizar que en dicho origen venga una fecha válida, ya que caso contrario ocurrirá un error en la actividad.
Esta función en particular, Day, no requiere configuración , ya que simplemente toma el valor de origen y le extrae la fecha. Pero existen otras funciones que requieren una configuración adicional. Estas funciones quedarán con el borde en rojo una vez que se arrastren sobre un mapeo, como muestra la figura siguiente:
3 – Custom Function configurable.
En este caso, la función "FormatDateTime" permite aplicar un formato a una fecha, recibe como parámetro adicional el formato en sí. Para configurarla, se debe hacer doble clic sobre la misma:
4 – Configuración genérica de Custom Functions.
Se abrirá esta pantalla en donde, por cada parámetro que permita configurar la custom function se mostrará un Combo que me seleccionar alguno de los orígenes que tiene la función o ponerle un valor en duro.
En el caso de FormatDateTime, la fecha la vamos a sacar del node "Value" parámetro mapeado, y el formato lo vamos a poner en duro.
Esta pantalla es genérica, y se utiliza en todas las Custom Function configurables, excepto en la de "Code function". Esta función en particular permite tomar los valores mapeados hacia ella y enviárselo como parámetro a una función escrita en VB.NET.
4 – Configuración de la Code Function
Al hacerle doble clic sobre para configurar esta Custom Function se nos abrirá una pantalla en donde nos pide el nombre de la función que vamos a crear. A continuación se abre una ventana en donde podemos escribir código VB.NET.
5 – Configuración de la Code Function
Como se ven en este caso se abre una pantalla en donde se puede escribir el cuerpo de la función en VB.NET, yse reciben como parámetros los orígenes mapeados a la Custom Function antes de configurarla.
Podemos escribir código VB.NET, haciendo uso de casi todas las funcionalidades del Framework.
Se debe tener en cuenta que esta función nunca puede devolver "Nulo", siempre debe retornar un valor, sino ocurrirá un error en la ejecución de la actividad.