Configurar Esquemas de Analitos Calculados

Esta actividad describe cómo crear o modificar esquemas de analitos calculados en AssayNet LIMS. Estos esquemas se utilizan para realizar cálculos automáticos sobre los resultados analíticos, desde fórmulas simples (por ejemplo, multiplicar un resultado bruto por un factor) hasta operaciones más complejas con múltiples esquemas.

Crear esquemas de analitos calculados requiere una buena comprensión de cómo AssayNet LIMS maneja las fórmulas. Si bien los cálculos simples son directos, las configuraciones más avanzadas implican referenciar otros esquemas, aplicar condiciones y estructurar expresiones de una manera diferente a herramientas como Excel.

Es importante notar que Excel y AssayNet LIMS utilizan estructuras lógicas diferentes para realizar cálculos. En Excel, las fórmulas se escriben en formato basado en celdas (por ejemplo, =A1+B1), mientras que en AssayNet LIMS las fórmulas siguen una estructura similar a SQL, referenciando los códigos de esquema en lugar de celdas y operando sobre conjuntos de datos.

Nota: La interfaz del generador de fórmulas incluye dos ventanas distintas—Fórmula inglesa y Fórmula bruta.

La ventana Fórmula inglesa está diseñada para ayudar al usuario a comprender la estructura de la fórmula en un lenguaje sencillo. Muestra la fórmula utilizando el Código de Esquema ingresado para el esquema de analito involucrado. Si bien esta vista es útil para la claridad y validación, es principalmente informativa y no controla directamente cómo se aplica la fórmula en el sistema.

La lógica real de la fórmula se ejecuta a través de la ventana Fórmula bruta. Esta ventana utiliza el código ID de cada esquema de analito—identificadores únicos asignados en la base de datos SQL. La Fórmula bruta define cómo el sistema realiza el cálculo durante el procesamiento de los datos.

Aunque puedes construir o modificar una fórmula en cualquiera de las dos ventanas, esta actividad se enfoca principalmente en cómo construir una fórmula en la ventana Fórmula inglesa, con una breve descripción general de la ventana de la Fórmula bruta. Para expresiones más complejas o basadas en SQL, contacta al soporte de AssayNet para obtener asistencia adicional.

Puedes construir tu fórmula utilizando no solo esquemas de analito, sino también parámetros del sistema predefinidos que están programados en AssayNet LIMS. Estos parámetros extraen valores de otras paginas del sistema, como el peso inicial de la muestra, el peso de preparación registrado en el Pre-Análisis de Laboratorio u otros campos asociados con la muestra.

Esta actividad describe las herramientas y opciones básicas para construir o modificar esquemas de analitos calculados. Para obtener ayuda con casos de uso avanzados y fórmulas más complejas, contacta al soporte de AssayNet.

Pasos de la Actividad

En la pestaña de cinta Perfil, bajo el grupo Análisis, haz clic en Esquemas de Analito.
Se muestra la pantalla Esquemas de Analito.
Selecciona el Código de Esquema calculado que deseas modificar. Puedes filtrar los esquemas de analito seleccionando Tipos de Analito, Analitos y/o Métodos. Para crear un nuevo Código de Esquema, consulte Crear Esquemas de Analito.
Haz clic en Editar.
Se muestra la pantalla Editar Esquema de Analito.
Haz clic en el icono Enter Formula (Ingresar Fórmula) en el grupo de campos Tipo de Esquema de Analito.
Se muestra la pantalla Fórmula de Esquema y se posiciona por defecto en el analito para el Esquema de Analito seleccionado, en la ventana de construcción Fórmula inglesa.
Para comenzar a construir una fórmula simple en la ventana Fórmula inglesa:
1. Ubica el esquema de analito que vas a utilizar en la fórmula en la pestaña Entrada de Esquema. Puedes usar los filtros Analito y Método para acotar la búsqueda.
2. Selecciona el Esquema de Analito y haz clic en el icono Add Analyte (Agregar Analito) para enviarlo a la ventana del generador de fórmulas.
3. Haz clic en el operador requerido en el teclado de la ventana del generador de fórmulas; por ejemplo, X para multiplicar.
4. Utiliza uno de los siguientes métodos para ingresar la siguiente variable en tu fórmula:
  1. Selecciona el Esquema de Analito requerido y haz clic en el icono Add Analyte (Agregar Analito) para enviarlo a la ventana del generador de fórmulas.
  2. Utiliza el teclado para ingresar un valor numérico.
