Attribute eines Knotens aufrufen

Attribute eines Knotens aufrufen - TIAPortal

TIA Portal Openness: API für die Automatisierung von Engineering-Workflows

ft:publication_title

TIA Portal Openness: API für die Automatisierung von Engineering-Workflows

Product

TIAPortal

Version

V20

Publication date

01/2025

Language

de-DE

Attribute eines Knotens aufrufen

Voraussetzung

Die TIA Portal Openness-Anwendung ist mit dem TIA Portal verbunden.

Siehe Verbindung zum TIA Portal aufbauen
Ein Projekt ist geöffnet.

Siehe Projekt öffnen

Anwendung

Ein Geräteelement bietet bestimmte obligatorische Attribute, die gelesen und/oder geschrieben werden können. Die Attribute sind nur verfügbar, wenn sie in der UI verfügbar sind. Der Schreibvorgang ist im Allgemeinen nur dann zulässig, wenn ein Attribut auch vom Benutzer in der UI geändert werden kann. Dies kann je nach Typ des Geräteelements variieren. Der Benutzer kann RouterAddress nur dann festlegen, wenn RouterUsed wahr ist. Wenn der Benutzer die SubnetMask am IO-Controller ändert, dann wird auch die Subnetzmaske auf allen IO-Devices auf denselben Wert geändert.

Attribute eines Knotens vom Typ ASI

Attribute	Datentyp	Schreibbar	Zugriff	Beschreibung
Name	String	r	modelliert	Name des Knotens.
NodeId	String	r	modelliert	ID des Knotens.
NodeType	NetType	r	modelliert	Ein Knoten ruft seinen Typen vom Subnetz ab.
Address	String	r/w	dynamisch	Weitere Attribute für AS-i-Slaves.

Attribute eines Knotens vom Typ Ethernet

Attribute	Datentyp	Schreibbar	Zugriff	Beschreibung
Name	String	r	modelliert	Name des Knotens.
NodeId	String	r	modelliert	ID des Knotens.
NodeType	NetType	r/w manchmal r/o	modelliert	Ein Knoten ruft seinen Typen vom Subnetz ab.
UseIsoProtocol	Bool	r/w	dynamisch	True, wenn ISO-Protokoll verwendet werden muss
MacAddress	String	r/w	dynamisch	z. B. 01-80-C2-00-00-00
UseIpProtocol	Bool	r/w	dynamisch	Dieser Wert kann auch dann gelesen werden, wenn er an der entsprechenden TIA UI-Steuerung nicht sichtbar ist.
IpProtocolSelection	Enum	r/w	dynamisch	-
Address	String	r/w	dynamisch	nur IPv4 und nicht IPv6 wird unterstützt
SubnetMask	String	r/w	dynamisch	-
UseRouter	Bool	r/w	dynamisch	-
RouterAddress	String	r/w	dynamisch	-
DhcpClientId	String	r/w	dynamisch	-
PnDeviceNameSetDirectly	Bool	r/w	dynamisch	PROFINET-Gerätename wird direkt am Gerät festgelegt. Nicht für jedes Gerät verfügbar.
PnDeviceNameAutoGeneration	Bool	r/w	dynamisch	PROFINET-Gerätename wird automatisch erstellt.
PnDeviceName	String	r/w	dynamisch	Eindeutiger Name im Subnetz.
PnDeviceNameConverted	String	r	dynamisch	Gerätename für systeminterne Nutzung umgewandelt.

Attribute eines Knotens vom Typ MPI

Attribut	Datentyp	Schreibbar	Zugriff	Beschreibung
Name	String	r	modelliert	Name des Knotens.
NodeId	String	r	modelliert	ID des Knotens.
NodeType	NetType	r	modelliert	Ein Knoten ruft seinen Typen vom Subnetz ab.
Address	String	r/w	dynamisch	-

Attribute eines Knotens vom Typ PC internal

Attribut	Datentyp	Schreibbar	Zugriff	Beschreibung
Name	String	r	modelliert	Name des Knotens.
NodeId	String	r	modelliert	ID des Knotens.
NodeType	NetType	r	modelliert	Ein Knoten ruft seinen Typen vom Subnetz ab.

Attribute eines Knotens vom Typ PROFIBUS

