i4designer Knowledgebase

i4designer Signals tutorials

Abstract

Check out the signals simulation functionality allowing you to test your visualization project while designing it, hence saving valuable engineering time.

From i4designer point of view, the signals are assets that are present in the project itself. Each project can have its own set of signals that can be either imported from using an XML file or directly synchronized from your database.

In order to avoid a direct connection between i4designer and i4SCADA or i4connected servers, the signals in i4designer are capable to trigger simulated values. Based on the i4designer provided signal simulation patterns, it is possible to test every scenario that you might have, by tweaking the simulation patterns and see actual state updates. This way, the designed project can be tested before actually publishing the project without risking real data corruption.

After publishing your project and opening the visualization, the online signals will be applied.

Tip

For more details about the Signals menu and its particularities check out the article here.

Importing signals from an XML file
Abstract

Check out this tutorial and learn how to import signals to your i4designer project from an XML file, obtained directly from your i4SCADA project.

In order to import your signal to an i4designer project, please follow the below-described steps:

  1. Open your i4designer project and click on the Signals menu of the global actions area. The Signal operation panel and the Signal Configuration page are opened.

    Signals_menu.jpg
  2. Click on the Signal import designated area in order to open the files explorer window.

  3. Select the XML file containing the signals to be imported and click the Open button to uploaded them to your project.

    upload_signals.jpg
  4. The Signals import area is updated to display the uploaded XML file. In this view, the user can choose between Replace and Merge import behaviors.

    Apply_signals.jpg
  5. Click the Apply button to proceed with the Signals import action.

  6. The Signal Configuration page is updated to display the list of all uploaded Signals providing a set of available information about them.

    Signals_available.jpg
Synchronizing signals from an i4connected database
Abstract

Check out this tutorial and learn how to get signals from an i4connected database directly into your i4designer project and use them for simulation purposes.

In order to synchronize signals from your i4connected database and reuse them for simulation purposes in the Designer, please follow the below described steps:

Warning

The option to synchronize Signals from an i4connected database is active, only for projects running on an Active synchronization mode.

Since Signals synchronization for i4connected environments, running on Passive synchronization

For more details about Signal synchronization, from i4connected environments, running on Passive synchronization, please also read the dedicated article, available in the i4connected knowledge base.

  1. Open your i4designer project and click the Settings menu of the global actions area.

    Tip

    For more details about the Settings menu please also check the respective article here.

  2. In the Settings panel, fill in the Platform settings.

    Tip

    For more details about the Platform settings please also check the i4connected Plaform article.

    Platform_settings.jpg
  3. Next, open the Signal configuration menu of the global actions area. The Signal operations panel and the Signal Configuration page are opened.

    Signal_config_menu.jpg
  4. Click on the Get i4connected signals button.

    get_i4conected_signals.jpg
  5. The Signal Configuration page is populated with all the Signals available in the pre-configured platform.

    Signal_Config_populated.jpg
Synchronizing signals from an i4SCADA database
Abstract

Check out this tutorial and learn how to get signals from an i4SCADA database directly into your i4designer project and use them for simulation purposes.

In order to synchronize signals from your i4SCADA database and reuse them for simulation purposes in the Designer, please follow the below-described steps:

  1. Open the i4SCADA Studio application.

  2. Select the Settings menu and expand the i4designer node, until reaching the Project settings node.

    i4designer_Project_settings.jpg
  3. Right-click within the Project settings empty panel and select the option New.

    New_project_settings.jpg
  4. The Project settings panel is updated and allows you to fill in the Project Token. Fill in the Project Token after copying it from the application.

    Project_token.jpg

    Tip

    Each project has an allocated connection-token. This can be easily copied from the Control Center, as visible in the screenshot below.

    connection_token.jpg
  5. After filling in the Project settings, make sure that the Server and the Synchronization Service are running.

    Service_Mgr.jpg
  6. Next, open your i4designer project, in design-mode.

  7. Open the Signal configuration menu of the global actions area. The Signal operations panel and the Signal Configuration page are opened.

    Signals_operations_menu.jpg
  8. Click on the Get i4SCADA signals button.

  9. The Signal Configuration page is populated with all the Signals available on your i4SCADA server.

    List_of_SCADA_signals.jpg
Testing states updates in signal simulation mode
Abstract

Check out this tutorial and learn how to test your component's states updates by tweaking the signals simulation patterns.

As previously indicated, the i4designer Signals are assets that only show simulated values. The present tutorial will guide you through a set of steps that will demonstrate to you how to use the signal simulation functionality to test your project while in the design phase.

Note

