Page History

if (s_form.isChanged()) {
  const changedFields = s_form.getChanges();
  let payload = {};
  changedFields.forEach((field) => {
    payload[field.fieldName] = field.currentValue;
  });
  SimpleStorage.setItem('payload', payload);
}const FIELD_LABEL = s_form.getLabelOf('username');
s_form.addErrorMessage(`Field "${FIELD_LABEL}" contains invalid characters.`);

const FIELD_LABEL = s_form.getLabelOf('username');
s_form.addErrorMessage(`Field`Service "${FIELD_LABELs_form.getREMDisplayValue('service')}" containsis invalidnot characters.`available`);

const FIELD_LABEL = s_form.getREMLabelOf('phone');
s_form.addErrorMessage(`Service`Field "${s_form.getREMDisplayValue('service')FIELD_LABEL}" iscontains notinvalid available`characters.`);

constif FIELD_LABEL =(s_form.getREMValue('model')) {
  s_form.getREMLabelOfhideFieldMsg('phonemodel');
s_form.addErrorMessage(`Field "${FIELD_LABEL}" contains invalid characters.`);

ifconst sectionNames = (s_form.getREMValuegetSections('model'))).map(section => section.name);
if (sectionNames.length) {
    s_form.hideFieldMsg('model');
}

.addInfoMessage(`You can move between ${sectionNames.join(', ')}` sections);
}

The method returns the system table name, not the table title. Example:

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

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);
  }
});

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.addInfoMessage(`Service "${s_form.getDisplayValue('service')}" is not available`);

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

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

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

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

if (s_form.isMandatory('state') && !s_form.getValue('state')) {
  s_form.addInfoMessage('State cannot be None');
}

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

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

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

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

It makes sense to use this method if the form contains the fields of the Date , Date/Time and Date/ Time Specific typescolumns, as the method does not support validation checks for the fields of other types.

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

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

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

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');
    }
  });
}

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

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");
}

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

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

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

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

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

Note that this method is asynchronous; for better performance, use the await keyword as shown in the code example below.

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

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

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);
}

Use s_form.clearValue() method for field clearing instead to clear the field instead of setting an empty string value.

Note that this method is asynchronous; for better performance, use the await keyword as shown in the code example below.

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);
    })
  });

Hiding a field for which the mandatory attribute is set on a column level (including the mandatory override described in the Column OverridingOverride article) leads to the validation errors after the form is saved or submitted from the client-side.

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

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.showRelatedList('UI Action');

This method is deprecated and not recommended to use. Use the s_form.isFieldChanged(fieldName) method instead.

If there is a client script running on the specified form and changing itchanging a scpecified fieldon the form is running, the s_form. fieldHasChanges(fieldname) method returns true. Both a user and a script can make changes to the form.

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

This method is deprecated and not recommended to use. Use the s_form.isChanged() method instead.

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