{"id":2515,"date":"2019-03-25T17:39:56","date_gmt":"2019-03-25T20:39:56","guid":{"rendered":"http:\/\/xexeu.elipse.com.br\/pt\/using-libraries-in-elipse-e3-lesson-3\/"},"modified":"2020-01-20T17:22:02","modified_gmt":"2020-01-20T20:22:02","slug":"using-libraries-in-elipse-e3-lesson-3","status":"publish","type":"post","link":"https:\/\/kb.elipse.com.br\/en\/using-libraries-in-elipse-e3-lesson-3\/","title":{"rendered":"Using Libraries in Elipse E3: Lesson 3."},"content":{"rendered":"

XObject<\/h3>\n

XObjects are data libraries which allow configuring a data structure to execute on the server. This structure can perform calculations, links, communication, alarm acknowledgement, historic recording, and much more.<\/p>\n

To insert a new XObject in a Library, follow these steps:<\/p>\n

\n
    \n
  1. Right-click the XObjects<\/b>, select the option Insert XObject in<\/b> and then click the library file.<\/li>\n<\/ol>\n<\/div>\n

    \"\"<\/p>\n

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

    \n
      \n
    1. Change the name XObject1<\/code> to any other suitable name.<\/li>\n<\/ol>\n<\/div>\n

      When installing an XObject, there are two tabs on the lower side of the screen, Properties<\/b> and Scripts<\/b>. Because an XObject is a data structure, not a visual object, there is no Design<\/b> tab.<\/p>\n

      In an XObject, it is possible to insert XProperties and any E3 module running on the server:<\/p>\n

      \"\"<\/p>\n

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

      Developing XObjects<\/h3>\n

      As you already have a Library file, you can create XObjects.<\/p>\n

      EngineTag<\/h4>\n

      As an example, let’s develop an application which monitors the maintenance state, failure, and speed of each engine. Besides, in case the engine is on failure, an alarm must be triggered.<\/p>\n

      \n
        \n
      1. Insert a new XObject named EngineTag<\/code>.<\/li>\n
      2. In the Properties<\/b> tab, create three properties:<\/li>\n<\/ol>\n<\/div>\n

        \"\"<\/p>\n

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

        \n
          \n
        1. Insert an Alarm Configuration object in the XObject.<\/li>\n<\/ol>\n<\/div>\n

          \"\"<\/p>\n

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

          \n
            \n
          1. In the Alarm Configuration object, create an Area named Engine<\/code>.<\/li>\n
          2. In the Engine<\/code> area, insert a Digital Alarm named FailAlarm<\/code> to monitor the Fail<\/b> property of the XObject.<\/li>\n<\/ol>\n<\/div>\n

            \"\"<\/p>\n

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

            \n
              \n
            1. Right-click the FailAlarm<\/code> object to access its properties, and choose a message for this alarm.<\/li>\n<\/ol>\n<\/div>\n

              \"\"<\/p>\n

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

              \n
                \n
              1. Save and register the Library.<\/li>\n<\/ol>\n<\/div>\n

                Using an XObject<\/h3>\n

                Follow the next procedures to use the XObject:<\/p>\n

                \n
                  \n
                1. In the Data Server, insert three objects of type EngineTag<\/b>, Engine1<\/code>, Engine2<\/code>, and Engine3<\/code>.<\/li>\n<\/ol>\n<\/div>\n

                  \"\"<\/p>\n

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

                  \n
                    \n
                  1. In the InitialScreen<\/code>, create three buttons of type ToggleButton<\/b>, Engine1<\/code>, Engine2<\/code>, and Engine3<\/code>.<\/li>\n
                  2. Create a Bidirectional Link between the Value<\/b> property of each button and the Fail<\/b> property of its respective engine.<\/li>\n<\/ol>\n<\/div>\n

                    \"\"<\/p>\n

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

                    \n
                      \n
                    1. Near each engine button, insert a Display to view the RPM. Make a link with the RPM<\/b> property of the respective EngineTag<\/code>.<\/li>\n
                    2. To view the alarms, insert an E3Alarm object on the Screen.<\/li>\n
                    3. In the E3Alarm, configure the Alarm Server Name<\/b> property. In case there is no server available, insert an Alarm Server in the Domain.<\/li>\n<\/ol>\n<\/div>\n

                      \"\"<\/p>\n

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

                      \n
                        \n
                      1. Execute the application.<\/li>\n<\/ol>\n<\/div>\n

                        Getting values<\/h3>\n

                        The XObject is a data structure with several properties. These properties can get values from other objects using links or scripts.<\/p>\n

                        \n
                          \n
                        1. In the Data object of the Data Server, create three Demo Tags named RPM1<\/code>, RPM2<\/code>, and RPM3<\/code> of type Random<\/b>.<\/li>\n<\/ol>\n<\/div>\n

                          \"\"<\/p>\n

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

                          \n
                            \n
                          1. Create a Simple Link between the RPM<\/b> property of each TagEngine (Engine1<\/code>, Engine2<\/code>, and Engine3<\/code>) with the respective Demo Tag.<\/li>\n<\/ol>\n<\/div>\n

                            \"\"<\/p>\n

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

                            \n
                              \n
                            1. Execute the application.<\/li>\n<\/ol>\n<\/div>\n

                              Exercises<\/h3>\n

                              Maintenance Time<\/h4>\n

                              Now, let’s create an object which triggers an alarm if the device is turned on for more time than the recommended.<\/p>\n

                              \n
                                \n
                              1. Create an XObject named MaintenanceTime<\/code>.<\/li>\n
                              2. In the Properties<\/b> tab, create the following properties:<\/li>\n<\/ol>\n<\/div>\n

                                \"\"<\/p>\n

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

                                \n
                                  \n
                                1. In the XObject MaintenanceTime<\/code>, insert a Data Server named Data<\/code>.<\/li>\n<\/ol>\n<\/div>\n

                                  \"\"<\/p>\n

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

                                  \n
                                    \n
                                  1. In the Data folder, insert a Counter Tag named Counter<\/code>.<\/li>\n<\/ol>\n<\/div>\n

                                    \"\"<\/p>\n

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

                                    \n
                                      \n
                                    1. Change the CounterType<\/b> property of the Counter<\/code> to 1 – Infinite<\/b>.<\/li>\n
                                    2. Create a link in the Counter Tag so that its value can be sent to the OnTime<\/b> property.<\/li>\n
                                    3. The property to enable or disable (Enabled<\/b>) the Counter Tag must be linked to the OnOff<\/b> property of the XObject.<\/li>\n
                                    4. Insert an Alarm Configuration in the XObject.<\/li>\n
                                    5. Create an Area with a Digital Alarm for OnTime<\/b> – MaximumTime<\/b>.<\/li>\n
                                    6. Save and register the Library.<\/li>\n
                                    7. Insert three MaintenanceTime<\/b> objects in the Data folder, Time1<\/code>, Time2<\/code>, and Time3<\/code>.<\/li>\n
                                    8. Insert on the Screen a button of type ToggleButton<\/b>, a Display, and a SetPoint. The button must be linked to the OnOff<\/b> property, the Display to the OnTime<\/b> property, and the SetPoint to the MaximumTime<\/b> property of a MaintenanceTime object.<\/li>\n<\/ol>\n<\/div>\n

                                      \"\"<\/p>\n

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

                                      \n
                                        \n
                                      1. To view the alarms, insert on the screen an E3Alarm object and check if there is an Alarm Server object on the Domain (create one if not).<\/li>\n
                                      2. Execute the application and test its functionalities.<\/li>\n<\/ol>\n<\/div>\n

                                        ValveTag<\/h4>\n

                                        Let’s create an object which saves a historic of failure, open, or closed statuses of all valves in the database.<\/p>\n

                                        \n
                                          \n
                                        1. Create an XObject named ValveTag<\/code>.<\/li>\n
                                        2. In the Properties<\/b> tab, create the following properties:<\/li>\n<\/ol>\n<\/div>\n

                                          \"\"<\/p>\n

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

                                          \n
                                            \n
                                          1. Perform the following configuration:<\/li>\n<\/ol>\n