Pasarela Web

Guía de Usuario Parte 8
Pasarela Web
Status Enterprise
Pasarela Web
Contenidos
1
RESUMEN
1.1
Especificaciones/Requerimientos de la Pasarela ................................................................. 3
1.2
Soporte para Dispositivos Móviles ........................................................................................ 4
1.3
Conectando a la Pasarela .................................................................................................... 4
1.4
Arquitectura ........................................................................................................................... 4
1.5
Características Soportadas y Limitaciones .......................................................................... 5
1.5.1
Características Soportadas ............................................................................................... 5
1.5.2
Ontroles UI Soportados ..................................................................................................... 5
1.5.3
Espacios de Trabajo y Seguridad ...................................................................................... 8
1.5.4
Restricciones ..................................................................................................................... 8
2
PERSONALIZANDO EL INICIO DE SESIÓN PARA LA PASARELA...................................................... 10
2.1
Ajustes de Inicio de SesiónAutomático .............................................................................. 10
2.2
Fijando una Ruta para el “Mimic” por Defecto. ................................................................... 11
2.3
Método de Navegación Recomendado .............................................................................. 13
2.4
Cambiando el Servidor de la Pasarela ............................................................................... 13
2.5
Creando una Página de Inicio de Sesión Personalizada. .................................................. 15
2.6
Moviendo la Pasarela a otro Sitio Web IIS ......................................................................... 16
2.6.1
Borrar la Pasarela desde el Sitio Web Actual en IIS ....................................................... 16
2.6.2
Añadiendo la Pasarela a un nuevo Sitio IIS .................................................................... 17
3
RESOLUCIÓN DE PROBLEMAS ................................................................................................... 18
3.1
Elementos Truncados ......................................................................................................... 20
1
Status Enterprise
Pasarela Web
Imágenes y Tablas
Imagen 1 – Especificaciones/Requerimientos .............................................................................................. 3
Imagen 2 – Pantalla de Configuración de IIS ............................................................................................. 10
Imagen 3 – Pantalla de Ajustes de Aplicaión.............................................................................................. 11
Imagen 4 – Administrador de IIS. ............................................................................................................... 12
Imagen 5 – Ruta del “mimic” por Defecto ................................................................................................... 12
Imagen 6 – Ajustes de Aplicación ............................................................................................................... 13
Imagen 7 – Ruta del Servidor en la Pasarela ............................................................................................. 14
2
Status Enterprise
Pasarela Web
1 Resumen
Este documento define las líneas generales de la experiencia de la interfaz de usuario para el entorno de
ejecución basado en Web de Status Enterprise conocido como Pasarela o Gateway. La Pasarela o
Gateway es una aplicación ASP.NET que conecta con el servidor de Status Enterprise y convierte los
“mimics” almacenados como XAML en el servidor, en documentos HTML 5 para un navegador Web. Los
“Mimics” abiertos tienen conexiones a datos en tiempo-real. La mayoría de los navegadores y
dispositivos móviles – incluyendo el Ipad – soportan HTML5.
Para una lista de los términos frecuentes, definiciones y abreviaturas, por favor mira la Parte 1 –
Resumen y Conceptos Básicos.
NOTA: A fin de que la aplicación de Pasarela funcione, IIS debe de estar instalado antes de que Status
Enterprise esté instalado.
1.1
Especificaciones/Requerimientos de la Pasarela
XP
7&8
IIS Debe de estar instalado.
*Pasos:



Abre el “Activar o Desactivar características de Windows”
Habilita “Internet Information Services”
Expande “Internet Information Services\Servicios World Wide Web \Características de
Desarrollo de Aplicaciones \” y habilita “ASP.NET 4.5”
Haz clic en “OK”

*Si tu no tienes permisos para editar las características de Windows, contacta
tu administrador de red.
Despues de la instalación de IIS tu necesitas ejecutar el ejecutable RegIIS
lozalizado en “%WindowsDir%\Microsoft.NET\Framework\v4.0.30319\...”
llamado “aspnet_regiis.exe”.
*Si tienes un SO de 64 bits, reemplaza Framework por Framework64.
En el administrador de IIS el “Pool” de Aplicaciones debería ser fijado como
sigue:
IIS > ApplicationPools > Advanced Settings
 .NET Framework Ver = v4.0
 Identity = Network Service
