{"id":2337,"date":"2019-03-25T17:39:07","date_gmt":"2019-03-25T20:39:07","guid":{"rendered":"http:\/\/xexeu.elipse.com.br\/pt\/usando-bibliotecas-no-elipse-e3-licao-3\/"},"modified":"2019-05-27T15:31:29","modified_gmt":"2019-05-27T18:31:29","slug":"usando-bibliotecas-no-elipse-e3-licao-3","status":"publish","type":"post","link":"https:\/\/kb.elipse.com.br\/en\/usando-bibliotecas-no-elipse-e3-licao-3\/","title":{"rendered":"Usando Bibliotecas no Elipse E3: Li\u00e7\u00e3o 3."},"content":{"rendered":"

XObject<\/h3>\n
<\/div>\n

XObjects s\u00e3o bibliotecas de dados que permitem configurar uma estrutura de dados a ser executada no servidor. Essa estrutura pode realizar c\u00e1lculos, associa\u00e7\u00f5es, comunica\u00e7\u00f5es, verifica\u00e7\u00e3o de alarmes, registro hist\u00f3rico, e mais.<\/p>\n

<\/div>\n

Para inserir um novo XObject na Biblioteca, siga estes passos:<\/p>\n

<\/div>\n
\n
    \n
  1. Clique com o bot\u00e3o direito do mouse em XObjects<\/b>, selecione a op\u00e7\u00e3o Inserir XObject em<\/b> e clique no arquivo de Biblioteca.<\/li>\n<\/ol>\n<\/div>\n

    \"\"<\/p>\n

    Figura 1<\/b><\/span><\/p>\n

    \n
      \n
    1. Altere o nome de XObject1<\/code> para o nome que desejar.<\/li>\n<\/ol>\n<\/div>\n

      Ao inserir um XObject, h\u00e1 duas abas na parte inferior da tela, Propriedades<\/b> e Scripts<\/b>. Como o XObject \u00e9 uma estrutura de dados, e n\u00e3o um objeto visual, n\u00e3o h\u00e1 uma aba Design<\/b>.<\/p>\n

      Em um XObject, \u00e9 poss\u00edvel inserir XProperties e qualquer m\u00f3dulo do E3 que seja executado no servidor:<\/p>\n

      \"\"<\/p>\n

      Figura 2<\/b><\/span><\/p>\n

      Desenvolvimento de XObjects<\/h3>\n

      Como j\u00e1 temos um arquivo de Biblioteca, podemos criar XObjects.<\/p>\n

      <\/div>\n

      TagMotor<\/h4>\n
      <\/div>\n

      Como exemplo, vamos desenvolver uma aplica\u00e7\u00e3o que monitora o estado de manuten\u00e7\u00e3o, defeito e a velocidade de cada motor. Al\u00e9m disso, caso o motor esteja com defeito, um alarme deve ser disparado.<\/p>\n

      \n
        \n
      1. Insira um novo XObject chamado TagMotor<\/code>.<\/li>\n
      2. Na aba Propriedades<\/b>, crie tr\u00eas propriedades:<\/li>\n<\/ol>\n<\/div>\n

        \"\"<\/p>\n

        Figura 3<\/b><\/span><\/p>\n

        \n
          \n
        1. Insira um objeto Configura\u00e7\u00e3o de Alarmes no XObject.<\/li>\n<\/ol>\n<\/div>\n

          \"\"<\/p>\n

          Figura 4<\/b><\/span><\/p>\n

          \n
            \n
          1. No objeto Configura\u00e7\u00e3o de Alarmes, crie uma \u00c1rea chamada Motor<\/code>.<\/li>\n
          2. Na \u00c1rea Motor<\/code>, insira um Alarme Digital chamado AlarmeDefeito<\/code> para monitorar a propriedade Defeito<\/b> do XObject.<\/li>\n<\/ol>\n<\/div>\n

            \"\"<\/p>\n

            Figura 5<\/b><\/span><\/p>\n

            \n
              \n
            1. Clique com o bot\u00e3o direito do mouse sobre o objeto AlarmeDefeito<\/code> para acessar suas propriedades, e escolha uma mensagem para o alarme.<\/li>\n<\/ol>\n<\/div>\n

              \"\"<\/p>\n

              Figura 6<\/b><\/span><\/p>\n

              \n
                \n
              1. Salve e registre a Biblioteca.<\/li>\n<\/ol>\n<\/div>\n

                Utilizando um XObject<\/h3>\n

                Siga os procedimentos abaixo para utilizar o XObject:<\/p>\n

                <\/div>\n
                \n
                  \n
                1. No servidor de Dados, insira tr\u00eas objetos do tipo TagMotor<\/b>, Motor1<\/code>, Motor2<\/code> e Motor3<\/code>.<\/li>\n<\/ol>\n<\/div>\n

                  \"\"<\/p>\n

                  Figura 7<\/b><\/span><\/p>\n

                  \n
                    \n
                  1. Na TelaInicial<\/code>, crie tr\u00eas bot\u00f5es do tipo ToggleButton<\/b>, Motor1<\/code>, Motor2<\/code> e Motor3<\/code>.<\/li>\n
                  2. Crie uma Associa\u00e7\u00e3o Bidirecional entre a propriedade Value<\/b> de cada bot\u00e3o com a propriedade Defeito<\/b> do seu respectivo motor.<\/li>\n<\/ol>\n<\/div>\n

                    \"\"<\/p>\n

                    Figura 8<\/b><\/span><\/p>\n

                    \n
                      \n
                    1. Ao lado de cada bot\u00e3o do motor, insira um Display para visualizar o RPM. Fa\u00e7a uma associa\u00e7\u00e3o com a propriedade RPM<\/b> do respectivo TagMotor<\/code>.<\/li>\n
                    2. Para visualizar os alarmes, insira um objeto E3Alarm na Tela.<\/li>\n
                    3. No E3Alarm, configure a propriedade Nome do Servidor de Alarmes<\/b>. Caso n\u00e3o haja nenhum servidor dispon\u00edvel, insira um Servidor de Alarmes no seu Dom\u00ednio.<\/li>\n<\/ol>\n<\/div>\n

                      \"\"<\/p>\n

                      Figura 9<\/b><\/span><\/p>\n

                      \n
                        \n
                      1. Execute a aplica\u00e7\u00e3o.<\/li>\n<\/ol>\n<\/div>\n

                        Recebendo valores<\/h3>\n

                        O XObject \u00e9 uma estrutura de dados com diversas propriedades. Essas propriedades podem receber valores de outros objetos atrav\u00e9s de associa\u00e7\u00f5es ou scripts.<\/p>\n

                        <\/div>\n
                        \n
                          \n
                        1. No objeto Dados do Servidor de Dados, crie tr\u00eas Tags Demo chamados RPM1<\/code>, RPM2<\/code> e RPM3<\/code> do tipo Aleat\u00f3rio<\/b> (random<\/i>).<\/li>\n<\/ol>\n<\/div>\n

                          \"\"<\/p>\n

                          Figura 10<\/b><\/span><\/p>\n

                          \n
                            \n
                          1. Crie uma Associa\u00e7\u00e3o Simples entre a propriedade RPM<\/b> de cada objeto TagMotor (Motor1<\/code>, Motor2<\/code> e Motor3<\/code>) com o respectivo Tag Demo.<\/li>\n<\/ol>\n<\/div>\n

                            \"\"<\/p>\n

                            Figura 11<\/b><\/span><\/p>\n

                            \n
                              \n
                            1. Execute a aplica\u00e7\u00e3o.<\/li>\n<\/ol>\n<\/div>\n

                              Exerc\u00edcios<\/h3>\n

                              Tempo de Manuten\u00e7\u00e3o<\/h4>\n

                              Agora, vamos criar um objeto que dispara um alarme se o equipamento estiver ligado h\u00e1 mais tempo do que o recomendado.<\/p>\n

                              <\/div>\n
                              \n
                                \n
                              1. Crie um XObject chamado TempoManutencao<\/code>.<\/li>\n
                              2. Na aba Propriedades<\/b>, crie as seguintes propriedades:<\/li>\n<\/ol>\n<\/div>\n

                                \"\"<\/p>\n

                                Figura 12<\/b><\/span><\/p>\n

                                \n
                                  \n
                                1. No XObject TempoManutencao<\/code>, insira um Servidor de Dados chamado Dados<\/code>.<\/li>\n<\/ol>\n<\/div>\n

                                  \"\"<\/p>\n

                                  Figura 13<\/b><\/span><\/p>\n

                                  \n
                                    \n
                                  1. Na pasta Dados, insira um Tag Contador chamado Contador<\/code>.<\/li>\n<\/ol>\n<\/div>\n

                                    \"\"<\/p>\n

                                    Figura 14<\/b><\/span><\/p>\n

                                    \n
                                      \n
                                    1. Altere a propriedade CounterType<\/b> do Contador<\/code> para 1 – Infinite<\/b>.<\/li>\n
                                    2. Crie uma associa\u00e7\u00e3o no Tag Contador para que seu valor seja enviado para a propriedade TempoLigado<\/b>.<\/li>\n
                                    3. A propriedade de habilitar ou desabilitar (Enabled<\/b>) do Tag Contador deve estar associada \u00e0 propriedade Ligado<\/b> do XObject.<\/li>\n
                                    4. Insira um objeto Configura\u00e7\u00e3o de Alarmes no XObject.<\/li>\n
                                    5. Crie uma \u00c1rea com um Alarme Digital para TempoLigado<\/b> – TempoMaximo<\/b>.<\/li>\n
                                    6. Salve e registre a Biblioteca.<\/li>\n
                                    7. Insira tr\u00eas objetos TempoManutencao<\/b> na pasta Dados, Tempo1<\/code>, Tempo2<\/code> e Tempo3<\/code>.<\/li>\n
                                    8. Insira na Tela um bot\u00e3o do tipo ToggleButton<\/b>, um Display e um SetPoint. O bot\u00e3o deve estar associado \u00e0 propriedade Ligado<\/b>, o Display \u00e0 propriedade TempoLigado<\/b> e o SetPoint \u00e0 propriedade TempoMaximo<\/b> de um objeto TempoManutencao.<\/li>\n<\/ol>\n<\/div>\n

                                      \"\"<\/p>\n

                                      Figura 15<\/b><\/span><\/p>\n

                                      \n
                                        \n
                                      1. Para visualizar os alarmes, insira na Tela um objeto E3Alarm e verifique se h\u00e1 um objeto Servidor de Alarmes no Dom\u00ednio (crie um se n\u00e3o houver).<\/li>\n
                                      2. Execute a aplica\u00e7\u00e3o e teste as funcionalidades.<\/li>\n<\/ol>\n<\/div>\n

                                        TagValvula<\/h4>\n

                                        Vamos criar um objeto que salva um hist\u00f3rico dos estados defeito, aberto ou fechado de todas as v\u00e1lvulas no banco de dados.<\/p>\n

                                        <\/div>\n
                                        \n
                                          \n
                                        1. Crie um XObject chamado TagValvula<\/code>.<\/li>\n
                                        2. Na aba Propriedades<\/b>, crie as seguintes propriedades:<\/li>\n<\/ol>\n<\/div>\n

                                          \"\"<\/p>\n

                                          Figura 16<\/b><\/span><\/p>\n

                                          \n
                                            \n
                                          1. Fa\u00e7a as seguintes configura\u00e7\u00f5es:<\/li>\n<\/ol>\n