Build the software development kit (SDK) examples solution

Follow the procedure below to retrieve the source code and build the examples' extended libraries on your system.

To build the software development kit (SDK) examples solution

1. Set up the Test and Development System.

   For more information around installation, please contact AVEVA Customer Support.

2. On the RealTime server in the Test and Development System, log on as dnaInstaller.

3. Install the RealTime.Service.msi file, if not already installed.

4. On the RealTime server in the Test and Development System, log on as a member of DNA Developers.

5. On the desktop, double-click the Windows PowerShell for DNA shortcut.

   Windows PowerShell for DNA opens.

6. Create a RealTime Developer Environment (refer to the AVEVA Enterprise SCADA Shared Components Developer documentation).

7. To build all the examples, proceed as follows:

   1. In Notepad, open the %DNASourceRoot%\RealTime\build.xml file.

   2. Locate the <ItemGroup Label="Solutions"> element.

   3. Add the following to the above element:

      DataExport.Examples.sln

      The updated section should look as follows:

      <ItemGroup Label="Solutions">

      <Solution Include="source\DataExport.Examples.sln" />

      </ItemGroup>

   4. Save and close the file

8. Select Start, and, in the Search field, enter Developer Command Prompt for Visual Studio.

9. Press Enter.

   The Visual Studio Developer Command Prompt window opens.

10. Execute the following commands:

    cd %DNASourceRoot%\RealTime

    msbuild build.xml

    Once msbuild completes successfully, the system will:

    • Copy the OASySDNA.RealTime.DataExport.ExamplePlugin.dll file to %DNADataRoot%\RealTime\bin.

    • Copy the OASySDNA.DataExport.UnitTests.dll file to %DNADataRoot%\RealTime\bin.

11. Copy the %DNASourceRoot%\RealTime\source\DataExport\RealTime_DataExport_SamplePlugin.json file to the %DNADataRoot%\RealTime\config\settings folder.

    Note: For information on overriding default configuration settings, see Modify configuration settings.

12. Restart the RealTime service.

    The sample code will watch for changes in the curval field of any analog record.

13. For this plugin to function, create at least one analog record and configure a simulator.

14. Test the code as follows:

    1. Update the value in the simulator to 75.

       The following message should appear in the oasErrLog.log file:

       Field curval changed, DO EXPORT CODE HERE. Old value is 0 and new value is 75

    2. Update the value in the simulator to 99.

       The following message should appear in the oasErrLog.log file:

       Field curval changed, DO EXPORT CODE HERE. Old value is 75 and new value is 99