# Módulos personalizados

ServiceDesk Plus incluye varios módulos integrados (como Solicitudes, Cambios, Activos, etc.) con sus configuraciones predeterminadas (como Estado, Matriz de prioridad, Código de cierre, etc.). Sin embargo, las necesidades de su organización pueden requerir entidades, campos y flujos de trabajo más allá de estos módulos y configuraciones predeterminados.

En esos casos, puede usar **Módulos personalizados** para crear sus propios módulos y configuraciones, además de subformularios y subentidades para las plantillas existentes.

**Rol requerido**: SDAdmin

## Beneficios de los módulos personalizados

- Construya módulos que se ajusten a sus procesos empresariales.
- Cree formularios personalizados y subentidades para recopilar información adicional.
- Importe datos y genere informes a partir de los registros recopilados.
- Configure reglas de automatización para optimizar los flujos de trabajo.

> Módulos personalizados está disponible solo en la edición Enterprise.

## Tipos de módulos personalizados

Puede crear cuatro tipos de módulos personalizados: **Pestaña web**, **Configuración**, **Subformulario** y **Subentidad**.

Después de crear un módulo personalizado, puede comenzar a agregarle datos relevantes. La información ingresada en los módulos personalizados se recopila y almacena como registros.

| Tipo | Propósito | Ejemplos | Acceso desde |
|---|---|---|---|
| Pestaña web | Cree sus propios módulos para configurar, editar, almacenar y eliminar los registros que desee. Puede habilitar funciones avanzadas como Automatizaciones, Informes, Importación y más. | **Solicitudes** (con funciones de automatización, informes e importación) | Panel de navegación (similar a los módulos integrados) |
| Configuración | Cree configuraciones personalizadas para almacenar valores que sirvan como entidades de referencia o ayuden a definir flujos de trabajo. | **Estado** y otros similares a los que se encuentran en **Admin > Personalización** | **Admin > Personalización > Configuraciones personalizadas** |
| Subformulario | Cree secciones de formulario para capturar múltiples entradas vinculadas al registro principal en formato tabular. | En una **Orden de compra**, un subformulario puede contener múltiples partidas. | Formularios de pestaña web, configuración personalizada y subentidad |
| Subentidad | Cree entidades para almacenar detalles adicionales y administrar un registro a lo largo de su ciclo de vida. | En un proyecto, **Hitos** y **Tareas** son subentidades. | Página de detalles de un registro |

> En el Directorio ESM, solo se pueden crear módulos personalizados de tipo Configuración.  
> Puede crear hasta 10 pestañas web, 50 configuraciones personalizadas, 20 subformularios y 20 subentidades.  
> No puede agregar subentidades a las configuraciones personalizadas.

## Crear un módulo personalizado

**Rol requerido**: SDAdmin

