SimpleForm

Данный класс включает в себя методы, позволяющие настраивать формы. Они могут использоваться исключительно на стороне клиента.

Помимо этого, нижеперечисленные методы можно использовать для настройки зависимостей между полями и значениями. Например, для изменения или удаления значений полей.

SimpleForm(table, sys_id)

Используйте этот метод для создания экземпляра объекта SimpleForm.

Параметры:

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

Пример:

window.s_widget_custom.submit = async function () {
  await s_widget.serverUpdate();
  const tableName = s_widget.getFieldValue('table_name');
  const recordId = s_widget.getFieldValue('record_id');

  const builtInForm = new SimpleForm(tableName, recordId);
  
  await builtInForm.save().then(s_form.save());
  s_modal.setShow(false);
  s_go.reloadWindow();
}

Использование глобальных переменных

Внутри каждой формы записи можно использовать преднастроенные глобальные переменные.

window.currentFieldLabel.getColumnId()

s_form.addErrorMessage(message)

Используйте этот метод для отображения всплывающего окна с сообщением об ошибке в нижнем правом углу окна.

Параметр:

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

Пример:

s_form.addErrorMessage('Пожалуйста, введите email в следующем формате: joe@example.com');

s_form.addInfoMessage(message, durationMilliseconds)

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

Параметры:

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

Пример:

s_form.addInfoMessage('Ссылка скопирована', 2000);

s_form.addSuccessMessage(message, durationMilliseconds)

Этот метод отображает сообщение об успешном действии, которое всплывает в нижнем правом углу окна. Сообщение исчезнет через некоторое время. Вторым параметром можно задать это время в миллисекундах.

Параметры:

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

Пример:

s_form.addSuccessMessage('Запись успешно добавлена!', 3000);

s_form.addWarningMessage(message, durationMilliseconds)

Данный метод отображает сообщение с предупреждением в правом нижнем углу окна. Сообщение исчезнет через некоторое время. Вторым параметром можно задать это время в миллисекундах.

Параметры:

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

Пример:

s_form.addWarningMessage('Эта запись изменена другим пользователем', 3000);

s_form.addOption(fieldName, choiceValue)

Используйте данный метод для добавления опции выбора в конец списка поля типа Choice. Пользователь может добавить значения choiceValue, определённые для колонки fieldName в текущем наборе опций таблицы.

Параметры:

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

Пример:

const choices = ['10', '20', '30'];
s_form.clearOptions('contact_type');
for (const optionValue of choices) {
    await s_form.addOption('contact_type', optionValue);
}

s_form.clearMessages()

Используйте этот метод для того, чтобы закрывать все виды сообщений (информационные и об ошибке) на форме. 

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

Пример:

s_i18n.getMessage('End date time cannot be less than start date time', (response) => {
  s_form.clearMessages();
  s_form.addErrorMessage(response);
});
return false; // abort form submit

s_form.clearOptions(fieldName)

Используйте данный метод для удаления всех опций из списка с выбором поля типа Choice.

Параметр:

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

Пример:

const choices = ['10', '20', '30'];
s_form.clearOptions('contact_type');
for (const optionValue of choices) {
    await s_form.addOption('contact_type', optionValue);
}

s_form.clearValue(fieldName) 

Используйте данный метод для удаления значения любого поля.

Параметр:

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

Пример:

if (!s_form.getValue('sprint')) {
  s_form.clearValue('points');
}

s_form.isFieldChanged(fieldName)

Используйте этот метод, чтобы проверить, изменилось ли значение указанного поля.

Параметр:

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

Пример:

if (s_form.isFieldChanged('state') && s_form.getValue('state') != 'new') {
  return false; // abort form submit
}

s_form.formId

Это свойство класса возвращает ID текущей формы. ID формы – это ID записи в таблице Формы (sys_ui_form)

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

Пример:

const url = new URL(`${API_BASE_URL}/export/excel`);
if (typeof s_form !== "undefined") {
  url.searchParams.set('form_id', s_form.formId);
}
window.open(url, "_blank");

s_form.getChanges()

