Manual netWarning Versión: 2.3 Elaborado: AG 6. Configuración Iframes netWarning permite ser insertado dentro de web, de esta forma los usuarios al interactuar con netWarning lo percibirán como parte de su web. Para poder insertar netWarning en su web, es necesario que usted cree dos páginas en su web e inserte un iframe en cada una de estas páginas. Un iframe permite insertar, dentro de una pagina web, una ventana que contiene otra pagina web. Así un iframe permite incluir una página web dentro de otra, a titulo de ejemplo el iframe contenido en el Cuadro-1, inserta www.google.com dentro de otra <iframe src ="http://www.google.com" width="100%" height="300"> <p>Your browser does not support iframes.</p> </iframe> Cuadro-1 página como se muestra en la Figura-9. Más información sobre los Iframes la puede encontrar en la siguiente página: http://www.w3schools.com/tags/tag_iframe.asp Figura-9: Ejemplo Iframe Como ya se ha comentado, usted debe incluir dos páginas en su web. La primera contendrá un iframe que permitirá a los usuarios acceder a su cuenta de netWarning y gestionar sus vigilancias (un ejemplo en la Figura-10). La segunda página contendrá un iframe que mostrará a los usuarios un documento (y el pdf asociado) cuando pulsen el botón “Ver Detalles” al recibir un correo electrónico con vigilancias (un ejemplo en la Figura-11). netWarning_Manual_6 14 de 24 Manual netWarning Versión: 2.3 Elaborado: AG Figura-10: Ejemplo pagina con Iframe para acceso usuarios Figura-11: Ejemplo pagina con Iframe documento Ver Detalles En necesario indicar a netWarning cuales son las páginas de su web que contendrán los dos iframes. Para ello en la pantalla de configuración de Iframes existen dos netWarning_Manual_6 15 de 24 Manual netWarning Versión: 2.3 Elaborado: AG campos para hacerlo (ver Figura-12). A continuación se describe la pantalla de configuración de Iframes. Figura-12: Pantalla Configuración Iframes La pantalla de configuración de Iframes tiene lo siguientes campos: • Link Página Acceso Usuarios: Aquí debe incluir un link a la página que haya creado en su web para que sirva de punto de acceso de usuarios. Mientras crea esta pagina el link por defecto lleva a la página mostrada en la Figura-10. • Código del Iframe para Acceso Usuarios: En este campo puede obtener el Iframe que debe insertar en la página anterior. Es posible cambiar algunas propiedades del Iframe para adaptarlo a su necesidad (ejemplo, mostrar borde o barras de scroll), puede encontrar todas las opciones de configuración de un iframe en la página: http://www.w3schools.com/tags/tag_iframe.asp. Si usted valida a sus usuarios al acceder a su web (mediante nombre de usuario y contraseña), puede resultar molesto, para sus usuarios, el tener que volver a validarse para acceder a su área de gestión en netWarning, en estos casos es posible permitir a los usuarios acceder directamente a netWarning sin necesidad de validarse (como hacerlo se explica un poco más adelante). • Link Página Ver Detalles: Aquí debe incluir un link a la página que haya creado en su web para el iframe Ver Detalles. Mientras crea dicha página el link por defecto lleva a la página mostrada en la Figura-11. • Código del Iframe para Ver Detalles: En este campo puede obtener el Iframe que debe insertar en su página, usted puede cambiar alguna de las netWarning_Manual_6 16 de 24 Manual netWarning Versión: 2.3 Elaborado: AG propiedades del iframe para adaptarlo a su necesidad (ejemplo, mostrar borde o barras de scroll), puede encontrar todas las opciones de configuración de un iframe en la página: http://www.w3schools.com/tags/tag_iframe.asp. Cuando su web reciba un “request” para esta página, debe extraer la cadena con los parámetros del “request” y pasarla al Iframe (esto se explica a continuación). • Botón Salir sin Guardar: Al pulsar este botón se vuelve al panel de control SIN GUARDAR los cambios. • Botón Guardar Cambios y Salir: Al pulsar este botón se GUARDAN los CAMBIOS y se vuelve al panel de control. ¿Cómo permitir a los usuarios acceder directamente a su área de gestión sin tener que validarse? Para que los usuarios accedan a sus páginas de gestión sin tener que validarse es necesario modificar el Iframe para pasarle unos parámetros. Es decir, supongamos que la página de su web, a través de la que acceden sus usuarios a netWarning, fuese la mostrada en la Figura-11. Como se comentaba anteriormente para que aparezca la pantalla de netWarning ha debido insertar en su página un Iframe parecido al del Cuadro-2. <iframe Id="netWarning" runat="server" src="http://netwarning.itelligent.es/Iframe/netWarningUsuariosEntrada.aspx?cc=c2db2b4bf1fb-441f-8639-929463463d2e" width="100%" frameborder="0" scrolling="no"> <p>Hay un problema con su navegador</p> </iframe> Cuadro-2 El campo “src” del Iframe indica la página, de netWarning, que se mostrará dentro del Iframe, a está pagina se le pasa un parámetro denominado cc que en el caso anterior tiene un valor: c2db2b4b-f1fb-441f-8639-929463463d2e, esto indica a netWarning que abra la página de acceso de usuarios del cliente con código (cc) = c2db2b4bf1fb-441f-8639-929463463d2e. Como resultado se mostrará la página de acceso para que el usuario se valide. Si al campo “src” del Iframe se le añade un nuevo parámetro con nombre ca y se le da como valor la clave de acceso directo de un usuario (correspondería a la columna D de la Figura-6), netWarning entenderá que el usuario con dicho código ya ha sido validado y permitirá acceder directamente a su área de gestión. <iframe Id="netWarning" runat="server" src="http://netwarning.itelligent.es/Iframe/netWarningUsuariosEntrada.aspx?cc=c2db2b4bf1fb-441f-8639-929463463d2e&ca=15f36a77-1b3c-4728-9402-94dca65604c1" width="100%" frameborder="0" scrolling="no"> <p>Hay un problema con su navegador</p> </iframe> Cuadro-3 netWarning_Manual_6 17 de 24 Manual netWarning Versión: 2.3 Elaborado: AG Así suponiendo que el usuario ya validado sea el correspondiente a la primera fila en la Figura-6, su código de acceso directo es: 15f36a77-1b3c-4728-9402-94dca65604c1 y el Iframe quedaría como el que se muestra en el Cuadro-3. Con este Iframe la página que se mostraría sería la de la Figura-13 y no la de la Figura-11. Figura-13: Acceso Directo al Panel de Control A continuación se explica como pasar un request al campo “src” de un Iframe, esta explicación también incluye como añadir el campo ca al “src” del Iframe. netWarning_Manual_6 18 de 24 Manual netWarning Versión: 2.3 Elaborado: AG ¿Cómo pasar los parámetros de un request al campo src de un Iframe? Cuando un usuario recibe un correo electrónico con resultados de vigilancias, dispone de la posibilidad de ampliar información pulsando los botones Ver Detalles. Al pulsar un botón Ver Detalles se abrirá la página de su web que usted haya creado para alojar el Iframe de Ver Detalles (es decir la página de su web que correspondería con la Figura-11), esta página recibirá una serie de parámetros a través de la URL Es decir, la pagina de la Figura-11 recibirá en su URL lo que se muestra en el Cuadro-4. http://netwarning.itelligent.es/Iframe/netWarningContenedorVerDetalles.aspx?cc=c 2db2b4b-f1fb-441f-8639-929463463d2e&iddoc=1932173d-9456-4200-9576315cc3296f7c&query=%28consultoria%20investigacion%29 En este caso la cadena con los parámetros es: cc=c2db2b4b-f1fb-441f-8639929463463d2e&iddoc=1932173d-9456-4200-9576315cc3296f7c&query=%28consultoria%20investigacion%29 Cuadro-4 No es necesario que usted conozca el significado de estos parámetros pero si debe ser posible que dicha cadena se la pase desde su página, que es quien la recibe, al Iframe. En el Cuadro-5 se muestra un pequeño ejemplo de cómo hacer esto en C# para una pagina asp.net. En el evento Page_Load de la página de su web que va a contener el Iframe de Ver Detalles debe incluir un pequeño código que pase el contenido del “request” que reciba está página (al pulsar un usuario sobre el botón Ver Detalles de un correo electrónico), al campo “src” del Iframe. Esto es: protected void Page_Load(object sender, EventArgs e) { this.netWarning.Attributes.Add("src", "http://netwarning.itelligent.es/Iframe/netWarningIframeVerDetalle.aspx?"+ Request.QueryString.ToString()); } Cuadro-5 De la misma forma si usted quiere que sus usuarios sean validados de forma automática deberá modificar el Iframe para pasarle el código de acceso directo del usuario (ca). En el Cuadro-6 se muestra un pequeño ejemplo de cómo hacer esto en C# para una página asp.net. netWarning_Manual_6 19 de 24 Manual netWarning Versión: 2.3 Elaborado: AG Si desea que un usuario no vuelva a ser validado en la página de acceso a netWarning, debe hacer lo siguiente: En el evento Page_Load de la página de su web que va a contener el Iframe de Acceso Usuarios debe incluir un pequeño código que modifique el campo “src” del iframe añadiendo el código de acceso directo (ca) del usuario que usted haya validado previamente. Es decir suponiendo que su clave de cliente (cc) sea: c2db2b4b-f1fb-441f8639-929463463d2e y que el cliente que usted ya ha validado tenga una clave de acceso directo (ca) que es: 15f36a77-1b3c-4728-9402-94dca65604c1 y que usted tenga guardada esta clave en una variable tipo GUID con nombre guidCA, entonces el código que debe incluir es el siguiente:: protected void Page_Load(object sender, EventArgs e) { this.netWarning.Attributes.Add("src", "http://netwarning.itelligent.es/Iframe/netWarningIframeVerDetalle.aspx?cc=c2db2b4bf1fb-441f-8639-929463463d2e"+ “&ca=” + guidCA.ToString(); } Cuadro-6 netWarning_Manual_6 20 de 24