Инструменты пользователя

Инструменты сайта


spravochnik_po_funkciyam:funkcii:bd:editingrec

Различия

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

Ссылка на это сравнение

spravochnik_po_funkciyam:funkcii:bd:editingrec [2019/08/08 08:44] (текущий)
jurist23rus создано
Строка 1: Строка 1:
 +====== EditingRec======
 +__автор__:​ jurist23rus \\
 +__модуль__:​ [[moduli:​jurist23rus:​recordeditor:​recordeditor|RecordEditor]] ​
  
 +
 +Вносит изменения,​ согласно заданным параметрам,​ в указанное поле,
 +указанной записи,​ указанной родительской формы.
 +
 +Функция,​ после её вызова,​ скрытно
 +для пользователя (т.е. без доп. уведомлений) находит форму, указанную ей в Параметре №1 и
 +открывает указанную ей в "​Параметре №2" запись этой формы. После чего,
 +находит указанное ей в "​Параметре №3" поле и меняет его значение на значение поля,
 +указанное в "​Параметре №4". Если параметры № 1, 2, 3 или 4 не указаны,​ или
 +указаны не верно, то есть имя не соответствует имени компонента (формы,​ поля)
 +или ID-записи,​ то функция оповещает пользователя об ошибке. В случае верного
 +указания параметров,​ функция пытается произвести замену значения поля,
 +указанного в "​Параметре №3" на значение поля, указанного в "​Параметре №4".
 +При успешной замене функция сохраняет сделанные изменения и прекращает свою работу.
 +Если замена произведена не была, то функция возвращает сообщение об ошибке.
 +Перед тем как произвести замену функция проверяет:​ не являются ли значения изменяемого
 +и замещающего полей равными,​ то есть идентичными (одинаковыми). Если функция установит
 +что значения полей равны она не будет производить замены и прекратит свою работу без
 +вывода какого-либо сообщения или ошибки. Замена будет происходить,​ только если
 +значения полей не равны, то есть в замене есть практический смысл. ​
 +
 +<WRAP center round info 80%>
 +Функцию рекомендуется использовать с кнопкой.
 +</​WRAP>​
 +
 +
 +''​EditingRec ('​ИмяФормы',​ 123(идентификатор записи),​ '​Имя изменяемого поля',​ [поле формы] или любое значение)''​
 +
 +
 +===== Параметры =====
 +  -имя ​ формы - текст (не может быть пустым)
 +  -идентификатор записи - число или функция,​ возвращающая число
 +  -имя изменяемого поля (т.е. поля той формы значение которого должно быть изменено) - текст (обязательное,​ не может быть пустым)
 +  -любое значение (текст,​ число, дата и т.д.) или ссылка на замещающее поле (т.е. поле формы в котором работает сама функция и содержащее значение,​ которое заменит значение изменяемого поля) - любое (обязательное)
 +  ​
 + 
 +===== Результат =====
 +ничего не возвращает
 +
 +
 +===== Пример =====
 +<​code>​
 +EditingRec ('​ИмяФормы',​ 123, '​Имя изменяемого поля',​ [Замещающее поле])
 +EditingRec ('​ИмяФормы',​ 123, '​Имя изменяемого поля',​ '​Какой-то текст'​)
 +EditingRec ('​ИмяФормы',​ 123, '​Имя изменяемого поля',​ 4567)
 +</​code>​
 +Как указано в примерах выше Праметр №4 может содержать любое значение как то "​Текст"​
 +(указывается в кавычках),​ 456 (число,​ указывается без кавычек,​ иначе это будет текст),​
 +или ссылку на поле текущей формы [Замещающее поле] (указывается в квадратных скобках)
 +<​code>​
 +EditingRec ('​ИмяФормы',​ 123, '​Имя изменяемого поля',​ DBGET (...))
 +</​code>​
 +Показан более сложный случай,​ когда параметр № 4 - это другая
 +функция,​ которая в свою очередь вернёт какое-то значение для функции EditingRec и
 +именно оно будет использоваться для замещения.
 +<​code>​
 +EditingRec ('​ИмяФормы',​ 123, '​Имя изменяемого поля',​ null)
 +</​code>​
 +В Параметре № 4 - указана функция null, то есть функция очистит изменяемое поле.
spravochnik_po_funkciyam/funkcii/bd/editingrec.txt · Последние изменения: 2019/08/08 08:44 — jurist23rus