Introducción
El presente manual ofrece una guía para la configuración del servicio “Dirección a Coordenadas” de forma básica con un ejemplo simple en el Formato Electrónico. La complejidad de las configuraciones dependerá del usuario final.
Objetivo
Guiar al usuario a la configuración del servicio de “Dirección a Coordenadas” en el Formato Electrónico mediante una descripción detallada e ilustrada de las opciones y funcionamiento.
Con el fin de facilitar la comprensión y configuración del servicio, se recomienda consultar este manual antes y/o durante la configuración de este.
- Nota: El manual estará constantemente actualizándose.
IDPortal
Ingreso al sistema
Para ingresar la página de acceso del sistema, se debe capturar la dirección URL en la barra de direcciones de su navegador e ingresar con las credenciales correspondientes:
- Usuario/ID: usuario proporcionado
- Contraseña: clave de acceso
Y damos clic en el botón “Autenticar”
Si los datos proporcionados fueron correctos el sistema mostrará la pantalla principal del ID Portal.
Acceso a la plantilla
Para tener acceso a el servicio, primero se debe de tener un documento electrónico listo para poder crear la plantilla. Para tener acceso a la plantilla seguimos los siguientes pasos:
- En la pantalla principal del ID Portal damos clic en “Menú”
Posteriormente entramos al Configurador > Configuración de Proyectos.
Damos doble clic en “Archivo” y entramos a la base cliente donde se tenga creado el documento electronico, en este caso es la base cliente “DGPNomina”
En la base cliente seleccionamos “Estructura de Documentos”
Seleccionamos el expediente en donde se encuentre el documento electrónico y damos clic en “Configurar Plantilla”
Si los pasos se realizaron correctamente el sistema muestra el Configurador de Plantillas
Configuración
Requerimiento de la plantilla
A continuación, se enlistarán lo necesario para realizar la configuración de este servicio:
- Elementos
- Página
- Cuatro elementos de tipo Texto Lineal
- Botón
- Servicios:
- “Dirección a Coordenadas”
- Reglas:
- Ejecutar el servicio de “Dirección a Coordenadas”
Elementos
Como primer paso se selecciona el elemento “Página” ubicado en la pestaña “Elementos”
El elemento se mostrará en la pantalla de la plantilla.
- Nota: El nombre de la página se da de manera automática
Para cambiar el nombre de la página damos clic en los Atributos del Elemento , nos dirigimos a la pestaña “General” y en el campo de texto “Titulo” cambiamos el nombre, en este caso la llamaremos “Dirección a Coordenadas”.
Seleccionamos la página y agregamos los cinco elementos de tipo “Texto lineal” ubicados en la pestaña “Elementos”
Entramos a los Atributos del Elemento del elemento “Texto lineal”, nos dirigimos a la pestaña “General” y en el campo de texto “Titulo” cambiamos el nombre de los elementos:
El primer Texto lineal llevará por nombre “Dirección”
El segundo Texto lineal llevará por nombre “Latitud”
El tercer Texto lineal llevará por nombre “Longitud”
El cuarto Texto lineal llevará por nombre “Latitud y Longitud”
Para agregar el elemento “Botón” nos dirigimos a la pestaña “Elementos” y seleccionamos el elemento “Botón”
Servicios
Para comenzar la configuración primero hay que observar el JSON del servicio.
En donde toman tres valores importantes.
- initialmethod: nombre del método del servicio,
- assemblypath: nombre de la dll que va a utilizar el servicio.
- dirección: valor de entrada del servicio
Para agregar el servicio, vamos a la pestaña “Archivo” y damos clic en el botón “Servicios”
El configurador nos abre el modal de “Servicios Genéricos”, damos clic en el botón “Agregar”
El servicio se agrega, damos clic en el icono y cambiamos el nombre a “Servicio de Dirección a Coordenadas”.
Seleccionamos el servicio y en la sección “Nombre del método del servicio” agregamos el valor del initialmethod del JSON: “ServiciosDigipro.ServicioSepomex. DireccionACoordenadas”.
En la sección “Ruta de la dll que ejecutará el servicio” agregamos el valor del assemblypath del JSON “ServiciosDigipro.dll”
En la sección “Prefijo que se utilizara para identificar los campos de entrada” agregamos el prefijo “DCEntrada_”.
Por último, en la sección “Prefijo que se utilizara para identificar los campos de salida” agregamos el prefijo “DCSalida_”.
Ahora hay que identificar los elementos de texto para importar o exportar los datos del servicio. Nos dirigimos a los atributos del elemento , seleccionamos la pestaña “General” y en el campo de texto “ID único” agregamos lo siguiente:
- El elemento de texto “Dirección” será nuestro elemento de entrada por lo que se le agrega el prefijo “DCEntrada_” seguido de la palabra “dirección” de la siguiente forma:
El elemento de texto “Latitud” será uno de los elementos de salida, por lo que se le agrega el prefijo “DCSalida_” seguido de la palabra “lat1” de la siguiente forma:
El elemento de texto “Longitud” será el segundo de los elementos de salida, por lo que se le agrega el prefijo “DCSalida_” seguido de la palabra “lon1” de la siguiente forma:
El elemento de texto “Latitud y Longitud” será el último de los elementos de salida, por lo que se le agrega el prefijo “DCSalida_” seguido de la palabra “latlon1” de la siguiente forma:
Regla
Como último paso vamos a añadir la regla que ejecutará el servicio de “Dirección a Coordenadas”, nos dirigimos a la pestaña “Archivo” y damos clic en el botón “Reglas”.
El configurador nos muestra el modal “Reglas”, para agregar la regla damos clic en el botón “Agregar”.
La regla se agrega en la parte izquierda del modal, damos clic en el icono y cambiamos el nombre de la regla a “Regla Servicio Dirección a Coordenadas”.
Nuestro servicio se va a ejecutar cuando se dé clic en el botón, para esto lo configuramos la regla de la siguiente forma:
- En el combo-box de la sección de “Condiciones” seleccionamos “Todas”:
En el combo-box “Categoría” seleccionamos “Elementos”
Y en el combo-box siguiente seleccionamos “Botón” > “Al dar clic”
En la columna “Acción” de la sección “Ejecutar las siguientes acciones” seleccionamos la opción “Ejecutar Servicio”.
En la columna “Al” seleccionamos el servicio “Servicio Dirección a Coordenadas”
Damos clic en “Cerrar” y guardamos la plantilla.
Plantilla finalizada
Para comprobar que el servicio y la regla se configuró de manera correcta seguiremos los pasos:
- Nos dirigimos a el “Menú” > Base Cliente “DGP Nómina” > “Digitalización” > “Nuevo Documento Electrónico”
En “Tipo de Expediente” seleccionamos el nombre de nuestro expediente, en este ejemplo “PruebaFormatoFat”
Agregamos un valor a “Dirección” y damos clic en el botón.
Al dar clic en el botón se visualizan los datos de salida del servicio junto con un modal de “Éxito” en la parte inferior derecha de la pantalla.
NOTA: En caso de que el servicio no este correctamente configurado, el sistema nos muestra un aviso en la parte inferior derecha de la pantalla.