IServer
La interfaz IServer crea una instancia nueva del objeto MapForce Server y ofrece acceso al motor de MapForce Server.
Si está usando C++ en una plataforma COM, el nombre de la interfaz principal es IServer. Si está usando un lenguaje .NET, como C# o VB.NET, el nombre de la interfaz principal es Server.
Propiedades
Nombre | Descripción |
|---|---|
De solo lectura. Obtiene la versión principal de la API de MapForce Server. Si la API está conectada a otro servidor, la versión puede diferir de la versión del producto. | |
De solo lectura. Obtiene la versión secundaria de la API de MapForce Server. Si la API está conectada a otro servidor, la versión puede diferir de la versión del producto. | |
De solo lectura. Obtiene la versión de service pack de la API de MapForce Server. Si la API está conectada a otro servidor, la versión puede diferir de la versión del producto. | |
De solo lectura. Devuelve true si el motor de MapForce Server es un ejecutable de 64 bits. | |
De solo lectura. Obtiene el mensaje obtenido durante la última ejecución del comando Run. | |
De solo lectura. Obtiene la versión principal del producto como número de años a partir de 1998 (p. ej. "20" para Altova MapForce Server 2018). | |
De solo lectura. Obtiene la versión secundaria del producto (p. ej. "2" para Altova MapForce Server 2018 r2). | |
De solo lectura. Obtiene la versión secundaria del producto (p. ej. "para Altova MapForce Server"). | |
De solo lectura. Obtiene el nombre completo y la versión del producto (p. ej. "Altova MapForce Server 2018 r2 sp1 (x64)"). | |
Obtiene o establece la ruta de acceso del ejecutable de MapForce Server. | |
De solo lectura. Obtiene la versión de service pack del producto (p. ej. "1" para Altova MapForce Server 2018 r2 sp1). | |
Obtiene o establece el directorio actual para los trabajos que están en ejecución (las rutas de acceso relativas se evaluarán en función del directorio de trabajo). |
Métodos
Nombre | Descripción |
|---|---|
Añade una propiedad a la credencial actual (por ejemplo, el nombre de usuario, la contraseña o ambos). El primer argumento indica el nombre de la propiedad y el segundo su valor. Son nombres válidos de propiedad: username, password. En MapForce Server Advanced Edition también se admite el nombre de propiedad oauth:token.
Se llama a este método después de llamar a BeginCredential() y antes de llamar a EndCredential(). | |
Asigna un valor al parámetro definido en la asignación. El primer argumento especifica el nombre del parámetro tal y como se definió en la asignación. El segundo argumento especifica el valor del parámetro. | |
Crea una credencial nueva con el nombre dado como argumento. Si llama a este método también debe añadirle propiedades usando AddCredentialProperty() y cerrar la credencial llamando a EndCredential(). | |
Borra la lista de credenciales definida previamente. Todas las credenciales son válidas para el objeto mientras este dure. Llame a este método si necesita borrar explícitamente todas las credenciales que haya definido previamente. | |
Borra la lista de opciones previamente establecida con el método SetOption. Todas las opciones establecidas con el método SetOption son válidas para la vida útil del objeto. Llame a este método si necesita borrar de forma explícita todas las opciones previamente establecidas. | |
Borra la lista de parámetros que se definieron previamente con el método AddParameter. | |
Cierra un objeto de credencial creado previamente con el método BeginCredential. | |
Obtiene la cadena de salida generada por el último comando run. Devuelve null si no se generó ningún resultado. Esta función requiere un parámetro de cadena que identifique el nombre que tiene el componente de salida en Altova MapForce. | |
Ejecuta un archivo de ejecución de MapForce Server Execution (archivo .mfx). Devuelve true si se ejecuta correctamente. De lo contrario devuelve false. | |
Establece una opción antes de ejecutar la asignación. El primer argumento especifica el nombre de la opción, mientras que el segundo argumento especifica el valor de la opción. Este método es especialmente útil para asignaciones diseñadas para que consuman recursos globales (véase Recursos globales de Altova). Estas son las opciones compatibles actualmente:
•globalresourcefile (or gr): una ruta de acceso a los archivos de los recursos globales. (Si se indica esta opción también se debe indicar un nombre de configuración de los recursos globales, véase el siguiente punto). •globalresourcefile (or gr): un nombre de configuración de los recursos globales. (Si se indica esta opción también se debe indicar una ruta de acceso a los archivos de los recursos globales, véase el siguiente punto). •catalog: la ruta de acceso a un archivo RootCatalog.xml personalizado. Esta opción permite indicar un archivo de catálogo personalizado para resolver las URL que usa la asignación. El catálogo predeterminado está en el subdirectorio etc del directorio del programa de instalación. •taxonomy-package: la ruta a un paquete de taxonomías XBRL personalizado, si es necesario para la asignación. •taxonomy-packages-config-file: la ruta a un paquete de taxonomías XBRL personalizado, si es necesario para la asignación.
Todas las opciones establecidas son válidas para la vida útil del objeto. Si establece una opción dos veces con el mismo nombre se sobrescribirá la opción anterior. Para borrar de forma explícita todas las opciones, llame al método ClearOptions(). |
Ejemplos
En los siguientes ejemplos se muestra cómo inicializar y ejecutar MapForce Server en varios idiomas: