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. 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 y en Instalando complementos.
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=<Directorio> en la Sección [Sistema] del Archivo de Configuración GeoDin.ini se puede definir otro Directorio.
Disponibilidad de complementos
Como estándard Complementos no se cargan cuando GeoDin está Iniciado. Al introducir COMServerPlugins=Verdadero en la Sección [Sistema] del Archivo de Configuración GeoDin.ini 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:
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.
Nota: Cuando el Nombre del Directorio contenidos espacios Vacíos, el Parámetro completo ha de ponerse entre comillas, p. ej.:
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:
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.
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:
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:
o
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:
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 "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:
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:
Significado: El complemento se muestra solo en los proyectos abiertos de la base de datos "Boreholedatabase".
Ejemplo 3:
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:
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.
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
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
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
Vacío
en todos los proyectos
PRJID
solo en Proyectos con la Identificación introducida
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
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:
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:
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.
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.
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:
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:
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:
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:
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:
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.
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.
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.
(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.
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.
Esta función está disponible a partir de la edición Essentials.
La respuesta contiene información sobre GeoDin y los módulos disponibles.
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.
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.
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
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 y ExceptionMsg.
SeleccionarPerforación
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:
Los Parámetros tienen el siguiente significado:
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.
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 y Excepciones.
CreateObjectSelection
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.
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.
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 y ExceptionMsg.
ListaDeMétodosAsString
Funciones para iniciar los métodos de GeoDin.
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. Si no hay ningún Método disponible, la cadena de retorno está Vacío.
ExecuteMétodo
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) se documentan en Parámetros del Método.
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.
ExecuteMétodoParams
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 y en Parámetros del Método.
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.
ObtenerImagen
Función para crear una Imagen.
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.
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":
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
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
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
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
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.
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:
SysInfo(GeODinINIFileName): devuelve la ruta completa y el nombre de archivo del GeoDin.ini Actual.SysInfo(ProgramDataDirectorio): devuelve la ruta de datos del programa.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 Y ExecuteMétodoParams 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:
Los números Disponible son:
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:
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:
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:
Se esperan los nombres de los Archivos como una ruta de Longitud Completo.
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:
Nombre del dispositivo:
Para la Impresora a Usar, en el GEODIN.INI se debe introducir una Sección con Información de impresora. Ejemplo:
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:
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:
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, 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:
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 Y en la Descripción Cálculo de regresión del elemento de la serie temporal.
Ejemplo:
Última actualización
¿Te fue útil?