Systemrollen - 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
Systemrollen

Voraussetzung

Einleitung

Bei der Verwendung von TIA Portal Openness können Sie die folgenden Aufgaben für benutzerdefinierte Rollen und Geräte-Funktionsrechte ausführen:

  • Alle Systemrollen in einem Projekt abrufen

  • Eine bestimmte Systemrolle in einem Projekt suchen

  • Alle zugewiesenen Engineering-Rechte einer bestimmten Systemrolle abrufen

  • Alle zugewiesenen Systemgeräte-Funktionsrechte für eine Systemrolle abrufen

Für Systemrollen wird der Wert der Namenseigenschaft anhand der Sprache der TIA Portal-Benutzeroberfläche definiert. Der Wert der Bezeichnereigenschaft ist unabhängig von der Sprache der Benutzeroberfläche des TIA Portals immer konstant.

Für "Find" sollte der Eigenschaftswert des API-Bezeichners verwendet werden.

Programmcode

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

private static void SystemRolesFunctionRights(Project project, Device device)

{

    UmacConfigurator umacConfiguratorService = project.GetService<UmacConfigurator>();

    var umacDevice = device.GetService<UmacDevice>();

    //Retrieve all system role

    var systemRoles = umacConfiguratorService.SystemRoles;

    //Iterate through the system roles

    foreach (var sr in systemRoles)

    {

    string systemRoleName = sr.Name;

    }

    // Find a system role

    SystemRole systemRole = systemRoles.Find("SystemRole_01");

   //Retrieve assigned System Device Function Rights from system role

   IList<SystemDeviceFunctionRight> assignedSystemDeviceFunctionRights =

   (IList<SystemDeviceFunctionRight>)systemRole.

   GetAssignedSystemDeviceFunctionRights(umacDevice);

   //Retrieve assigned Engineering Function Rights from system role

   var engineeringFunctionRights = systemRole.AssignedEngineeringRights;

}