Capítulo 2: Tu entorno de trabajo

Parte I - Sección 1: Introducción - Nivel: Principiante

Objetivos de aprendizaje

Al finalizar este capítulo serás capaz de:

Configurar correctamente las carpetas de scripts en EPLAN
Elegir y configurar un editor de texto adecuado
Entender la estructura básica de un script EPLAN
Ejecutar tu primer script “Hello World” en EPLAN
Configurar el entorno para el resto del libro

Requisitos previos

Antes de comenzar este capítulo debes:

Tener instalado EPLAN Electric P8 (versión 2020 o superior)
Haber leído el Capítulo 1 y estar motivado para empezar
Tener permisos de administrador en tu computadora (para crear carpetas)

Proyecto del capítulo

Tu primer script funcional en EPLAN

Al final de este capítulo habrás ejecutado tu primer script que mostrará un mensaje en EPLAN. No entenderás todavía el código (eso viene después), pero verás que SÍ puedes hacer que EPLAN ejecute tus instrucciones.

Tiempo estimado: 30-45 minutos

Contenido

1. Introducción

Antes de escribir código, necesitas preparar tu espacio de trabajo. Piensa en esto como organizar tu taller antes de empezar un proyecto: necesitas saber dónde están tus herramientas, cómo acceder a ellas, y tener todo ordenado.

En este capítulo configuraremos:

Carpetas de scripts: Dónde guardar tus archivos .cs
Editor de texto: Dónde escribir código cómodamente
EPLAN: Cómo ejecutar scripts desde la interfaz

2. Versión de EPLAN

2.1 Verificar tu versión

Antes de continuar, verifica qué versión de EPLAN tienes instalada:

Abre EPLAN Electric P8
Ve a Ayuda > Acerca de EPLAN Electric P8
Busca el número de versión (ejemplo: “2026”, “2024”, etc.)

Importante: Este libro está escrito para EPLAN 2026, pero es compatible con versiones desde 2020 en adelante. La API no ha cambiado significativamente en esas versiones.

2.2 Diferencias entre versiones

Si tienes una versión más antigua (2020-2025):

La mayoría del código funcionará igual
Puede haber pequeñas diferencias en nombres de métodos
Algunas funcionalidades nuevas no estarán disponibles

Si encuentras alguna incompatibilidad, se mencionará en el capítulo correspondiente.

3. Estructura de carpetas para scripts

EPLAN puede ejecutar scripts desde varias ubicaciones. Vamos a crear una estructura organizada que usaremos durante todo el libro.

3.1 Carpeta principal de scripts

Crea la siguiente estructura de carpetas en tu disco:

Opción A (Recomendada): Carpeta local

C:\EPLAN_Scripts\
├── Aprendizaje\        (scripts de este libro)
├── Produccion\         (scripts terminados y probados)
├── Backup\             (respaldos)
└── Recursos\           (archivos auxiliares)

Opción B: En documentos

%USERPROFILE%\Documents\EPLAN_Scripts\
├── Aprendizaje\
├── Produccion\
├── Backup\
└── Recursos\

¿Por qué esta estructura?

Aprendizaje\: Scripts de práctica, experimentación
Produccion\: Scripts validados y listos para usar en proyectos reales
Backup\: Versiones anteriores por si algo sale mal
Recursos\: Plantillas, archivos de configuración, imágenes, etc.

3.2 Configurar EPLAN para encontrar tus scripts

EPLAN necesita saber dónde buscar tus scripts:

Abre EPLAN
Ve a Opciones > Configuración > Usuario > Administración > Scripts
En “Directorios de scripts”, añade tu carpeta:
- Clic en el botón con tres puntos […]
- Navega a C:\EPLAN_Scripts\Aprendizaje
- Aceptar

Ahora EPLAN buscará scripts en esa carpeta.

Nota: Puedes añadir múltiples directorios. Los scripts de todas las carpetas configuradas aparecerán en el menú de EPLAN.

4. Editor de texto

Necesitas un editor de texto para escribir código. NO uses Notepad (bloc de notas de Windows) porque no tiene resaltado de sintaxis ni autocompletado.

4.1 Opciones recomendadas

Opción 1: Visual Studio Code (Recomendado)

Ventajas:

Gratuito y ligero
Resaltado de sintaxis para C#
Extensiones útiles
Terminal integrado
IntelliSense (autocompletado inteligente)

Descargar: https://code.visualstudio.com/

Configuración básica:

Instalar Visual Studio Code
Abrir VS Code
Instalar extensión “C#” de Microsoft:
- Clic en el icono de extensiones (cuadrado con 4 cuadrados pequeños)
- Buscar “C#”
- Instalar “C# for Visual Studio Code”

Opción 2: Notepad++

Ventajas:

Muy ligero
Resaltado de sintaxis básico
Gratuito

Desventajas:

No tiene IntelliSense
Menos funcionalidades que VS Code

Descargar: https://notepad-plus-plus.org/

Opción 3: Visual Studio Community

Ventajas:

IDE completo y profesional
Mejor IntelliSense
Debugging avanzado

Desventajas:

Muy pesado (varios GB)
Overkill para scripts simples
Tiempo de instalación largo

Recomendación: Usa Visual Studio Code para este libro. Es el mejor balance entre funcionalidad y peso.

4.2 Configurar VS Code para EPLAN

Una vez instalado VS Code:

Abre VS Code
Ve a Archivo > Abrir carpeta
Selecciona C:\EPLAN_Scripts\Aprendizaje
Esta será tu carpeta de trabajo

Tip: Crea un acceso directo de VS Code con esta carpeta ya abierta para ahorrar tiempo.

5. Estructura de un script EPLAN

Antes de escribir tu primer script, veamos cómo luce un script EPLAN mínimo:

using System;
using Eplan.EplApi.Base;
using Eplan.EplApi.ApplicationFramework;

public class MiPrimerScript
{
    [Start]
    public void Ejecutar()
    {
        // Tu código aquí
        MessageBox.Show("Hola desde EPLAN!", "Mi Primer Script");
    }
}

No te preocupes por entender cada línea todavía. Pero aquí está la estructura básica:

5.1 Sección de “using”

using System;
using Eplan.EplApi.Base;
using Eplan.EplApi.ApplicationFramework;

¿Qué hace?: Le dice a C# qué librerías (conjuntos de código preescrito) vas a usar.

Analogía: Es como decir “voy a usar herramientas de la caja roja y de la caja azul” antes de empezar un trabajo.

Las librerías más comunes para EPLAN son:

System: Funcionalidades básicas de C#
Eplan.EplApi.Base: Clases fundamentales de EPLAN
Eplan.EplApi.ApplicationFramework: Interfaz con la aplicación EPLAN

5.2 Declaración de clase

public class MiPrimerScript
{
    // Contenido
}

¿Qué es una clase?: Por ahora, piénsalo como un “contenedor” de código. Todo el código de tu script vive dentro de una clase.

Regla importante: El nombre de la clase debe ser descriptivo de lo que hace el script.

5.3 Método con atributo [Start]

[Start]
public void Ejecutar()
{
    // Tu código
}

[Start]: Le dice a EPLAN “empieza ejecutando este método”.

public void Ejecutar(): Define un método (función) llamado “Ejecutar”.

Entre llaves : Va todo el código que quieres que se ejecute.

6. Tu primer script: Hello World

Ahora sí, vamos a crear tu primer script funcional.

Paso 1: Crear el archivo

Abre tu editor de texto (VS Code)
Crea un nuevo archivo:
- En VS Code: Archivo > Nuevo archivo
- O presiona Ctrl + N
Guarda el archivo como: C:\EPLAN_Scripts\Aprendizaje\HelloWorld.cs
- Importante: La extensión debe ser .cs (C Sharp)

Paso 2: Escribir el código

Copia exactamente este código en tu archivo:

using System;
using Eplan.EplApi.Base;
using Eplan.EplApi.ApplicationFramework;

public class HelloWorld
{
    [Start]
    public void Ejecutar()
    {
        MessageBox.Show("¡Hola! Este es mi primer script en EPLAN.",
                       "Mi Primer Script",
                       MessageBoxButtons.OK,
                       MessageBoxIcon.Information);
    }
}

Paso 3: Guardar

Presiona Ctrl + S para guardar
Verifica que el archivo se guardó como HelloWorld.cs en la carpeta correcta

Paso 4: Ejecutar desde EPLAN

Ahora viene la parte emocionante:

Abre EPLAN Electric P8
No necesitas tener un proyecto abierto (este script funciona sin proyecto)
Ve a Utilidades > Scripts > Ejecutar script…
En el diálogo que aparece:
- Busca y selecciona HelloWorld.cs
- Clic en Ejecutar

¿Qué debería pasar?

Deberías ver un cuadro de diálogo con el mensaje:

"¡Hola! Este es mi primer script en EPLAN."

Si lo ves: ¡Felicidades! Acabas de ejecutar tu primer script.

Si no lo ves: Ve a la sección de “Problemas comunes” más abajo.

7. Entendiendo lo que acabas de hacer

Analicemos el script línea por línea:

using System;
using Eplan.EplApi.Base;
using Eplan.EplApi.ApplicationFramework;

Líneas 1-3: Importamos las librerías necesarias.

public class HelloWorld
{

Línea 5: Declaramos una clase llamada HelloWorld.

    [Start]
    public void Ejecutar()
    {

Líneas 7-8:

[Start]: Marca este método como punto de entrada
public void Ejecutar(): Define el método que se ejecutará

        MessageBox.Show("¡Hola! Este es mi primer script en EPLAN.",
                       "Mi Primer Script",
                       MessageBoxButtons.OK,
                       MessageBoxIcon.Information);

Líneas 10-13:

MessageBox.Show(): Muestra un cuadro de diálogo
Primer parámetro: El mensaje a mostrar
Segundo parámetro: El título de la ventana
Tercer parámetro: Qué botones mostrar (OK, Sí/No, etc.)
Cuarto parámetro: Qué icono mostrar (Información, Error, Advertencia)

}
}

Líneas 15-16: Cierran el método y la clase.

8. Mejorando tu primer script

Ahora que funciona, vamos a mejorarlo un poco. Modifica tu script para que se vea así:

using System;
using Eplan.EplApi.Base;
using Eplan.EplApi.ApplicationFramework;

public class HelloWorld
{
    [Start]
    public void Ejecutar()
    {
        // Obtener la fecha y hora actual
        DateTime ahora = DateTime.Now;
        string fechaHora = ahora.ToString("dd/MM/yyyy HH:mm:ss");

        // Obtener el nombre del usuario de Windows
        string usuario = Environment.UserName;

        // Construir el mensaje personalizado
        string mensaje = string.Format(
            "¡Hola {0}!\n\n" +
            "Este es tu primer script en EPLAN.\n" +
            "Fecha y hora: {1}\n\n" +
            "¡Bienvenido al mundo de la automatización!",
            usuario,
            fechaHora);

        // Mostrar el mensaje
        MessageBox.Show(mensaje,
                       "Mi Primer Script Mejorado",
                       MessageBoxButtons.OK,
                       MessageBoxIcon.Information);
    }
}

¿Qué hace este script mejorado?

Obtiene la fecha y hora actual
Obtiene tu nombre de usuario de Windows
Construye un mensaje personalizado con esa información
Lo muestra en un cuadro de diálogo

Ejecútalo nuevamente para ver la diferencia.

