Métodos Lappiz

Métodos predefinidos.

Los métodos de Lappiz se crean en los espacio de eventos o en la configuración de controles personalizados.

getUser

JavaScript

/*
*Esta función reemplaza el bloque de código
*JSON.parse(sessionStorage.LappizUser);
*/
var userInfo = getUser();
console.log(userInfo);

JSON result

Descripción

getEntityId

JavaScript

// Método encargado de retornar el id de la entidad del formulario
var entityId = getEntityId();
console.log(entityId);

getAppViewId

JavaScript

// Método encargado de retornar el id de la vista del formulario
var appViewId = getAppViewId();
console.log(appViewId);

getRowId

JavaScript

// Método encargado de retornar el id del formulario
var rowId = getRowId();
console.log(rowId);

getNewId

JavaScript

// Método encargado de generar un nuevo GUID
var newId = getNewId();
console.log(newId);

getCurrentItem

JavaScript

var result = getCurrentItem();
console.log(JSON.stringify(result));

JSON result

Descripción

getCampoById

JavaScript

// Método encargado de retornar el objeto de configuración del campo solicitado
var campoId = '000000-0000-0000-0000-00000000';
var configCampo = getCampoById(campoId);
console.log(configcampo);

setFieldValue

JavaScript

var number =  10;
var fieldId = '6F9619FF-8B86-D011-B42D-00C04FC964FF';
setFieldValue(fieldId, number);

Descripción

getFieldValue

JavaScript

var fieldId = '6F9619FF-8B86-D011-B42D-00C04FC964FF';
var result = getFieldValue(fieldId);
console.log(result);

Descripción

disableField

JavaScript

var fieldId = '6F9619FF-8B86-D011-B42D-00C04FC964FF';
var parentId = 'O9DJN65-NH54-A7DJ-09DM-MNHHJ7D54NDH';
//deshabilitar campo
disableField(fieldId, true);
//deshabilitar campos en detalle
disableField(fieldId, true,
{
    campoParentId: parentId, 
    EventTypeName: 'FormLoaded', 
    EventType: 'Form'
});
//habilitar campo
disableField(fieldId, false);

Descripción

requireField

JavaScript

// Método encargado de dar obligatoriedad a un campo específico
// True para volver obligatorio - False para quitar obligatorio
var campoId = '000000-0000-0000-0000-00000000'
requireField(campoId, true|false);

Descripción

visibilityField

JavaScript

// Método encargado de dar visibilidad a un campo específico
// True para mostrar - False para ocultar
var campoId = '000000-0000-0000-0000-00000000'
visibilityField(campoId, true|false);

Descripción

visibilitySection

JavaScript

// Método encargado de dar visibilidad a una sección específica
// True para mostrar - False para ocultar
var sectionId = '000000-0000-0000-0000-00000000'
visibilitySection(sectionId, true|false);

Descripción

visibilityLoader

JavaScript

// Método encargado de dar visibilidad al loader spinner del formulario
// True para mostrar - False para ocultar
visibilityLoader(true|false);

disableAction

JavaScript

let actionId = '1ba30857-d0be-4988-b935-5b8c34e80274';
let value = true;
disableAction(actionId, value);
value = false;
disableAction(actionId, value);

Descripción

isDisableField

JavaScript

// Método encargado de obtener si un campo está habilitado o no
var campoId = '000000-0000-0000-0000-00000000';
var isDisabled = isDisableField(campoId);
console.log(isDisabled);

goLocation

JavaScript

//URL para direccionar a las vistas tipo lista
var urlList = '#/grids?viewName=Nombre_Entidad&workspaceId=7e77378b-d518-46bc-b08b-6bf96e378190&entityId=79668f51-d03a-412e-9d37-7ba91488000d&dato=Cliente&appViewId=35059d95-adf1-4ad2-a591-9cb83d23307a';
//URL para direccionar a las vistas tipo formulario creación
var urlForm = '#/forms?viewName=Nombre_Entidad&entityId=79668f51-d03a-412e-9d37-7ba91488000d&entityName=Nombre_Entidad';
//URL para direccionar a las vistas tipo formulario en modo edición
var urlFormEdited = '#/forms?rowId=423DBD02-E42E-4CCB-9505-00E1307E3B9A&viewName=Nombre_Entidad&entityId=79668f51-d03a-412e-9d37-7ba91488000d';
//URL para direccionar a las vitas tipo formulario en modo lectura de datos
var urlFormRead = '#/viewItem?rowId=EE40533F-922E-4654-9156-01159F663AC8&viewName=Dev_Lappiz_Users&entityId=8b7085ba-e615-46e2-a774-2a34f6f509b0&appViewId=2d3e9425-2aad-4fc4-a8ec-eaa6d59566b9';

