DESARROLLO DE UNA INTERFAZ ENTRE COORDCOMP Y NEPLAN

PARA LA COORDINACION DE COMPENSADORES DE REACTIVOS

CESAR AUGUSTO BECERRA COCUAME

ING. ELECTRICISTA

UNIVERSIDAD DEL VALLE

FACULTAD DE INGENIERA
ESCUELA DE INGENIERA ELCTRICA Y ELECTRNICA
PROGRAMA DE POSGRADO EN INGENIERA ELCTRICA Y ELECTRNICA
SANTIAGO DE CALI
2009

DESARROLLO DE UNA INTERFAZ ENTRE COORDCOMP Y NEPLAN

PARA LA COORDINACION DE COMPENSADORES DE REACTIVOS

CESAR AUGUSTO BECERRA COCUAME

Proyecto de investigacin presentado como requisito parcial para optar

al ttulo de Magister en Ingeniera con nfasis en Ingeniera Elctrica

DIRECTORES:
Ing. Diego Fernando Garca Gmez, M.Sc.
Ing. Ferley Castro Aranda, Ph.D.

UNIVERSIDAD DEL VALLE

FACULTAD DE INGENIERA
ESCUELA DE INGENIERA ELCTRICA Y ELECTRNICA
PROGRAMA DE POSGRADO EN INGENIERA ELCTRICA Y ELECTRNICA
SANTIAGO DE CALI
2009

Ing. Cesar A. Becerra C.

ANEXO C. TUTORIAL DE CONFIGURACIN PARA EL DESARROLLO DE

APLICACIONES BASADAS EN C++ MFC, NPL, XML Y HTMLHELP.

En este tutorial se describen las diferentes opciones de configuracin y ajustes a

realizar en la plataforma Visual Studio .NET 2005, para un adecuado desarrollo de
aplicaciones C++ / MFC que integren las siguientes tecnologas:
1. NPL - Neplan Programming Library. Biblioteca utilizada para la interaccin y
automatizacin de tareas en NEPLAN.
2. XMLLite Library. Biblioteca para la lectura y escritura de archivos XML.
3. HTMLHelp Library. Biblioteca para la vinculacin de un archivo de ayuda en
formato CHM.

Programas relacionados con este tutorial

1. Microsoft Visual Studio .NET 2005 SP1. IDE para el desarrollo de aplicaciones
C++ MFC.
2. NEPLAN 5.3.5 u otra versin que soporte el mdulo NPL y que a su vez se
encuentre habilitado.
3. Html Help Workshop. Software proporcionado por Microsoft para crear archivos
de ayuda en formato CHM. Puede ser empleado otro similar.

Instaladores que contienen las bibliotecas a vincular en el IDE Visual Studio

.NET 2005
1. NPL_Distribution_V535.zip. Disponible en www.neplan.ch; para la descarga
se requiere que la licencia de NEPLAN incluya el mdulo NPL habilitado.
2. Microsoft Windows Software Development Kit Update for Windows Vista.
Disponible en www.microsoft.com; para la descarga se requiere validacin de
autenticidad del sistema operativo.

160

ANEXO C

Ubicacin de los archivos .h que se requieren vincular en el IDE Visual

Studio .NET 2005
Las rutas que se especifican son sugeridas.
1. Archivos: NeplanProgrammingLibrary.H y NepModuleDef.h
Ruta: C:\NeplanProgrammingLibrary\
2. Archivo: xmllite.h
Ruta: C:\Program Files\Microsoft SDKs\Windows\v6.0\Include\
3. Archivo: htmlhelp.h
Ruta: C:\Program Files\Microsoft SDKs\Windows\v6.0\Include\

Ubicacin de los archivos .lib que se requieren vincular en el IDE Visual

Studio .NET 2005
Las rutas que se especifican son sugeridas.
1. Archivo: NeplanProgrammingLibrary.lib
Ruta: C:\NeplanProgrammingLibrary\
2. Archivo: xmllite.lib
Ruta: C:\Program Files\Microsoft SDKs\Windows\v6.0\Lib\
3. Archivo: htmlhelp.lib
Ruta: C:\Program Files\Microsoft SDKs\Windows\v6.0\Lib\

Opciones de configuracin del IDE Visual Studio .NET 2005 para especificar
la ubicacin los archivos .h y .lib
Cada biblioteca que se desee vincular en algn proyecto C++ MFC debe ser
localizada en este IDE. En la ventana de opciones se deben especificar las rutas
de los directorios en los que se encuentran los archivos .h y .lib, ver la Figura 87 y
la Figura 88 respectivamente.
Esta labor se realiza una sola vez, con ella se le est indicando al IDE que las
bibliotecas podrn ser vinculadas en proyectos C++ MFC, de manera que cada
proyecto que lo requiera debe especificarlo como se describe ms adelante, antes
se mostrarn los pasos para crear un nuevo proyecto tipo C++ MFC para el
desarrollo de aplicaciones tipo DLL.