Nota: Los comentarios (líneas que empiezan con //) no se ejecutan. Son solo notas para los humanos.

9. Acceso rápido a scripts

Cada vez que quieras ejecutar un script, ir a Utilidades > Scripts > Ejecutar script… es tedioso. Veamos formas más rápidas:

9.1 Crear un menú personalizado

En EPLAN, ve a Opciones > Configuración > Usuario > Menús > Menú contextual
Crea una nueva entrada:
- Nombre: “Mis Scripts”
- Tipo: Carpeta
Dentro de “Mis Scripts”, añade entradas para tus scripts más usados

9.2 Atajo de teclado

También puedes asignar atajos de teclado a scripts específicos (lo veremos en capítulos posteriores cuando tengas scripts que uses frecuentemente).

10. Problemas comunes

Problema 1: “El archivo no aparece en el diálogo”

Causa: EPLAN no está buscando en la carpeta correcta.

Solución:

Ve a Opciones > Configuración > Usuario > Administración > Scripts
Verifica que tu carpeta esté en “Directorios de scripts”
Si no está, añádela

Problema 2: “Error de compilación” o “Error de sintaxis”

Causa: Probablemente copiaste mal el código o falta un punto y coma.

Solución:

Verifica que copiaste exactamente el código del libro
Presta atención a mayúsculas y minúsculas (C# es case-sensitive)
Verifica que no falten punto y coma ; al final de las líneas

Problema 3: “No pasa nada al ejecutar”

Causa: Puede que no tengas permisos o EPLAN esté bloqueando la ejecución.

Solución:

Ejecuta EPLAN como administrador
Verifica que el archivo se guardó correctamente
Intenta reiniciar EPLAN

Problema 4: El archivo se abre con un programa incorrecto

Causa: Windows asoció .cs con otro programa.

Solución:

Abre VS Code primero
Luego abre el archivo desde dentro de VS Code
O haz clic derecho en el archivo > “Abrir con” > VS Code

Deep Dive: Namespaces de EPLAN disponibles

Para scripts simples, estos son los namespaces que usarás:

System: Funcionalidades básicas de C#

using System;                     // Básico
using System.IO;                  // Archivos y carpetas
using System.Text;                // Manipulación de texto
using System.Collections.Generic; // Listas y colecciones

EPLAN API: Funcionalidades de EPLAN

using Eplan.EplApi.Base;                    // Clases base
using Eplan.EplApi.ApplicationFramework;    // Aplicación
using Eplan.EplApi.Scripting;              // Scripts
using Eplan.EplApi.DataModel;              // Datos del proyecto
using Eplan.EplApi.HEServices;             // Servicios

Extras incluidos gratis:

using System.Windows.Forms;   // GUI (formularios, botones)
using System.Net.Http;        // Peticiones HTTP/REST
using Newtonsoft.Json;        // Manejo de JSON
using System.Xml.Linq;        // Manejo de XML

No necesitas memorizar esto ahora. Lo irás usando naturalmente en los próximos capítulos.

Mejores prácticas desde el inicio

Aunque apenas estás empezando, adopta estas buenas costumbres desde ahora:

1. Nombres descriptivos

// Mal
public class Script1 { }

// Bien
public class ExportarPDFMultiidioma { }

2. Comentarios útiles

// Mal (obvio)
// Mostrar mensaje
MessageBox.Show("Hola");

// Bien (explica el por qué)
// Informar al usuario que la exportación comenzó
MessageBox.Show("Exportación iniciada. Por favor espere...");

3. Organización de archivos

Un script por archivo
Nombre del archivo = Nombre de la clase
Usa carpetas para categorizar

4. Backup regular

Copia tus scripts a la carpeta Backup\ antes de hacer cambios grandes
O mejor aún: usa Git (lo veremos en capítulos avanzados)

Resumen

En este capítulo configuraste:

Carpeta de scripts organizada: C:\EPLAN_Scripts\Aprendizaje\
EPLAN configurado para encontrar tus scripts
Editor de texto (VS Code recomendado)
Ejecutaste tu primer script funcional
Entendiste la estructura básica de un script EPLAN

Conexiones

Capítulo anterior: Capítulo 1: ¿Por qué aprender a programar como ingeniero eléctrico?

Próximo capítulo: Capítulo 3: Variables y tipos de datos

En el próximo capítulo empezarás a aprender C# de verdad. Variables, números, texto, y cómo almacenar información. Por fin entenderás qué significan todas las líneas del script que acabas de ejecutar.

Checklist de completitud

Antes de pasar al siguiente capítulo, asegúrate de:

Tener EPLAN instalado y funcionando
Carpeta de scripts creada y configurada en EPLAN
VS Code (o tu editor preferido) instalado
Haber ejecutado exitosamente HelloWorld.cs
Ver el mensaje personalizado con tu nombre y fecha
Entender dónde guardar futuros scripts

Última actualización: Enero 2025 Tiempo de lectura: 25-30 minutos Tiempo de práctica: 15-20 minutos

📂 Código del Capítulo

Todos los scripts de este capítulo están disponibles en GitHub:

📥 Ver código en GitHub →

Los scripts son 100% funcionales y usan únicamente APIs gratuitas de EPLAN.

🔓 Desbloquea el Contenido Completo

¿Te gustó este capítulo? Hay 25 capítulos más esperándote con:

✅ Scripts profesionales completos
✅ Casos de estudio reales
✅ Suite de automatización integrada
✅ Ahorra 80-95% de tiempo en tareas repetitivas

💎 Ver Libro Completo ($79)