The present demonstration will use the Signals imported from the default WEBfactory i4SCADA Demo project.

  1. Open an i4designer project and drag on the project page the State image component.

    Add_State_image_compo.jpg
  2. Make sure that your project is populated with Signals, under the Signal configuration menu under the global actions area.

    Signal_config.jpg
  3. Select a Signal from the Signal Configuration page and double-click on it. The Signal simulation panel for the selected signal will be opened.

    Signal_simulation.jpg
  4. In the Signal simulation panel define the signal simulation patterns.

    Tip

    For the present tutorial we selected the Setpoint 1 signal and updated its properties as follows:

    • Set property Max to 1.

    • Set property Min to 0.

    • Set Simulation Type to Linear.

    For more details about the Signal simulation patterns check out the article describing them.

  5. Return to your project page where the State image component was added and double click on it to open its properties.

  6. In the State image properties panel, organize the following changes:

    1. Add two new States for the component.

      Add_states.jpg
    2. Expand the properties of the first state and set the Condition rule, the Image, and the Symbolic Text.

      Tip

      For the present tutorial we selected the following properties :

      State_1.jpg
      • Condition rule - %Setpoint 1% ==0

      • Image 1

      • Symbolic text - Error

    3. Expand the properties of the second state and set the Condition rule, the Image, and the Symbolic Text.

      Tip

      For the present tutorial we selected the following properties :

      State_2.jpg
      • Condition rule - %Setpoint 1% ==1

      • Image 2

      • Symbolic text - Success

  7. As soon as the two states have been defined, the State image component will start changing the images based on the signal simulated value change.

    Signal_value_is_0.jpg
    Signal_value_is_1.jpg

    State image component changes image based on Signal value

Using the Signal List component to manage online Signal values
Abstract

Check out this article and learn more details on how to view signal values in your visualizations, using the Signal List component.

The Signal List component is a collection of numeric and textual display extensions that can display signal values with labels and icons.

Depending on the design-time configuration, the Signal List component allows the users the possibility to read and write online Signal values in i4designer visualizations.

Adding Signals at design-time

The i4designer component allows the user the possibility to add Signals at design-time, as follows:

  1. Open an i4designer project in design mode. For the present tutorial, we shall use an i4SCADA platform project.

  2. Go to the Toolbox panel in the contextual actions area, drag the Signal List component to your project page and proceed as follows:

    Signal_List_comp.jpg
    1. Expand the Signals property, under the Signal category, by clicking the Expand array list button.

      Signals_expand_array_list.jpg
    2. To add signals to the configuration click the Add new item button. The view is expanded to display one new Signal item.

      Add_new_signal_at_design_time.jpg
    3. In the signal item area, you can either type in the name of your Signal, or you can use the Signal browser panel to select it from the list view.

      Apply_signal.jpg

      Tip

      The list of design-time Signals can be populated by adding Signals to your i4designer project. For more details on how to add Signals to a Designer project, please visit the dedicated tutorials, here.

    4. Next, expand the Default signal configuration property, in the Signal category, and set the desired signal configuration.

      Default_signal_config_properties.jpg

      Important

      The settings of the Default signal configuration properties will be applied to all the Signals in the list.

      Tip

      For more details about each Default signal configuration property please read the dedicated article, here.

    5. To override the Default Signal configuration properties, for one or multiple Signals, expand the Override signals configuration property, under the Signal category. Select your desired configurations.

      Override_signal_config_properties.jpg

      Tip

      For more details about each Default signal configuration property please read the dedicated article, here.

  3. Make sure your changes are saved.

  4. Build and publish your project.

    Build_and_publish.jpg

    Tip

    For more details about i4SCADA platform deployments, please visit the dedicated tutorials here.

    If your project is targeting an i4connected environment, please read more details about i4connected platform details, please visit the dedicated article here.

  5. Access your target environment and open the visualization containing your i4designer project.

  6. The Signal List component is displayed and all the previously configured Signals are visible.

    Project_with_signals.jpg
  7. To populate the list of Signals, click the Add Signals button.

    Add_Signals_button.jpg
  8. Using the Signal Selector dialog, select the desired Signals. Once the signals are selected, they will be displayed in the Series list. To confirm your selection click the Save Changes button.

    Signal_selector.jpg
  9. The Signal List is populated with the selected Signals. The list is spread through three columns: The Signal name, the Signal value, and the Signal unit.

    The listed Signals expose their current value, and any changes at the Signal value level will be displayed in this view.

    List_populated.jpg
Adding Signals at run-time

