PSC-Datei erstellen und exportieren - 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
PSC-Datei erstellen und exportieren

Voraussetzung

Einleitung

Über TIA Portal Openness können Sie eine PSC-Datei erstellen und ein Gerät in die Datei laden. Um eine PSC-Datei zu erstellen und eine Gerätekonfiguration in die Datei zu laden, können Sie die Methode Export() des Dienstes CardReaderPscProvider verwenden, die Teil des Namespace Siemens.Engineering.HW.Utilities ist.

Sie können nur dann eine PSC-Datei erstellen und eine Gerätekonfiguration in eine PSC-Datei laden, wenn im Parameter keine PSC-Datei vorhanden ist.

Zum Erstellen und Öffnen einer PSC-Datei gibt es keinen eigenen Befehl. Wenn eine PSC-Datei als Parameter vorhanden ist, löst die Methode Export() eine Ausnahme aus und überschreibt die Datei nicht.

Hinweis

Aus Sicherheitsgründen wird der Exportvorgang für F-aktivierte Geräte in V18 und früher nicht unterstützt (beim Export wird eine Ausnahme zurückgegeben).

Aus TIA Portal Openness V20 können Sie eine verschlüsselte PSC-Datei exportieren. Um eine verschlüsselte PSC-Datei zu exportieren, verwenden Sie die überladene Export()-Methode mit dem zusätzlichen Password-Parameter.

Hinweis

Die PSC-Verschlüsselung wird auf Geräten mit CPU-Version V40.0 und höher unterstützt.

Methode

Methodenname

Beschreibung

void Export(Device device, FileInfo fileName)

Zum Exportieren einer PSC-Datei und zum Herunterladen einer Gerätekonfiguration in eine PSC-Datei.

Die Export()-Methode akzeptiert die folgenden Parameter:

  • Gerät: Gibt das zu exportierende Gerät an.

  • fileName: Gibt den Dateinamen an, unter dem die PSC-Datei gespeichert wird.

void Export(Device device, FileInfo fileName, SecureString password)

Zum Exportieren einer verschlüsselten PSC-Datei.

Die Export()-Methode ist eine Methodenüberladung, die den folgenden zusätzlichen Parameter akzeptiert:

  • Password: Zum Verschlüsseln oder Entschlüsseln des Archivinhalts.

Ausnahme

Siemens.Engineering.EngineeringTargetInvocationException wird unter folgender Bedingung ausgelöst:

  • Das ausgewählte Gerät unterstützt keine Verschlüsselung

Siemens.Engineering.EngineeringPasswordPolicyViolationException wird unter folgenden Bedingungen ausgelöst:

  • Das angegebene Passwort ist null

  • Das angegebene Passwort entspricht nicht den Kriterien der Richtlinie

Programmcode

Ändern Sie folgenden Programmcode, um eine PSC-Datei zu erstellen und zu exportieren:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

private static void PscFileExport(Project myProject)

{

    // Preconditions

    Device ipcDevice = myProject.Devices.Find("IPC427D");

    FileInfo exportFile = new FileInfo

    (@"C:\Users\Ertan\Documents\Automation\PC system configuration74.psc");

    //Get the card reader provider from hardware utilities

    HardwareUtilityComposition utilities = myProject.HwUtilities;

    HardwareUtility utility = utilities.Find("CardReaderPscProvider");

    CardReaderPscProvider crp = (CardReaderPscProvider)utility;

    //Perform the export

    crp.Export(ipcDevice, exportFile);

}

Ändern Sie den Programmcode, um eine verschlüsselte PSC-Datei zu exportieren:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

private static void EncryptedPscFileExport(SecurePassword password)

{

    Project testProject = project;

    HardwareUtilityComposition utilComp = testProject.HwUtilities;

    HardwareUtility utility = utilComp.Find("CardReaderPscProvider");

    CardReaderPscProvider cardReaderPscProvider = (CardReaderPscProvider)utility;

    Device device = testProject.Devices.Find("name_Of_Device");

    FileInfo fullPathOfFile = GetFullPathOfFile();

    SecureString password = GetSecurePassword();

    cardReaderPscProvider.Export(device, fullPathOfFile, password);

}