Configuración de Edición de Clientes

SuperVentaMovil (SVM)

Objetivo

Documentar el funcionamiento de la configuración Clientes.Edit.Fields, que permite definir qué campos del cliente pueden ser editados desde la app móvil y cuáles son obligatorios, a nivel company.

Este documento está orientado a producto y soporte.

Alcance

• Nivel de configuración: Company
  
  

• Plataforma impactada: App móvil SuperVentaMovil
  
  

• Gestión actual: Manual
  
  

• Estado: No visible en WAT
  
  

• Formato de configuración: JSON
  
  

Configuración Clientes.Edit.Fields

La edición de datos del cliente en la app se controla mediante la configuración Clientes.Edit.Fields.

Esta configuración recibe un JSON con una lista de campos, donde para cada campo se define:

• si puede editarse desde la app
  
  

• si es obligatorio al momento de guardar
  
  

Estructura del JSON

[

  {

    "fieldName": "CLI_DOMICILIO",

    "editable": true,

    "required": false

  }

]

Propiedades

Reglas generales

• Un campo puede ser obligatorio y no editable.
  
  

• required: true no implica editable: true.
  
  

• Solo los campos incluidos en el JSON son evaluados por esta configuración.
  
  

• El nombre del campo debe coincidir exactamente con el nombre en base de datos.
  
  

Ejemplo de configuración utilizada

El siguiente JSON fue utilizado como ejemplo funcional en DEV, acompañado por capturas de pantalla.

[

  {

    "fieldName": "CLI_ID",

    "editable": false,

    "required": true

  },

  {

    "fieldName": "CLI_NOMBRE",

    "editable": true,

    "required": true

  },

  {

    "fieldName": "CLI_TELEFONO",

    "editable": true,

    "required": false

  },

  {

    "fieldName": "CLI_DOMICILIO",

    "editable": true,

    "required": false

  },

  {

    "fieldName": "CLI_LATITUD",

    "editable": true,

    "required": true

  },

  {

    "fieldName": "CLI_LONGITUD",

    "editable": true,

    "required": true

  }

]

Comportamiento resultante en la app

Con esta configuración aplicada:

• ID del Cliente

  • Obligatorio

  • No editable
    
    

• Nombre del Cliente

  • Editable

  • Obligatorio
    
    

• Teléfono

  • Editable

  • Opcional
    
    

• Domicilio

  • Editable

  • Opcional
    
    

• Latitud / Longitud

  • Editables

  • Obligatorios
    
    

La app no permite guardar el cliente si:

• el nombre está vacío

• falta latitud o longitud
  
  

Evidencia visual

Se adjuntan capturas tomadas desde una company en DEV, donde se observa:

• Pantalla de edición de cliente
  
  

• Campos editables y no editables
  
  

• Validaciones de campos obligatorios
  
  

• Guardado exitoso al completar los datos requeridos