SigniertWrite()
- Last UpdatedApr 24, 2026
- 5 minute read
Führt einen Schreibvorgang auf ein Attribut AutomationObject aus, das eine Sicherheitsklasse Gesicherter Schreibvorgang oder Verifizierter Schreibvorgang hat.
Hinweis: SignedWrite() wird derzeit nur für InTouch HMI-Projekte unterstützt.
Kategorie
Sonstige
Syntax
int SignedWrite(string Attribut,
object Wert,
string ReasonDescription,
Bool Comment_Is_Editable,
Enum Comment_Enforcement,
string[] Predefined_Comment_List
);
Klammern [ ] geben ein Array an.
Parameter
|
Attribut |
Der Name des zu aktualisierenden Attributs (Datentyp: Zeichenfolge). Kann eine konstante Zeichenfolge, ein Verweis oder ein Ausdruck sein. Unterstützt gebundene und mehrstufig gebundene Verweise. Für detaillierte Beispiel zur Verwendung des Attribute-Parameters, siehe das Thema Beispiele für den Attributparameter der Funktion SignedWrite() unter „Grafiken verwalten“ im Creating and Managing Industrial Graphics User Guide. Beispiel 1: "UserDEnterefined_001.temp" Beispiel 2: "Pump15" + ".valve4" Beispiel 3: Mit UDO_7, was die beiden Zeichenfolgen-Attribute, namestrA und namestrB gesetzt auf
die Werte „Tank1“ bzw. „Tank5“ enthält, schreibt folgendes Skript in Tank1.Level oder
Tank5.Level, je nachdem, ob strselect „A“ oder „B“ ist: Dim strselect als String; Dim x As Indirect; { logic to set strselect to "A" or "B" } x.BindTo ("UDO_7.namestr" + strselect); SignedWrite(x + ".Level", 243, "Set " + x + " Level", true, 0, null); |
|
Wert |
Der Wert, der geschrieben werden soll. Der Datentyp ist Objekt. Der gültige Bereich für den Wert muss dem Datentyp des zu aktualisierenden Attributs entsprechen. Der Wert kann ein konstanter Wert, ein Verweis, ein Ausdruck oder NULL sein, wenn nichts eingegeben werden soll. |
|
ReasonDescription |
Text, der den Zweck des Zielattributs und die Auswirkungen einer Änderung erklärt. Der Datentyp ist eine Zeichenfolge mit maximal 256 Zeichen. Kann eine konstante Zeichenfolge, ein Verweis oder ein Ausdruck sein. ReasonDescription wird im Rahmen des Schreibvorgangs an das angegebene Attribut weitergegeben. Das Objekt beinhaltet auch den Schreibkommentar des Benutzers, wenn vorhanden. Die Beschreibung Feld-Attribut wird nur für den Parameter ReasonDescription verwendet, wenn das Attribut ein Feld-Attribut ist und eine Beschreibung hat (nicht Null ist). Ansonsten wird die Kurzbeschreibung für das entsprechende ApplicationObject verwendet für den Parameter ReasonDescription. |
|
Comment_is_Editable |
Dieser Parameter gibt an, ob ein Benutzer den Schreibkommentar bearbeiten kann. Der Datentyp ist „Boolean“. Bei True: Das Kommentartextfeld ist mit Ausnahmen aktiviert.
|
|
Comment_Enforcement |
Dieser Parameter hat den Datentyp „Aufzählung“ und folgende Wertoptionen: 0 = Optional 1 = Mandatory 2 = PredefinedOnly |
|
Predefined_Comment_List |
Ein Zeichenfolgen-Array, das für vordefinierte Kommentare verwendet werden kann. Der Datentyp ist „Zeichenfolge“. Es sind maximal 20 Kommentare mit jeweils maximal 200 Zeichen zulässig.
|
Rückgabewerte
Rückgabewerte geben die Zustände Erfolg oder Fehler an. Ein Zustand, der nicht den Wert Null hat, gibt den Typ des Fehlers an.
|
0 |
Die Funktion gibt einen Wert von 0 zurück (bedeutet Erfolg), wenn folgendes alles wahr ist:
|
|
1 |
Die Funktion ist aufgrund eines Fehlers fehlgeschlagen, der nicht von den anderen angegebenen Rückgabewerte abgedeckt ist. Dies beinhaltet jeden Fehler, der nicht von den anderen angegebenen Rückgabewerte abgedeckt ist. Wenn ein Fehler auftritt, wird eine bestimmte Meldung im Logger protokolliert. |
|
2 |
Ein oder mehrere Parameter wurde nicht auf den geeigneten Datentyp zur Laufzeit gezwungen. Beispiel: Der Parameter ist ein Verweis, für den der Datentyp Boolean erwartet wird. Zur Laufzeit wird auf den Datentyp Zeichenfolge verwiesen, der nicht auf True oder False gezwungen werden kann. Die Funktion gibt diesen Wert zurück und schreibt eine Meldung in den Logger. |
|
3 |
Der Attribut-Parameter war zur Laufzeit nicht gültig.
|
|
4 |
Der Wert des Parameters Comment_Enforcement ist außerhalb des Bereichs für gültige Enumerator-Objekte gelegen. |
Anmerkungen
Die Funktion SignedWrite() wird nur für Client-Skripte und nicht für Objekt-Skripte unterstützt.
Ein Rückgabewert von 0 bedeutet nicht, dass das Attribut aktualisiert wurde, sondern nur, dass die Funktion als Eintrag in der Warteschlange für das Schreiben eines Attributs platziert wurde. Der Benutzer kann entscheiden, ob der Vorgang nach dem Anzeigen des Dialogfelds Gesicherter Schreibvorgang oder Verifizierter Schreibvorgang abgebrochen wird. In diesem Fall wird das Attribut nicht aktualisiert und eine Meldung wird im Logger platziert, die angibt, dass der Benutzer den Vorgang abgebrochen hat. Auch wenn der Benutzer gültige Anmeldeinformationen eingegeben hat und auf OK klickt, kann es sein, dass das Attribut trotzdem nicht aktualisiert wurde, das ungeeignete Berechtigungen oder Umwandlungsregeln vorhanden sind.
Die Funktion SignedWrite() unterstützt die Weitergabe der benutzerdefinierten Eigenschaft als ersten Parameter mit öffnenden und schließenden Anführungszeichen, "".
Wenn die benutzerdefinierte Eigenschaft CP wie im folgenden Skript dargestellt konfiguriert wird, versucht das Skript CP auszulösen und zu bestimmen, ob es einen Verweis hat. Wenn es einen Verweis hat, dann wird der Verweis abgerufen und der Schreibvorgang wird auf den Verweis ausgeführt.
SignedWrite("CP", Wert, Grund, bearbeitbar, Erzwingung, null);
Für weitere Informationen zur Verwendung der Funktion SignedWrite(), siehe das Thema Mit der Funktion SignedWrite() für abgesicherte und kontrollbestätigte Schreibvorgänge arbeiten unter „Grafiken verwalten“ im Creating and Managing Industrial Graphics User Guide.
Beispiele
SignedWrite ("UserDefined_001.temp", 185, "Ändert die Ofentemperatur", true, 1, null);
Folgendes Beispiel zeigt dem Benutzer ein Array vordefinierter Kommentare:
Dim n als Integer;
n = SignedWrite("UserDefined_001.temp", 185, "Ändert die Ofentemperatur", true, 1, UserDefined_001.OvenCommentArray[ ]);
wobei UserDefined_001.OvenCommentArray ein Attribut ist, das ein Zeichenfolgen-Array enthält.