Home
Datenmanagement
Klassifizieren, strukturieren und archivieren sie Ihre Daten.
Common Name Service (CNS)
Mit dem Anlagenmodell-Editor können auf Basis von CNS Datenstrukturen in Form von Views und Bäumen aufgebaut und verwaltet werden.
CNS Control Functions
cnsChangeNodeData
Changes the datapoint (element) and type of the given node.

Versionsinformationen
Release Notes, Update-Informationen, Zertifizierungen and häufig gestellte Fragen.
Konzepte
Ihr erster Schritt in die moderne und leistungsstarke Prozessvisualisierung.
Deployment
Themen, die Sie vor der Nutzung von WinCC OA wissen sollten.
Sicherheit
Wachsen sie in Bezug auf Cybersecurity über die Norm hinaus.
Engineering
Leistungsstarke Tools für einfache sowie komplexe Engineering-Aufgaben.
Datenmanagement
Klassifizieren, strukturieren und archivieren sie Ihre Daten.
- Archivierung
  Übersicht der momentan von WinCC OA angebotenen Lösungen für die Protokollierung bzw. Archivierung.
- Module PARA
  Grafische Oberfläche zum Bearbeiten von Datenpunkttypen und Datenpunkten.
- Common Name Service (CNS)
  Mit dem Anlagenmodell-Editor können auf Basis von CNS Datenstrukturen in Form von Views und Bäumen aufgebaut und verwaltet werden.
  - Editor
  - Viewer
  - OPC
  - Modbus
  - MQTT
  - Log
  - Nodetype
  - CNS Control Functions
    - cnsAddNode
      Adds a new node to a tree or sub-tree.
    - cnsAddTree
      Allows to create a tree or sub-tree.
    - cnsAddObserver
      Registers the given function as CNS observer.
    - cnsChangeNodeData
      Changes the datapoint (element) and type of the given node.
    - cnsChangeNodeDisplayNames
      Changes the display name of the given node.
    - cnsChangeNodeName
      Changes the ID of the given node.
    - cnsChangeTree
      Replaces a tree or sub-tree with a new tree.
    - cnsChangeViewDisplayNames
      Changes the display name of the given tree.
    - cnsChangeViewName
      Changes the ID of the given view.
    - cnsChangeViewSeparators
      Changes the separators of the given view.
    - cnsCreateView
      Allows to create a new view.
    - cnsDeleteTree
      Allows to delete a tree, sub-tree or node.
    - cnsDeleteView
      Allows to delete a view (with all its trees).
    - cnsGetAccessRight
      Returns the AccessRight (value of the defined parameter "propertyKey") as UINT for the given node.
    - cnsGetChildren
      Returns the ID paths of all child element of a node.
    - cnsGetDisplayNames
      Returns the display names of a node.
    - cnsGetDisplayPath
      Returns the display name path of a node
    - cnsGetId
      Returns the linked datapoint and CNSDataIdentifierType of the given node.
    - cnsGetIdSet()
      Returns the names of datapoints linked to the matching nodes.
    - cnsGetNodesByData
      Looks for nodes that are linked to the given datapoint (element).
    - cnsGetNodesByName()
      Looks for ID paths of nodes that match the given criteria.
    - cnsGetOPCAccessRight
      Returns the OPC AccessLevel (value of the key OA:OPC) as UINT for the given node.
    - cnsGetParent
      Returns the path of the parent node.
    - cnsGetProperty
      Retrieves the key value from the property of the defined node.
    - cnsGetPropertyKeys
      Returns a list of all keys which are defined for the given node.
    - cnsGetRoot
      Returns the ID path of the root node of the tree which contains the given node.
    - cnsGetSystemNames
      Returns the display names of the given system.
    - cnsGetTrees
      Returns the ID paths of all trees of the given view.
    - cnsGetUserData
      Returns the user data stored in a node.
    - cnsGetViewDisplayNames
      Returns the display names of the given view.
    - cnsGetViewSeparators
      Returns the separators of the given view.
    - cnsGetViews
      Returns the paths of all views in the given system.
    - cnsRemoveObserver
      De-registers the given observer function.
    - cnsRemoveProperty
      Removes the key from the property of the given node.
    - cnsSetProperty
      Sets the properties for the given node as key/value pair.
    - cnsSetSystemNames
      Changes the display name of the given system.
    - cnsSetUserData
      Stores user data in a node.
    - cnsSubStr
      Extracts parts of a CNS path.
    - cns_checkId
      Checks whether the ID is valid.
    - cns_checkName
      Checks whether the given display name is valid.
    - cns_checkSeparator
      Checks if the separator is valid or not.
    - cns_createNodeType
      Creates a new node type.
    - cns_createTreeOrNode
      Creates a tree or a node and adds it to the given parent element.
    - cns_createView
      Creates a new view.
    - cns_createViewDp
      Creates a internal datapoint for the given view.
    - cns_deleteNodeType
      Deletes the given node type.
    - cns_deleteTreeOrNode
      Deletes the given tree or node.
    - cns_deleteView
      Deletes the given view.
    - cns_deleteViewDp
      Deletes the internal datapoint which is linked to the given view.
    - Common Name Service Control Functions
      The following control functions are provided for an easier use of the Common Name Service feature in scripts.
    - cns_getNodeIcon
      Returns the path of the icon defined for the given ID.
    - cns_getNodeTypeDisplayName
      Returns the display name of the given node type.
    - cns_getNodeTypeIcon
      Returns the icon path of the given node type.
    - cns_getNodeTypeValue
      Returns the value of the given node type.
    - cns_getNodeTypes
      Returns all existing node types.
    - cns_getReadableViews
      Returns a list with all views (for which the current permission is sufficient) of the given system.
    - cns_getViewPermission
      Returns the permission bits defined for the given view.
    - cns_isNode
      Checks whether the given ID path is a node.
    - cns_isTree
      Checks whether the given node ID is a tree or not.
    - cns_isView
      Checks whether the given ID is a view.
    - cns_nodeExists
      Checks if the given node exists.
    - cns_setNodeIcon
      Sets an icon for the given node.
    - cns_setNodeTypeDisplayName
      Sets the multilingual display name of a node type.
    - cns_setNodeTypeIcon
      Allows to set an icon for the given node type.
    - cns_setNodeTypeValue
      Sets the value of the given node type.
    - cns_setViewPermission
      Sets the permission for the given view.
    - cns_treeExists
      Checks whether the given tree exists.
    - cns_viewDpToName
      Returns the ID of the view which is linked to the given internal data point.
    - cns_viewExists
      Checks whether the given view exists or not.
    - cns_viewNameToDpName
      Returns the name of the internal datapoint linked to the given view.
    - cns_changeNodeTypeName
      Changes the ID of a node type.
    - cns_changeViewName
      Changes the ID of the given view.