161

Ing. Cesar A. Becerra C.

Figura 87. Anexo C. Ajustes para la ubicacin de archivos .h en Visual Studio .NET 2005

Figura 88. Anexo C. Ajustes para la ubicacin de archivos .lib en Visual Studio .NET 2005

162

ANEXO C

Creacin de un nuevo proyecto C++ MFC tipo DLL y definicin de

propiedades
Al crear un nuevo proyecto se debe especificar que ser del tipo MFC y aplicar la
plantilla MFC DLL. Se debe especificar adems un nombre del proyecto y
ubicacin. Se recomienda dejar habilitada la opcin Create directory for solution.
Estas opciones se ilustran en la Figura 89, en este ejemplo la aplicacin se
llamar NPL_ICCNep y se debe crear en la ruta D:\VC++NETprojects\.
Figura 89. Anexo C. Opciones para la creacin de un nuevo proyecto C++ MFC tipo DLL

Despus de presionar OK, aparecer una nueva ventana de ajustes de la

aplicacin, en ella simplemente se debe especificar que el tipo de DLL ser
Regular DLL using shared MFC DLL.
Despus de crear el nuevo proyecto es momento de especificar sus principales
propiedades para un correcto funcionamiento [1].
Para las propiedades generales del nuevo proyecto especificar (ver Figura 90):

163

Ing. Cesar A. Becerra C.

Configuration: Release

Platform: Win32

Use of MFC: Use Standard Windows Libraries

Character Set: Use Unicode Character Set

Figura 90. Anexo C. Propiedades generales de configuracin del nuevo proyecto

En las propiedades del preprocesador de C/C++ se adicionara la definicin

NPL_ICCNEP como macro (ver Figura 91):

Prerprocessor definitions: ;NPL_ICCNEP

En las propiedades del idioma definir (ver Figura 92):

Treat wchar_t as Built-in type: No (/Zc:wchar_t-)

164

ANEXO C

Figura 91. Anexo C. Propiedades del preprocesador de C/C++ para el nuevo proyecto

Figura 92. Anexo C. Propiedades del idioma en C/C++ para el nuevo proyecto

En las propiedades Input del Linker definir (ver Figura 93):

Ignore Specific Library: MSVCRTD;msvcrt

Finalmente, en las propiedades Command Line del Linker definir (ver Figura 94)
las bibliotecas a utilizar, en este caso las mencionadas en este tutorial:
NeplanProgrammingLibrary.lib, xmllite.lib y HtmlHelp.lib.

165

Ing. Cesar A. Becerra C.

Figura 93. Anexo C. Propiedades Input del Linker de C/C++ para el nuevo proyecto

Figura 94. Anexo C. Propiedades Command Line del Linker de C/C++ para el nuevo
proyecto

Lneas de cdigo necesarias en los archivos principales de la nueva

aplicacin
Una vez implementadas las diferentes opciones de configuracin del nuevo
proyecto, es necesario crear algunas lneas de cdigo importantes en los archivos
.h, .cpp y .def de la nueva aplicacin. Estos archivos se ilustran en la Figura 95, y
las lneas de cdigo correspondientes se muestran en la Tabla 21, Tabla 22 y
Tabla 23 respectivamente.

166

ANEXO C

Figura 95. Anexo C. Archivos principales del nuevo proyecto C++ MFC

Tabla 21. Anexo C. Cdigo necesario en el archivo .h principal de la aplicacin

...
#ifdef NPL_ICCNEP
#define NPL_ICCNEP_API __declspec(dllexport)
#else
#define NPL_ICCNEP_API __declspec(dllimport)
#endif
NPL_ICCNEP_API BOOL RunNeplanScript();

Tabla 22. Anexo C. Cdigo necesario en el archivo .cpp principal de la aplicacin

...
#include "NeplanProgrammingLibrary.h"
#include "NepModuleDef.h"
// RunNeplanScript es la function principal de entrada a la DLL
NPL_ICCNEP_API BOOL RunNeplanScript() {
// En esta seccin se crean las lneas de codigo de la aplicacion
}

167

Ing. Cesar A. Becerra C.

Tabla 23. Anexo C. Cdigo necesario en el archivo .def principal de la aplicacin

; NPL_ICCNEP.def : Declares the module parameters for the DLL.

LIBRARY

"NPL_ICCNEP"

EXPORTS
; Explicit exports can go here
RunNeplanScript @1

A partir de este punto, el desarrollador podr comenzar a realizar el proceso de

codificacin de su aplicacin. Puede seguir algunos ejemplos mostrados en el
manual de NPL proporcionado por NEPLAN [1].

REFERENCIAS BIBLIOGRFICAS
[1] BCP Switzerland. NPL - NEPLAN Programming Library Manual. BCP
Busarello+Cott+Partner Inc. 2008. Web Site: www.neplan.ch.

168