Guía Completa de Automatización EPLAN 2026

¿Qué es esta guía?

Esta es la guía completa de automatización de EPLAN Electric P8 usando scripts en C#. Contiene 36 capítulos que cubren desde los fundamentos de programación hasta técnicas avanzadas de integración con sistemas externos.

Todo el contenido es 100% gratuito y los scripts usan únicamente APIs gratuitas de EPLAN, sin necesidad de licencias premium de DataModel o HEServices.

Qué encontrarás

• 36 Capítulos Completos - Desde fundamentos de C# hasta Remoting y SignalR. Todo el contenido de la guía, sin restricciones.
• Scripts Funcionales - Código C# listo para usar en EPLAN. Cada capítulo tiene scripts asociados que puedes ejecutar directamente.
• 100% APIs Gratuitas - Todos los scripts usan solo namespaces gratuitos. Sin licencias de DataModel ni HEServices.
• Código en GitHub - Todos los scripts están disponibles en nuestro repositorio.

Estructura de la Guía

Parte I: Fundamentos de C# (Capítulos 1-11)

Aprende los fundamentos de programación en C# necesarios para automatizar EPLAN. Desde qué es programar hasta programación orientada a objetos y manejo de errores.

Parte II: EPLAN API (Capítulos 12-19)

Introducción a la API de EPLAN: atributos [Start] y [DeclareAction], event handlers, y ejecución de comandos con CommandLineInterpreter.

Parte III: Pathmap y Mensajes (Capítulos 20-21)

Variables del sistema de EPLAN con Pathmap y manejo de mensajes del sistema con BaseException.

Parte IV: Flujo de Control (Capítulos 22-23)

Métodos con valor de retorno y sobrecarga de métodos para crear scripts más flexibles.

Parte V: Interacción con el Usuario (Capítulos 24-25)

Preguntar al usuario durante la ejecución con Decider y selección de elementos con ListSelect.

Parte VI: Barras de Progreso (Capítulo 26)

Implementar barras de progreso en EPLAN con SimpleProgress para operaciones largas.

Parte VII: Windows Forms (Capítulos 27-29)

Crear interfaces gráficas con Windows Forms: templates, formularios completos y manejo del cursor.

Parte VIII: Archivos y Carpetas (Capítulo 30)

Verificar y crear carpetas y archivos desde scripts de EPLAN.

Parte IX: Master Data (Capítulo 31)

Contar artículos y trabajar con datos maestros en proyectos de EPLAN.

Parte X: Casos Reales (Capítulos 32-36)

Proyectos del mundo real: SelectionSet, HTTP REST, logging remoto, SignalR y EPLAN Remoting.

Ensamblados Permitidos sin Licencia API

Ensamblados System (100% Gratuitos)

• System - Namespace base
• System.Drawing - Gráficos y UI
• System.Windows.Forms - Interfaces de usuario
• System.Net.Http - Comunicación HTTP
• System.IO.Compression.FileSystem - Compresión de archivos
• System.Xml.LINQ y System.Xml - Procesamiento XML
• System.Core (LINQ)
• Newtonsoft.Json - Procesamiento JSON

Ensamblados EPLAN (Referenciados por Defecto)

• Eplan.EplApi.Base - Funcionalidades base
• Eplan.EplApi.ApplicationFramework - CommandLineInterpreter (clave para scripts gratuitos)
• Eplan.EplApi.Scripting - Atributos [Start] y [DeclareAction]
• Eplan.EplApi.Gui - Componentes de interfaz
• Eplan.EplApi.MasterData - Datos maestros

Importante: APIs NO Gratuitas

Los siguientes namespaces requieren licencia premium y NO se usan en esta guía:

• Eplan.EplApi.DataModel - Acceso directo a objetos del proyecto
• Eplan.EplApi.HEServices - Servicios de búsqueda y filtrado avanzados

Alternativa Gratuita: Patrón Export-Parse-Process

En lugar de usar APIs premium, usamos este patrón:

1. Exportar datos con CommandLineInterpreter (CLI)
2. Parsear con System.Xml.Linq o Newtonsoft.Json
3. Procesar los datos con lógica C#
4. Importar resultados si es necesario (también con CLI)

Requisitos Previos

Para aprovechar al máximo esta guía:

• EPLAN Electric P8 2025 instalado (o versión 2020+)
• Conocimientos básicos de programación (variables, funciones, estructuras de control)
• Familiaridad con el entorno de trabajo de EPLAN

No se requieren licencias premium de EPLAN API ni Add-ins de pago.

Cómo Usar Esta Guía

1. Sigue el orden de los capítulos para un aprendizaje progresivo
2. Practica con los ejemplos de código disponibles en GitHub
3. Experimenta con tus propios proyectos de EPLAN
4. Consulta los scripts en cada capítulo para ver el código completo

¡Comencemos tu viaje de automatización EPLAN!