Detaillierte Informationen über das Audit Trail Panel

Dieses Kapitel beschreibt die Funktionen writeAuditEntry und writeAuditBatchEntrysowie den_auditTrail-Datenpunkttyp. Die FunktionenwriteAuditEntry und writeAuditBatchEntrywerden verwendet, um die Einträge für das Audit Trail Panel zu generieren. Die Funktionen sind in derscripts/libs/userMan.ctlDatei enthalten. Die Einträge bekommen Sie durch Definieren von Parametern für die oben erwähnten Funktionen. Die Funktionen und Parameter werden im Folgenden beschrieben:

writeAuditEntry()

Über die Funktion writeAuditEntry werden Sollwerte in das Audit Trail Panel geschrieben.

Synopsis

writeAuditEntry(anytype dpe,anytype alterWert,anytype neuerWert,int &fehler, string grund= "");

Parameter


Parameter	Bedeutung
dpe	Das Datenpunktelement (z.B. string dpe = "sollwert"). Kann auch eine dyn_string sein.
alterWert	Einer oder mehrere Werte (z.B. float alterWert = 85). Wenn der Parameter vom Typ dyn ist, können mehrere Werte geschrieben werden.
neuerWert	Einer oder mehrere Werte (z.B. float neuerWert = 80). Wenn der Parameter vom Typ dyn ist, können mehrere Werte geschrieben werden.
&fehler	Zurückgelieferter Fehlercode. 0 == OK -1 dynlen(alterWert) !==dynlen(neuerWert). Das bedeutet, dass mehrere Werte auf einmal gesetzt wurden und die Anzahl der Werte nicht übereinstimmt.
grund= ""	Grund (ein beliebiger Text ) warum der Wert geändert wurde. Der Defaultwert ist leer.

Rückgabewert

Keine

Beschreibung

Die Funktion wird für Sollwerte verwendet (z.B. für den Sollwert des Wasserspiegels oder Sollwert für Spritzguss) und schreibt die alten und neuen Werte, sowie den Grund warum der Wert geändert wurde. Der Grund ist jedoch optional und kann leer gelassen werden. Beachten Sie, dass Sie die Funktion aufrufen müssen, um die Datenpunktparametrierungen (Wertänderungen) vom PARA in das Audit Trail Panel zu bekommen. Die Werte werden nicht automatisch in das Audit Trail Panel geschrieben.

Beispiel

Die Funktion schreibt das betroffene Gerät (DPE) "sollwert", den alten Wert 85 und neuen Wert 80 sowie den Grund warum der Wert geändert wurde "Zu hohe Temperatur beim Spritzguss" in das Audit Trail-Panel.

main()
{
  string dpe = "sollwert";
  float alterWert = 85;
  float neuerWert = 80;
  string grund = "Zu hohe Temperatur beim Spritzguss";
  int fehler;
  writeAuditEntry(dpe,alterWert ,neuerWert ,fehler,grund);
  DebugN(dpe,alterWert,neuerWert,fehler,grund);
}

writeAuditBatchEntry

Die Funktion wird z.B. in Produktionsprozessen verwendet. Sie schreibt die ChargenID, das Datenpunktelement (auf das die ausgeführte Aktion einen Einfluss hatte), den Datenpunkttyp, die ausgeführte Aktion und den Grund warum die Aktion ausgeführt wurde.

Synopsis

writeAuditBatchEntry(unsigned chargID,string DPitem,string itemtyp,string aktion,int &fehler,string grund= "");

Parameter


Parameter	Bedeutung
chargID	Die ID-Nummer eines Prozesses wenn eine Prozessnummer existiert.
DPitem	Das Datenpunktelement auf das die ausgeführte Aktion einen Einfluss hatte (z.B. string DPitem = "prod_proz";).
itemtyp	Der Datenpunkttyp. Der Typ wird jedoch nicht im Audit Trail Panel angezeigt.
aktion	Die ausgeführte Aktion (z.B. string aktion ="Produktionsprozess gestartet").
&fehler	Der zurückgelieferte Fehlercode. 0 == OK
grund= ""	Grund warum die Aktion ausgeführt wurde. Der Defaultwert ist leer.

Rückgabewert

Keine

Fehler

Wenn der zurückgelieferte Code 0 ist, gibt es keinen Fehler. Fehlerbehandlung nicht vorhanden.

Beschreibung

Über die Funktion writeAuditBatchEntry werden Informationen wie chargenID, Aktion usw. (siehe Parameter oberhalb) in das Audit Trail Panel geschrieben.

Beispiel

Die Funktion schreibt die ChargenID (Nummer) 4, DPE "prod_proz", Aktion "Produktionsprozess gestartet" und den Grund "Starte Produktionsprozess" in das Audit Trail Panel.

main()
{
  unsigned chargID = 4;
  string DPitem = "prod_proz";
  string itemtyp = "proz";
  string aktion = "Produktionsprozess gestartet";
  int fehler;
  string grund = "Starte Produktionsprozess";
  writeAuditBatchEntry(chargID,DPitem,itemtyp,aktion,fehler,grund);
  DebugN(chargID,DPitem,itemtyp,aktion,grund);
}

_AuditTrail Datenpunkttyp

Die folgende Tabelle zeigt die Struktur des _AuditTrail-Datenpunkttyps:


Element	Bedeutung
time	Zeit wann die "Aktion" (Wertänderung) ausgeführt wurde.
username	Der Benutzername.
uinum	Die Nummer der Benutzeroberfläche (UI).
batchid	Die ChargenID wenn die ausgeführte Aktion eine Chargennummer hat.
item	Das Datenpunktelement auf das die ausgeführte Aktion einen Einfluss hatte.
itemtype	Der Datenpunkttyp.
action	Die ausgeführte Aktion.
oldval	Der alte Wert.
newval	Der neue Wert.
reason	Der Grund warum der Wert geändert wurde.