The Signal List component allows you the possibility to add Signals in your visualization, regardless if there were no Signals configured at design time. Please follow the steps below:

  1. Open an i4designer project in design mode. For the present tutorial, we shall use an i4SCADA platform project.

  2. Go to the Toolbox panel in the contextual actions area, drag the Signal List component to your project page. Since our goal is to add Signals to the list at run-time, we shall leave the default settings on.

    Signal_List_comp.jpg
  3. Build and publish your project.

    Tip

    For more details about i4SCADA platform deployments, please visit the dedicated tutorials here.

    If your project is targeting an i4connected environment, please read more details about i4connected platform details, please visit the dedicated article here.

  4. Access your target environment and open the visualization containing your i4designer project.

  5. The Signal List component is displayed. Since no Signals were added at design time, the list will be empty.

    Visualization.jpg
  6. To populate the list of Signals, click the Add Signals button.

    Add_Signals_button.jpg
  7. Using the Signal Selector dialog, select the desired Signals. Once the signals are selected, they will be displayed in the Series list. To confirm your selection click the Save Changes button.

    Signal_selector.jpg
  8. The Signal List is populated with the selected Signals. The list is spread through three columns: The Signal name, the Signal value, and the Signal unit.

    The listed Signals expose their current value, and any changes at the Signal value level will be displayed in this view.

    List_populated.jpg
Writing Signal values

To write new values to your Signals, please proceed as follows:

  1. Open an i4designer project in design mode. For the present tutorial, we shall use an i4SCADA platform project. You can either add your Signals at design time or at run time.

  2. Expand the Default signal configuration property, in the Signal category, and set the Mode property to value ReadWrite.

    ReadWrite.jpg

    Tip

    You can set the ReadWrite mode for specific Signals only, under the Override signals configuration properties.

  3. Build and publish your project.

    Tip

    For more details about i4SCADA platform deployments, please visit the dedicated tutorials here.

    If your project is targeting an i4connected environment, please read more details about i4connected platform details, please visit the dedicated article here.

  4. Access your target environment and open the visualization containing your i4designer project.

  5. The Signal List component is displayed.

    List_of_signals.jpg
  6. To change the current Signal value, click in the Signal value area and type in the new value.

    NewValue.jpg
  7. The Signal update is done and the new value will now be displayed.

    ValueOK.jpg
Exporting Signals

You can obtain an output of the Signals list as follows:

  1. Click the Export toolbar button. The exported content will be saved on your local machine, to a storage location of your choice.

    Signal_List_exporty.jpg
  2. The Signal list document is saved in CSV format.

    Exported_file.jpg
Importing Signal values

The Import function of the Signal List component allows you to write multiple Signal values, for a list of already configured Signals, as follows:

  1. Click the Import button.

    Import_button.jpg
  2. The Open dialog is opened, allowing you to browse for the import file, on your local computer.

    Import_dilaog.jpg

    Important

    The import file needs to be a CSV file, that you can manually update before

    Import_file.jpg
  3. After finding the desired import file, click the Open button. The Import will take place in the system's background. As soon as it is finished the new values will be displayed in the Signal List.

    Import_done.jpg

    Warning

    Since the import function only allows Signal value updates, if any new/unknown Signal is found in the import file it will be ignored. Only the Signals available in the Signal List will be updated.

Save and Load predefined configurations

Previous configurations at the level of the Signal List component can be stored and reused, as follows:

  1. Click the Configuration toolbar button.

    Configuration.jpg
  2. The Configuration window is opened, displaying the following areas:

    1. The Add / Import new configuration area features an easy method to define new configurations or to update the existing configurations, by typing in the name of the configuration and clicking the Add / Update button. The Import new configuration allows you to browse for the import file, from your local computer.

      Tip

      There can not be multiple configurations with the same name, for the same component. In an attempt to add a duplicate configuration, the Add button, displayed in the Add new configuration section, is changed into an Update button.

      add_new.jpg
    2. The Existing configurations area lists all the configurations, available for the Alarm viewer. The Existing configurations table features the following columns:

      existing_config.jpg
      • Name - the name of the component configuration, provided by the creator user, at the moment of creation. There cannot be multiple configurations with the same name, in the context of one single component.

      • Owner - the user that owns the component configuration.

      • Created On - the creation date.

      • Namespace - the value of the Namespace property, as defined at design-time.

      • Actions - the actions available for the selected configuration. The scope of the Actions area is to allow the user to either load configurations or remove them.

        The Apply button enforces the selected configuration to the component. As soon as an existing configuration is applied, the Configurations window is closed and the component is updated according to the configurations

        The Export button exports the configuration on your local machine, to a storage location of your choice.

        The Delete button removes the selected configuration.

        As soon as an existing configuration is selected and the user clicks the Delete button, a confirmation dialog pops up asking for the user decision (Yes / No buttons).

        Delete_config.jpg