Un campo consta de una expresión FPScript que proporciona un valor o cadena de caracteres que se mostrará y un formateador que define cómo se dará formato a los datos para la salida.
Puede insertar campos en cualquier texto, por ejemplo, etiquetas de ejes, objetos de texto, etiquetas en documentos, etc. Los valores a visualizar pueden ser resultados de cálculos, información de cabecera como el nombre y la unidad física de los registros de datos, pero también la fecha o la hora actuales.
El siguiente campo representa, por ejemplo, el primer valor de la componente X de una señal con tres decimales:
%.3f{Signal.x[0]}
En este ejemplo, Signal.x[0] es la expresión FPScript que devuelve el valor y %.3f{...} es el formateador que determina que el número debe formatearse sin exponente y con tres decimales. Las especificaciones de formato son opcionales aquí; el formateador simple %{...} da salida a cualquier tipo de datos en un formato estándar. Los números de coma flotante se imprimen con un número de dígitos válidos que puede establecerse en la pestaña General del cuadro de diálogo de propiedades de la base de datos del proyecto FlexPro.
Los campos empiezan siempre por el signo %. Si desea insertar un único signo de porcentaje en un texto, deberá escribirlo dos veces para evitar que se interprete como un formateador, por ejemplo
La probabilidad de error es %{Probability}%%.
Acceso a los atributos de los objetos en los campos
Dado que FPScript tiene acceso completo al modelo de objetos de automatización de FlexPro, puede mostrar cualquier atributo de objeto, también conocido como propiedades. Los campos predefinidos para el etiquetado de ejes en diagramas hacen un uso intensivo de esto, por ejemplo, para determinar los nombres, comentarios y unidades de los registros de datos trazados sobre un eje. Los campos FPScript utilizados para ello son a veces bastante alargados, por lo que FlexPro para campos comunes Marcador de posición utilizado. Los marcadores de posición también tienen un formateador, pero éste no va seguido de código FPScript, sino de un nombre. El texto estándar para el etiquetado del eje Y de una curva 2D tiene este aspecto, por ejemplo:
%<NameOrQuantityOrComments> %<[Unit]>
FlexPro sustituye los dos marcadores de posición por los siguientes campos FPScript al crear el texto:
%{.Data.YValueObject(%<ListElement>).NameOrQuantityOrComments(.Data.YComponent)}
%{ThisFPObject.YAxes(.YAxis).Scaling.CurrentUnitInBrackets(%<YAxisElement>)}
FPScript define un objeto estándar que puede ser direccionado con la palabra clave opcional ThisObject. Por lo tanto, la expresión .Data es equivalente a la expresión ThisObject.Data. Cuando se evalúa el etiquetado de los ejes de una curva, ThisObject es una referencia a la curva. Utilice ThisFPObject para acceder al objeto FlexPro, por ejemplo, el diagrama o la tabla que contiene el campo.
Si se asigna a la curva una lista con varios registros de datos, estos se analizan para cada elemento de la lista. %<ListElement> es un marcador de posición que se sustituye por el índice del elemento de lista correspondiente antes de la evaluación.
La siguiente tabla muestra qué objetos hacen referencia a ThisObject y ThisFPObject:
El campo se encuentra en |
ThisObject muestra |
ThisFPObject muestra |
|---|---|---|
Etiquetado de un eje |
Eje |
Diagrama |
Etiqueta de eje, etiqueta de curva o entrada de leyenda de una curva |
Curva |
Diagrama |
Título de la leyenda |
Leyenda |
Diagrama |
Etiquetado con leyenda de colores |
Leyenda de colores |
Diagrama 3D |
Título de una tabla de columnas |
Tabla de columnas |
Tabla de columnas |
Título de una columna en una tabla de columnas |
Columnas de la tabla |
Tabla de columnas |
Título de una tabla de celdas |
Tabla de celdas |
Tabla de celdas |
Celdas en una tabla de celdas |
Celda |
Tabla de celdas |
Objeto de texto |
Objeto de texto |
Objeto de texto |
Etiquetado en un documento/diagrama |
Etiqueta |
Documento/diagrama |
Marcadores de posición para campos FPScript
La siguiente lista contiene los marcadores de posición que puede incrustar en el etiquetado mediante un menú de selección.
La mayoría de los marcadores de posición acceden a los atributos de los objetos. La función de algunos marcadores de posición depende del tipo de etiquetado en el que se utilice el marcador. El marcador de posición %<Comments> hace referencia al comentario del componente de un registro de datos que aparece en la columna del título de una columna de tabla, por ejemplo. Sin embargo, si se utiliza en el título de un diagrama, hace referencia al comentario del diagrama.
Denominación |
Marcador de posición |
Significado |
|---|---|---|
Expresión FPScript |
%{ ... } |
Inserta un campo en el que puede incrustar cualquier código FPScript |
Parámetros |
%{ ... .Parameters("Name")} |
El valor del parámetro Name del objeto que contiene el marcador de posición o el valor del parámetro Name del objeto de datos al que se refiere el marcador de posición. |
Nombre de la base de datos del proyecto |
%<DatabaseName> |
El nombre de la base de datos del proyecto. |
Ruta de la base de datos del proyecto |
%<DatabasePath> |
El nombre de la base de datos del proyecto, incluida su ruta en el disco duro. |
Ruta |
%<Path> |
El nombre del objeto que contiene el marcador de posición, incluida su ruta en la base de datos del proyecto. |
Nombre |
%<Name> |
El nombre del objeto que contiene el marcador de posición o el nombre del objeto de datos al que se refiere el marcador de posición. |
Nombre del elemento |
%<ElementName> |
El nombre del elemento de la lista o componente del objeto de datos al que se refiere el marcador de posición. |
Nombre o comentario |
%<NameOrComments> |
Para el componente Y, el nombre y para los componentes restantes, el comentario del componente del objeto de datos al que hace referencia el marcador de posición. |
Nombre, tamaño o comentario |
%<NameOrQuantityOrComments> |
Para el componente Y, el nombre y para el resto de componentes, si están disponibles, el tamaño físico y, en caso contrario, el comentario del componente del objeto de datos al que se refiere el marcador de posición. |
Comentario |
%<Comments> |
El comentario del objeto que contiene el marcador de posición o el comentario Y del objeto de datos al que se refiere el marcador de posición. |
Comentario o nombre |
%<CommentsOrName> |
Según la disponibilidad, el comentario o el nombre del objeto que contiene el marcador de posición, o el comentario o el nombre del componente del objeto de datos al que se refiere el marcador de posición. |
Tamaño, comentario o nombre |
%<QuantityOrCommentsOrName> |
Según la disponibilidad, el tamaño físico, el comentario o el nombre del componente del objeto de datos al que se refiere el marcador de posición. |
Unidad |
%<Unit> |
La unidad física del componente del objeto de datos al que se refiere el marcador de posición. |
[Unidad] |
%<[Unit]> |
La unidad física entre corchetes del componente del objeto de datos al que se refiere el marcador de posición. Si la unidad está vacía, no se emiten corchetes. |
(unidad) |
%<(Unit)> |
La unidad física entre paréntesis del componente del objeto de datos al que se refiere el marcador de posición. Si la unidad está vacía, no se emiten corchetes. |
Tamaño |
%<Quantity> |
El tamaño físico del componente del objeto de datos al que se refiere el marcador de posición. |
Autor |
%<Author> |
El autor del objeto de datos al que se refiere el marcador de posición. |
Fecha de creación |
%<CreationDate> |
La fecha de creación del objeto que contiene el marcador de posición o la fecha de creación del objeto de datos al que se refiere el marcador de posición. |
Tiempo de creación |
%<CreationTime> |
La hora en la que se creó el objeto que contiene el marcador de posición o la hora a la que se creó el objeto de datos al que se refiere el marcador de posición. |
Fecha de modificación |
%<ModificationDate> |
La fecha de la última modificación del objeto que contiene el marcador de posición o la fecha de la última modificación del objeto de datos al que se refiere el marcador de posición. |
Tiempo de modificación |
%<ModificationTime> |
La hora de la última modificación del objeto que contiene el marcador de posición o la hora de la última modificación del objeto de datos al que se refiere el marcador de posición. |
Origen |
%<Origin> |
El origen del objeto de datos al que se refiere el marcador de posición. |
Valor Z |
%<ZValue> |
Cuando se visualiza una serie de señales, es el valor Z que se asigna a la señal de la serie de señales visualizada como curva. |
Comentario Z |
%<ZComments> |
Cuando se visualiza una serie de señales, es el comentario del componente Z del objeto de datos al que se refiere el marcador de posición. |
Unidad Z |
%<ZUnit> |
Cuando se visualiza una serie de señales, es la unidad física del componente Z del objeto de datos al que se refiere el marcador de posición. |
[Unidad Z] |
%<(ZUnit)> |
Cuando se visualiza una serie de señales, es la unidad física entre corchetes del componente Z del objeto de datos al que se refiere el marcador de posición. Si la unidad está vacía, no se emiten paréntesis. |
(Unidad Z) |
%<(ZUnit)> |
Cuando se visualiza una serie de señales, se trata de la unidad física entre paréntesis del componente Z del objeto de datos al que se refiere el marcador de posición. Si la unidad está vacía, no se emiten paréntesis. |
Fecha |
%<Date> |
Fecha de la última actualización del marcador de posición. |
Hora |
%<Time> |
Hora a la que se actualizó por última vez el marcador de posición. |
Nombre de la carpeta |
%<FolderName> |
El nombre de la carpeta de la base de datos del proyecto en la que se encuentra el objeto que contiene el marcador de posición. |
Comentario de la carpeta |
%<FolderComments> |
El comentario de la carpeta de la base de datos del proyecto en la que se encuentra el objeto que contiene el marcador de posición. |
Nombre de la subcarpeta activada |
%<ActiveFolderName> |
El nombre de la subcarpeta activada de la carpeta de la base de datos del proyecto en la que se encuentra el objeto que contiene el marcador de posición. |
Comentario de subcarpeta activada |
%<ActiveFolderComments> |
El comentario de la subcarpeta activada de la carpeta de la base de datos del proyecto en la que se encuentra el objeto que contiene el marcador de posición. |
Usuarios |
%<User> |
El nombre del usuario actualmente conectado a Windows. |
Ruta del documento |
%<DocumentPath> |
La ruta en la base de datos del proyecto del objeto contenedor en el que se encuentra el objeto que contiene el marcador de posición. Para un diagrama incrustado en un documento u planilla, es la ruta del documento u hoja de cálculo y, en caso contrario, la ruta de la carpeta en la que se encuentra el diagrama. |
Nombre del documento |
%<DocumentName> |
El nombre del objeto contenedor en el que se encuentra el objeto que contiene el marcador de posición. Para un diagrama incrustado en un documento u planilla, es el nombre del documento u planilla y, en caso contrario, el nombre de la carpeta en la que se encuentra el diagrama. |
Marcadores de posición integrados
FlexPro también utiliza algunos marcadores de posición que no tienen código FPScript almacenado:
Marcador de posición |
Denominación |
Utilizado en |
Significado |
|---|---|---|---|
%<DataSet> |
Índice de registro de datos |
Etiquetado de ejes, etiquetado de curvas e introducción de leyendas para curvas 3D |
Representa el número de la serie de datos respectiva en la curva para la que se crea una etiqueta de eje, una etiqueta de curva o una entrada de leyenda y se utiliza en el código FPScript como índice para el listado Curve3DDataSets del objeto Curve3D. |
%<Index> |
Índice de series de datos |
Etiquetado de ejes, etiquetado de curvas e introducción de leyendas para curvas 2D o 3D. Marcador en curva 2D o 3D y coordenadas en el cursor. |
Representa el número de la serie de datos respectiva en el conjunto de datos 3D para el que se crea una etiqueta. Se utiliza en el texto para mostrar el índice de la serie de datos o en el código FPScript como variable de índice. |
%<[Index]> |
Índice de la serie de datos, entre corchetes |
" |
Como %<Index>, pero la salida se encierra entre corchetes. Este marcador de posición no puede utilizarse en el código FPScript. |
%<ListElement> |
Índice del elemento de la lista |
Etiquetado de ejes, etiquetado de curvas e introducción de leyendas para curvas 2D o 3D y título de columnas de una tabla de columnas. |
Representa el número del elemento de lista respectivo en la curva para el que se crea una etiqueta de eje, una etiqueta de curva o una entrada de leyenda. Se utiliza en el código FPScript como argumento para la propiedad ValueObject. |
%<YAxisElement> |
%<YAxisElement> |
Etiquetado de ejes, etiquetado de curvas e introducción de leyendas para curvas 2D |
Representa el número de la escala del eje Y por encima del cual se muestra la curva para la que se crea una etiqueta de eje, una etiqueta de curva o una entrada de leyenda. Se utiliza en el código FPScript como argumento para la propiedad CurrentUnit. |
%<XAxisElement> |
%<XAxisElement> |
" |
Representa el número de la escala del eje X por encima del cual se muestra la curva para la que se crea una etiqueta de eje, una etiqueta de curva o una entrada de leyenda. Se utiliza en el código FPScript como argumento para la propiedad CurrentUnit. |
%<YName> |
Nombre Y Nombre Z |
Etiquetado y marcado de datos en curva 2D o 3D y coordenadas en el cursor |
Los nombres de los componentes individuales del punto de datos a etiquetar. %<ZName> solo puede utilizarse en curvas 3D. Los nombres corresponden al nombre del registro de datos (Y) o a los comentarios correspondientes (Y, Z). |
%<YValue> |
Valor Y Valor Z |
" |
Los valores de los componentes individuales del punto de datos a etiquetar. %<ZValue> solo puede utilizarse en curvas 3D. |
%<Y2Value> |
Valor Y2 Valor Z2 |
Marcador de distancia en curva 2D o 3D |
Los valores de los componentes individuales del 2. Punto de datos del marcador de rango. %<Z2Value> solo puede utilizarse en curvas 3D. |
%<YUnit> |
Unidad Y Unidad Z |
" |
Las unidades físicas de los componentes individuales del punto de datos a etiquetar. %<ZUnit> solo puede utilizarse en curvas 3D. |
%<DeltaY> |
Delta Y |
Marcador de distancia en curva 2D o 3D y coordenadas en el cursor |
Los valores de diferencia de los dos cursores o de las dos posiciones del marcador de rango. %<DeltaZ> solo puede utilizarse en curvas 3D. |
%<DeltaYPerc> |
Delta Y % |
Marcador de distancia en curva 2D o 3D y coordenadas en el cursor |
Los valores de diferencia de los dos cursores o las dos posiciones del marcador de rango en porcentaje, en relación con el primer valor. %<DeltaZPerc> solo puede utilizarse en curvas 3D. |
%<OrderTrackingName> |
Análisis de pedidos |
Marcador con línea de orden o hipérbola de frecuencia y coordenadas en el cursor en espectro de velocidad-frecuencia o espectro de orden. |
Muestra «Orden» (espectro de velocidad-frecuencia) o «Frecuencia» (espectro de orden). |
%<OrderTrackingValue> |
Valor de análisis del pedido |
" |
El orden es la relación entre la velocidad y la frecuencia en el punto marcado. |
%<OrderTrackingUnit> |
Unidad de análisis de pedidos |
" |
La unidad del valor de análisis de la orden. |
%<AreaName> |
Nombre del contenido del área |
Marcador de área con el área bajo la curva como cursor del marcador |
Devuelve «Área». |
%<AreaValue> |
Valor del contenido de la superficie |
" |
Devuelve el área de la superficie bajo el área de la curva marcada. |
%<AreaUnit> |
Unidad de superficie |
" |
La unidad de contenido del área. |
%<SlopeName> |
Nombre de la pendiente |
Marcador de área con tangente como cursor de marcador |
Devuelve «Gradiente». |
%<SlopeValue> |
Valor de la pendiente |
" |
Emite el gradiente en el punto marcado de la curva. |
%<SlopeUnit> |
Unidad de inclinación |
" |
La unidad del gradiente. |
%<Length> |
Longitud |
Marcador de zona con línea de cota |
La longitud de la línea de cota en la unidad de la curva. |
%<DataSetName> |
Nombre del registro de datos |
Etiquetado de datos en curva 2D o 3D |
El nombre del conjunto de datos adicional especificado para el etiquetado de datos. |
%<DataSetValue> |
Valor del conjunto de datos |
" |
El valor del conjunto de datos adicional especificado para el etiquetado de datos asignado al punto de datos que se va a etiquetar. |
%<DataSetUnit> |
Unidad de registro de datos |
" |
Unidad del conjunto de datos adicional especificada para el etiquetado de datos. |
%<XIndex> |
Índice X |
Etiquetado de datos o marca |
El índice de línea del punto de datos que se va a etiquetar/marcar. |
%<ZIndex> |
Índice Z |
Etiquetado o marcador de datos en curva 3D |
El índice de columna del punto de datos que se va a etiquetar/marcar en el conjunto de datos 3D. |
%<PlotOrder> |
Orden de dibujo |
Marca en un diagrama |
Los sellos se numeran ascendente según el orden de dibujo. Los marcadores con un orden de dibujo superior aparecen en primer plano. Cuando los marcadores se leen sin ordenar, se devuelven según su orden de dibujo. |
%<PageNumber> |
Número de página |
Formulario «Etiquetado» en el documento |
El número de la página del documento en la que se encuentra el formulario. |
%<NumberOfPages> |
Número de páginas |
Formulario «Etiquetado» en el documento |
El número de páginas del documento en el que se encuentra el formulario. |
%<H1> ... %<H9> |
Contador de nivel de contorno 1 - 9 |
Formulario «Etiquetado» en el documento |
El valor de recuento actual para el nivel de estructura correspondiente del documento. |
%<N> |
Contador de etiquetado |
Formulario «Etiquetado» en el documento |
El valor de recuento actual para el nivel de contorno asignado al etiquetado. |
Campos para la salida de números complejos
Si el registro de datos cuyo contenido desea visualizar contiene números complejos, puede utilizar las siguientes funciones en el campo:
Función |
Significado |
|---|---|
RealPart(Conjunto de datos) |
Devuelve la parte real del número complejo en el conjunto de datos. |
ImaginaryPart(Conjunto de datos) |
Devuelve la parte imaginaria del número complejo en el conjunto de datos. |
Absolute(Conjunto de datos) |
Devuelve el valor absoluto del número complejo en el conjunto de datos. |
Phase(Conjunto de datos) |
Devuelve la fase del número complejo en el conjunto de datos. |
Indexación de valores individuales para su visualización
Si el conjunto de datos cuyo valor se desea visualizar no contiene un valor escalar, sino una serie de datos o una matriz de datos, puede utilizar un índice para visualizar un valor específico. Si no se utiliza un índice, se toma el primer valor. Si introduce el número -1 como índice, siempre se toma el último valor.
Si el conjunto de datos contiene una señal, una serie de señales o una curva espacial, puede seleccionar el componente deseado añadiendo . X, . Y o . Z al nombre. Si no especifica un componente, se utiliza el componente Y.
Ejemplos
%{Signal.Y[10]} |
Representa el 11. Valor del componente Y de la señal. |
%{Signal.X[-1]} |
Representa el último valor de la componente X de la señal. |
%{Matrizdatos[0][10]} |
Representa el 11. Valor del 1. Columna de la matriz de datos. |
%{Serieseñales.Z[%<Index>]} |
Representa el valor Z de la serie de una serie de señales visualizada como una curva. |
Campos solicitud de entrada
También puede incrustar solicitudes de entrada en textos utilizando los campos correspondientes. Utilice esta opción, por ejemplo, para solicitar información al usuario cuando actualice el documento, que luego deberá mostrarse en el documento.
Hay dos formas de incrustar una solicitud de entrada en un texto. Puede incluir una solicitud de entrada en la expresión FPScript de un campo, por ejemplo %{TextInput(«Por favor, introduzca su nombre»)}, o puede utilizar un formateador especial que solicite una entrada, por ejemplo %«Dispositivo de medición:\DM2000\MX2000». La segunda alternativa tiene varias ventajas, en primer lugar puede especificar valores por defecto para la entrada, en el ejemplo «DM2000» y «MX2000». A continuación, se muestran en un cuadro de lista. En segundo lugar, FlexPro resume varias solicitudes de entrada que están incrustadas en el mismo texto y, en tercer lugar, FlexPro recuerda las entradas que ha realizado para que solo tenga que introducir los cambios cuando vuelva a actualizar el sistema.