C135 PCS 7 (PCS7)
6C
6 Cielo Ciencia y Tecnología
·Publicada en C135 PCS 7 (PCS7)

Resolución de la función APL_OpenFaceplate faltante y faceplates inactivas en SIMATIC PCS 7

En SIMATIC PCS 7, cuando al hacer clic en los iconos de bloque durante el tiempo de ejecución (runtime) o la simulación no se abren las faceplates y aparece un error que indica que APL_OpenFaceplate no existe, el problema se debe a que no se ha ejecutado el Editor de proyectos OS o faltan los archivos de cabecera de Global Script de APL. Para solucionarlo es necesario ejecutar el Editor de proyectos OS en el WinCC Explorer para copiar los scripts en C estándar de APL en la carpeta Library del proyecto, generar las cabeceras de los scripts en C mediante Options -> Generate Header en Global Script, y asegurarse de que el paquete PCS 7 WinCC Faceplates esté instalado.

Índice de contenidos

Rol de APL_OpenFaceplate en la arquitectura gráfica de PCS 7

En la Advanced Process Library (APL) de SIMATIC PCS 7, al hacer clic en cualquier icono de bloque de proceso (como MotL, VlvL o PIDConL) se inicia una llamada de script en C orientada a eventos que carga dinámicamente la ventana de imagen de la faceplate correspondiente (@PG_*.pdl):
* Propósito de la función: APL_OpenFaceplate.fct es la función en C central responsable de analizar el prefijo de variable (tag prefix) del objeto pulsado, calcular las coordenadas de pantalla, verificar la autorización del operador y ordenar al administrador de ventanas de imágenes de WinCC que muestre la faceplate.
* Ubicación de almacenamiento: El archivo fuente reside en la subcarpeta del proyecto WinCC Library\aplib\Faceplate\APL_OpenFaceplate.fct o dentro de la ruta de búsqueda de scripts globales Siemens\WinCC\aplib.
* Escenarios comunes de fallo:
1. Omisión del Editor de proyectos OS: Al crear un nuevo proyecto OS o recuperar un archivo incompleto, los directorios del proyecto GraCS y Library se pueblan únicamente con archivos básicos de STEP 7, omitiendo los scripts de APL.
2. Cabeceras en C sin compilar (ap_def.h): Si no se generaron las cabeceras de Global Script, el compilador de C interno no puede resolver los prototipos de las funciones, lo que provoca que la ejecución en tiempo de ejecución se interrumpa silenciosamente o registre Function APL_OpenFaceplate not found.
3. Instalación incompleta: Instalar únicamente los componentes de ingeniería de AS de PCS 7 en una Estación de ingeniería sin seleccionar el componente de configuración WinCC APL Faceplates deja los archivos .fct físicos ausentes en el disco duro.

Procedimiento paso a paso de restauración y compilación

Siga este procedimiento para restaurar APL_OpenFaceplate y volver a habilitar la invocación de faceplates en WinCC.

Requisitos previos

  • Credenciales de administrador en la Estación de ingeniería / Servidor OS.
  • Paquete de software PCS 7 APL instalado en el equipo.
  • Proyecto WinCC abierto en WinCC Explorer con el Runtime desactivado.

Paso 1: Verificar la instalación de APL Faceplates en el PC

  1. Abra el Explorador de archivos de Windows y vaya a:
    C:\Program Files (x86)\Siemens\WinCC\Options\PDL\Faceplates_APL (o ...\Siemens\WinCC\aplib\Faceplate)
  2. Verifique que APL_OpenFaceplate.fct y los archivos @PG_*.pdl correspondientes existan en este repositorio maestro.
  3. Si este directorio falta o está vacío, inserte el medio de instalación de PCS 7, ejecute Setup.exe, seleccione Package installation y marque PCS 7 Faceplates / APL Faceplates.

Paso 2: Ejecutar el Editor de proyectos OS en WinCC Explorer

  1. En WinCC Explorer, haga doble clic en OS Project Editor.
  2. En la pestaña Layout, seleccione la resolución de pantalla de destino (por ejemplo, 1920 * 1080).
  3. Seleccione el botón de opción Complete configuration (o asegúrese de que Update diagnostic screens and system pictures esté marcado).
  4. Haga clic en OK.
  5. El Editor de proyectos OS copia todas las imágenes de sistema estándar, mapas de bits y funciones de script en C (incluyendo APL_OpenFaceplate.fct) desde el directorio maestro de instalación de Siemens a las carpetas GraCS y Library del proyecto activo.