- Massen-Parametrierung
  Durch die Massenparametrierung in WinCC OA werden Grundlagen für das Aufsetzen eines Projektes und in weiterer Folge die Parametrierung der verschiedensten Datenpunkte neu definiert.
- SQL Panel
  Das SQL-Panel erlaubt mit Hilfe von SQL-Statements Abfragen von aktuellen sowie archivierten Daten aus der WinCC OA Datenbank.
- ASCII-Manager
  Der ASCII-Manager erlaubt es, Datenpunkte und Datenpunkttypen sowie die Parametrierung von Datenpunkten ein- und auszuspielen und damit auch zu ändern.
- Korrekturwerte und Laborwerte
  Mit diesen Panels kann man bestehende Werte ändern (=korrigieren), Werte aus der History DB und RDB abfragen sowie neue Werte in dieselben einfügen.
- Datenpunktgruppen
  Hauptziel ist die einfachere Auswahl von Datenpunkten und Datenpunktelementen.
- Verzögerte Alarme
  Mit verzögerten Alarmen kann eine Meldeverzögerung parametriert werden. Damit können kurze Bereichsänderungen ausgefiltert werden.
- Relationale DBs mit Control-ADO
  Die DB-Schnittstellen in WinCC OA bieten die Möglichkeit eines Zugriffs auf externe Datenbanken.
Business Logic / Control
Endlose Möglichkeiten in der Datenverarbeitung für Ihre Projekte.
Datenvisualisierung
User Interfaces, Trends und Reports für jeden Zweck und jedes Gerät.
Southbound Interfaces
Der Prozessanschluss zu den echten Maschinen/Sensoren.
Northbound Interfaces
Ihr Portal zur Cloud oder übergeordneten Systemen.
Konnektivität / Netzwerk Schnittstellen
Datenaustausch, APIs und moderne (Web) Technologien.
Benutzerverwaltung
Alles über Autorisierung, Authentifizierung und Login-Anpassung.
Verfügbarkeit
Wie sie maximale Systemverfügbarkeit erreichen können.
Reporting
Erstellen sie "State of the art"-Reports ohne Limits.
Erweiterungen
Nützliche Werkzeuge und Erweiterungen für spezielle Anforderungen.
Referenztabellen
Detaillierte und umfangreiche Inhalte für spezielle Projektanpassungen.
Videos & Tutorials
Erkunden Sie die Möglichkeiten von WinCC OA mit unserer sorgfältig ausgewählten Sammlung von Video-Tutorials und Anleitungen.
Dokumentation
Grundlegende Informationen über Bezeichnungen und Funktionsweisen innerhalb der Dokumentation.
Support & Services
Ein erfahrenes Team von Support-Mitarbeitern, Beratern und Trainern steht bereit, aktive Partnerschaften mit Kunden zu fördern, die von unserem umfassenden Service profitieren.
Disclaimer
Erläuterungen zu Haftungsausschlüssen oder rechtlichen Hinweisen.

cnsChangeNodeData

Changes the datapoint (element) and type of the given node.

Synopsis

bool cnsChangeNodeData(string cnsPath, string dp [, int type]);

Parameters


Parameter	Description
cnsPath	ID path of the node
dp	Name of the new datapoint (element)
type	CNSDataIdentifierType of the node

Return value

Returns TRUE if successful or FALSE in case of an error.

Errors

Description

The function changes the linked datapoint (element) of a node. In order to remove a datapoint it is possible to specify an empty string. If not explicitly defined, either CNS_DATATYPE_EMPTY (in case of dp == "") or CNS_DATATYPE_DATAPOINT (in case of a defined datapoint (element)) is used as CNSDataIdentifierType.

main()
{
  cnsChangeNodeData("System1.View1:TreeA.Node", "ExampleDP_int", 501);
}

Availability

UI, CTRL