//Se envia como parámetro la URL a la que se desea redireccionar

goLocation(urlForm);

Descripción

sendEmail

JavaScript

let email = '[email protected],[email protected]';
let subject = 'My life is a bug';
let text = '';
let HTML = `<h1>Design great ideas with HTML to personalize the different 
emails you will send to your team.
Worry about your business, leave the code to Lapiz</h1>`;
let attachments = [
    {
        filename: 'test.txt',
        content: 'Hola mundo Lappiz desde un archivo!'
    }
];
let cc = ["[email protected]"];
let bcc = ["[email protected]"];
let smtpsender = 'lappiz';

sendEmail(smtpsender, email, subject, text, HTML, attachments, cc, bcc).then(function (response) {
    toastr.info('Se ha enviado el correo');
}, function (error) {
    toastr.warning('Ha ocurrido un error al enviar el correo');
});

Descripción

execQuery

JavaScript

var StringQuery = `select Nombre from LappizApp_Lappiz_Personas`;
execQuery(StringQuery).then(function(response){
    var dataResult = response[0];
    //imprimir resultado de la consulta
    console.log(dataResult);
},function(error){
    console.log(error);
});

Descripción

execSP

JavaScript

var SpName = 'GetClientById';
var clientId = '0E984725-C51C-4BF4-9960-E1C80E27ABA0';
var status = 'Activo';
var paramsArray = [1, 2, "'"+clientId+"'", "'"+status+"'"];

execSP(SpName, paramsArray).then(function(response){
    var dataResult = response[0];
    //imprimir resultado del SP
    console.log(dataResult);
},function(error){
    console.log(error);
});

Descripción

openCustomModal

JavaScript

// Método encargado de abrir una modal
var header = ``, body = ``, footer = ``

header = `<h4 class="modal-title">Título modal Lappiz</h4>`
body = `<p>
  <span>
    Lorem ipsum dolor sit, amet consectetur adipisicing elit.
  </span>
</p>`
footer = `<h4>Modal footer</h4>`

var config = {
  htmlTemplate: true,
  headerTemplate: header,
  bodyTemplate: body,
  footerTemplate: footer,
  showBtnsFooter: true|false,
  size: 'sm'|'lg'|'xl',
  scrollable: true|false,
  centered: true|false
}

const done = () => {
  console.log('Done callback')
}

const cancel = () => {
  console.log('Cancel callback')
}

openCustomModal(config, done, cancel)

Descripción

closeModal

JavaScript

closeModal();

Descripción

sendSMS

JavaScript

// Método encargado de realizar envío de mensajes via SMS
var phoneDestination = '3175758621'
var message = 'Hello world Lappiz!'
sendSMS(phoneDestination, message).then(response => {
    const {
        body: status
    } = response
    console.log(status)
}).catch(error => console.error(error))

Descripción

sendPush

JavaScript

// Método encargado de realizar envío de mensajes via push
var userId = '000000-0000-0000-0000-00000000'
var dataMessage = {
    notification: {
        title: 'Lappiz Notification',
        body: 'Hola mundo Lappiz'
    }
}

sendPush(userId, dataMessage).then(response => {
    // ...
}).catch(error => console.error(error))

Descripción

isReadyForm

JavaScript

//Metodo encargado de ocultar o mostrar todo el formulario.
// True para mostrar - False para ocultar

isReadyForm(true);

Descripción

execLF

JavaScript

// Metodo encargado para ejecutar una lappoz function
let nameFunction = 'myLappizFunction';
let lappizFunctionId = '5c3740d2-a208-4257-8879-60a3b8b86501';
let method = "GET"//POST

let body = {myFirstParam: 1, mySecondParam: 'parametro para el funcionamiento de la LP'}
let config = {nameFunction, lappizFunctionId, body, method}
execLF(config).then(success => {
    console.log(success)    
}).catch(error => {
    console.log(error)
})

Second Tab

Cancelar transacciones en eventos.

Los eventos que soportan cancelar transacciones con la propiedad e.cancelson ItemCreating, ItemEditing, ItemSaving.

e.cancel = true;

Si se están usando operaciones asíncronas y se utiliza la instrucción dentro de la respuesta no va a funcionar, para poder cancelar dicha operación debe ser sincronía.