Paso 3: Regenerar las cabeceras de Global Script

  1. En WinCC Explorer, expanda Global Script.
  2. Haga clic derecho en C-Editor y seleccione Open.
  3. En el menú del editor de C, seleccione Options -> Generate Header.
  4. El compilador recompile todas las funciones estándar y regenera el archivo de cabecera interno ap_def.h.
  5. Verifique en la ventana de salida que la generación de cabeceras finalice con 0 errores.

Paso 4: Recompilar y probar CFC / OS

  1. En SIMATIC Manager, realice una compilación de OS (OS Compile):
    * Haga clic derecho en el objeto OS y seleccione Compile.
    * Elija Entire OS - with memory reset si se trata de una configuración nueva.
  2. Active el WinCC Runtime para verificar el funcionamiento de las faceplates.

Verificación

  • En WinCC Explorer, abra Global Script -> C-Editor y expanda Standard Functions -> Faceplate. Confirme que APL_OpenFaceplate aparece en el árbol de funciones.
  • Inicie WinCC Runtime o inicie el proyecto en modo de simulación.
  • Haga clic en un icono de bloque de motor o válvula de APL. La ventana emergente de la faceplate correspondiente debe aparecer inmediatamente sobre el gráfico de proceso.
  • Abra el visor de diagnóstico de WinCC (apdiag.exe -> Output Window) y confirme que no se produzcan errores de compilación de scripts ni de ejecución en tiempo de ejecución durante la apertura de la faceplate.

Limitaciones y precauciones operativas

  • Evitar renombrar funciones estándar de APL: Nunca edite o renombre APL_OpenFaceplate.fct directamente; las personalizaciones deben implementarse mediante tipos de faceplates personalizados o scripts de usuario que llamen a la API estándar.
  • Distribución Servidor-Cliente: En sistemas cliente-servidor, es necesario ejecutar el Editor de proyectos OS en el Servidor OS, seguido de la generación de datos de servidor (Server Data) y la descarga de los proyectos de los clientes para garantizar versiones de scripts uniformes.
  • Coincidencia de versiones de la biblioteca APL: Asegúrese de que la versión de APL instalada en la Estación de ingeniería coincida con las versiones de los bloques APL colocados en el diagrama CFC; mezclar faceplates V8.x con bloques AS V9.1 puede provocar discrepancias en la comunicación de variables.

Preguntas frecuentes del ingeniero

  • ¿Puedo copiar manualmente APL_OpenFaceplate.fct en el proyecto?
    Sí, copiar APL_OpenFaceplate.fct desde el directorio de instalación de WinCC a la carpeta Library\aplib\Faceplate del proyecto funciona, pero se prefiere ejecutar el Editor de proyectos OS porque sincroniza todas las imágenes y scripts adjuntos.
  • ¿Por qué ocurrió este error en la simulación con PLCSIM?
    La simulación prueba exactamente los mismos scripts gráficos de WinCC que el runtime físico. Si los archivos del proyecto OS estaban incompletos en la Estación de ingeniería, la simulación falla de forma idéntica.
  • ¿Qué es apdiag.exe y cómo ayuda?
    apdiag.exe es la utilidad de diagnóstico de scripts en C nativa de WinCC ubicada en C:\Program Files (x86)\Siemens\WinCC\bin. Abrir su ventana de salida (Output Window) captura fallos de scripts en tiempo real y errores de funciones faltantes.
  • ¿La generación de cabeceras borra mis funciones de proyecto personalizadas?
    No. Options -> Generate Header solo escanea las declaraciones de funciones para actualizar los índices del compilador; no altera ni borra el código en C existente.
  • ¿Por qué al hacer clic en el icono de bloque se produce un cursor de reloj de arena pero no aparece la faceplate?
    Un cursor de reloj de arena indica un tiempo de espera agotado (timeout) en el script. Esto ocurre típicamente cuando el prefijo de variable configurado en el icono de bloque no existe en la administración de variables (Tag Management) de WinCC.

Referencias técnicas

  • Siemens Industry Online Support Entry ID 109801081: SIMATIC PCS 7 Advanced Process Library (APL) Faceplate Architecture.
  • Siemens WinCC V7.5 Manual: ANSI-C for Creating Functions and Actions (Global Script).
  • Siemens System Manual: OS Project Editor Configuration and System Graphics.

Artículos relacionados

Etiquetas relacionadas

  • PCS 7
  • APL
  • Faceplate
  • WinCC
  • Global Script
  • OS Project Editor
  • C-Script
  • Industrial Automation
20 respuestas