Attribut	Datentyp	Schreibbar	Zugriff	Beschreibung
Name	String	r	modelliert	Name des Knotens.
NodeId	String	r	modelliert	ID des Knotens.
NodeType	NetType	r	modelliert	Ein Knoten ruft seinen Typen vom Subnetz ab.
Address	String	r/w	dynamisch	Netzwerkadresse des Knotens. Der Typ der Adresse ist abhängig vom Knotentyp (z. B. IP-Adresse für PROFINET-Knoten, PROFIBUS-Adresse für PROFIBUS-Knoten)

Attribute eines Knotens vom Typ PROFIBUS Integrated

Attribut	Datentyp	Schreibbar	Zugriff	Beschreibung
Name	String	r	modelliert	Name des Knotens.
NodeId	String	r	modelliert	ID des Knotens.
NodeType	NetType	r	modelliert	Ein Knoten ruft seinen Typen vom Subnetz ab.
Address	String	r	dynamisch	-

Attribute eines Knotens vom Typ PROFIdrive Integrated

Attribut	Datentyp	Schreibbar	Zugriff	Beschreibung
Address	String	r	dynamisch	Netzwerkadresse des Knotens.
ConnectedSubnet	Subnetz	r	modelliert	Verbundenes Subnetz.
Name	String	r	modelliert	Name des Knotens.
NodeId	String	r	modelliert	ID des Knotens.
NodeType	NetType	r	modelliert	Ein Knoten ruft seinen Typen vom Subnetz ab.

Programmcode: Attribute eines Knotens

Um die Attribute eines Knotens abzurufen oder festzulegen, ändern Sie folgenden Programmcode:


Node node = ...; string nameValue = node.Name; NetType nodeType = (NetType)node.NodeType; node.NodeType = NetType.Mpi;

Node node = ...;

string nameValue = node.Name;

NetType nodeType = (NetType)node.NodeType;

node.NodeType = NetType.Mpi;

Programmcode: Dynamische Attribute

Um dynamische Attribute eines Knotens abzurufen oder festzulegen, ändern Sie folgenden Programmcode:


Node node = ...; var attributeNames = new[] { "Address", "SubnetMask", "RouterAddress", "UseRouter", "DhcpClientId", "IpProtocolSelection" }; foreach (var attributeName in attributeNames) { object attributeValue = ((IEngineeringObject)node).GetAttribute(attributeName); }

Node node = ...;

var attributeNames = new[]

{

"Address", "SubnetMask", "RouterAddress", "UseRouter", "DhcpClientId", "IpProtocolSelection"

};

foreach (var attributeName in attributeNames)

{

object attributeValue = ((IEngineeringObject)node).GetAttribute(attributeName);

}

Protokollauswahl

Wert	Beschreibung
IpProtocolSelection.None	Fehlerwert
IpProtocolSelection.Project	IP Suite innerhalb des Projekts konfiguriert.
IpProtocolSelection.Dhcp	IP Suite mit Hilfe von DHCP-Protokoll verwaltet. ID des DHCP-Client notwendig.
IpProtocolSelection.UserProgram	IP Suite mit Hilfe von FB (Funktionsbaustein) festgelegt.
IpProtocolSelection.OtherPath	IP Suite mit Hilfe von anderen Methoden festgelegt, z. B. PST Tool.
IpProtocolSelection.ViaIoController	IP Suite mit Hilfe von IO-Controller in Runtime festgelegt.

Netzwerktyp

Wert	Beschreibung
NetType.Asi	Netzwerktyp ist ASI.
NetType.Ethernet	Netzwerktyp ist Ethernet.
NetType.Link	Netzwerktyp ist Link.
NetType.Mpi	Netzwerktyp ist MPI.
NetType.PcInternal	Netzwerktyp ist PC internal.
NetType.Profibus	Netzwerktyp ist PROFIBUS.
NetType.ProfibusIntegrated	Netzwerktyp ist PROFIBUS Integrated.
NetType.ProfidriveIntegrated	Netzwerktyp ist PROFIdrive Integrated.
NetType.Ptp	Netzwerktyp ist PTP.
NetType.Wan	Netzwerktyp ist Wide Area Network (WAN).
NetType.Unknown	Netzwerktyp ist unbekannt.