Saltar navegación

Documentación de FlexPro 2025

Tutorial Funciones FPScript personalizadas

FlexPro le ofrece la posibilidad de programar sus propias funciones en FPScript, guardarlas en una base de datos de plantillas y utilizarlas después en fórmulas FPScript. Una función FPScript es una fórmula escrita en FPScript que utiliza al menos un argumento. Los argumentos se declaran con la instrucción Arguments.

En el siguiente ejemplo, aprenderá a programar una función para normalizar un conjunto de datos, registrarla como función FPScript y, a continuación, utilizarla.

Nota  El ejemplo se limita a la implementación de una función definida por el usuario en el lenguaje FPScript. Si desea acceder a bibliotecas externas (DLLs) para implementar la función o desea hacer que los algoritmos existentes estén disponibles para FlexPro, debe implementar la función FPScript definida por el usuario en VBA u otro lenguaje de programación compatible con Automation. Siehe hierzu Una función FPScript personalizada.

Registro de una función FPScript definida por el usuario

1.Crea una fórmula con el siguiente código FPScript:
 
Arguments Data, NormalizeTo
If NormalizeTo == Empty Then
  NormalizeTo = 1.
End
NormalizeTo * Data / Maximum(Data)
 
La instrucción Argumentsconvierte la fórmula en una función y se le debe proporcionar una lista de argumentos cuando se llama.

2.Seleccione la fórmula en la lista de objetos y haga clic en Inicio[Objetos seleccionados] > Guardar como plantilla.

3.En la primera página del asistente de plantillas, seleccione Función FPScript como tipo de plantilla, ingrese Normalize como nombre y Normalizado como comentario.

Nota  El tipo de plantilla de función FPScript solo puede seleccionarse si se ha seleccionado exactamente una fórmula. Además, la fórmula debe contener la palabra clave Arguments en la primera línea y no debe contener errores de sintaxis.

4.Haga clic en Siguiente. Introduzca el texto El conjunto de datos a normalizar como descripción del argumento Datos. Seleccione los tipos de datos permitidos: número entero de 16 bits a número de coma flotante de 64 bits. Seleccione Serie de datos y Señal como estructuras de datos permitidas.

5.Haga clic en Siguiente. Introduzca el valor de texto al que se normaliza el conjunto de datos como descripción del argumento NormalizeTo. Seleccione entre números enteros de 16 bits y números de coma flotante de 64 bits como tipos de datos permitidos. Seleccione Valor escalar como las Estructuras de datos permitidas. Active la opción Valor por defecto e introduzca 1.

6.Haga clic en Siguiente. En la última página del asistente, revise la configuración y guarde la plantilla en la base de datos de Plantillas personales. Salga del asistente.

7.La función Normalize se guarda ahora en la base de datos de plantillas. Ahora puede eliminarlos de la base de datos de su proyecto. Para ello, seleccione la función en la lista de objetos y pulse la tecla DEL.

Una función FPScript personalizada verwenden

1.Seleccione Insertar[Datos] > Señal > Seno para crear una señal senoidal sintética.

2.A continuación, cree una fórmula vacía utilizando Insertar[Datos] > Fórmula y haga clic en Borrador de fórmula[Insertar elemento de código] > Función. Seleccione la categoría Personalizar y, a continuación, la función Normalize.

3.Introduzca el conjunto de datos de la señal que se va a normalizar como argumento Datos y el valor 10 como argumento NormalizeTo.
El código debería tener ahora este aspecto: Normalize(Signal, 10)

4.Ahora haga clic en el nombre de la fórmula en la lista de objetos. La curva senoidal se muestra ahora con los valores extremos +-10 en la vista previa.

Hacer que una función FPScript definida por el usuario esté disponible en la red de la empresa

Nota  Esta opción solo está disponible en las ediciones Professional y Developer Suite de FlexPro.

1.Crea una nueva base de datos de proyectos y guárdala con el nombre de biblioteca FPScript en una carpeta compartida de la red.

2.Haga clic en Archivo > Información > Organizar y active la pestaña Plantillas en el cuadro de diálogo Organizar.

3.Haga clic en Bases de datos de plantillas compartidas para abrir el cuadro de diálogo del mismo nombre.

4.Haga clic en Insertar y, a continuación, en el botón situado en el borde derecho del campo recién creado en la lista.

5.Seleccione la base de datos guardada anteriormente y, a continuación, cierre ambos cuadros de diálogo con Aceptar.

6.En el cuadro de diálogo Organizar, seleccione el tipo de plantilla función FPScript.

7.En la parte izquierda, en Elementos disponibles en la base de datos de proyectos guardada previamente en la red, seleccione Biblioteca FPScript. Si no aparece en la lista, haga clic en Cerrar base de datos de proyectos y, a continuación, en Abrir base de datos de proyectos y seleccione el archivo.

8.En el lado derecho, en Elementos disponibles en, seleccione la base de datos Plantillas personales.

9.Seleccione la función Normalize en el cuadro de lista de la derecha y haga clic en Copiar para copiarla en la base de datos de plantillas compartidas.

10.Ahora haga clic en Borrar para eliminar la función de la base de datos de plantillas personales.

Notas
Para que sus colegas puedan utilizar las funciones FPScript almacenadas en la base de datos de plantillas de la biblioteca FPScript, deben introducirlas en la lista Bases de datos de plantillas compartidas, tal como se describe en las secciones 2 a 5.
 
Las funciones con el mismo nombre en diferentes bases de datos de plantillas se cargan desde la base de datos de plantillas con mayor prioridad. Se aplica el siguiente orden:
1) Base de datos de plantillas personales
2) Bases de datos de plantillas compartidas en el orden en que aparecen en la lista de Bases de datos de plantillas compartidas.