Navegadores soportados:
Navegadores soportados:
 Mozilla Firefox
 Internet Explorer
 Google Chrome
 Google Chrome
**Preferentemente**
**Preferentemente**
 Mozilla Firefox
 Safari
 Opera
Imagen 1 – Especificaciones/Requerimientos
3
Status Enterprise



1.2
Pasarela Web
Cuando ejecutes IIS 8 y Windows Server 2012, es extremadamente recomendado que tu instales
el Protocolo WebSocket desde las características y roles del servidor.
Las reglas de entrada/salida del Firewall TIENEN que ser especificamente fijadas para el
ejecutable del servidor (StatusEnterpriseServer.exe) por cada zona sobre la que esperes enviar
datos.
Los archivos estáticos js deberían de usarse en modo usuario y modo Kernel cacheando para
reducir el tiempo de carga de las páginas.
Soporte para Dispositivos Móviles
La pasarela Status Enterprise puede ser accedida a través de iPads, Iphones y cualquier dispositivo
móvil que soporte HTML5, permitiendo el acceso móvil directamente a tus “mimics” y datos en vivo sin la
necesidad de conectar con un cliente remoto via VPN.
1.3
Conectando a la Pasarela
La primera vez que un usuario intenta acceder a la Pasarela, se efectúa una comprobación para
asegurar que IIS está instalado y configurado en tu sistema. Si IIS no está instalado, al usuario se le
solicitará que esta instalación sea completada antes de usar la Pasarela Status Enterprise. Si IIS está ya
instalado, el cliente de la Pasarela ejecutará un testeo del administrador de IIS para comprobar que está
configurado correctamente. Si no, la configuración será comletada automáticamente antes de que al
usuario se le de la oportunidad de iniciar sesión.
Tu Administrador de Red te proveerá de la dirección web para iniciar sesión en la Pasarela Status
Enterprise. La URL por defecto es http://localhost/StatusEnterpriseGateway y usa el puerto 4502. La
página de inicio de sesión te preguntará por el nombre de usuario y la contraseña. Después de haber
iniciado sesión se te presentará un sistema de navegación en el cual tu podrás navegar a través de las
carpetas hasta el documento que desees abrir – el “path” actual a la carpeta que estás, es presentado en
la parte de abajo de la pantalla y hay un botón atrás para subir un nivel.
Un nombre de usuario y contraseña puede ser introducido en la Pasarela a través del archivo
“web.config” a fin de que la pasarela inicie con un usuario automáticamente.(Esto podría ser
especialmente util en caso de que tengas una cuenta de usuario público con la pasarela alojada en el
servidor web). También podemos añadirle una ruta para el documento en el mismo lugar cuando los
usuarios tienen que iniciar sesión sobre un “mimic” específico.
1.4
Arquitectura
La Pasarela Status Enterprise inicia sobre el Servidor Status y mantiene la sesión para tu cliente web
cuando tu tienes la sesión iniciada. La Pasarela hace peticiones al “mimic” desde el servidor usando el
documento elegido a través del sistema o especificado en el archivo “web.config”. Cuando el documento
sea pasado a la Pasarela, esta lo convierte en un documento desde el formato nativo de los “mimics”
XAML a un documento HTML5. El HTML es devuelto al cliente para mostrarse en un navegador web. Un
“socket” de conexión web es creado entre la Pasarela y el cliente. Cualquie gráfico en el documento
HTML5 que contenga enlaces a datos en vivo es actualizado a través del “socket” de conexión hacia la
Pasarela.
4
Status Enterprise
1.5
Pasarela Web
Características Soportadas y Limitaciones
1.5.1 Características Soportadas
Los “Mimics” ejecutandose en la Pasarela podrán tener casi toda la funcionalidad que tendrían en el
cliente de entorno de ejecución. Todos los controles de navegación son soportados. Todos los enlaces a
Datos son soportados, incluyendo los enlaces de dos direcciones, y continuarán actualizando con datos
en vivo y aceptando las propiedades escritas desde el “mimic”. Las Tendencias también son soportadas,
tanto las históricas como las que funcionan con datos en tiempo real.
Los Controles de Alarmas actualmente no están soportados, así que mientras tus datos estén en tiempo
real y tus alarmas estén monitorizando los cambios, no verás los controles de alarma desde la Pasarela
Web.
1.5.2
Ontroles UI Soportados
Los Documentos XAML que están destinados para la conversión a HTML tienen que usar un
subconjunto de Controles UI disponibles en el Diseñador de “Mimics”.Estos incluyen:
1.5.2.1
Botones