Используйте данный метод для получения информации об измененных полях: название поля, предыдущее значение, текущее значение.

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

Пример:

if (s_form.isChanged()) {
  const changedFields = s_form.getChanges();
  let payload = {};
  changedFields.forEach((field) => {
    payload[field.fieldName] = field.currentValue;
  });
  SimpleStorage.setItem('payload', payload);
}

s_form.getLabelOf(fieldName)

Этот метод возвращает отображаемое название поля на форме.

Параметр:

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

Пример:

const FIELD_LABEL = s_form.getLabelOf('username');
s_form.addErrorMessage(`Поле "${FIELD_LABEL}" содержит недопустимые символы.`);

s_form.getREMDisplayValue(fieldName)

Данный метод возвращает отображаемое значение REM атрибута.

Параметр:

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

Пример:

s_form.addErrorMessage(`Сервис "${s_form.getREMDisplayValue('service')}" недоступен.`);

s_form.getREMLabelOf(fieldName)

Данный метод возвращает текстовое значение заголовка REM атрибута.

Параметр:

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

Пример:

const FIELD_LABEL = s_form.getREMLabelOf('phone');
s_form.addErrorMessage(`Field "${FIELD_LABEL}" contains invalid characters.`);

s_form.getREMValue(fieldName)

Данный метод возвращает значение REM атрибута.

Параметр:

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

Пример:

if (s_form.getREMValue('model')) {
  s_form.hideFieldMsg('model');
}

s_form.getSections()

Используйте этот метод, чтобы получить массив секций.

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

s_form.getSectionNames()

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

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

s_form.getTableName()

Этот метод возвращает название таблицы, к которой относится указанная запись.

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

const TABLE_NAME = s_form.getTableName();
console.log(TABLE_NAME);

s_form.getUniqueValue()

Данный метод возвращает уникальный ID (sys_id) записи.

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

Пример:

const TABLE_NAME = s_form.getTableName();
const RECORD_ID = s_form.getUniqueValue();
const currentRecord = new SimpleRecord(TABLE_NAME);
currentRecord.get(RECORD_ID, ()=> {
  if (currentRecord.sys_id === RECORD_ID) {
    s_form.addInfoMessage(currentRecord.sys_created_at);
  }
});

s_form.getValue(fieldName)

Этот метод возвращает значение указанного поля из базы данных.

Параметры:

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

Пример:

const callerId = s_form.getValue('caller_id');
if (!callerId) {
  const callerRecord = new SimpleRecord('employee');
  callerRecord.get(callerId, ()=> {
    if (callerRecord.sys_id &&
      callerRecord.personal_schedule) {
      await s_form.setValue('schedule', callerRecord.personal_schedule);
    } else {
      s_form.addInfoMessage('Users schedule is not defined');
    }
  });
}

s_form.getDisplayValue(fieldName)

Этот метод возвращает отображаемое значение поля.

Параметры:

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

Пример:

s_form.addInfoMessage(`Сервис "${s_form.getDisplayValue('service')}" недоступен`);

s_form.goBack()

Используйте этот метод для перенаправления пользователя на предыдущую страницу. Если это невозможно, пользователь будет перенаправлен на представление записей текущей таблицы в виде списка, например, со страницы записи инцидента на страницу списка инцидентов.

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

Пример:

if (s_form.isChanged()) {
  s_form.save().then(() => s_form.goBack());
} else {
  s_form.goBack();
}

s_form.isChanged()

Используйте этот метод, чтобы узнать, была ли запись изменена. 

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

Пример:

if (s_form.isChanged()) {
  s_form.save().then(() => s_form.goBack());
} else {
  s_form.goBack();
}

s_form.hideFieldMsg(fieldName)

В отличие от s_form.showFieldMsg(), данный метод скрывает информационные сообщения или сообщения об ошибке под указанным полем формы.

Параметры:

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

Пример:

if (s_form.getValue('state')) {
  s_form.hideFieldMsg('state');
}

s_form.hideRelatedLists()

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

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

Пример:

if (s_form.getValue('type') == 'internal') {
  s_form.hideRelatedLists();
}

