{"butons":[{"type":"api-insert",..}]}

Los botones para vistas nos permiten lanzar procesos de Inserción o conectar con alguna funcionalidad específica que queramos desarrollar como: exportación del listado de información, importación en bloque de datos, conexión con un API externo que nos muestre una aplicación concreta, generación de documentos PDF etc..

La estructura de los botones se suele definir antes que las vistas y existen diferentes tipos.

• api-insert
  
• api-bulk
• api-external

En cada botón podemos:

• Aplicar Localización en el parámetro 'title'
• Añadir una restricción de seguridad para que ese botón sólo sea utilizado por usuarios con ciertas reglas

Securización de Botones

Para restringir el acceso a un botón según los privilegios del usuario, se utiliza la propiedad security dentro del objeto del botón. Esta propiedad permite definir qué usuarios pueden ver y utilizar el botón basándose en sus privilegios asignados.

Propiedades disponibles en security:

• user_privileges: Array de privilegios permitidos. El usuario debe tener al menos uno de estos privilegios para ver el botón.

Ejemplo de configuración:

{
  "buttons": [
    {
      "type": "api-insert",
      "title": "Subir Nómina"
    },
    {
      "title": "Importar Nóminas",
      "type": "external-api",
      "api": "https://api.cloudframework.dev/cloud-solutions/hrms/payrolls/{{Platform:namespace}}/{{User:KeyName}}/cfi/import",
      "ico": "upload",
      "security": {
        "user_privileges": [
          "people-admin",
          "people-manager",
          "people-hr",
          "people-backoffice",
          "portal-user-people-payroll"
        ]
      }
    },
    {
      "title": "[DEV] Importar Nóminas",
      "type": "external-api",
      "api": "http://localhost:9999/cloud-solutions/hrms/payrolls/{{Platform:namespace}}/{{User:KeyName}}/cfi/import",
      "ico": "upload",
      "security": {
        "user_privileges": [
          "development-admin",
          "development-user"
        ]
      }
    }
  ]
}

En este ejemplo:

• El primer botón "Subir Nómina" no tiene restricción de seguridad, por lo que es visible para todos los usuarios con acceso al CFO.
• El segundo botón "Importar Nóminas" solo será visible para usuarios con privilegios de HRMS (people-admin, people-manager, etc.) o usuarios de portal con el privilegio específico.
• El tercer botón "[DEV] Importar Nóminas" solo es visible para usuarios con privilegios de desarrollo, útil para entornos de pruebas.

Nota: La seguridad de los botones complementa la seguridad del CFO y del endpoint API. Es recomendable que los privilegios definidos en el botón coincidan con los privilegios requeridos en el endpoint al que apunta.