Flat Toggle Switch

Gel Toggle Button

Generic Toggle Button

Industrial Toggle Button

Power Toggle Button

Toggle Switch
1.5.2.2
Controles Comunes

Check Box

Label

Text Block
1.5.2.3
Controles de Fecha y Hora

Date Time Display
1.5.2.4
Gauge Controls

Dual Gauge

Dynamic Gauge

Horizontal Linear Gauge

Parabolic Gauge

Racing Gauge
5
Status Enterprise

Radial Gauge

Simple Gauge

Variable Gauge

Vertical Linear Gauge
1.5.2.5

1.5.2.6

1.5.2.7

1.5.2.8
Pasarela Web
Paneles y Cuadrículas
Canvas
Controles Indicadores
Indicator Tower Three State
Entrada
Data Text Box
Etiquetas

Data Label

Variance Label
1.5.2.9
Display LED

LED Five By Seven Matrix

LED Light

LED Seven Segment

LED Sixteen Segment
1.5.2.10 Media

Bindable Image
1.5.2.11 Controles de Miscelanea

Ratings Control
1.5.2.12 Motores y Ventiladores

Centrifugal Pump
6
Status Enterprise

Gear

Heavy Motor

Helical Motor

Metal Fly Wheel

Paddle Wheel

Simple Fan

Small Fly Wheel

Sprocket

Square Motor

Tire

Wind Generator
Pasarela Web
1.5.2.13 Botones de Navegación

Gel Navigation Back Button

Gel Navigation Button

Navigation Back Button

Navigation Border

Navigation Button

Navigation Combo

Navigation List
1.5.2.14 Tanques y Tuberías

Connector Pipe

Cutaway Tank

Cylinder Tank

Fitted Elbow Pipe

Fitted Pipe

Funnel Tank

Indicator Tank

Ladder Tank

Mixing Tank

Standard Elbow Pipe

Standard Pipe

Universal Pipe Connector

Valve
7
Status Enterprise

Pasarela Web
Vessel Tank
1.5.2.15 Formas

Ellipse

Line

Path

Polygon

Polyline

Polygon and Polyline Pencil

Rectangle
1.5.2.16 Tendencias

Trend Graph

Graph Pen
1.5.3 Espacios de Trabajo y Seguridad
La configuración de Seguridad y los espacios de trabajo de tu modelo de datos son aplicables cuando
ejecutas los “Mimics” en la Pasarela Web. Tu actividad de inicio de sesión es monitorizada por el Status
Server. Los espacios de trabajo de los que eres miembro serán aplicados en tu inicio de sesión web. Las
propiedades a las que no tenas acceso basandonos en tu espacio de trabajo no se actualizarán.
1.5.4
Restricciones
Como se ha mencionado arriba, hay ciertos controles en el “toolbox” del Diseñador “mimics” que no son
compatibles con la Pasarela Web. Una lista de los controles compatibles se puede encontrar en la
sección 1.5.2.
Usando la Pasarela para ejecutar un “mimic” que contiene controles no soportados no evitará que el
“mimic” funcione pero tu no verás los controles no soportados en la pantalla. En vez de eso un marcador
genérico será mostrado. Todos los controles compatibles funcionarán con normalidad.
Las alarmas no están disponibles en la Pasarela Web, y las Tendencias están disponibles con soporte
limitado.
Los “mimics” en la pasarela pueden ser vistos en cualquier navegador que soporte HMTL5, incluyendo
las versoines actuales de los siguientes navegadores:





Internet Explorer
Chrome
Firefox
Opera
Safari
La mayoría de los navegadores móviles han adoptado el estandar HTML5, sin embargo la compatibilidad
de algunas características ha sido reportado que puede variar de un dispositivo a otro. Tu podrías querer
testear la compatibilidad de tu dispositivo con HTML5 antes de usar la Pasarela Web. A la fecha de
8
Status Enterprise
Pasarela Web
escritura de este manual, los siguientes navegadores móviles soportan HTML5:










Safari iOS
Android Browser
Google Chrome
Amazon Silk
Blackberry Browser
Nokia Browser
Internet Explorer
Opera Mobile
Opera Mini
Firefox
9
Status Enterprise
Pasarela Web
2 Personalizando el Inicio de Sesión para la Pasarela
2.1
Ajustes de Inicio de SesiónAutomático
Esta sección describe como ajustar la Pasarela para saltar la pantalla de inicio de sesión usando las
credenciales predefinidas.
Requerimientos:

En el archivo Web.config, las variables “Nombre de usuario” y “Contaseña” tienen que estar
fijadas con las correctas credenciales, y el ajuste “Inicio de Sesión Automático” necesita estar
fijado a un valor de ‘Si’.
Ejemplo:
 Abre IIS, selecciona la Aplicación “StatusEnterpriseGateway” y después selecciona la
característica “Ajustes de Aplicacion”.
Imagen 2 – Pantalla de Configuración de IIS
10
Status Enterprise

Pasarela Web
Fija “Inicio de Sesión Automático” a ‘Si’, y el ‘Nombre de usuario’ y la ‘Contraseña a las
credenciales que corresponde.
Imagen 3 – Pantalla de Ajustes de Aplicaión

2.2
Ahora cuando abras la pasarela, automáticamente iniciará sesión con el usuario predefinido.
Fijando una Ruta para el “Mimic” por Defecto.
Esta sección describe como fijar un “mimic” por defecto para mostrar para el usuario que inicie sesión en
vez de la pagina de navegación del modelo.
Requerimientos:
 La variable DefaultMimicPath en el archivo Web.config debe ser fijada a una ruta válida.
Ejemplo:
 Abre IIS, selecciona la aplicación “StatusEnterpriseGateway” y después selecciona la
característica “Ajustes de Aplicación”.
11
Status Enterprise
Pasarela Web
Imagen 4 – Administrador de IIS.

Fija “DefaultMimicPath” a una ruta válida para el “mimic” que quieres mostrar.
Imagen 5 – Ruta del “mimic” por Defecto
12
Status Enterprise

2.3
Pasarela Web
Ahora cuando inicies sesión en la Pasarela, este “mimic” será mostrado en vez del sistema de
navegación.
Método de Navegación Recomendado
La Pasarela Status Enterprise incluye un menú de navegación. El menú es presentado después del inicio
de sesión. Este menú proveerá de acceso rápido a todo el “mimic”, y a Activos, pero no es el método
recomendado de navegación. La Buena Práctica sería crear una Página de Inicio con botones de
navegación hacia otros “mimics” necesarios.
2.4
Cambiando el Servidor de la Pasarela
Esta sección define como especificar a que Servidor de Pasarela Web nos conectamos:
Requerimientos:
 La variable ‘StatusEnterpriseServer’ en el archivo Web.config debe de tener fijada una ruta hacia
el servidor.
Ejemplo:
 Abre IIS, selecciona la Aplicación “StatusEnterpriseGateway” y después selecciona la
característica “Ajustes de Aplicación”.
Imagen 6 – Ajustes de Aplicación
13
Status Enterprise

Pasarela Web
Fija “StatusEnterpriseServer” a una ruta válida en el Servidor Status Enterprise.
Imagen 7 – Ruta del Servidor en la Pasarela

Ahora la Pasarela se conectará al servidor de cualquier modo en vez de a tu máquina local.
14
Status Enterprise
2.5
Pasarela Web
Creando una Página de Inicio de Sesión Personalizada.
Requerimientos:
 Tu tienes que tener un formulario con una acción de "UserLogin.aspx" y un métodod “post”
 Tres entradas son requeridas en el formulario, una entrada de texto “Nombre de Usuario”, otra
de “contraseña” y un botón de “Enviar”.
 El cuadro de texto de entrada “Nombre de Usuario” necesita un nombre de “Nombre de
Usuario” y el de “Contraseña” necesita un nombre de “Contraseña”
 La tercera entrada debría de ser del tipo “Submit”
 Para mostrar errores cuando el inicio de sesión dalla, añade una referencia para el script
query_string.js y llama loadPageVar(“error”). Esto te dará el error devolviendote por el servidor
cuando el Inicio de Sesión falla. Esto puede ser almacenado en una variabley mostrado en la
página de cualquier manera necesaria.
Ejemplos:
 Formulario con Entradas –
