Cómo conectarse a la Base de Datos de MonitorPro para generar Reportes.
Una de las formas más sencillas de extraer datos desde MonitorPro para utilizarlos en otros sistemas de reportes, o para una integración posterior general, es conectarse directamente a la Base de Datos de MonitorPro en SQL Server.
Para el caso de reportes, recomendamos el uso de procedimientos almacenados "report_ stored procedures" (se incluye una lista completa de los reportes disponibles al final de este artículo). Estos procedimientos almacenados se han diseñado específicamente para generar datos en varios formatos útiles para los reportes que necesita. Contienen todos los campos básicos, como Ubicación, Punto de Muestreo, Variable/Parámetro, Fuente de Datos, Fecha y Hora, etc. A su vez, están nombrados de tal manera que dan una buena indicación de su contenido. También podrá conectarse y obtener una vista previa de los datos con el fin de confirmar que el procedimiento contenga los campos que usted necesita. Si no está seguro, o cree que necesita campos personalizados que no se encuentran en estos procedimientos almacenados, comuníquese con support@ehsdata.com.
Si bien puede conectarse directamente a las tablas de la base de datos, como la base de datos es relacional y los datos están normalizados, sin un conocimiento completo del esquema de la base de datos, incluso la vinculación básica de tablas podría resultar dificultoso. La ventaja de utilizar procedimientos almacenados es que no necesitará hacer esto, ya que estos procedimientos hacen el trabajo por usted. El único enlace de tabla directo que deberá especificar es el ID del Dataset o de la Selección Almacenada (ISelectionID), lo cual se explica más adelante.
Conexión
Para este propósito, se pueden crear usuarios específicos o se pueden utilizar las credenciales de los usuarios existentes que tengan acceso a MonitorPro. Si se va a utilizar una cuenta dedicada, entonces deberá asignarle el Rol "Monitor Reporting". Este Rol tiene acceso limitado a las tablas y a las funciones particulares que se utilizan específicamente para los informes, y no puede acceder a otras tablas del sistema que normalmente no se requieren.
Cuando MonitorPro está alojado en el servidor del cliente (Self-Hosted), garantizar que se realicen las aceptaciones de firewall necesarias y asegurar el acceso entre MonitorPro y el nuevo sistema será responsabilidad del departamento de IT del cliente. Si MoniorPro está alojado en los servidores de EHS Data, póngase en contacto con support@ehsdata.com, con el fin de proporcionarle una dirección IP para la conexión y una cuenta de usuario para la autenticación. A su vez, requeriremos que el cliente nos proporcione una dirección IP Fija desde la cual se realizarán las llamadas y se realizará una excepción de firewall específica en nuestros servidores entre los puntos finales.
Devolver y Filtrar Datos
Una vez establecida la conexión, las dos bases de datos se podrán comunicar entre sí. Los procedimientos almacenados se pueden ejecutar, simplemente a través del ISelectionID. Los datos que se devuelven, el rango de fechas, las ubicaciones, etc. estarán controlados por el ISelectionID. El procedimiento almacenado simplemente controla el formato, los datos asociados y cualquier lógica de procesamiento incluida.
Los distintos ISelectionID no cambiarán y los datos ofrecidos seguirán siendo aquellos contenidos dentro de la selección almacenada. Las selecciones almacenadas que se utilizan para este propósito deben contener rangos de fechas dinámicos o rangos de fechas amplios para conservar los datos entrantes. A su vez, deben ser lo suficientemente amplios como para permitir un mayor nivel de filtrado, pero no tan grandes como para afectar el rendimiento del sistema a largo plazo. Tenga en cuenta que se pueden realizar selecciones adicionales y conectarlas al sistema en cualquier momento.
A continuación podrá ver el listado completo de procedimientos almacenados (report_stored procedures):
• report_001_SelectedData
• report_001_SelectedLocations
• report_003_SelectedVariables
• report_003a_SelectedSources
• report_003b_SelectedSampleTypes
• report_005_Data_Basic
• report_005_Data_Basic_AdditionalFields
• report_005v_Data_Basic_VariableOrder
• report_005vs_Data_Basic_VariableSamplePointOrder
• report_005vs_Data_Basic_VariableSamplePointOrderPreordered
• report_005vsd_Data_Basic_VariableSamplePointOrderDummy
• report_005x_Data_Deleted
• report_006_Data_Extended
• report_006a_Data_Extended_ComplianceGridsOnly
• report_006a_Data_Extended_ComplianceGridsOnlyBroken
• report_006avs_Data_Extended_ComplianceGridsOnly_VariableSamplePointOrder
• report_006b_Data_Extended_AllComplianceTypes
• report_006b_Data_Extended_CompliancePivot
• report_006b1_Data_Extended_AllComplianceTypes_ImportanceWarning
• report_006b2_Data_Extended_AllComplianceTypes_ImportanceInternal
• report_006b3_Data_Extended_AllComplianceTypes_ImportanceBreach
• report_006b4_Data_Extended_AllComplianceTypes_ImportanceHighPriorityBreach
• report_006c_Data_Extended_AllComplianceTypes_Incl_Metadata
• report_007_Exceedences
• report_007a_Exceedences_ComplianceGridOnly
• report_007b_Exceedences_AllComplianceTypes
• report_008_Data_Basic_By_Group
• report_008_Data_Basic_by_Grp
• report_008x_Data_Basic_By_Group_Extended
• report_009_Data_Basic_By_Suite
• report_010_Aggregates
• report_010_DataImportedYesterday_Detail
• report_010_DataImportedYesterday_DetailWithThresholds
• report_010a_Aggregates_ComplianceGridsOnly
• report_010b_Aggregates_AllComplianceTypes
• report_011_Extended_Incl_Suites
• report_011a_Extended_Incl_Suites_ComplianceGridsOnly
• report_011b_Extended_Incl_Suites_AllComplianceTypes
• report_012_Exceedences_Raw_Data
• report_012a_Exceedences_Raw_Data_ComplianceGridsOnly
• report_012b_Exceedences_Raw_Data_AllComplianceTypes
• report_013_Data_Basic_Monitoring_Performance_Report
Para obtener un lSelectionID con los datos que necesita, puede ser útil conectarse directamente a la tabla tblSelection.
Puede ubicar el lSelectionID que necesita utilizando el sSelectionstorename (nombre común que visualiza el usuario en MonitorPro) como un filtro en su consulta o query.
Campos de Información
La mayoría de las veces, los procedimientos almacenados "report_ stored procedures" ofrecerán los campos que usted necesita, incluyendo todos los campos básicos. A continuación se describirán los nombres de los campos más utilizados. En la mayoría de los casos, los nombres son precisos y familiares para cualquier usuario de MonitorPro. Algunos campos tendrán una denominación larga y otra corta, las cuales se relacionan con los nombres largos y cortos de MonitorPro.
Values - Los valores se almacenan en el campo numérico Data_Value y en el campo de texto Data_Text_Value. Elija el campo que necesite, por ejemplo, para crear gráficos debería utilizar el campo Data_Value.
Site_Long_Name y Site_Short_Name - Es el nivel principal de organización de los puntos de muestreo, también conocido como Location o Monitoring Type. Este campo también se puede utilizar como un atajo, combinando el nombre del Site con el nombre corto del punto de muestreo.
Sample_Point_Long_Name y Sample_Point_Short_Name - Son los puntos de muestreo, es decir, las ubicaciones individuales en donde se almacenan los datos.
Variable_Long_Name y Variable_Short_Name - Es la substancia, variable o parámetro que se está monitoreando. El campo Measure es un atajo útil, ya que es un campo que combina el nombre de la Variable con la Unidad de medida. La unidad también se puede seleccionar por separado a través del campo Unit.
Selection End and Start Dates - Es el intervalo de tiempo de la selección almacenada subyacente. En MonitorPro se pueden configurar periodos de tiempo dinámicos o fijos.
Data_Source_Name - Indica la fuente u origen de los datos. Se utiliza para diferenciar la fuente de los datos (por ejemplo, datos de campo o de laboratorio). Es posible que los datos de la selección ya se encuentren refinados, pero de ser necesario podrá refinar aún más los datos en Tableau utilizando este campo.
Sample_Date - Indica la fecha y la hora en la que una muestra ha sido recolectada o en la que se ha registrado el valor de una variable.
Variantes
Hay algunas variantes en cuanto a la salida de reportes que se pueden proporcionar. Entre algunos ejemplos se encuentran las exportaciones de datos basadas en la fecha de actualización de los datos, para que los datos se puedan compartir con otros sistemas cuando se modifican o se actualizan dentro del sistema.
La conexión con Sistemas de Información Geográfica (GIS) es otro ejemplo en el que la información de localización actualizada se puede compartir con las aplicaciones GIS del cliente.
Si alguna de estas opciones es de su interés, por favor comuníquese con support@ehsdata.com.