Add IndexSubstitution or SubstiVar via API in Zenon12

Add IndexSubstitution or SubstiVar via API in Zenon12

Hello everyone,

I am currently facing an issue with the zenon API and I am running out of ideas what I might be doing wrong.

I am developing an Engineering Studio Wizard that creates ScreenSwitch functions.
Creating the ScreenSwitch itself works fine (picture, monitor, etc.), but I am struggling to correctly create and persist an IndexSubstitution (or SubstiVar) via the API.

No matter which approach I try (SetDynamicProperty, setting [-1], using indexed paths like [0].Source / [0].Destination), the substitution entries are not stored. When I read the values back immediately, the count stays 0, and in the XML export no <IndexSubstitution_0> / <SubstiVar_0> node is created.

It seems that the substitution collections are handled internally via a PropertyParameterAdapter, but I cannot find a documented or working example on how to properly create and fill these entries programmatically.

Has anyone successfully implemented IndexSubstitution or SubstiVar for ScreenSwitch functions via the zenon API and could point me in the right direction?

Any help or example code would be greatly appreciated.

Thank you very much!


  1. // Erstelle Funktion - Bildumschaltung
  2. IFunctionCollection functionCollection = myProject.FunctionCollection;
  3. IFunction newfunction = functionCollection.Create(sFunktionBildumschaltung, FunctionType.ScreenSwitch);

  5. newfunction.SetDynamicProperty("PictSwitch.Picture", "stbNewEnStatus");
  6. newfunction.SetDynamicProperty("PictSwitch.Monitor", "-2"); //Relativ Bildumschaltung

  8. newfunction.SetDynamicProperty("PictSwitch.IndexSubstitution[0].Source", "zziNewEnStatusVarvalue");
  9. newfunction.SetDynamicProperty("PictSwitch.IndexSubstitution[0].Destination", $"{sPfad}");

  11. newfunction.SetDynamicProperty("PictSwitch.IndexSubstitution[-1]", "1");


    Disclaimer

    This document governs the use of our Community Forum. By registering and using the platform, you accept these conditions.

    The COPA-DATA Community Forum serves to encourage the exchange of information and experience about the zenon software between forum users respectively zenon users.

    Please mind that any published information on the Community Forum is the subjective opinion and view based on the experience and the level of knowledge of the author. COPA-DATA does not overtake any responsibility for the content and the accuracy of the shared information.

    Users of the Community Forum are encouraged to share only well-founded experiences and to point out any risks associated with the implementation of proposed solutions to problems. COPA-DATA at its absolute discretion, reserves the right to moderate the forum. In this connection COPA-DATA may remove any information containing false facts, potentially dangerous solutions, bad language or content that may insult, degrade or discriminate others. COPA-DATA may block a non-complying user from forum access if the user violated this provision.

    COPA-DATA reserves the right to change this document from time to time at own discretion.


    Ing. Punzenberger COPA-DATA GmbH
    Karolingerstraße 7b · 5020 Salzburg · Austria
    www.copadata.com