HTML
<form action=”UserLogin.aspx” method=”post”>
<input type=”text” name=”username” placeholder=”Username” />
<input type=”password” name=”password” placeholder=”Password” />
<input type=”submit” title=”Log In” />
</form>

Almacenando el “error” como una variable y mostrandolo en la página –
Javascript w/ librería de jQuery referenciada y usada
$(function()
{
var error = loadPageVar(“error”);
if (error != undefined && error != null && error != “”)
{
var errorBar = $(‘#errorBar’);
errorBar.text(error);
errorBar.css(‘display’, ‘block’);
}
});

Habilitando Encriptación SSL
Javascript w/ librería de jQuery referenciada y usada
$(function()
{
If (location.href.substring(0,5) != “https”)
{
Location.href = “https” + location.href.substring(4);
}
});
15
Status Enterprise
Pasarela Web
NOTA: Si estás creand una pantalla de inicio de sesión personalizada, necesitarás asegurarte que la
Pasarela está apuntando a la página que tú has creado actualizando el parámetro “LoginPage”
localizado en los “Ajustes de Aplicación” en IIS
2.6
Moviendo la Pasarela a otro Sitio Web IIS
Es posible que tu quieras mover la Pasarela a otro sitio de IIS. Esta sección te guía sobre como mover la
Pasarela con éxito hacia otro sitio de IIS.
2.6.1 Borrar la Pasarela desde el Sitio Web Actual en IIS
Para eliminar la pasarela, navega hasta el sitio donde la PAsarela esté instalada. Si está disponible, la
Pasarela será instalada en el sitio Web por defecto. Si no está disponible crea un nuevo sitio llamado
“StatusEnterpriseGateway”. Expande el sitio, después encuentra una Aplicación de IIS llamada
“StatusEnterpriseGateway” y haz clic derecho para sacar el menú contextual y selecciona eliminar
como se miestra en la imagen de abajo:
16
Status Enterprise
Pasarela Web
2.6.2 Añadiendo la Pasarela a un nuevo Sitio IIS
Para añadir el Gateway en el IIS, primero selecciona tu Sitio Web IIS donde quieras añadir la Pasarela,
después crea un nuevo “Directorio Virtual” que apunte a la carpeta de la Pasarela en tu directorio de
instalación de Status Enterprise (C:\Program Files\B-Scada\StatusEnterprise\Gateway by default).
Después, convierte el Directorio Virtual para una Aplicación usando el botón derecho del ratón,
asegurate que el “Pool” de Aplicaciones está siendo usado. La Pasarela Status Enterprise requiere que
el “Pool” de Aplicaciones usado esté ejecutando ASP.NET 4.0 usando una fuente de información
ejecutandose como servicio de red.
Una vez completado, verifica que la Pasarela carga apropiadamente visitando la URL asociada con el
sitio al que has añadido la Pasarela.
NOTA: Si mueves la Pasarela a otro sitio, asegurate que el Index.aspc está añadido al
documento por defecto.
17
Status Enterprise
Pasarela Web
3 Resolución de Problemas
Error Code:
Server Error in '/StatusEnterpriseGateway'
Application.
Access to the registry key 'Global' is denied.
Description: Una excepción no controlada durante la ejecución de la solicitud Web actual. Revise el seguimiento de la
pila para obtener más información acerca del error y dónde se originó en el código.
Exception Details: System.UnauthorizedAccessException:EL Acceso a la clave del registro 'Global' está denegado.
ASP.NET No autoriza el acceso a este recurso. Considera garantizar los derechos de acceso al recurso para la petición de
identidad de ASP.NET. ASP.NET tiene un proceso de identidades base (normalmente {MACHINE}\ASPNET en IIS 5 o
Servicio de Red en IIS 6 and IIS 7, y la aplicación de “pool” de identidades configurada en IIS 7.5) que es usado si la
aplicación no utiliza impersonación. Si la aplicación utiliza impersonación via <identity impersonate=”true”/> la identidad
será anónima.
Para garantizar acceso ASP.NET a un archivo, haz clic derecho en el archivo en el explorador, elige propiedades y
selecciona la pestaña Seguridad. Haz clic para agregar el usuario o grupo apropiado.Realza la cuenta ASP.NET, y marca
las cajas para el acceso deseado.
Source Error:
Line 96:
socketServer.NewMessageReceived += new
SessionEventHandler<WebSocketSession, string>(socketServer_NewMessageReceived);
Line 97:
Line 98:
if (!SocketServerManager.Start())
Line 99:
{
Line 100:
SocketServerManager.Stop();
Archivo Origen: c:\Status Enterprise 2011 Q4\Gateway\Status.Enterprise.Gateway\Global.asax.cs
Line: 98
Stack Trace:
[UnauthorizedAccessException: Access to the registry key 'Global' is denied.]
Microsoft.Win32.RegistryKey.Win32Error(Int32 errorCode, String str) +6504925
Microsoft.Win32.RegistryKey.InternalGetValue(String name, Object defaultValue,
Boolean doNotExpand, Boolean checkSecurity) +361
Microsoft.Win32.RegistryKey.GetValue(String name) +62
18
Status Enterprise
Pasarela Web
System.Diagnostics.PerformanceMonitor.GetData(String item) +148
System.Diagnostics.PerformanceCounterLib.GetPerformanceData(String item) +255
System.Diagnostics.PerformanceCounterLib.get_CategoryTable() +172
System.Diagnostics.PerformanceCounterLib.CounterExists(String category, String
counter, Boolean& categoryExists) +35
System.Diagnostics.PerformanceCounterLib.CounterExists(String machine, String
category, String counter) +95
System.Diagnostics.PerformanceCounter.InitializeImpl() +392
System.Diagnostics.PerformanceCounter..ctor(String categoryName, String
counterName, String instanceName, Boolean readOnly) +373
System.Diagnostics.PerformanceCounter..ctor(String categoryName, String
counterName, String instanceName) +14
SuperSocket.SocketEngine.SocketServerManager.StartPerformanceLog() +252
SuperSocket.SocketEngine.SocketServerManager.Start() +498
Status.Enterprise.Gateway.Global.StartSuperWebSocketByConfig() in c:\Status
Enterprise 2011 Q4\Gateway\Status.Enterprise.Gateway\Global.asax.cs:98
[HttpException (0x80004005): Access to the registry key 'Global' is denied.]
System.Web.HttpApplicationFactory.EnsureAppStartCalledForIntegratedMode(HttpConte
xt context, HttpApplication app) +12864673
System.Web.HttpApplication.RegisterEventSubscriptionsWithIIS(IntPtr appContext,
HttpContext context, MethodInfo[] handlers) +175
System.Web.HttpApplication.InitSpecial(HttpApplicationState state, MethodInfo[]
handlers, IntPtr appContext, HttpContext context) +304
System.Web.HttpApplicationFactory.GetSpecialApplicationInstance(IntPtr
appContext, HttpContext context) +404
System.Web.Hosting.PipelineRuntime.InitializeApplication(IntPtr appContext) +475
[HttpException (0x80004005): Access to the registry key 'Global' is denied.]
System.Web.HttpRuntime.FirstRequestInit(HttpContext context) +12881540
System.Web.HttpRuntime.EnsureFirstRequestInit(HttpContext context) +159
System.Web.HttpRuntime.ProcessRequestNotificationPrivate(IIS7WorkerRequest wr,
HttpContext context) +12722601
Solución:
1.
2.
3.
4.
Abre el administrador de IIS.
Expande la máquina local en el panel de conexiones de la izquierda.
Haz clic en el “Pool” de Aplicaciones en Panel de Conexiones.
Haz clic derecho en StatusEnterpriseGateway en el panel “Pool” de Aplicaciones y selecciona
Ajustes Avanzados.
5. Bajo el marco “Modelo del Proceso” selecciona identidad..
6. Haz clic al botón sobre el ‘…’ a la derecha de los valores disponibles.
7. Selecciona “Cuenta ‘Built-in’:
“NetworkService”
19
Status Enterprise
3.1
Pasarela Web
Elementos Truncados
Activar el registro de datos de WCF puede resultar en una pérdida de datos. Mira ‘Habilidando WFC
registrando causas de corrupción en el servicio webHttp que devuelve una corriente’:
http://social.msdn.microsoft.com/Forums/en-US/wcf/thread/2bc5e5a6-1971-46cb-8b4f-f1c46130faca
20