Status Enterprise Guia do Usuário. Parte 8 Gateway Web - PDF
Status Enterprise Guia do Usuário. Parte 8 Gateway Web
Download "Status Enterprise Guia do Usuário. Parte 8 Gateway Web"
Luís Ramalho Amaro
1 Guia do Usuário Parte 8
2 Conteúdos 1 RESUMO Especificações /Requerimentos da Gateway Suporte para Dispositivos Móviles Conectando com a Gateway Arquitetura Características Suportadas e Limitações Características Soportadas Controles UI Suportados Espaços de trabalho e Segurança Restrições PERSONALIZANDO O INÍCIO DE SESSÃO PARA A GATEWAY Configurações de Início de Sessão Automático Fixando uma Rota para o Mimic por Padrão Método de Navegação Recomendado Mudando o Servidor da Gateway Criando uma Página de Início de Sessão Personalizada Movendo a Gateway para outro Site IIS Borrar la Gateway desde el Sitio Web Actual en IIS Adicionando a Gateway para um novo Site IIS RESOLUÇÃO DE PROBLEMAS Elementos Truncados
3 Imagems e Tabelas Imagem 1 Especificações/Requerimentos... 3 Imagem 2 Tela de Configuração de IIS Imagem 3 Pantalla de Configurações de Aplicaión Imagem 4 Administrador de IIS Imagem 5 Rota do mimic por Padrão Imagem 6 Configurações de Aplicação Imagem 7 Rota do Servidor na Gateway
4 1 Resumo Este documento define as linhas gerais no uso da interfaz de usuário para o tempo de execução baseado em Web de Status Enterprise conhecido Passagem ou. A Gateway é um aplicativo ASP.NET que conecta com o servidor de Status Enterprise e transforma os mimics salvados no servidor como XAML, em documentos HTML 5 para os navegadores Web. Os Mimics que foram abertos vão ter conexão com os dados em tempo-real. A maioría dos navegadores e dispositivos móveis incluindo o Ipad suportam HTML5. Para uma lista de termos freqüentes, definições e abreviaturas, por favor, consulte a Parte 1 Resumo e Conceitos Básicos. NOTA: A fim de que a aplicação de Gateway funcione, IIS deve estar instalado antes que o Status Enterprise for instalado. 1.1 Especificações /Requerimentos da Gateway XP 7 & 8 IIS Deve estar instalado. *Passos: Abra Ativar ou Desativar características de Windows Ative Internet Information Services Expanda Internet Information Services\Servicios World Wide Web \Características de Desenvolvimento de Aplicações \ e ative ASP.NET 4.5 Clique em OK *Sãe voçê não tiver permissões para editar as características de Windows, contacte o seu administrador de red. Após a instalação de IIS você precisa executar o executável RegIIS localizado em %WindowsDir%\Microsoft.NET\Framework\v \... e nomeado aspnet_regiis.exe. *Se tiver um SO de 64 bits, substitua Framework por Framework64. No administrador de IIS o Pool de Aplicações devería ser fixado da seguinte forma: IIS > ApplicationPools > Advanced Settings.NET Framework Ver = v4.0 Identity = Network Service Navegadores suportados: Mozilla Firefox Google Chrome **Preferentemente** Navegadores soportados: Internet Explorer Google Chrome **Preferentemente** Mozilla Firefox Safari Opera Imagem 1 Especificações/Requerimentos 3
5 Ao executar IIS 8 e Windows Server 2012, é extremadamente recomendável que você instale o Protocolo WebSocket desde as características e funções do servidor. As regras de entrada/salida do Firewall devem ser especificamente fixadas para o executável do servidor (StatusEnterpriseServer.exe) por cada zona sobre a que esperamos enviar dados. Os arquivos estáticos js deveríam se usar em modo usuário e modo Kernel armazenando em cache para reduzir o tempo de carregamento de páginas. 1.2 Suporte para Dispositivos Móviles A gateway Status Enterprise pode ser acessada a partir de ipads, Iphones e quaisquer dispositivos móveis que suportem HTML5, permitindo o acesso móvel direitamente para seus mimics e dados ao vivo sem necessidade de se conectar com um cliente remoto via VPN. 1.3 Conectando com a Gateway A primeira vez que um usuário tenta acessar na Gateway, vai se fazer uma comprobação para verificar que o IIS está instalado e configurado no seu sistema. Se o IIS não estiver instalado, vai se solicitar ao usuário para que esta instalação seja completada antes de usar Gateway Status Enterprise. Se o IIS já estiver instalado, o cliente da Gateway vai executar um teste do administrador de IIS para verificar que ele está configurado corretamente. Se não a configuração será comletada automáticamente antes de que o usuário possa iniciar sessão. Seu Administrador de Rede vai lhe fornecer com a direcção web para iniciar sessão na Gateway Status Enterprise. A URL por padrão é e usa o porto A página de inicio de sessão vai pedir o nome usuário e a senha. Após ter iniciado sessão vai se mostrar um sistema de navegação que permite navegar através das pastas até o documento que você deseje abrir o path da pasta atual, é na parte inferior da tela e tem um botão para mudar de nível. Um nome de usuário e senha pode ser introduzido na Gateway através do arquivo web.config a fim de que a gateway inicie com um usuário automaticamente (isto podería ser especialmente util se você tiver uma conta de usuário público com a gateway hospedada no servidor web). Também pode se adicionar uma rota para o documento na mesma forma se quisermos que o usuário inicie sessão sobre um mimic específico. 1.4 Arquitetura A Gateway Status Enterprise inicia sobre o Servidor Status e mantém a sessão para seu cliente web quando você tem a sessão iniciada. A Gateway faz solicitações ao mimic a partir do servidor usando o documento selecionado através do sistema ou especificado no arquivo web.config. Quando o documento é passado para a Gateway, ela o torna num documento a partir de seu formato nativo de mimic XAML para um documento HTML5. O HTML este é devolvido ao cliente para ser mostrado num navegador web. Uma conexão de soquete web é criada entre a Gateway eo cliente web. Todos os gráficos no documento HTML5 que contêm ligações para dados em tempo real são atualizados através da conexão de soquete web para o Gateway. 1.5 Características Suportadas e Limitações 4
6 1.5.1 Características Soportadas Os Mimics que funcionam na Gateway terão quase todas as funcionalidades que têm no cliente Runtime. Todos os controles de navegação são suportados. Todos as ligações de Dados são suportadas, incluindo as ligações bidirecionais, e vão continuar a atualização com dados ao vivo e aceitando a escrita de propiedades a partir do mimic. As Tendências também são suportadas, quer as históricas e as que funcionam com dados em tempo real. Os Controles de Alarmes atualmente não estão suportados, por tanto, embora seus dados sejam monitorados em tempo real e seus alarmes estejam monitorando as mudanças, você não vai ver os controles de alarmes a partir da Controles UI Suportados Os Documentos XAML destinados à conversão para a HTML precisam usar um subconjunto de Controles UI disponíveis no Designer de Mimics, que incluem: Botões Flat Toggle Switch (Interruptor Plano de alternância) Gel Toggle Button (Botão Gel de alternância) Generic Toggle Button (Botão de alternância Genérico) Industrial Toggle Button (Botão de alternância industrial) Power Toggle Button (Botão de alternância de energía) Toggle Switch (Interruptor de alternancia) Controles Comuns Check Box (Caixa de Seleção) Label (Etiqueta) Text Block (Bloco de Texto) Controles de Data e Hora Date Time Display (Mostrador de Data e Hora) Controles de Bitola Dual Gauge (Bitola Dupla) Dynamic Gauge (Bitola Dinámica) Horizontal Linear Gauge (Bitola Linear Horizontal) Parabolic Gauge (Bitola Parabólica) Racing Gauge (Bitola de Racing) 5
7 Radial Gauge (Bitola Radial) Simple Gauge (Bitola Simples) Variable Gauge (Bitola Variável) Vertical Linear Gauge (Bitola Vertical Linear) Painéis e Grelhas Canvas (Lona) Controles Indicadores Indicator Tower Three State Entrada Data Text Box (Caixa de texto de dados) Etiquetas Data Label (Etiqueta de Dados) Variance Label (Etiqueta de Variação) Monitores LED LED Five By Seven Matrix (de Matriz Cinco por Sete) LED Light (de Luz) LED Seven Segment (de Segmento Sete) LED Sixteen Segment (de Segmento dezesseis) Mídia Bindable Image (Imagem Vinculável) Controles Diversos Ratings Control (Controle de Classificação) Motores e Ventiladores Centrifugal Pump (Bomba Centrífuga) 6
8 Gear (Engrenagem) Heavy Motor (Motor Pesado) Helical Motor (Motor Helicoidal) Metal Fly Wheel Paddle Wheel Simple Fan Small Fly Wheel Sprocket (Roda Dentada) Square Motor (Motor Quadrado) Tire (Pneu) Wind Generator (Gerador de Vento) Botões de Navegação Gel Navigation Back Button Gel Navigation Button Navigation Back Button Navigation Border (Borda ou Limite de Navegação) Navigation Button (Botão de Navegação) Navigation Combo (Combinação) Navigation List Tanques e Tubulações Connector Pipe (Tubulação conectora) Cutaway Tank (Tanque de Corte) Cylinder Tank (Tanque de Cilindro) Fitted Elbow Pipe (Tubo de cotobelo embutido) Fitted Pipe (Tubo adaptado) Funnel Tank Indicator Tank Ladder Tank (Tanque de escada) Mixing Tank (Tanque de mistura) Standard Elbow Pipe (Tubo de Cotobelo Standard ou Padrão) Standard Pipe (Tubo Padrão) Universal Pipe Connector (Conector de Tubo Universal) Valve (Válvula) 7
9 Vessel Tank (Tanque de Vaso) Formas Ellipse Line Path Polygon Polyline Polygon and Polyline Pencil Rectangle Tendências Trend Graph (Grafico de Tendências) Graph Pen (Pena gráfica) Até aquí os controles UI suportados em HTML Espaços de trabalho e Segurança A configuração de Segurança e os Espaços de Trabalho (E. T.) de seu modelo de dados são aplicáveis quando os Mimics são executados na. Seu inicio de sessão é monitorado pelo Status Server, então, os Espaços de Trabalho de que você é membro vão ser mostrados na sua sessão web. As propriedades que você não pode acessar segundo os seus E. T., não vão ser atualizadas Restrições Como temos mencionado acima, há certos controles na "caixa de ferramentas" do Designer de Mimics que não são compatíveis com a Web Gateway. A lista de controles suportados pode ser encontrada na Secção Usando a Gateway para executar um mimic que tiver alguns controles no suportados, não impede que o mimic funcione mas esses controles não vão ser mostrados tela. Em vez disso, um marcador genérico vai ser exibido. Todos os controles suportados funcionam normalmente. Os alarmes não estão disponíveis na, e as Tendências estão disponíveis com suporte limitado. Os mimics na gateway podem ser mostrados a partir de qualquer navegador que suporte HMTL5, incluindo as versões atuais dos seguintes navegadores: 8
10 Internet Explorer Chrome Firefox Opera Safari A maioria dos navegadores móveis têm adotado o padrão HTML5, mas nem sempre a compatibilidade das características com os dispositivos e a mesma. Se quiser verificar a compatibilidade de seu dispositivo com HTML5 antes de usar a, até hoje você pode tentar através dos seguintes navegadores móveis (todos suportam HTML5): Safari ios Android Browser Google Chrome Amazon Silk Blackberry Browser Nokia Browser Internet Explorer Opera Mobile Opera Mini Firefox 9
11 2 Personalizando o Início de Sessão para a Gateway 2.1 Configurações de Início de Sessão Automático Esta Secção descreve como configurar o Gateway para pular a tela de Início de Sessão usando as credenciais predefinidas. Requerimentos: No arquivo Web.config, as variáveis Nome de usuário e Senha devem estar fixadas com as credenciais corretas, e a configuração Inicio de Sessão Automático precisa estar fixado para um valor de Sim. Exemplo: Abra IIS, selecione a Aplicação StatusEnterpriseGateway e depois selecione a característica Configuração da Aplicação. Imagem 2 Tela de Configuração de IIS 10
12 Fixe Início de Sessão Automático a Sim, e o Nome de usuário e a Senha às credenciais correspondentes. Imagem 3 Pantalla de Configurações de Aplicaión Agora, quando você abrir a gateway, automáticamente vai iniciar sessão com o usuário predefinido. 2.2 Fixando uma Rota para o Mimic por Padrão. Esta secção descreve como fixar um mimic para mostrar quando o usuário inicie sessão, em vez de a pagina de navegação do modelo. Requerimentos: A viariável DefaultMimicPath no arquivo Web.config deve ser fixada com uma rota válida. Exemplo: Abra o IIS, selecione a aplicação StatusEnterpriseGateway e depois selecione a característica Configurações de Aplicação. 11
13 Imagem 4 Administrador de IIS. Fixe DefaultMimicPath com uma rota válida para o mimic que quiser mostrar. Imagem 5 Rota do mimic por Padrão 12
14 Agora quando você iniciar uma sessão na Gateway, este mimic será mostrado em vez do sistema de navegação. 2.3 Método de Navegação Recomendado A Gateway Status Enterprise inclui un menú de navegação. O menú é mostrado após o início de sessão. Este menú fornece de acesso rápido para todo o mimic, e para os Activos, mas não é o método recomendado de navegação. A Boa Prática sería criar uma Página de Início com botões de navegação para os mimics necessários. 2.4 Mudando o Servidor da Gateway Esta secção define como especificar com qual Servidor de vamos nos conectar: Requerimentos: A variável StatusEnterpriseServer o arquivo Web.config deve ter fixada uma rota para o servidor. Exemplo: Abra o IIS, selecione la Aplicação StatusEnterpriseGateway, e depois selecion a característica Configurações de Aplicação. Imagem 6 Configurações de Aplicação 13
15 Fixe StatusEnterpriseServer para uma rota válida no Servidor Status Enterprise. Imagem 7 Rota do Servidor na Gateway Agora a Gateway irá conectar a um servidor em outro lugar em vez de sua máquina. 14
16 2.5 Criando uma Página de Início de Sessão Personalizada. Requerimentos: Voçê tem que ter um formulario com uma acção de "UserLogin.aspx" e um método post Para o formulárico vão ser requeridas três entradas: uma entrada de texto Nome de Usuário, outra de Senha e um botão de Enviar. A caixa de texto de entrada Nome de Usuário precisa um nome de Nome de Usuário e Senha precisa um nome de Senha A terceira entrada deve ser de tipo "Enviar" ou Submit Para mostrar erros quando o início de sessão falhar, adicione uma referência para o script query_string.js e nomeie-la loadpagevar( error ). Isto vai devolver um erro para o servidor quando i Início de Sessão falhar. Isto pode ser armazenado numa variável e mostrado na página da forma necessária. Exemplos: Formulário com 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> Salvando o erro como uma variável e mostrando-lo na 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 ); } }); Ativando Encriptação 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
17 NOTA: Se estiver criando uma tela de início de sessão personalizada, verifique que a Gateway está apontando para a página que você criou, atualizando o parâmetro "loginpage" localizado nas "Configurações do aplicativo" no IIS. 2.6 Movendo a Gateway para outro Site IIS É possível que voçê queira mover a Gateway para outro site de IIS. Esta secção vai guiá-lo sobre como mover a Gateway isso com sucesso Borrar la Gateway desde el Sitio Web Actual en IIS Para eliminar la gateway, navege até o site onde a Gateway esté instalada. Si está disponible, la Gateway 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 Aplicação de IIS llamada StatusEnterpriseGateway y haz clic derecho para sacar el menú contextual y selecciona eliminar como se miestra na imagem de abajo: 16
18 2.6.2 Adicionando a Gateway para um novo Site IIS Para añadir el Gateway en el IIS, primero selecciona tu Sitio Web IIS donde quieras añadir la Gateway, después crea un nuevo Directorio Virtual que apunte a la carpeta de la Gateway en tu directorio de instalação de Status Enterprise (C:\Program Files\B-Scada\StatusEnterprise\Gateway by default). Después, convierte el Directorio Virtual para una Aplicação usando el botón derecho del ratón, asegurate que el Pool de Aplicações está siendo usado. La Gateway Status Enterprise requiere que el Pool de Aplicações usado esté ejecutando ASP.NET 4.0 usando una fuente de informação ejecutandose como servicio de red. Una vez completado, verifica que la Gateway carga apropiadamente visitando la URL asociada con el sitio al que has añadido la Gateway. NOTA: Si mueves la Gateway a otro sitio, asegurate que el Index.aspc está añadido al documento por defecto. 17
19 3 Resolução de Problemas Error Code: Server Error in '/StatusEnterpriseGateway' Application. Access to the registry key 'Global' is denied. Description: Una excepção no controlada durante la ejecução de la solicitud Web actual. Revise el seguimiento de la pila para obtener más informação acerca del error y dónde se originó en el código. Exception Details: System.UnauthorizedAccessException:EL Acesso a la clave del registro 'Global' está denegado. ASP.NET No autoriza el acesso a este recurso. Considera garantizar los derechos de acesso al recurso para la petição 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 aplicação de pool de identidades configurada en IIS 7.5) que es usado si la aplicação no utiliza impersonação. Si la aplicação utiliza impersonação via <identity impersonate= true /> la identidad será anónima. Para garantizar acesso ASP.NET a un arquivo, haz clic derecho en el arquivo en el explorador, elige propiedades y selecciona la pestaña Seguridad. Haz clic para agregar el usuário o grupo apropiado.realza la cuenta ASP.NET, y marca las cajas para el acesso 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(); Arquivo 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) Microsoft.Win32.RegistryKey.InternalGetValue(String name, Object defaultvalue, Boolean donotexpand, Boolean checksecurity) +361 Microsoft.Win32.RegistryKey.GetValue(String name)
20 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 (0x ): Access to the registry key 'Global' is denied.] System.Web.HttpApplicationFactory.EnsureAppStartCalledForIntegratedMode(HttpConte xt context, HttpApplication app) 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 (0x ): Access to the registry key 'Global' is denied.] System.Web.HttpRuntime.FirstRequestInit(HttpContext context) System.Web.HttpRuntime.EnsureFirstRequestInit(HttpContext context) +159 System.Web.HttpRuntime.ProcessRequestNotificationPrivate(IIS7WorkerRequest wr, HttpContext context) Solução: 1. Abra o administrador de IIS. 2. Expanda a máquina local no painel conexões da esquerda. 3. Clique no Pool de Aplicações no painel de conexões. 4. Clique com botão direito em StatusEnterpriseGateway no painel Pool de Aplicações e selecioe Configurações Avanzadas. 5. Baixo o frame Modelo del Proceso selecione identidade. 6. Clique no botão sobre o na direita dos valores disponíveis. 7. Selecione Conta Built-in : NetworkService 19
21 3.1 Elementos Truncados Ativar o registro de dados de WCF poder gerar uma perda de dados. Consulte Habilidando WFC registrando motivos de corrupção no serviço webhttp que devolve uma correnteça: 20