EspoCRM – Open Source CRM Application
PHP calendarcontactscrmcrm-platformcrm-systemcustomer-portalcustomer-supportcustomizabledocumentsemail-marketingkanbanleadsopen-sourcephpplatformsales-automationsingle-page-applicationsupport
/************************************************************************
* This file is part of EspoCRM.
*
* EspoCRM – Open Source CRM application.
* Copyright (C) 2014-2026 EspoCRM, Inc.
* Website: https://www.espocrm.com
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*
* The interactive user interfaces in modified source and object code versions
* of this program must display Appropriate Legal Notices, as required under
* Section 5 of the GNU Affero General Public License version 3.
*
* In accordance with Section 7(b) of the GNU Affero General Public License version 3,
* these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
************************************************************************/
import View from 'view';
import Model from 'model';
import EntityManagerEditFormulaRecordView from 'views/admin/entity-manager/record/edit-formula';
import _ from 'underscore';
class EntityManagerFormulaView extends View {
template = 'admin/entity-manager/formula'
/** @type {string} */
scope
attributes
data() {
return {
scope: this.scope,
type: this.type,
};
}
setup() {
this.addActionHandler('save', () => this.actionSave());
this.addActionHandler('close', () => this.actionClose());
this.addActionHandler('resetToDefault', () => this.actionResetToDefault());
this.addHandler('keydown.form', '', 'onKeyDown');
this.scope = this.options.scope;
this.type = this.options.type;
if (!this.scope || !this.type) {
throw Error("No scope or type.");
}
if (
!this.getMetadata().get(['scopes', this.scope, 'customizable']) ||
this.getMetadata().get(`scopes.${this.scope}.entityManager.formula`) === false
) {
throw new Espo.Exceptions.NotFound("Entity type is not customizable.");
}
if (!['beforeSaveCustomScript', 'beforeSaveApiScript'].includes(this.type)) {
Espo.Ui.error('No allowed formula type.', true);
throw new Espo.Exceptions.NotFound('No allowed formula type specified.');
}
this.model = new Model();
this.model.name = 'EntityManager';
this.wait(
this.loadFormula().then(() => {
this.recordView = new EntityManagerEditFormulaRecordView({
model: this.model,
targetEntityType: this.scope,
type: this.type,
});
this.assignView('record', this.recordView, '.record');
})
);
this.listenTo(this.model, 'change', (m, o) => {
if (!o.ui) {
return;
}
this.setIsChanged();
});
}
async loadFormula() {
await Espo.Ajax
.getRequest('Metadata/action/get', {key: 'formula.' + this.scope})
.then(formulaData => {
formulaData = formulaData || {};
this.model.set(this.type, formulaData[this.type] || null);
this.updateAttributes();
});
}
afterRender() {
this.$save = this.$el.find('[data-action="save"]');
}
disableButtons() {
this.$save.addClass('disabled').attr('disabled', 'disabled');
}
enableButtons() {
this.$save.removeClass('disabled').removeAttr('disabled');
}
updateAttributes() {
this.attributes = Espo.Utils.clone(this.model.attributes);
}
actionSave() {
const data = this.recordView.fetch();
if (_.isEqual(data, this.attributes)) {
Espo.Ui.warning(this.translate('notModified', 'messages'));
return;
}
if (this.recordView.validate()) {
return;
}
this.disableButtons();
Espo.Ui.notifyWait();
Espo.Ajax
.postRequest('EntityManager/action/formula', {
data: data,
scope: this.scope,
})
.then(() => {
Espo.Ui.success(this.translate('Saved'));
this.enableButtons();
this.setIsNotChanged();
this.updateAttributes();
})
.catch(() => this.enableButtons());
}
actionClose() {
this.setIsNotChanged();
this.getRouter().navigate('#Admin/entityManager/scope=' + this.scope, {trigger: true});
}
async actionResetToDefault() {
await this.confirm(this.translate('confirmation', 'messages'));
this.disableButtons();
Espo.Ui.notifyWait();
try {
await Espo.Ajax.postRequest('EntityManager/action/resetFormulaToDefault', {
scope: this.scope,
type: this.type,
});
}
catch (e) {
this.enableButtons();
return;
}
await this.loadFormula();
await this.recordView.reRender();
this.enableButtons();
this.setIsNotChanged();
Espo.Ui.success(this.translate('Done'));
}
setConfirmLeaveOut(value) {
this.getRouter().confirmLeaveOut = value;
}
setIsChanged() {
this.isChanged = true;
this.setConfirmLeaveOut(true);
}
setIsNotChanged() {
this.isChanged = false;
this.setConfirmLeaveOut(false);
}
updatePageTitle() {
this.setPageTitle(this.getLanguage().translate('Formula', 'labels', 'EntityManager'));
}
/**
* @param {KeyboardEvent} e
*/
onKeyDown(e) {
const key = Espo.Utils.getKeyFromKeyEvent(e);
if (key === 'Control+KeyS' || key === 'Control+Enter') {
this.actionSave();
e.preventDefault();
e.stopPropagation();
}
}
}
export default EntityManagerFormulaView;