SIMPLESFONDOS Contenido QUÉ HACE EL SOFTWARE... 2 TÉRMINOS DE USO... 2 REQUISITOS... 2 INSTALAR EL SOFTWARE... 2 EJECUTAR EL SOFTWARE... 3 DEJAR UNA TAREA PROGRAMADA CON LOS SCRIPTS... 4 OBTENER UNA LISTA DE TODOS LOS VALORES EN LA BASE DE DATOS... 5 1
QUÉ HACE EL SOFTWARE Se conecta a internet y descarga los valores liquidativos de los fondos de inversión del fichero lista_isin.lst. El fichero lista_isin.lst es un fichero de texto. Puedes editarlo para que contenga la lista de ISIN de los fondos de inversión que te interesan. Un isin por línea. No debe haber líneas en blanco. Como ejemplo vienen varios isin. Puedes borrarlos si quieres. Los valores liquidativos se guardan en el fichero fondos.sqlite. Es una base de datos SQLite3. Además, según los scripts que se ejecuten, también se guardan en algunos ficheros de texto en formato CSV (texto separado por comas). TÉRMINOS DE USO Lee el fichero licencias.txt. Contiene la lista de software usado y los enlaces. Revisa que estás de acuerdo con los términos de uso. Hasta donde yo he leído, todo el software incluido aquí es de uso libre en al ámbito personal. MUY IMPORTANTE: Este software se conecta a internet a varias páginas y descarga datos. Revisa que puedes usar los datos descargados. Es tú responsabilidad, no la de este software. El software sólo se ejecutará si tú lo lanzas, no lo hará por sí mismo. Los sitios a los que se conecta tienen políticas de uso de los datos. REVÍSALAS. Si no estás de acuerdo o no permiten que conectes con este software, entonces no debes ejecutar este software. Bajo tu responsabilidad. Sólo tuya. Este software se ofrece sin ninguna garantía ni responsabilidad. Se ofrece tal cual es. REQUISITOS Funciona sólo en sistemas operativos Windows. Sólo se ha probado en: Windows 7 Professional 32 bits Spanish Windows Server 2008 R2 64 bits English La "teoría" dice que debería funcionar en cualquier Windows. Pero mejor habría que probarlo. INSTALAR EL SOFTWARE NOTA IMPORTANTE: Si vas a actualizar la versión, sigue el documento específico para actualizar versión. Junto a este documento habrá un fichero de texto de nombre actualización_x_y_z.txt con las instrucciones. Si no vas a actualizar versión, es decir, que vas a instalarlo por primera vez, sigue los siguientes pasos. Descarga el fichero sf_x_y_z.zip (donde x, y, z es la versión. Por ejemplo sf_0_0_1.zip). Descomprime el fichero en una carpeta. Por ejemplo en c:\sf. IMPORTANTE: La carpeta no debe tener espacios en blanco. 2
Editar con un editor de texto (por ejemplo el Notepad/Bloc de notas) el fichero lista_isin.lst para que contenga los isin de los fondos de inversión que te interesan. Abre una ventana MS-DOS en dicho directorio. Para ello ves a INICIO --> EJECUTAR --> escribe CMD y pulsa ENTER. Se abre la ventana MS-DOS. Desde esa ventana debes ir a la carpeta donde descomprimiste el software (por ejemplo en c:\sf). El comando para ir a la carpeta c:\sf es: cd c:\sf Una vez en la carpeta, hay diferentes scripts. EJECUTAR EL SOFTWARE SCRIPT Ft_cargar_todos.bat USO Lanza un proceso que obtiene los valores liquidativos históricos (unos meses hacia atrás) de los isin en el fichero lista_isin.lst. El proceso puede tardar, dependiendo de la velocidad de tu ordenador, de tu conexión a internet, etc, etc. En cualquier momento lo puedes parar cerrando la ventana MS-DOS. El proceso puede tardar, dependiendo de la velocidad de tu ordenador, de tu conexión a internet, etc, etc. En cualquier momento lo puedes parar cerrando la ventana MS-DOS. Cuando finalice el proceso, se habrá generado un fichero con los valores liquidativos de los fondos de inversión. Será en el formato ISIN_3.txt. Por ejemplo, para el fondo con isin ES0173323009 el fichero de texto se llamará ES0173323009_3.txt. Contiene los últimos valores liquidativos de cada fondo, no sólo el último valor. Cada vez que se ejecuta, se incluyen los nuevos valores en la base de datos fondos.sqlite. Ft_cargar_todos_log.bat Qf_cargar_todos.bat Qf_cargar_todos_log.bat Es como Ft_cargar_todos.bat pero el resultado en lugar de aparecer en una ventana MS-DOS se guarda en el fichero ft_cargar_todos.log. Es un fichero de texto. Es útil para resolver problemas de ejecución, para dejar registro de su ejecución, o para usarlos en tareas programadas en el tiempo. Es como ft_cargar_todos.bat pero: Sólo obtiene el último valor liquidativo con formato de 6 decimales. El fichero que genera es en el formato qf_yyyymmdd_hhmmss_3 (siendo yyyy el año en 4 cifras, mm el mes en 2 cifras, dd el día en 2 cifras, hh la hora en 2 cifras, mm los minutos en 2 cifras, y ss los segundos en 2 cifras) la fecha y la hora del comienzo de la ejecución. Es como qf_cargar_todos.bat pero el resultado en lugar de aparecer en una ventana MS-DOS se guarda en el fichero ft_cargar_todos.log. Es un fichero de texto. Es útil para resolver problemas de ejecución, para dejar registro de su ejecución, o para 3
usarlos en tareas programadas en el tiempo. DEJAR UNA TAREA PROGRAMADA CON LOS SCRIPTS Es posible dejar los script programados en el tiempo, para que se ejecuten por si solos. Por ejemplo diariamente. Para dejar una tarea programada, hay que seguir los siguientes pasos. Estos pasos son para Windows 7 Professional 32 bits Spanish. Para otras versiones de Windows son similares. Ir a INICIO --> PANEL DE CONTROL --> hacer doble click en TAREAS ADMINISTRATIVAS - -> hacer doble click en PROGRAMADOR DE TAREAS. Se abre una nueva ventana. En la nueva ventana de nombre PROGRAMADOR DE TAREAS, ir al menú ACCIÓN --> CREAR TAREA. Se abre una nueva ventana. En la ventana CREAR TAREA hay que cumplimentar la siguiente información: o En la pestaña GENERAL, en NOMBRE, indicar un nombre descriptivo. Por ejemplo FT Cargar Todos. o En la pestaña DESENCADENADORES, hacer clic en NUEVO. Se abre una nueva ventana de nombre DESENCADENADOR. En CONFIGURACIÓN, elegir DIARIAMENTE, y en INICIO indicar una hora. Por ejemplo a las 20:00:00 horas. Y pulsar ACEPTAR. Con esta información, la tarea se ejecuta todos los días a las 20:00:00 horas. o En la pestaña ACCIONES, hacer clic en NUEVA. Se abre una nueva ventana de nombre NUEVA ACCIÓN. En PROGRAMA O SCRIPT, escribir lo siguiente, suponiendo que los scripts están en c:\sf c:\sf\ft_cargar_todos_log.bat O se puede poner qf_cargar_todos_log.bat Además, en INICIAR EN escribir c:\sf Con esta información la tarea que se ejecuta es c:\sf\ft_cargar_todos_log.bat, y deja un fichero de log (registro) en formato texto de nombre ft_cargar_todos.log. Esto sirve para resolver errores en caso de que algo no funcione bien y también para comprobar que se ha ejecutado. Y después pulsar ACEPTAR. En la ventana CREAR TAREA, pulsar ACEPTAR. En la ventana PROGRAMADOR DE TAREAS, en la parte izquierda, hacer clic en BIBLIOTECA DEL PROGRAMADOR DE TAREAS. En la parte central aparecen las tareas programadas actualmente. Entre ellas está FT Cargar Todos, donde se indica que se ejecuta a las 20:00 horas todos los días, su próxima hora de ejecución, la última ejecución y el resultado de la última ejecución. 4
Con todo lo anterior la tarea ya está creada. Para ver si va correctamente, se puede ejecutar manualmente, sin que sea necesario espera a que llegue la hora programada (20:00 horas). Para ello, hacer click con el botón derecho del ratón sobre FT Cargar Todos y seleccionar EJECUTAR. Se lanza una ventana MS-DOS con la ejecución del script. Una vez finalizado, se observa la hora de última ejecución y el resultado de última ejecución, que debe ser "La tarea se completó correctamente (0x0)". Lo siguiente es esperar a que llegue la hora programada de su próxima ejecución y comprobar que el resultado ha sido correcto, mirando el programador de tareas y viendo que los ficheros de los scripts están actualizados. OBTENER UNA LISTA DE TODOS LOS VALORES EN LA BASE DE DATOS Para obtener un listado en formato texto CSV (texto separado por comas) con todos los valores históricos de la base de datos fondos.sqlite ejecuta el comando db_exportar_csv.bat Genera un fichero de nombre db_isin.csv. Este fichero lo puedes abrir con un fichero de texto (por ejemplo el Notepad/Bloc de notas), una hoja de cálculo (por ejemplo Excel), etc. Para obtener un listado en formato web (html) con todos los valores históricos de la base de datos fondos.sqlite ejecuta el comando: db_exportar_html.bat Genera un fichero de nombre db_isin.html. 5