s_form.isMandatory(fieldName)

Используйте этот метод, чтобы проверить является ли указанное поле обязательным.

Параметр:

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

Пример:

if (s_form.isMandatory('state') && !s_form.getValue('state')) {
  s_form.addInfoMessage('Укажите статус');
}

s_form.hideRelatedList(relListTitle)

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

Параметр:

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

Пример:

if (s_form.getValue('type') == 'external') {
  s_form.hideRelatedList('Customer');
}

s_form.isNewRecord()

Если запись не была еще сохранена, метод возвращает true. В противном случае, метод возвращает значение false.

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

Пример:

if (s_form.isNewRecord()) {
  await s_form.setValue('state', 'new');
  s_form.setReadOnly('state', true);
}

s_form.isReadonly(fieldName)

Используйте этот метод, чтобы узнать, является ли указанное поле редактируемым или оно доступно только для чтения.

Параметр:

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

Пример:

if (!s_form.isReadonly('state')) {
  await s_form.setValue('state', 'new');
}

s_form.isSectionVisible(sectionName)

Данный метод определяет, является ли указанная секция видимой или нет.

Параметр:

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

Пример:

if (s_form.isSectionVisible('Instructions')) {
  s_form.addInfoMessage('Check out the "Instructions" section', 5000);
}

s_form.isValid()

Данный метод позволяет определить, является ли указанная форма валидной или нет.

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

Пример:

if (!s_form.isValid()) {
  s_form.addErrorMessage('This form is invalid');
}

s_form.isVisible(fieldName)

Используйте этот метод чтобы узнать, является ли указанное поле видимым.

Параметры:

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

Пример:

if (s_form.isVisible('state')) {
  s_form.setSectionDisplay('Controls', true);
}

s_form.refreshUiActions()

Используйте этот метод для перезагрузки всех UI actions на форме и пересчета серверных условий, которые определены для этих UI действий, без обновления страницы.

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

Пример:

const stateValue = s_form.getValue('state');
if (stateValue == 'in-progress') {
    s_form.refreshUiActions();
}

s_form.removeOption(fieldName, choiceValue)

Используйте этот метод, чтобы определить и удалить опцию из списка.

Параметры:

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

Пример:

const serviceId = s_form.getValue('service');
if (serviceId) {
  const service = new SimpleRecord('sys_cmdb_ci_service');
  service.get(serviceId, ()=> {
    if (service.business_criticality > '1') {
      s_form.removeOption('impact', 'low');
      s_form.removeOption('urgency', 'low');
    }
  });
}

s_form.save()

Используйте данный метод для сохранения записи, не покидая ее формы.

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

Пример:

const sysId = await s_form.save().finally(__resolveServerResponse;
await s_user.setPreference(preferenceApplicationName, packApplicationId);
await s_user.setPreference(preferenceLocalPackName, sysId);
await s_pref.refresh();

s_form.setLabelOf(fieldName, value)

Используйте данный метод для того, чтобы установить текстовое значение для лейбла поля. 

Параметры:

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

Пример:

if (s_form.getTableName() == "employee") {  
  s_form.setLabelOf("email", "Personal Email");
  s_form.setLabelOf("manager.email", "Manager's Email");
} else {
  s_form.setLabelOf("email", "Email");
}

s_form.setMandatory(fieldName, mandatory)

Используйте этот метод для того, чтобы сделать указанное поле обязательным, то есть оно не может быть пустым.

Параметры:

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

Пример:

const scriptType = s_form.getValue('type');
const mandatoryColumn = ['onChange', 'onCellEdit'].includes(scriptType);
s_form.setVisible('column_id', mandatoryColumn);
s_form.setMandatory('column_id', mandatoryColumn);

s_form.setReadOnly(fieldName, readOnly)

Используйте этот метод, чтобы изменить настройки поля и сделать его редактируемым или доступным только для чтения.

Параметры:

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

Пример:

if (s_form.getValue('any_tables')){
  s_form.setMandatory('table_id', false);
  s_form.setReadOnly('table_id', true);
  s_form.setVisible('table_id', false);
}

s_form.setREMLabelOf(fieldName, value)

Используйте этот метод, чтобы задать лейблу REM атрибута значение простого текста.

Параметры:

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

Пример:

if (s_form.getTableName() == 'user') {
  s_form.setREMLabelOf('email', 'Email');
} else {
  s_form.setREMLabelOf('email', 'Personal Email');
}

s_form.setREMMandatory(fieldName, mandatory)

Используйте данный метод для того, чтобы сделать поле, определенное REM атрибутом, обязательным.

Параметры:

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

Пример:

const isDeliveryFilled = !!s_form.getValue('delivery');
s_form.setREMMandatory('phone', isDeliveryFilled);

s_form.setREMReadOnly(fieldName, readOnly)

Используйте этот метод, чтобы сделать поле, указанное в REM атрибуте, доступным только для чтения.

Параметры:

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

Пример:

if (s_form.isNewRecord()) {
  s_form.setREMValue('state', 'new');
  s_form.setREMReadOnly('state', true);
}

s_form.setREMValue(fieldName, databaseValue)

При помощи этого метод можно установить значение лейбла REM атрибута.

Параметры:

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

Пример:

await s_form.setREMValue('state', 'new');
s_form.save();

s_form.setREMVisible(fieldName, display)

Используйте данный метод, чтобы настроить видимость поля, указанного в REM атрибуте. 

Параметры:

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

Пример:

s_form.setREMVisible('additional_info', !s_form.isNewRecord());

s_form.setSectionDisplay(sectionName, display)

Используйте этот метод, чтобы скрыть указанную секцию. 

Параметры:

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

Пример:

if (s_form.getValue('state') == '7') { // Completed
  s_form.setSectionDisplay('Closure Information', true);
  s_form.setMandatory('closure_code', true);
  s_form.setMandatory('closure_notes', true);
} else {
  s_form.setMandatory('closure_code', false);
  s_form.setMandatory('closure_notes', false);
  s_form.setSectionDisplay('Closure Information', false);
}

s_form.setValue(fieldName, databaseValue)

Данный метод предназначен для настройки значения поля.

Параметры:

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

Пример:

await s_form.setValue('state', '7'); // Completed
await s_form.setValue('closure_notes', articleBodies.join('\n'));
await s_form.setValue('closure_code', '1'); // Solved 1st Level
s_form.save()
  .then(() => {
    s_i18n.getMessage(`The typical solution is applied`, (e) => {
      s_form.addInfoMessage(e);
    })
  });

s_form.setVisible(fieldName, display)

Данный метод предназначен для управления отображением полей, которые были добавлены в форму через Form Layout. Эти поля можно скрыть или показать. Статус скрытого поля похож на статус поля, удаленного с формы представления. 

Параметры:

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

Пример:

if (!s_form.isNewRecord()) {
  s_form.setVisible('subject', true);
  s_form.setVisible('reason', false);
}

s_form.showFieldMsg(fieldName, message, type)

Используйте этот метод для вывода сообщений, содержащих значение 'info', 'error', or 'warning' под указанным полем формы. 

Параметры:

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

Пример:

s_form.showFieldMsg('subject', 'Cannot be empty', 'info');

s_form.showFieldMsg('subject', 'Cannot be empty', 'warning');

s_form.showFieldMsg('subject', 'Cannot be empty', 'error');

s_form.showRelatedLists()

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

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

s_form.showRelatedList(listTitle)

Данный метод предназначен для отображения определенных списков, связанных с формой.

Параметр:

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

Пример:

s_form.showRelatedList('UI Action');

s_form.submit()

Используйте данный метод для подачи формы записи.

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

Устаревшие методы

s_form.fieldHasChanges(fieldName)

Используйте этот метод, чтобы проверить, было ли указанное поле изменено.

Параметр:

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

console.log(s_form.fieldHasChanges('state'));

s_form.hasChanges()

Используйте данный метод, чтобы узнать, была ли запись изменена.

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

Пример:

if (s_form.hasChanges()) {
  s_form.save().then(() => s_form.goBack());
} else {
  s_form.goBack();
}