5. Puedes usar los botones C y CE para borrar toda la fórmula o eliminar el último parámetro ingresado, respectivamente.
  Nota: Alternativamente, para mayor flexibilidad en la edición de la fórmula, cambia a Modo de Edición, como se describe en los siguientes pasos.
6. Para editar la fórmula usando el Modo de Edición:
  1. Haz clic en el icono de lápiz y papel (ubicado a la derecha de la ventana) para modificar manualmente la fórmula.
    El fondo de la ventana del generador de fórmulas cambia a amarillo.
  2. Ingresa parámetros como valores numéricos o símbolos de operadores usando el teclado de la computadora.
    Nota: Para utilizar un Esquema de Analito en tu fórmula, debes seleccionarlo y luego hacer clic en el iconoAdd Analyte (Agregar Analito). Esto asegura que se inserte el código ID correcto, lo cual es esencial ya que la lógica real de la fórmula se ejecuta usando el código ID subyacente en SQL. Si lo deseas, puedes modificar el nombre en inglés del parámetro en la ventana Fórmula inglesa para facilitar la identificación. Cambiar el nombre de visualización no afecta la ejecución de la fórmula.
  3. Haz clic nuevamente en el icono de lápiz y papel para guardar los cambios.
    El fondo de la ventana del generador de fórmulas vuelve a blanco.
7. Para usar otros parámetros preconfigurados en la fórmula:
  1. Haz clic en la pestaña Entrada de Pre-Análisis.
    Se muestra la lista de parámetros predefinidos del sistema.
  2. Selecciona los parámetros predefinidos según sea necesario.
    Nota: Las siguientes opciones de parámetros son las más utilizadas como variables en las fórmulas.
    - Peso Seco—Este parámetro recupera el peso registrado (si lo hay) en la pantalla Datos de la página Pre-Análisis de Laboratorio desde la cual se crea la lectura de instrumento. Para más información, consulta Ingresar Mediciones en el Pre-Análisis. Ten en cuenta que solo se recupera el peso asociado al mismo código de análisis para su uso en la ecuación final. El sistema no aplica un valor de Peso Seco de diferentes códigos de análisis.
      Nota: No necesitas incluir parámetros como el esquema de analito para el resultado bruto × peso seco / volumen al construir la fórmula para calcular la concentración final, ya que estos son cálculos predefinidos disponibles en las opciones del esquema. Para más información, consulta Configurar Esquemas de Analitos.
    - Peso de Muestra—Este parámetro recupera el peso inicial (si lo hay) capturado en la pantalla Datos de la página Lotes de Muestras.
    - Fecha—Utiliza los parámetros de fecha al crear un esquema de analito de tipo fecha. Estos son parámetros independientes que insertas en el generador de fórmulas para mostrar la fecha requerida como resultado final.
8. Configura la opción Agregado si es necesario.
  Nota: Por defecto, cuando una muestra tiene réplicas, AssayNet LIMS promedia los valores para calcular y reportar un solo resultado final para la muestra o el material de control de calidad. Esta condición se puede predefinir en las Opciones de Cálculo dentro del Código de Análisis. Para más información, consulta. Configurar Opciones de Cálculo para Códigos de Análisis. Sin embargo, en el esquema de analito puedes seleccionar un tipo de acumulador diferente para definir cómo AssayNet LIMS debe manejar los valores de réplica.
  1. En el campo Acumulador, selecciona entre:
    - None (Ninguno)—(Predeterminado) utiliza la configuración de acumulador predefinida.
    - Sum (Suma)—Suma todas las réplicas para el tipo de muestra seleccionado.
    - Average(Promedio)—Promedia las réplicas para el tipo de muestra seleccionado.
    - Maximum (Máximo)—Selecciona el resultado máximo entre las réplicas.
    - Minimum (Mínimo)—Selecciona el resultado mínimo entre las réplicas.
  2. Si se selecciona el campo Acumulador, el campo Se Aplica a se habilita. Selecciona entre:
    - All (Todos)—El comportamiento del acumulador afecta a todas las muestras.
    - Samples (Muestras)—El comportamiento del acumulador afecta solo a las muestras del cliente.
    - Reference Material (Material de Referencia)—El comportamiento del acumulador afecta solo a las muestras de material de referencia.
    - Method Blank (Blanco de Método)—El comportamiento del acumulador afecta solo a las muestras blanco de método.
    Nota: Puedes dejar el campo Agrupar por en None (Ninguno).
  3. Sigue los pasos 2-4 para seleccionar el esquema de analito al que se aplican las opciones de acumulador y envíalo al generador de fórmulas.
