Данный раздел описывает функции «writeAuditEntry» и «writeAuditBatchEntry», а также тип точки данных «_auditTrail». Функции «writeAuditEntry» и «writeAuditBatchEntry» используются для создания параметров панели контрольного журнала. Функции находятся в файле «scripts/libs/userMan.ctl». Можно получить записи путем определения параметров для вышеуказанных функций. Функции и параметры описаны ниже:

writeAuditEntry()

Функция «writeAuditEntry» используется для записи установленных значений в панель контрольного журнала.

Краткое описание

writeAuditEntry(anytype dpe, anytype oldvalue, anytype newvalue, int &error, string reason = «»);                                 

Параметры

Параметр	Значение
dpe	Элемент точки данных (напр., string dpe = «threshold_value»).   Также допускается «dyn_string».
oldvalue	Одно или несколько значений. Если параметр «dpe» имеет тип «dyn», могут записываться несколько значений (напр., float oldValue = 85).
newvalue	Одно или несколько значений. Если параметр «dpe» имеет тип «dyn», могут записываться несколько значений (напр., float newValue = 80).
&error	Возвращаемый код ошибкиПри отсутствии ошибки, возвращается код 0Если возвращаемый код равен -1, то  dynlen(oldvalue) !==dynlen(newvalue). Это означает одновременное определение нескольких значений, а количество значений не совпадает.
reason = «»	Причина (произвольный текст) изменения значения. Значение по умолчанию — пустое.

Возвращаемое значение

None (Нет функции)

Описание

Функция используется для уставок (напр., уставка уровня воды или пороговое значение литьевого формования) и фиксирует старые и новые значения, а также причину изменения значения. Тем не менее, причина — это дополнительный пункт и он может оставаться пустым. Необходимо отметить, что эту функцию следует вызывать в случае необходимости получения конфигураций точки данных (изменения значения) из PARA в панель контрольного журнала. Значения в панель контрольного журнала не записываются автоматически.

ПРИМЕР

Функция записывает информацию об используемом устройстве (dpe) «threshold_value»,  «oldvalue» 85 и «newvalue» 80, а также причину изменения значения «Too high temperature at injection molding»в панель контрольного журнала.

main()
{
string dpe = «threshold_value»;
float oldvalue = 85;
float newvalue = 80;
string reason = «Too high temperature at injection molding»;
int error;
writeAuditEntry(dpe,oldvalue,newvalue,error,reason);
DebugN(dpe,oldvalue,newvalue,error,reason);
}

writeAuditBatchEntry

Эта функция используется, например, в производственных процессах и записывает идентификационный номер партии, элемент точки данных, на который повлияло действие, тип точки данных, выполненное действие,а также причину выполнения действия.

Краткое описание

writeAuditBatchEntry(unsigned batchid, string item, string itemtype, string action, int &error, string reason = «»);       

Параметры

Параметр	Значение
batchid	Идентификационный номер процесса, если существует номер процесса.
item	Элемент точки данных, на который повлияло выполненное действие (напр., string item = «prod_proc»;).
itemtype	Тип точки данных. Тем не менее, тип не отображается в панели контрольного журнала.
action	Выполненное действие (напр., string reason = «Production process started»).
&error	Возвращаемый код ошибкиВ случае наличия ошибки, возвращается код 0Обработка ошибок не запрограммирована.
reason = «»	Причина выполнения действия. Значение по умолчанию — пустое.

Возвращаемое значение

None (Нет функции)

Ошибки

В случае наличия ошибки, возвращается код 0. Обработка ошибок не запрограммирована.

Описание

Функция «writeAuditBatchEntry» используется для записи информации, такой как «batchid», «action» и т.д. (см. параметры выше) в панель контрольного журнала.

ПРИМЕР

Функция записывает «batchID» 4, «item» — (dpe) «prod_proc», «action» — «Production process started», а также причину — «Start the production process» в панель контрольного журнала.main()
{
unsigned batchid = 4;
string item = «prod_proc»;
string itemtype = «proc»;
string action = «Production process started»;
int error;
string reason = «Start the production process»;
writeAuditBatchEntry(batchid,item,itemtype,action,error,reason);
DebugN(batchid,item,itemtype,action,reason);
}

_AuditTrail data point type

Следующая таблица отображает структуру типа точки данных «_AuditTrail»:

Элемент	Значение
time	Время выполнения «действия» (изменение значения).
username	Имя пользователя.
uinum	Номер интерфейса пользователя.
batchid	Идентификатор пакета, если выполненное действие имеет номер пакета.
item	Элемент точки данных, затронутый выполненным действием.
itemtype	Тип точки данных.
action	Выполненное действие.
oldval	Предыдущее значение.
newval	Новое значение.
reason	Причина изменения значения.