1. [Paso 1: Agregar detalles](#paso-1-agregar-detalles)
2. [Paso 2: Agregar campos](#paso-2-agregar-campos)
3. [Paso 3: Definir y personalizar el diseño del formulario](#paso-3-definir-y-personalizar-el-diseño-del-formulario)
4. [Paso 4: Configurar permisos](#paso-4-configurar-permisos)
5. [Paso 5: Agregar subentidades](#paso-5-agregar-subentidades)
6. [Paso 6: Crear acciones personalizadas](#paso-6-crear-acciones-personalizadas)
7. [Paso 7: Definir reglas de campo y formulario](#paso-7-definir-reglas-de-campo-y-formulario)
8. [Publicar el módulo personalizado](#estados-del-módulo-personalizado)

### Paso 1: Agregar detalles

- Vaya a **Admin > Espacio del desarrollador > Módulos personalizados**.
- Haga clic en **Nuevo**.
- Ingrese los siguientes detalles y haga clic en **Guardar**:

| Nombre del campo | Descripción | Comentarios |
|---|---|---|
| Nombre para mostrar * | Ingrese el nombre para mostrar. | Se muestra cuando se hace referencia a un solo registro. |
| Nombre plural para mostrar * | Ingrese el nombre plural. | Se mostrará en menú, vistas de lista e informes. |
| Nombre de API * | Se completa automáticamente, puede modificarse. | Prefijo `cm_`. Solo minúsculas, números y guion bajo. No editable después de guardar. |
| Nombre plural de API * | Se completa automáticamente. |  |
| Tipo * | Seleccione el tipo requerido. | - |
| Descripción | Ingrese una descripción. | - |
| Ícono | Cargue un ícono. | Máx. 5 MB (JPEG, JPG, PNG, GIF). |
| Archivos adjuntos | Adjunte archivos relevantes. | Máx. 10 MB. |

\*Campos obligatorios

![Formulario nuevo módulo personalizado](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/2025_11_18_06_55_5841.png)

#### Colaboración

Use **Colaborar** para configurar el módulo junto con otros administradores.

![Colaboración](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/2025_11_18_06_56_5142.png)

### Funciones avanzadas (Solo pestañas web)

Habilite funciones avanzadas para mejorar la funcionalidad del módulo.

![Funciones avanzadas](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/2025_11_18_06_58_1243.png)

| Función | Propósito | Configuración |
|---|---|---|
| Automatizaciones | Configurar reglas como [Reglas de negocio](https://www.manageengine.com/latam/service-desk/help/adminguide/business-rules.html), Disparadores personalizados, [Flujos de trabajo](https://www.manageengine.com/latam/service-desk/help/adminguide/workflows.html) y [Acciones de temporizador](https://www.manageengine.com/latam/service-desk/help/adminguide/request-timer-actions.html). | - |
| Funciones personalizadas | Ejecutar acciones automatizadas y llamadas API. | - |
| Importación | Importar datos (XLS, XLSX, CSV). | Permite agregar, actualizar, eliminar o ignorar duplicados. |
| Búsqueda global | Buscar registros desde la búsqueda global. | - |
| Vistas personalizadas | Crear y compartir vistas. | Configurar roles y columnas. |
| Sin inicio de sesión | Acceso sin autenticación. | Definir campos y filtros visibles. |
| Papelera | Eliminación temporal. | Restauración 15/30/45 días. |
| Eliminación automática | Eliminación programada. | 1, 4 u 8 años. |
| Informes | Generar [informes](https://www.manageengine.com/latam/service-desk/help/adminguide/reports.html). | - |
| Etiquetas | Agregar etiquetas a registros. | - |

### Paso 2: Agregar campos

En **Lista de campos**, agregue campos según el tipo requerido.

| Tipo de campo | Descripción |
|---|---|
| Una sola línea | Textos cortos. |
| Varias líneas | Textos largos. |
| Lista de selección / Radio | Selección única. |
| Selección múltiple / Casilla | Selección múltiple. |
| Campos numéricos | Solo números. |
| Fecha/Hora | Valores de fecha y hora. |
| Booleano | Verdadero / Falso. |
| Color | Selector de color. |
| Carga de archivos | Adjuntar archivos. |
| HTML | Editor enriquecido. |
| URL | URL válidas. |

![Agregar campos](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/2025_11_18_07_06_4750.png)

> Puede cifrar campos de una sola línea, varias líneas y teléfono al crearlos.  
> Puede marcar un campo como PII solo al crear el módulo.

### Paso 3: Definir y personalizar el diseño del formulario

En **Personalizador de formularios**, agregue secciones, campos y subformularios mediante arrastrar y soltar.

![Personalizador de formularios](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/2025_11_18_07_09_2751.png)

#### Agregar y personalizar secciones

- Haga clic en el ícono más.
- Arrastre la sección al lienzo.
- Edite propiedades y estilos.

![Propiedades de sección](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/2025_11_18_07_12_4454.png)

#### Agregar subformularios

- Arrastre el subformulario.
- Defina nombre API, máximo de registros y formato (Formulario o Tabla).

![Subformulario](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/2025_11_18_07_19_2358.png)

> Máximo 90 campos por formulario.  
> Hasta cinco subformularios por pestaña web.

### Paso 4: Configurar permisos

En la pestaña **Permisos**, configure:

#### Permiso a nivel de registro

- **Todos los registros**
- **Registros asociados**

#### Permiso a nivel de módulo

| Permiso | Acciones permitidas |
|---|---|
| Ver | Solo ver |
| Agregar | Ver y agregar |
| Editar | Ver, agregar y editar |
| Eliminar | Ver, agregar y eliminar |
| Todas las operaciones | Ver, agregar, editar y eliminar |

![Permisos](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/2025_11_18_10_06_3779.png)

### Paso 5: Agregar subentidades (Solo pestaña web)

Arrastre subentidades como **Tarea**, **Comentario**, **Notificación**, **Registro de trabajo**, **Lista de verificación** o cree una personalizada.

Ejemplo de configuración de **Tarea**:

| Campo | Configuración |
|---|---|
| Dependencias | Mapear dependencias |
| Campos | Seleccionar campos visibles |
| Operaciones | Definir acciones disponibles |
| Criterios de grupo | Filtrar grupos |
| Criterios de propietario | Filtrar usuarios |

![Subentidad tarea](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/2025_11_18_11_23_291.png)

> Puede agregar hasta 10 subentidades por pestaña web.

### Paso 6: Crear acciones personalizadas (Solo pestaña web)

Permite configurar acciones como:

| Acción | Qué hace | Caso de uso |
|---|---|---|
| Adición rápida | Crear registros con valores prellenados. | Registro rápido de solicitudes. |
| Edición masiva | Actualizar múltiples registros. | Cambios masivos de fechas. |
| Activar función personalizada | Ejecutar funciones predefinidas. | Recordatorios automáticos. |

![Acciones personalizadas](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/2025_11_18_09_52_5273.png)

> Puede crear hasta cinco acciones personalizadas.

### Paso 7: Definir reglas de campo y formulario (Solo pestaña web)

Configure reglas que se ejecuten:

| Evento del formulario | Descripción |
|---|---|
| Al cargar | Al abrir el formulario |
| Al cambiar | Al modificar un campo |
| Al enviar | Al enviar el formulario |

Más información: [Reglas de campo y formulario](https://www.manageengine.com/latam/service-desk/help/adminguide/configurations/helpdesk/field-form-rules.html)

![Reglas de campo y formulario](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/image(65).png)

## Estados del módulo personalizado

| Estado | Descripción |
|---|---|
| Borrador | En creación |
| Publicado | Activo |
| Suspendido | Temporalmente deshabilitado |
| Retirado | Permanentemente deshabilitado |

![Estados del módulo](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/image(66).png)

> Solo se puede acceder a módulos publicados.

## Editar un módulo personalizado

Solo se pueden editar en estado **Borrador**.

## Eliminar módulos personalizados

- Vaya a **Módulos personalizados**.
- Haga clic en **Acciones > Eliminar**.

> No puede recuperar módulos eliminados.  
> Se eliminarán permanentemente todos sus registros.

## Acceder a módulos personalizados

- Pestañas web: Desde el panel de navegación.  
  Más información: [Administrar pestañas web](https://www.manageengine.com/latam/service-desk/help/adminguide/web-tabs.html)
- Configuraciones personalizadas:  
  **Admin > Personalización > Configuraciones personalizadas**  
  Más información: [Administrar configuraciones personalizadas](https://www.manageengine.com/latam/service-desk/help/adminguide/custom-configurations.html)

## Acciones de la vista de lista

En la vista de lista puede:

- Ver todos los módulos personalizados.
- Editar o eliminar.
- Mover al Directorio ESM.
- Buscar módulos.
- Administrar la vista.
- Ver historial.

![Vista de lista](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/2025_11_18_09_52_0672.png)

---

## Recursos adicionales

- [Administrar pestañas web](https://www.manageengine.com/latam/service-desk/help/adminguide/web-tabs.html)
- [Administrar configuraciones personalizadas](https://www.manageengine.com/latam/service-desk/help/adminguide/custom-configurations.html)