9. En el campo Nivel Calculado, selecciona entre—
  - Intra Lectura–Nivel de Resultados—Los cálculos se realizan solo con los resultados dentro de la misma lectura de instrumento. Todos los esquemas de analito en la fórmula deben provenir de cualquier lectura de instrumento asignada al lote de muestras a nivel de resultado. Esta es la opción predeterminada y la más recomendada para la mayoría de los cálculos de esquemas de analito, especialmente los simples.
  - Intra Pre-Análisis–Nivel de Análisis—Permite que las fórmulas referencien datos del pre-análisis de laboratorio del cual se creó la lectura. Es útil para valores como peso seco o peso de muestra.
  - Inter Lectura–Nivel de Análisis—Los cálculos se realizan solo con los resultados de la misma lectura de instrumento a nivel de análisis. Todos los esquemas de analito en la fórmula deben provenir de esta lectura.
  - Inter Lectura–Nivel de Muestra—Los cálculos se realizan con los resultados de diferentes lecturas de instrumento a nivel de muestra. Todos los esquemas de analito en la fórmula deben provenir de esta lectura.
    Nota:Puedes probar cada opción y realizar pruebas para determinar cuál produce los resultados que necesitas. Para modificar y probar el esquema de analito directamente en la pantalla Datos de la página Lectura de Instrumento, consulta Probar Esquema Calculado.
10. En el grupo de campos Cálculo de Texto, selecciona entre—
  - Evaluar como Numérico—Trata los valores como números durante el cálculo. Usa esta opción cuando el campo de texto contiene datos numéricos que deben procesarse. Es la opción predeterminada y la más adecuada para la mayoría de los cálculos de esquemas de analito, especialmente los simples.
  - Evaluar como Texto—Realiza el cálculo basándose en el contenido del texto. Utiliza esta opción cuando el esquema de analito involucra otros esquemas que son de tipo texto y se usan en expresiones lógicas, como comparaciones condicionales de texto.
  - Usar Resultado de Texto—Devuelve un resultado de texto fijo o predefinido directamente desde la fórmula. No evalúa los valores de entrada, solo muestra el texto como resultado final.
  1. Selecciona el Producto de Preparación al que aplica la fórmula, si es necesario.
    Nota: Las muestras pueden tener más de un producto de preparación. Por defecto, el cálculo se aplica a todos ellos. Puedes especificar cuál debe usar el cálculo.
Para usar la ventana de fórmula bruta:
1. Haz clic en el icono Fórmula bruta.
  La ventana muestra el código SQL de la fórmula (si existe).
2. Para modificar la fórmula, usa los pasos 2-5 y/o entra al Modo de Edición como se describe en el paso 6.
3. Para obtener el código SQL de los esquemas de analito requeridos, en la pantalla anterior Esquemas de Analito, busca el esquema que deseas usar en tu fórmula.
  1. Haz clic en OK para salir de la pantalla Fórmula de Esquema de Analito.
  2. Haz clic en OK para salir de la pantalla Editar Esquema de Analito.
  3. Selecciona el Esquema de Analito. Puedes filtrar los esquemas seleccionando Tipos de Analito, Analitos y/o Métodos.
  4. En la pestaña de cinta Herramientas, haz clic en ID Actual.
    Se muestra un mensaje de AssayNet LIMS mostrando el Record ID (ID de Registro) para el registro seleccionado.
    Nota: Si el campo ID de Registro aparece en blanco, usualmente significa que el esquema de analito no se ha seleccionado correctamente. Para volver a seleccionarlo, haz clic a la izquierda de la fila bajo la columna Método.
Para probar la fórmula, consulta Probar Esquema Calculado.