Campos personalizados y extensibilidad
Agregar un campo que la plataforma no incluye, sin una actualización y sin modificar las tablas principales.
Un campo que su empresa necesita y que la plataforma no incluye se agrega como un campo personalizado. Se define por empresa, se asocia a un recurso, se le asigna un tipo y una etiqueta, y luego aparece en el formulario, las columnas de lista, los filtros, la asignación de importación y la exportación de dicho recurso.
- Los campos personalizados se encuentran fuera de las tablas principales, por lo que agregar uno no altera el esquema que comparten todas las empresas.
- Una vez definidos, son campos ordinarios: filtrables, ordenables, importables y exportables, no un campo de notas con una etiqueta.
- Son por empresa, por lo que las adiciones de una empresa no son visibles para otra.
- El campo Sí/No se representa de forma similar a las casillas de verificación del propio producto: la casilla junto a su etiqueta, la etiqueta en la que se puede hacer clic y la ayuda justo debajo.
Antes de añadir uno, compruebe si una lista de clasificación cumple con el propósito. Si lo que desea es un nuevo valor en un menú desplegable existente, eso es configuración, no extensión.
Hacer un campo es obligatorio
Para que un campo sea siempre obligatorio, o obligatorio antes de un paso como Enviar o Publicar, vaya a Plataforma › Personalización › Requisitos de campo: márquela, no es necesario escribir ninguna regla. Consulte Hacer que cualquier campo sea obligatorio: Requisitos de campo. La lógica personalizada, que se muestra a continuación, es para una condición.
Plataforma → Personalización → Lógica personalizada contiene las reglas que una empresa define: una validación que impide guardar, un valor que se calcula cada vez que se guarda un registro y un valor predeterminado para un nuevo registro. Para que un campo sea obligatorio (ya sea uno que el producto incluya o uno que usted haya añadido), escriba una validación en esa pantalla que sea verdadera solo cuando el campo tenga un valor y muestre el mensaje que los usuarios deben ver cuando no lo tenga.
- Plataforma abierta → Personalización → Lógica personalizada y elija el módulo y la pantalla: HRMS, Empleados.
- Agregue una regla de tipo Validar, que se ejecutará en cada guardado.
- Escribe la condición que debe cumplirse. not_empty(iqama_number) hace que el número de Iqama sea obligatorio para cada empleado. is_saudi o not_empty(iqama_number) lo exige para todos los que no sean ciudadanos saudíes, que es lo que generalmente se quiere decir: un ciudadano saudí tiene un documento nacional de identidad, no una Iqama.
- Escriba el mensaje: «Se requiere el número de Iqama para un empleado que no sea ciudadano saudí» y guárdelo. Pruébelo en la misma pantalla comparándolo con un registro antes de usarlo.
El servidor verifica la regla en cada guardado, independientemente de cómo llegue el registro: mediante un formulario, una importación, ASK o la API. Modificar un registro existente de forma que incumpla la regla también se rechaza.
En Arabia Saudita, el formulario del empleado también incluye el registro saudita: nacionalidad saudita, número y fecha de vencimiento de la Iqama, vencimiento del permiso de trabajo, número y categoría de abonado de GOSI, transferencia de patrocinio, fecha de contratación Hijri, salario base y subsidios de vivienda y transporte a partir de los cuales se calcula GOSI. Cualquiera de estos datos puede ser obligatorio de esta manera. El formulario ya muestra solo los que corresponden: número y fecha de vencimiento de la Iqama, vencimiento del permiso de trabajo y transferencia de patrocinio cuando no se marca la nacionalidad saudita, y categoría de abonado de GOSI cuando sí se marca.
Ver los valores que contienen sus campos
En Plataforma → Personalización → Campos personalizados, se muestra una tabla con los registros de la pantalla seleccionada, donde las columnas corresponden a los campos de tu empresa. Es una lista paginada y permite realizar búsquedas, de modo que puedes consultar la información sin tener que abrir los registros uno por uno.
- Solo se muestran los registros que ya podías abrir en esa pantalla.
- Los campos se muestran por sus etiquetas, tal como aparecen en el formulario, y no por ningún nombre interno.
Se utiliza la misma presentación sencilla siempre que se muestran valores para su lectura: los detalles de una entrada de auditoría, la solicitud de aprobación de un agente y el resultado de una acción muestran una tabla de campos y valores en lugar de datos sin procesar.