> For the complete documentation index, see [llms.txt](https://docs.geodin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geodin.com/geodin-desktop/es/integraciones-y-complementos/overview-1/method-reference.md). # Referencia del Método Esta Página es la referencia canónica para la API COM de GeoDin. Describe los Métodos que una aplicación externa puede llamar a conducir GeoDin (como un servidor COM) o a incrustar Funciones especiales en GeoDin como complementos. La referencia está dirigida a desarrolladores de software que combinan GeoDin con otros productos o integran Funciones especiales en GeoDin. Para cada Método se indica el Campo necesario edición de GeoDin. ## Vista general ### COM-Funciones y Plugins GeoDin ofrece la opción de conectar GeoDin con aplicaciones externas. Este capítulo describe los Métodos técnicos y está dirigido a desarrolladores de software, que están a punto de combinar GeoDin con otros productos o integrar Funciones especiales en GeoDin. Para ejecutar GeoDin mediante una aplicación externa, hay varias funciones disponibles. Una parte de estas funciones se utiliza para controlar la interfaz del programa GeoDin (en este caso GeoDin es visible para el usuario), de modo que una aplicación externa como por ejemplo un GIS selecciona de forma autónoma un objeto en el gestor de objetos de GeoDin e inicia un método de GeoDin. Otra parte de las funciones se utiliza para suministrar información desde la base de datos de GeoDin a imágenes gráficas de los objetos. Aquí GeoDin suele ser invisible y gestiona sus tareas en segundo plano. Las funciones individuales se describen en la sección [Funciones COM](#com-functions). Para cada función se define qué edición de GeoDin es necesaria. Por otro lado, es posible integrar aplicaciones o funciones externas en la interfaz del programa de GeoDin. Dichas funciones (los llamados plug-ins) pueden, por ejemplo, realizar Cálculos especiales o exportaciones de datos y se muestran en GeoDin con un Símbolo del método. Se proporciona una Descripción para incrustar y configurar estas funciones externas en la Sección [Complementos](#plug-ins) y en [Instalando complementos](/geodin-desktop/es/integraciones-y-complementos/installing-plug-ins.md). ### COM-Funciones **Consejos para Usar GeoDin como servidor COM** Usar GeoDin como servidor COM (al crear una Perforación del Tipo `GeoDin.GeODinApplication`) puede controlarse mediante los siguientes Parámetros. #### Directorio de trabajo de la aplicación GeoDin Como estándard, se usa el Directorio "TEMP" en el Directorio "Ajustes locales" del Usuario Actual como el directorio de trabajo de la aplicación GeoDin en el modo de inicio como servidor COM. Al introducir `ExecutePath=` en la Sección `[Sistema]` del [Archivo de Configuración GeoDin.ini](/geodin-desktop/es/instalacion-y-licencias/configuration-file-reference.md) se puede definir otro Directorio. #### Disponibilidad de complementos Como estándard [Complementos](#plug-ins) no se cargan cuando GeoDin está Iniciado. Al introducir `COMServerPlugins=Verdadero` en la Sección `[Sistema]` del [Archivo de Configuración GeoDin.ini](/geodin-desktop/es/instalacion-y-licencias/configuration-file-reference.md) se puede lograr la carga del complemento. #### Directorio de la aplicación de GeoDin El directorio de la aplicación de GeoDin es, por estándard, el Directorio situado un Nivel por encima del Directorio BIN (en el que se incluye GeoDin.exe). Una típica Instalación de GeoDin tiene la siguiente estructura: ``` C:\Programs\GeoDin (contenidos GeoDin.ini) C:\Programs\GeoDin\BIN (contenidos GeoDin.exe) C:\Programs\GeoDin\SYSLIB C:\Programs\GeoDin\Fuente etc. ``` El directorio de la aplicación es en este caso `C:\Programs\GeoDin`, donde también se lee el Archivo de Configuración GeoDin.ini. Con este Nombre también se han creado los Nombre de varios subdirectorios (p. ej., para Fuente, QUERYDEF, Diseños, etc.). Es posible Configurar el directorio de la aplicación de GeoDin a cualquier otro Directorio, por lo tanto se puede diferenciar, Cuando GeoDin es Iniciado directamente como aplicación por el Usuario O se instancia como un servidor COM. Para un Inicio ("normal") de GeoDin por el Usuario el directorio de la aplicación puede establecerse mediante un parámetro de Línea de comandos. Tiene que empezar con la palabra clave `-af` Y tiene que contener posteriormente un nombre completo de directorio. ``` C:\Programs\GeoDin\BIN\GeoDin.exe -afC:\Programs\GeoDin\Soluciones\Water ``` **Nota:** Cuando el Nombre del Directorio contenidos espacios Vacíos, el Parámetro completo ha de ponerse entre comillas, p. ej.: ``` C:\Programs\GeoDin\BIN\GeoDin.exe "-afC:\Programs\GeoDin\Soluciones\Water" ``` Al iniciar GeoDin como servidor COM, no es posible un parámetro de línea de comandos. Por ello se preparó un método para introducirlo a través del registro. Aquí el nombre del directorio de aplicación elegido tiene que colocarse antes del inicio del servidor COM en el `REG_SZ` clave "ApplicationFolder" en la siguiente clave del registro: ``` [HKEY_CURRENT_USER\Software\Sistema GeoDin\COMServer] ``` Con ambos métodos, GeoDin comprueba la existencia del directorio e ignora la configuración si no lo encuentra. No se realizan comprobaciones adicionales. Asegúrese de que el directorio seleccionado incluye como contenidos un archivo de configuración GeoDin.ini y todos los subdirectorios necesarios para GeoDin. ### Complementos **Complementos** son módulos externos (programas/servidor COM), a los que se llama desde la interfaz de usuario de GeoDin. De este modo, un desarrollador de software puede integrar el inicio de una aplicación determinada, por ejemplo, una función especial de Exportar o una nueva función de cálculo, en la interfaz de usuario del programa GeoDin. Para el Usuario, la aplicación aparece como un método GeoDin «normal». Toda la información necesaria para el Objeto(s) elegido se transfiere al complemento en el gestor de objetos de GeoDin. De este modo, el complemento puede ofrecer funciones de análisis Adicional para una cantidad seleccionada de objetos. Un complemento también puede ser una aplicación que no funciona con la Base de datos de GeoDin. La configuración del complemento también puede integrar la «calculadora» del sistema operativo en la interfaz de usuario del programa GeoDin. Se puede llamar a un complemento como aplicación (archivo EXE) o como función COM de un servidor COM registrado. Aquí, el parámetro Ejecutar **o** Servidor en la configuración del complemento. Un servidor COM que deba llamarse como complemento tiene que cumplir determinados requisitos, que se describen a continuación. Para la configuración paso a paso, consulte [Instalando complementos](/geodin-desktop/es/integraciones-y-complementos/installing-plug-ins.md). **Definición de un complemento** La configuración de los complementos que se van a usar se realiza en el archivo de configuración GEODIN.INI. Con GeoDin 9, los complementos se definen en la pestaña Sistema de la Configuración del sistema, en la Sección «Publicaciones». **1. Lista de complementos disponibles** En la Sección `[Plugins]` cada complemento se define con una línea y recibe un Nombre; ejemplo: ``` [Plugins] Plugin1=Calcular Plugin2=Exportar ``` ***Nota:*** *Es posible que la Sección `[Plugins]` deba ser creada si no se ha configurado ningún complemento Anterior. Añada una línea que contenga `[Plugins]` con un Editor de texto al final del archivo GEODIN.INI y, al menos, una línea como `Plugin1=Nombre del complemento`. Usar números consecutivos (`Plugin1=`, `Plugin2=` etc.) para la definición de más de un complemento.* **2. Definición de un único complemento de la Lista** Para cada complemento introducido en la Lista `[Plugins]` se debe crear una Sección independiente en el archivo de configuración GEODIN.INI que contenga el Nombre del complemento definido en el paso 1; ejemplo: ``` [Calcular] Nombre=Calcular Ejecutar=C:\PROGRAMS\GEODIN\BIN\GPI.EXE ``` ***o*** ``` Servidor=GeODinPlugin.GeODinPluginSample Módulo=Module1 Icono=C:\PROGRAMS\GEODIN\BIN\CALC.ICO Emergente=falso Esperar=falso DBNode1=1 DBNode2=2,1 ``` Añada las líneas correspondientes al archivo GEODIN.INI con el Editor de texto. Los parámetros de esta Sección controlan a qué objetos (en el gestor de objetos de GeoDin) se debe aplicar el complemento, qué archivo de programa o qué función de servidor COM se debe ejecutar y si el Usuario debe esperar a la ejecución de la función. Se establecen los siguientes parámetros: | Parámetro | Descripción | | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Nombre` | Nombre del complemento en el gestor de objetos de GeoDin (estos nombres se muestran bajo el Símbolo del método o en el menú emergente). | | `Ejecutar` | Programa ejecutable (nombre de archivo completo con ruta). **Ejemplo:** `C:\WINDOWS\SYSTEM32\CALC.EXE` | | ***o*** `Servidor` | Nombre del servidor COM que debe ejecutar la función elegida. **Ejemplo:** `GeODinPlugin.GeODinPluginSample` | | `DBNode1..n` | Lista de nodos en el gestor de objetos de GeoDin **Bases de datos**, en el que el complemento puede ser Iniciado. Aquí selecciona en qué nodos (ramas y estado del nodo) debe ser posible la llamada del complemento. Esto se hace seleccionando una Lista de definiciones de ramas de Cualquiera Longitud, que debe establecerse mediante un Ingreso `DBNodexx`. Usar los números consecutivos (`DBNode1=`, `DBNode2=` etc.) para la definición de varios nodos. Vea los ejemplos y la sintaxis a continuación. | | `Módulo` (opcional) | Nombre del programa Módulo en el complemento; este Nombre se transfiere como Parámetro al programa ejecutable o a la función COM. Cuando no se introduce ningún Nombre de Módulo, el Parámetro de transferencia permanece Vacío. Mediante esta opción es posible que una sola aplicación o función de servidor COM pueda realizar diferentes tareas, que están controladas por la Identificación del Módulo. Se pueden combinar varias funciones en una aplicación externa al Usar Nombre de Módulo, porque se permite conectar varios complementos con el mismo Archivo de aplicación o función de servidor COM. Al transferir el Nombre del Módulo como un Parámetro, diferentes Procesos pueden quedar Activado en la aplicación externa o función. En este caso, diferentes funciones pueden alinearse a diferentes Símbolos usando el Parámetro "Icon". | | `Icono` (opcional) | Nombre de archivo completo de un archivo ICO para la visualización del Símbolo del método en el gestor del método. Cuando este Parámetro no se introduce, se usa el icono del programa ejecutable (no posible para servidores COM). Cuando el programa no contenidos ningún icono, se usa un icono Texto estándar. | | `Ventana emergente` (opcional) | El Método se muestra solo como menú emergente (haga clic con el botón derecho del ratón sobre la Perforación en el gestor de objetos de GeoDin). Establezca el Valor a `=Verdadero`, cuando el complemento no debe aparecer como Símbolo del método, sino solo en el menú emergente. El Texto estándar del Valor es `=Falso` -> Símbolo en el gestor del método. | | `Espera` (opcional) | Controla si GeoDin debe esperar a Ejecutar la función en el complemento. Para aplicaciones (Archivos EXE) establezca el Valor a `=Verdadero`, cuando la función debe completar, para seguir trabajando en GeoDin. El Texto estándar de este Parámetro es `=Falso`. ***Nota:*** *Cuando se usa un servidor COM, GeoDin Siempre espera hasta que la función haya terminado.* | | `PermitirAbrirMétodos` (opcional) | Define si el complemento puede ejecutarse, Cuando hay Métodos para Abrir (p. ej., Estadística de datos). La configuración estándard permite que el complemento se ejecute: establezca el Parámetro a `=Falso`, para evitar esto (en cuyo caso se mostrará una Advertencia). | | `Ocultar` (opcional) | Controla si el complemento es visible en el administrador de Método (como Símbolo o menú emergente). Como estándard es visible. Establezca el Parámetro `Ocultar` a `=Verdadero`, para Ocultar el complemento. Entonces, el complemento solo puede llamarse usando el [función COM](#com-functions) **"ExecuteMétodoParams"**. | | `ExecuteAfterExpanding` (opcional) | Controla si el complemento se ejecuta automáticamente al abrir la rama por primera vez. Establezca el Parámetro `=Verdadero` a iniciar el complemento automáticamente. Los complementos ocultos por el Parámetro `Ocultar=Verdadero` pueden iniciarse automáticamente. De este modo es posible invocar una función no por el Usuario de GeoDin, sino que se ejecuta automáticamente cuando se abre esta rama (por ejemplo, después de abrir la Base de datos). | | `RefreshDatabaseDictionaries` (opcional) | Esto define, después de que el complemento se haya ejecutado, si los Diccionarios de la Base de datos se descargan. Cuando sea necesario, se volverán a cargar automáticamente. | **Ejemplos de DBNode** **Ejemplo 1:** ``` DBNode1=3,2,1 ``` Significado: El complemento se muestra en un nodo de proyecto. El proyecto tiene que estar ya abierto y estar contenido en una Base de datos OneTableSet. **Ejemplo 2:** ``` DBNode1=3,Boreholedatabase,1 ``` Significado: El complemento se muestra solo en los proyectos abiertos de la base de datos "Boreholedatabase". **Ejemplo 3:** ``` DBNode1=3, Boreholedatabase,0,P00001 DBNode2=3, Boreholedatabase,0,P00002 ``` Significado: El complemento se muestra en los proyectos con la Identificación de proyecto P00001 o P00002 de la base de datos "Boreholedatabase". No importa si los proyectos están abiertos o cerrados. **Ejemplo 4:** ``` DBNode1=9,2,0,,2,JPG ``` Significado: El complemento se muestra en todas las Bases de datos SQL con la configuración OneTableSet en los Documentos del tipo JPG en la segunda posición de la lista de Métodos (después del método 'Vista previa'). **Sintaxis de la definición DBNodeX=** El Parámetro Identificación debe introducirse obligatoriamente; se pueden añadir más Parámetros separados por comas. ``` DBNode1..n=Identificación[,Param1][,Param2][,...] ``` | Identificación | El complemento se muestra en la Perforación ... | | -------------- | ----------------------------------------------- | | 1 | Bases de datos | | 2 | Base de datos | | 3 | Proyecto | | 4 | Consulta o Grupos en la rama Objetos | | 5 | Consulta o Grupos en la rama Puntos de medida | | 6 | Perforación | | 7 | Perforación de Punto de medida | | 8 | Directorio de Documento | | 9 | Documento | | Param1 | El complemento se muestra en los Objetos definidos por la Identificación en una Base de datos en ... | | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 0 | Todas las bases de datos | | 1 | para Identificación=1 el complemento se muestra solo cuando no hay ninguna Base de datos configurada actualmente; para Identificación=2 solo en Bases de datos SQL (sin bases de datos basadas en archivos) | | 2 | solo en Bases de datos SQL con la configuración OneTableSet | | Nombre | solo en la Base de datos concreta con el nombre introducido | | Param2 | El complemento se muestra en los Objetos definidos por la Identificación en una Base de datos ... | | ------ | ------------------------------------------------------------------------------------------------- | | 0 | independientemente de si la Base de datos o el Proyecto está abierto | | 1 | solo, cuando la Base de datos o el Proyecto está abierto | | 2 | solo, cuando la Base de datos o el Proyecto está cerrado | | Param3 | El complemento se muestra en los Objetos definidos por la Identificación en una Base de datos ... | | ------ | ------------------------------------------------------------------------------------------------- | | Vacío | en todos los proyectos | | PRJID | solo en Proyectos con la Identificación introducida | | Param4 | El complemento se muestra en la lista de Métodos en una posición preestablecida... | | --------- | ----------------------------------------------------------------------------------------------------------------- | | Vacío o 0 | al final de la lista (después de los Métodos de GeoDin) | | 1..n | en la posición introducida, por ejemplo, 1 - el Símbolo del método se muestra en la Perforación en la 1. posición | | Param5 | El complemento se muestra para Identificación=9 solo en Documentos del siguiente tipo ... | | ------ | ----------------------------------------------------------------------------------------- | | Vacío | en todos los tipos de Documento | | JPG | solo en Documentos de este tipo (aquí ejemplo: Imágenes JPG) | **Usando una aplicación (Archivo EXE) como complemento** Para usar una aplicación como complemento, debe introducir el Parámetro `Ejecutar=ruta de acceso completa de la aplicación` en la definición del complemento. GeoDin inicia la aplicación cuando se llama al método y transfiere todos los Parámetros de Campo necesario de la rama seleccionada en el gestor de Objetos de GeoDin. Con estos datos, el complemento puede realizar Operaciones de ejecución especiales para estos Objetos. Los Parámetros se transfieren a la aplicación en la línea de comandos. Según la rama seleccionada en el gestor de Objetos de GeoDin, el número de Parámetros varía, lo que se muestra en la siguiente Tabla: | Parámetro | Tipo | Contenido | Identificación=1 | Identificación=2 | Identificación=3 | Identificación=4-9 | | --------- | ---------------------- | ------------------------------------------------------------------------------------------------------- | ---------------- | ---------------- | ---------------- | ------------------ | | 1 | Cadena | Nombre del Módulo o Vacío | X | X | X | X | | 2 | Número entero | Posición de la Pantalla Izquierdo | | X | X | X | | 3 | Número entero | Posición de la Pantalla arriba | | X | X | X | | 4 | Número entero | Identificación de la sucursal | X | X | X | X | | 5 | Cadena | Nombre de base de datos \*1 | | - | X | X | | 6 | Cadena | Nombre de registro de la Base de datos | | - | X | X | | 7 | Cadena | Contraseña: Base de datos \*2 | | - | X | X | | 8 | Cadena | Identificación del Proyecto GeoDin, o cadena "DB" para una rama debajo de una Consulta de Base de datos | | - | - | X | | 9 | Cadena o Número entero | Dependiendo Sobre, en la Selección de la Identificación | | - | - | X | El tipo de parámetro 9 depende Sobre, en la Identificación de la rama, desde donde el complemento Iniciado: | Identificación | Parámetro 9 | | -------------- | -------------------------------------------------------------------------------------- | | 1,2,3 | Vacío | | 4 | Nombre de archivo de un archivo temporal con PRJ\_ID y LOCID de los Objetos | | 5 | Nombre de archivo de un Archivo temporal con una cadena de los INVIDs de los Objetos | | 6 | PRJ\_Identificación y LOCIdentificación de la Perforación seleccionado | | 7 | INVID del objeto seleccionado como cadena | | 8 | Nombre de archivo de un Archivo temporal con enteros de los ADC\_IDs de los Documentos | | 9 | ADC\_Identificación de los Documentos | \*1 Nombre de base de datos: Adicionalmente a Nombre de base de datos, esta cadena también incluye el Tipo de conexión (ADO o FireDAC) y el Signo de conexión en sí. \*2 La Contraseña: puede formar parte del Signo de conexión, por ejemplo, para Bases de datos del Sistema o para conexiones con una Contraseña: almacenada. En este caso, la cadena está Vacío. La Contraseña: debe extraerse directamente del Signo de conexión. {% hint style="warning" %} Cuando un Nombre de archivo con los IDs de los Objetos se transfiere a los complementos, el complemento es responsable de Eliminar este Archivo. Cuando el Archivo no se elimina, permanece en el Directorio TEMP del Usuario Actual. {% endhint %} El Archivo con los IDs contiene tantas líneas como Objetos están contenidos en la Consulta o Grupos. Sobre, en la sucursal Identificación = 4 cada Línea contenidos el PRJID y LOCID separados por comas (Ejemplo: PRJ001,3). Sobre, en la Identificación de la rama = 5 cada Línea tiene los contenidos INVID (Ejemplo: PRJ0010004FIL001). Sobre, en la rama Identificación = 8 cada Línea posee contenidos en el ADC\_Identificación (Ejemplo: 23). Los Parámetros 1 y 2 de la posición de la ventana "ideal" permiten (Permitir) posicionar la ventana de la aplicación externa de forma análoga a los Métodos GeoDin en el lado derecho, debajo del Símbolo del método o del Ingreso del menú emergente. **Usando un servidor COM como complemento** Para Usar un servidor COM como complemento, tienes que introducir el Parámetro a continuación `Servidor=nombre Completo de la interfaz del servidor COM` en la definición del complemento. El Nombre Completo consiste en el Nombre del servidor COM y el Nombre de la interfaz, que están separados por un Punto, por ejemplo `GeODinPlugin.PluginInterface`. La interfaz tiene que proporcionar una función con el Nombre `GeODinExecutePlugin`, que recibe una cadena como parámetro de transferencia y devuelve un parámetro OleVariant: ``` function GeODinExecutePlugin(const Params: WideString): OleVariant; ``` ***Nota:*** *La sintaxis de la definición de la función depende Sobre, en el Idioma de programación, en el que el complemento fue creado.* La cadena, que se transfiere en params, tiene la estructura de un archivo de configuración con las siguientes secciones y parámetros: ``` [Params] Parámetros generales Izquierdo= Posición ideal X de un método que muestra una ventana Arriba= Posición ideal Y de un método que muestra una ventana Módulo= Nombre del módulo (de GeoDin.ini) DBNode= Identificación de la rama seleccionada SolutionName= Nombre de la solución GeoDin (si está instalada) SolutionVersion= Versión de la solución GeoDin (si está instalada) Base de datos= Nombre de base de datos: ADOConnection Nombre de usuario= Identificación de usuario Contraseña:= contraseña de la Base de datos Propietario= Nombre del propietario de la tabla de la Base de datos PRJID= Identificación de Proyecto o "DB" Nombre de la consulta= Nombre de la consulta en la que están contenidas las Perforaciones seleccionadas [Objetos] Lista de las identificaciones de las Perforaciones seleccionadas Identificación1 Identificación2 ... [Consulta] Sección con elementos de la consulta (solo para Consultas del sistema) Seleccionar= Parte Seleccionar de un Comando SQL From= Parte FROM de un Comando SQL Donde= Parte de un Comando SQL Order By= Parte ORDER de un Comando SQL ``` Explicación: La Posición puede ser utilizada por el complemento, a colocar un diálogo correspondiente a las posiciones para los Métodos de GeoDin. El Parámetro DBNode contenidos la Identificación de la rama seleccionado (ver Descripción de DBNode arriba). La Conexión al base de datos se especifica mediante el Nombre de base de datos (consiste en Nombre y Signo de conexión separados por dos puntos), Información de inicio de sesión (para bases de datos SQL) y eventualmente el Nombre del propietario. El Parámetro PRJID es ocupado por la Identificación de proyecto GeoDin, Cuando las ramas seleccionado están bajo un Proyecto, de lo contrario este Parámetro contenidos la cadena Fijar "DB". Tipo de objeto Identificación: * Objetos: PRJ\_Identificación y LOCIdentificación separados por comas * Puntos de medida: INVID como cadena * Documentos: ADC\_Identificación de los documentos Cuando se utilizan Consultas del sistema, las Propiedades de los Comandos SQL, que han causado la entrada de los Objetos en el gestor de objetos, se transfieren en la Sección "Consulta". El valor devuelto de la función está reservado para futuras extensiones. El valor debe establecerse a Cero, porque Para el momento no se devuelve. **Complemento para Crear Informes** Además de la Ejecutar de complementos como Método en el gestor de objetos GeoDin, los complementos también pueden usarse para Crear Informes. Este tipo de complementos puede usarse en Diseños y Gráficas para realizar un tipo de Informe Fuerte y especial en una Gráfica. Desarrollar un complemento así es una tarea compleja, porque debe ser creado y devuelto como Parámetro a la función una clase GeoDin en Formato del papel XML. Aquí no se incluye una Descripción de una clase GeoDin en Formato del papel XML (se proporciona Información a petición); aquí solo se describe la Configuración de los complementos de Informe: **1. Lista de complementos de Informes Disponible** En la Sección `[Complementos de Informes]` cada complemento se define mediante una Línea y se le asigna un Nombre. **Ejemplo:** ``` [Complementos de Informes] Complemento1=Informe especial ``` **2. Definición de un único complemento de Informe de la Lista** Para cada complemento definido en la Lista `[Complementos de Informes]` debe crearse una Sección aparte en el Archivo de Configuración GEODIN.INI con el Nombre del complemento definido en el Paso 1. **Ejemplo:** ``` [Informe especial] Nombre=Informe especial de agua Servidor=GeODinInformePlugin.GeODinInformePluginSample Módulo=Module1 EjecutarSinDatos=Falso ``` | Parámetro | Descripción | | ------------------ | ------------------------------------------------------- | | `Nombre` | Nombre del Informe para Elementos del gráfico "Informe" | | `Servidor` | Nombre de la interfaz del servidor COM | | `Módulo` | nombre opcional del Módulo | | `EjecutarSinDatos` | Selección del tipo de ejecución del complemento | El nombre del Módulo se transfiere al complemento, para que diferentes Informes puedan ser creado en una función COM. Al establecer la opción `EjecutarSinDatos=Falso` el complemento es Iniciado por GeoDin, Cuando la Gráfica es un Seleccionar diseño Sin conexión de datos. Al establecer la opción `ExecuteWithOutData=Verdadero` solo comienza en una Gráfica con datos conectados. Para Usar un servidor COM como un complemento de Informe, introduzca en la definición del complemento el Parámetro a usar. `Servidor=nombre Completo de la interfaz del servidor COM`. El nombre completo consta del nombre del servidor COM y del nombre de la interfaz, que están separados por comas, por ejemplo `GeODinPlugin.PluginInterface`. La interfaz introducida tiene que proporcionar una función con el nombre a `GeODinGetGraphicReport`, que recibe una cadena como Parámetro de transferencia y un OleVariant como Parámetro de retorno: ``` función GeODinGetGraphicReport(const Params: WideString): OleVariant; ``` ***Nota:*** *La sintaxis de la definición de la función depende Sobre, en el Idioma de programación, en el que el complemento fue creado.* La cadena, que se transfiere en params, tiene la estructura de un Archivo de Configuración con las secciones y Parámetros como se describió arriba para los complementos del servidor. Como salida, se espera un flujo de datos XML de acuerdo a la clase GeoDin C\_GraphicDrawReport. ### Números de error Los números de error son fijos para todas las funciones. Son devueltos por [Valor de excepción](#exceptionvalue). | Número | Significado | | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 1 | Error del Sistema (Los recursos del Sistema están agotados, es decir.) | | 2 | Función no licenciada | | 3 | Error de inicialización (el servidor COM no se ha Iniciado o se ha iniciado de forma incompleta) | | 4 | Archivo de Seleccionar diseño (Parámetro LayoutFileName) o el El diseño / Informe de la Lista de diseño no se puede cargar (Nombre incorrecto, falta el Archivo, está defectuoso, etc.) | | 5 | Error en El diseño (p. ej., no existe Ningún objeto Marcos de perforación) | | 6 | La Base de datos no se puede abrir (Nombre de base de datos incorrecto, inicio de sesión incorrecto) | | 7 | No se puede cargar la Perforación (Identificación de Proyecto incorrecta O defectuosa, Identificación de Perforación incorrecta, Archivos defectuosos en el Directorio GeoDin SYSLIB) | | 8 | El Archivo seleccionado en el Parámetro OutFileName no puede guardarse (nombre de archivo incorrecto, permisos) | | 9 | El dispositivo de salida (Imprimir) seleccionado no definido en el Archivo de Configuración GeoDin.INI. | | 10 | El dispositivo de Imprimir definido por el Ingreso de Configuración no se puede encontrar en la Lista de controladores de Impresora instalados. | | 11 | Error al crear el Archivo de Imprimir (p. ej., configuración incorrecta del Formato del papel, el controlador de la Impresora no no admite este Formato del papel) | | 12 | Error al transferir el Archivo de Imprimir completado como Resultado de la función (definir SpoolTimeOut) | | 13 | No es posible crear el ingreso de Perforación o los Grupos de Perforación (Identificación de Perforación incorrecta, Tipo de objeto) | | 14 | No válido MethodID - la función no está Disponible | | 15 | Una Selección no es posible porque la Perforación marcada no puede cerrarse. Ejemplo: Cuando la Actual Perforación está editada y vencido a un Error de sintaxis en los datos no puede ser Izquierdo, marcar otra Perforación no es posible. | | 16 | El Término no puede ser Iniciado porque No se ha abierto ninguna ventana Gráfica. | ## Referencia: métodos COM ### Valor de excepción Funciones a identificar el estado del error. ``` función ExceptionValor: entero; ``` Esta función muestra el estado de error de la función llamada previamente. El valor de retorno es 0, si la función llamada previamente ha funcionado correctamente. Los posibles números de error se describen bajo [Números de error](#error-numbers). ``` función ExceptionMsg:string; ``` (Texto estándar edición requerida) Retorno del texto de error de una llamada de función fallida previamente. Cuando `ExceptionValor <> 0` el mensaje de error completo puede consultarse con esta función. ### ObjectManagerVisible Función para mostrar u ocultar la ventana de GeoDin. ``` propiedad ObjectManagerVisible:boolean ``` Al establecer esta propiedad en "verdadero" o "falso" se controla la visibilidad del administrador de objetos de GeoDin. ### Información de licencia Funciones para determinar la información de licencia. ``` función Información de licencia:string; ``` Esta función está disponible a partir de la edición Essentials. La respuesta contiene información sobre GeoDin y los módulos disponibles. ``` Información de licencia: Número de compilación: G1840809 Número de dongle: Desconocido GeoDin - Ediciones Profesional ``` La Información de la solución con Número de Versión es salida continua, Cuando están Disponible. ### Seleccionar ubicación Funciones a marcar (Selección) un Perforación en el gestor de la Perforación. ``` función SelectLocation(Base de datos, Nombre de usuario, Contraseña:, ProjectID:Widestring; LocationID:Número entero):Número entero; ``` Esta función está Disponible a partir del Módulo Base en adelante. El objeto especificado se marca en el administrador de objetos de GeoDin y se convierte en el objeto Actual. Como Identificación de objeto también se puede transferir -1. En este caso, el proyecto de GeoDin se marca en el administrador de objetos y se convierte en el objeto Actual. | Parámetro | Descripción | | ------------------------------- | --------------------------------------------------------------------------------------------------------------- | | `Base de datos` | Nombre de la Conexión al base de datos, por ejemplo "GeoDin COM example" | | `Nombre de usuario` | Nombre de inicio de sesión de la Base de datos (para Access, un carácter de libre ' ', ¡sin cadena Vacío!) | | `Contraseña:` | Contraseña: de inicio de sesión de la Base de datos (para Access, un carácter de libre ' ', ¡sin cadena Vacío!) | | `Identificación de Proyecto` | Identificación de proyecto GeoDin (6 dígitos) | | `Identificación de Perforación` | Identificación de Perforación de GeoDin | {% hint style="info" %} El Valor de retorno de la función es 0, Cuando se ejecuta la función. El Valor de retorno es 1, Cuando se ha producido un error. Consulte [Valor de excepción](#exceptionvalue) y ExceptionMsg. {% endhint %} ### SeleccionarPerforación ``` función SeleccionarPerforación(Params:Widestring):Número entero; ``` La Perforación especificada (Base de datos, Proyecto, Consulta, Perforación, Punto de medida) se marca en el administrador de Objetos de GeoDin y se convierte en la Perforación Actual. Se accede al control de la función mediante una cadena con el Formato del papel de un Bloque de Configuración: ``` [Params] Base de datos= Nombre de usuario= Contraseña:= Tipo de Perforación= NodoPrincipal= Consulta= Identificación de Perforación= Ampliar= ``` Los Parámetros tienen el siguiente significado: | Parámetro | Descripción | | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Base de datos` | Nombre de la Conexión al base de datos, por ejemplo "GeoDin COM example" | | `Nombre de usuario` | Nombre de inicio de sesión de la Base de datos (para Access Vacío, ¡internamente se utiliza un carácter de libre ' '!) | | `Contraseña:` | Contraseña: de inicio de sesión de la Base de datos (para Access Vacío, ¡internamente se utiliza un carácter de libre ' '!) | | `Tipo de Perforación` | `0` - Debe quedar seleccionado la rama de la Base de datos o la rama del Proyecto. Para Seleccionar la rama de la Base de datos, el Parámetro `NodoPrincipal` debe establecerse en `=Base de datos`, los Parámetros `Consulta` Y `Identificación de Perforación` permanecen Vacío (sin Ingreso). Para Seleccionar una rama de Proyecto, el Parámetro `NodoPrincipal` debe establecerse en `=Proyecto`, el Parámetro `Identificación de Perforación` debe contener la Identificación del Proyecto (p. ej. `ObjectID=PRJ001`), el Parámetro `Consulta` permanece Vacío (sin Ingreso). `1` - Debe quedar seleccionado la rama «Objetos» o un Objeto de la consulta. `2` - Debe quedar seleccionado la rama «Puntos de medida», una consulta de medición o un Punto de medida. | | `NodoPrincipal` | `=Base de datos`: define que la Perforación que debe quedar seleccionado tiene que estar directamente debajo de la Base de datos como una Consulta o dentro de una Consulta de ese Tipo. El Parámetro `Consulta=` define el Nombre de la Consulta de ese Tipo. `=DatabaseQueries`: define que la Perforación que debe quedar seleccionado tiene que estar en la rama Objetos (`ObjectType=1`) o en la rama de mediciones (`ObjectType=2`) de la Base de datos. El Parámetro `Consulta=` define el Nombre de la Consulta de ese Tipo. `=Proyecto`: define que la Perforación a ser seleccionado tiene que estar directamente debajo de la Consulta o dentro de una Consulta de ese tipo. El Parámetro `Consulta=` define el Nombre de una Consulta de ese tipo. `=ProyectoConsultas`: define que la Perforación a ser seleccionado tiene que estar ya sea en los Objetos de la rama (`ObjectType=1`) o en la rama de mediciones (`ObjectType=2`) del Proyecto. El Parámetro `Consulta=` define el Nombre de la Consulta. | | `Consulta` | Este es un Parámetros opcionales que define el Nombre de la Consulta a ser seleccionado o la Consulta, que tiene contenidos de la Perforación a ser seleccionado. Cuando este Parámetro no se introduce GeoDin selecciona automáticamente las Consultas "Todos los objetos" o la Consulta correspondiente o el Tipo de medición, que está definido por la Identificación de medición (de tres dígitos) en el INVID. | | `Identificación de Perforación` | El Parámetro `Identificación de Perforación` especifica la Perforación elegida. Cuando `Identificación de Perforación` está Vacío o tiene contenidos solo una Identificación de Proyecto de seis dígitos, solo las ramas (en este caso Consultas), que están definidas por `NodoPrincipal` Y `Consulta`, se han seleccionado Sin seleccionar una determinada Perforación o Punto de medida. Un Objeto ID tiene que seguir a el Proyecto Identificación directamente y tiene que consistir a partir de una cadena de cuatro dígitos, por ejemplo `PRJ0010022` = Proyecto Identificación: PRJ001 y Perforación Identificación 22. El Número de la Perforación Identificación debe completar con ceros y debe constar de exactamente cuatro caracteres. Cuando se debe seleccionado un Punto de medida, se debe introducir un INVID de dieciséis dígitos, por ejemplo `PRJ001022FIL001`. Una excepción es la Selección de una Consulta del punto de medida de GeoDin del Tipo "Filtro" o "Ejemplo". Usando un `Identificación de Perforación` del Tipo `= PRJ001????FIL` (`ObjectType=2`, `ParentNode=ProjectQueries`, `Consulta=Vacío`) por ejemplo, la Consulta "Filtro" en la rama Puntos de medida del Proyecto PRJ001 puede seleccionarse Sin elegir un Punto de medida determinado en esta rama. | | `Ampliar` | Este Parámetro define si la rama seleccionado debe abrirse al mismo tiempo. Usar las entradas `=Verdadero` o `=Falso` a fin de determinar el proceso de apertura. El valor de Texto estándar de `Ampliar` es `=Verdadero`. | {% hint style="info" %} El valor devuelto de la función es 0, Cuando la función fue ejecutada. El valor devuelto es 1, Cuando ocurrió un error. Véase [Valor de excepción](#exceptionvalue) y Excepciones. {% endhint %} ### CreateObjectSelection ``` función CreateObjectSelection(Base de datos, Nombre de usuario, Contraseña:, IDs de Perforación: WideString; Tipo de Perforación: Número entero; Nombre de referencia: WideString; ID de Método: Número entero; Parámetros de Método: WideString): Número entero; ``` Uno o más Objetos se añaden al gestor de Perforación de GeoDin. Opcionalmente, un Método con Parámetros puede ser Iniciado en una Perforación o en un Grupos de Perforación. | Parámetro | Descripción | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Base de datos` | Nombre de Conexión al base de datos, p. ej. "GeoDin COM ejemplo" | | `Nombre de usuario` | Nombre de inicio de sesión de la Base de datos (para Access, un carácter de libre ' ', ¡sin cadena Vacío!) | | `Contraseña:` | Contraseña: de inicio de sesión de la Base de datos (para Access, un carácter de libre ' ', ¡sin cadena Vacío!) | | `Perforación Identificación` | Cadena con una o más entradas de Identificación de Perforación. Estas se interpretan como valores INVID en caso de que el `Tipo de Perforación = 1` o `2`. En caso de que el `Tipo de Perforación = 3` se interpretan como valores ADC\_Identificación. Los INVIDs pueden tomarse de las Tablas LOCREG, FILREG o PRBREG, o construirse según las reglas. Los valores ADC\_Identificación deben estar contenidos en la Tabla ADC\_DATA. Al introducir una sola Identificación, se añade y queda seleccionado un único registro de Perforación. Cuando se introducen varias Identificaciones, estas deben separarse con CRLF (`$0D$0A`) (lista de cadenas de varias líneas). Cuando se añaden varios Objetos, resultan Grupos, que se seleccionan después de ser añadidos. | | `Tipo de Perforación` | Usando `Tipo de Perforación=0` los Objetos se interpretan como una Perforación. Usando `ObjectType=1` los Objetos se agregan como Puntos de medida. Esta opción es especialmente relevante para los INVIDs de la Tabla LOCREG, porque estos pueden ser Objetos o Puntos de medida. Agregando INVIDs de las Tablas FILREG o PRBREG con la `Tipo de Perforación=0` conduce a un error. Usando `Tipo de Perforación=3` Los Documentos se agregan y los IDs se interpretan como ADC\_IDs. | | `Nombre de referencia` | Cuando `Perforación Identificación` contenidos solo una Perforación, este parámetro no está en uso. Para varios Objetos, este parámetro debería contener un nombre de Grupos para simplificar la Navegación del Usuario (si se elige una cadena Vacío, el grupo se nombra "Nuevo grupo"). | | `ID de Método` | Indicación opcional de un ID de Método. Inicia el método correspondiente. Se transfiere como ID de Método -1, si No se ha Iniciado ningún Método. | | `Parámetros de Método` | Solo se usa, cuando `MétodoID <> -1`. Se usa para controlar la llamada sobre el método. Véase [ExecuteMétodoParams](#executemethodparams). | {% hint style="info" %} El Valor de retorno de la función es 0, Cuando se ejecuta la función. El Valor de retorno es 1, Cuando se ha producido un error. Consulte [Valor de excepción](#exceptionvalue) y ExceptionMsg. {% endhint %} ### ListaDeMétodosAsString Funciones para iniciar los métodos de GeoDin. ``` function ListaDeMétodosAsString:string; ``` Devuelve una lista de métodos, que pueden llamarse sobre el objeto seleccionado. La cadena resultado puede constar de varias líneas (separadas por CRLF), donde cada línea es un método. Un ingreso de método consiste en el MétodoID seguido de una coma y el nombre del método (p. ej. `2,Editar gráfica`). El MétodoID puede usarse en el método [ExecuteMétodo](#executemethod). Si no hay ningún Método disponible, la cadena de retorno está Vacío. ### ExecuteMétodo ``` función ExecuteMétodo(MétodoID:Número entero):Número entero; ``` Esta función está Disponible en el módulo Base GeoDin. Otros módulos pueden ser necesarios, dependiendo del Método (p. ej., Logs, Labs...). Los IDs de Método Disponible a través de esta función (y a través de [ExecuteMétodoParams](#executemethodparams)) se documentan en [Parámetros del Método](#method-parameters). {% hint style="info" %} El Valor devuelto por la función es 0, si la función se ejecuta. El Valor devuelto es 1, si ha ocurrido un error. {% endhint %} ### ExecuteMétodoParams ``` función ExecuteMétodoParams(MétodoID:Número entero; MétodoParams: WideString):Número entero; ``` Esta función está Disponible en el módulo Base GeoDin. Otros módulos pueden ser necesarios, dependiendo del Método (p. ej., Logs, Labs...). Inicia un Método de GeoDin con Parámetros. Los ID de Método válidos se describen en [ExecuteMétodo](#executemethod) y en [Parámetros del Método](#method-parameters). {% hint style="info" %} El Valor devuelto por la función es 0, si la función se ejecuta. El Valor devuelto es 1, si ha ocurrido un error. {% endhint %} ### ObtenerImagen Función para crear una Imagen. ``` function GetImage(const Base de datos, Nombre de usuario, Contraseña:, ProjectID: WideString; LocationID: Número entero; const VersionName, LayoutFileName, OutFileName: WideString; ImageType, MaxResolution, Compression, Escala, PageNumber: Número entero; out PageCount: Número entero): OleVariant; ``` {% hint style="info" %} **Nota:** Esta función solo está disponible con una Licencia de servidor GeoDin. Esta característica está disponible en el módulo del servidor de imágenes. {% endhint %} | Parámetro | Descripción | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Base de datos` | Nombre de Conexión al base de datos, p. ej., "GeoDin COM Example" | | `Nombre de usuario` | Nombre de inicio de sesión de la Base de datos (para Access, un carácter de libre ' ', ¡sin cadena Vacío!) | | `Contraseña:` | Contraseña: de inicio de sesión de la Base de datos (para Access, un carácter de libre ' ', ¡sin cadena Vacío!) | | `Identificación de Proyecto` | Identificación del proyecto GeoDin / identificación (6 caracteres) | | `Identificación de Perforación` | Identificación de objeto GeoDin / número de identificación | | `VersionName` | Cadena vacía `''` o las versiones pertinentes de los registros del pozo de sondeo / perfil del suelo y el proyecto de ampliación que se mostrarán. Este parámetro solo es compatible con los tipos de objetos de la autoridad geológica regional bávara (Landesamt). `VersionName` contenidos o bien una cadena Sin carácter de tabulación - entonces aquí se da el Nombre de la Versión del perfil del suelo - O `VersionName` contenidos dos cadenas, conectadas por un carácter de tabulación, a continuación, equivale al Nombre de la Versión del perfil del suelo seguido del Nombre de la Versión del Proyecto de ampliación (`SVVersion+chr(9)+ASBVersion`). En caso de los Tipos de objetos del Landesamt bávaro, los nombres de las versiones están definidos por la PKEY. | | `NombreDelArchivoDeMaquetación` | Nombre de archivo completo / completo del archivo de Seleccionar diseño, p. ej. `"C:\PROGRAMs\GEODIN\Diseños\BOREHO1.GLO"` o `'C:\PROGRAMDATA\GEODIN\DISEÑOS\BOHRPR1.GLO'` | | `Nombre del archivo de salida` | O bien una cadena vacía (No hay archivo creado) o el Nombre de archivo Completo / completo para el Archivo JPG resultante, p. ej. `"C:\SAMPLE1.JPG"` | | `Tipo de imagen` | `1` (=JPG); `2` (=JPG, los datos faltantes o los elementos gráficos incorrectos se muestran con líneas discontinuas, como en la Vista previa); `11` (=PNG); `12` (=PNG, se muestra con líneas discontinuas); `21` (=EMF); `22` (=EMF, se muestra con líneas discontinuas); `31` (=WMF); `32` (=WMF, se muestra con líneas discontinuas) | | `MáxResolución` | Resolución de una imagen de mapa de bits para el lado más largo del formato de papel del diseño elegido, p. ej. 1500 | | `Compresión` | Rango de Valores de 0 a 100. Controla la calidad / compresión de las imágenes JPG y la velocidad / compresión de las imágenes PNG. La Información detallada se da a continuación. | | `Escala` | Escala vertical del objeto en el Seleccionar diseño (sobrescribe los Ajustes en el Seleccionar diseño; las opciones "Proporcional a la hoja" y "Correción automática" no se ven afectadas y pueden conducir a un ajuste automático de la escala; los preajustes en el Seleccionar diseño "Leer de" se ignoran). | | `Número de página` | Número de página a mostrar | | `Número de páginas` | Devolución del número de página de la visualización del objeto Actual en la escala seleccionada | La función devuelve la imagen como OleVariant, de modo que no es necesario un desvío a través de OutFile. ***Nota:*** *El Parámetro `Compresión` no se utiliza en las imágenes EMF o WMF durante la creación.* Si crea una imagen EMF, el Parámetro `MáxResolución` puede utilizarse para controlar la Resolución. Al transferir 0, la Resolución de la imagen EMF se calcula internamente (como una exportación directa desde la interfaz de usuario del programa GeoDin). Si se transfiere un valor `> 0` se ajusta de modo que no se exceda el valor introducido. La imagen resultante puede tener un rango horizontal menor que el valor introducido, porque los Límites de la imagen EMF (Boundary box) se alinean con los elementos gráficos contenidos. Debido a ello, la visualización con el mismo diseño puede dar lugar a imágenes EMF con un rango horizontal diferente para distintos Pozos de observación, mientras que el rango de las imágenes es igual si se crean imágenes de mapa de bits. **Usando el parámetro Compresión:** JPG: calidad y compresión * 0 = baja calidad / alta compresión * 100 = alta calidad / baja compresión Tamaños de ejemplo con `MáxResolución = 1500` para una Página A4 con el diseño estándar "Perfil de perforación": | Compresión | Tamaño en KB | Comentario | | ---------- | ------------ | -------------------------------- | | 0 | 48 | no utilizable | | 25 | 85 | franjas muy intensas | | 50 | 109 | franjas perceptibles | | 75 | 135 | buena visualización | | 85 | 157 | buena visualización | | 100 | 320 | imagen muy clara pero muy grande | PNG: velocidad y compresión * 0 = muy lento / alta compresión * 100 = muy rápido / baja compresión | Compresión | Tamaño en KB | Comentario | | ---------- | ------------ | ------------------------------ | | 0 | 42 | extremadamente lento (>30 seg) | | 25 | 72 | creación eficiente (5 seg) | | 50 | 99 | creación rápida | | 75 | 157 | creación rápida | | 75 | 564 | archivo muy grande | | 100 | 564 | archivo muy grande | Los Valores por encima de 70 no deben usarse; la biblioteca utilizada crea estos archivos PNG defectuosos esporádicamente, de modo que las imágenes no pueden mostrarse con todos los programas. ### Ancho de la gráfica ``` función Ancho de la gráfica:Número entero ``` Devuelve el ancho de la figura, que se creó la última vez que se llamó a GetImage. La función solo debe usarse si en la aplicación llamada no existe la posibilidad de consultar estos Parámetros por sí misma. ### Altura de la gráfica ``` función Altura de la gráfica:Número entero ``` Devuelve la altura de la figura, que se creó la última vez que se llamó a GetImage. La función solo debe usarse si en la aplicación llamada no existe la posibilidad de consultar estos Parámetros por sí misma. ### Número de páginas de la gráfica ``` función Número de páginas de la gráfica:Número entero ``` Devuelve el número de página, que se creó la última vez que se llamó a GetImage o GetPrintFile. Es igual al parámetro de salida Número de páginas de ambas funciones. La función solo debe usarse si la aplicación que llama no puede manejar el parámetro de salida de ambas funciones. ### Información del sistema Función para determinar la Información del sistema. ``` función SysInfo(Parámetro:string):OleVariant; ``` Esta función está Disponible desde Essentials-Edition. Devuelve Información del Sistema dependiendo del Parámetro elegido. Los siguientes Parámetros están Disponible: 1. `SysInfo(GeODinINIFileName)`: devuelve la ruta completa y el nombre de archivo del GeoDin.ini Actual. 2. `SysInfo(ProgramDataDirectorio)`: devuelve la ruta de datos del programa. 3. `SysInfo(ApplicationDirectorio)`: devuelve la carpeta de la aplicación. ## Parámetros del Método Las siguientes secciones describen el `Parámetros de Método` cadenas aceptadas por [ExecuteMétodo](#executemethod) Y [ExecuteMétodoParams](#executemethodparams) para los Métodos individuales de GeoDin (identificados por su MethodID). ### Gestionar datos **ID de Método = 1 (Gestionar datos)** - `Parámetros de Método`: A) sin Ingreso Estadística de datos se ha Iniciado (editor de Sondeos en general); Cuando este Método ya se ha Iniciado, la máscara de datos Actual (Sondeos en general, Datos de capas, etc.) permanece activa. B) Seleccionando la máscara de editor deseada proporcionando una cadena de datos de Parámetro con la forma: ``` [Params] EditType=Número ``` Los números Disponible son: | Número | Máscara de editor | | ------ | ---------------------------------------------------------------------------------------- | | 1 | Sondeos en general | | 2 | Datos de capas | | 3 | Datos de muestras | | 4 | Datos del diseño | | 5 | Medición de pozos de sondeos, sondeos | | 6 | Datos adicionales (1:n), según el Tipo de objeto, p. ej., la tabla de aguas subterráneas | ### Editar gráfica **ID de método = 2 (Editar gráfica)** - `Parámetros de Método`: A) sin Ingreso Se abre la lista de diseño estándar. Se muestra el Diseño actual de la Lista de diseño. B) Introducción de un nombre de archivo (Seleccionar diseño), que debe mostrar el objeto. C) `"Seleccionar diseño:Nombre de diseño"` Se abre la lista de diseño estándar y se selecciona el diseño "layoutname". Opcionalmente, la lista de diseño que se debe utilizar puede describirse como ruta: ``` p. ej.: "Seleccionar diseño:Layoutname|c:\programs\geodin\syslib\geo.gll" ``` E) `"Informe:Reportname"` Se abre la lista de diseño estándar y se selecciona el informe "reportname". Opcionalmente, la lista de diseño que se debe utilizar puede describirse como ruta: ``` p. ej.: "Informe:Reportname|c:\programme\geodin\syslib\geo.gll" ``` ### Abrir gráfica **MethodID = 4 (Abrir Gráfica)** - `Parámetros de Método`: Se espera un nombre de ruta de longitud completa de una gráfica, un diseño o una lista de diseño de GeoDin. El archivo se abre en la ventana gráfica. ### Importar datos **ID del método = 12 (Importar Valores registrados)** - `Parámetros de Método`: ``` [Params] Base de datos= Nombre de usuario= Contraseña:= DatType= ImpTipo= ImpCmdFile= ImpDatFile= | ImpRepArchivo= ``` Se esperan los nombres de los Archivos como una ruta de Longitud Completo. ``` [Fuente de datos] Formato de importación= Campo de grupo 1= Campo de grupo n= Campo de parámetro= Campo de valor= Enlace del punto Mes= [Enlace del punto Mes] = ... ... [Parámetro de origen de datos] = ... ... [Opciones de importación] Agregar registros=Verdadero Actualizar registros=Falso Buscar registros= Tipo de actualización= Redondear números=Falso Cortar texto=Falso Ignorar errores de plausibilidad=Falso Calcular cambios de registro=Falso Protocolo detallado=Verdadero ``` ### Imprimir gráfica O Informe **MethodID = 13 (Imprimir gráfica o Informe)** - `Parámetros de Método`: No ingreso: El impreso se realiza Sin un diálogo de Imprimir Sobre, en la Impresora Actual. Cuando No se abre ninguna Gráfica (Vista de detalle O Vista previa del diseño) O cuando No hay Objetos conectados con El diseño en la Vista previa del diseño, nada queda impreso y se devuelve el Número de error 16. La salida de impresión puede configurarse opcionalmente introduciendo un Bloque de Parámetro: ``` [Opciones de impresión] MostrarDiálogoDeImprimir=Verdadero Se muestra un cuadro de diálogo de Imprimir PrintDevice=DeviceName Impresora a Usar ImprimirNombreDeArchivo=NombreDeArchivo Imprimir a archivo seleccionado ``` **Nombre del dispositivo:** Para la Impresora a Usar, en el GEODIN.INI se debe introducir una Sección con Información de impresora. Ejemplo: ``` [Dispositivos de impresión] PDF=Acrobat PDFwriter Win2PDF=Win2PDF SW=Canon GP300-405 PCL ``` Encontrará una descripción más detallada de esta sección en la información sobre la función "GetPrintFile". `Nombre del dispositivo` debe contener un ingreso válido de esta sección de configuración. **Nombre de archivo:** Si usa el parámetro "PrintFileName", introduzca un nombre de archivo completo. Un archivo existente con el mismo nombre se sobrescribe. Por ejemplo, el bloque de parámetros se vería así, si quiere usar la función de impresión para crear un archivo PDF: ``` [Opciones de impresión] PrintDevice=Win2PDF PrintFileName=C:\GEODINPrints\Ausdruck1.PDF ``` ### Iniciar plugin **MethodID = 14 (Iniciar plugin)** - `Parámetros de Método`: Tiene que transferirse un Bloque de Configuración, que contenidos al menos el Ingreso: ``` [Params] Plug-in= ``` Como **Nombre** debe introducirse el Nombre distintivo de la función del plugin. ***Nota:*** *El tema aquí no es el Parámetro "Nombre", que es visible en el administrador de Perforación como el nombre de la* [*Plugins*](/geodin-desktop/es/integraciones-y-complementos/installing-plug-ins.md)*, pero el nombre de la sección de configuración de este complemento. El complemento tiene que estar configurado y ser ejecutable para la rama (nodo) Actual en el administrador de objetos. Puede ocultarse en la propia lista de métodos (Parámetro "Ocultar" en la configuración del complemento).* Opcionalmente, el bloque de configuración puede contener otra sección con el nombre "PluginParams" y cualquier parámetro. Ejemplo: ``` [Params] Plugin=Función especial [PluginParams] Param1=Mi parámetro 1 Param2=Mi parámetro 2 ..... ``` Esta sección de configuración se transfiere al complemento (solo complementos de servidor COM) completamente y no es analizada por GeoDin. Debido a esto, cualquier parámetro puede transferirse al complemento mediante una llamada a través de la función COM. ### Comprobar datos **MethodID = 53 (Comprobar Valores registrados)** - `Parámetros de Método`: Usar la sección "Regresión" para comprobar Valores registrados usando un análisis de regresión. El Valor `Seleccionar diseño` contenidos el Nombre de la Gráfica de Regresión a ser usada. Más Información a este Método puede encontrarse en el capítulo [Comprobar datos](/geodin-desktop/es/analisis-de-datos/data-checks-and-validations.md) Y en la Descripción [Cálculo de regresión](/geodin-desktop/es/analisis-de-datos/regression-and-curve-fitting.md) del elemento de la serie temporal. **Ejemplo:** ``` [Regresión] Seleccionar diseño=AnalysisLayout1 ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.geodin.com/geodin-desktop/es/integraciones-y-complementos/overview-1/method-reference.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.