Administrar las configuraciones de campos personalizados

Esta guía recorre la tabla de Desarrollo → Campos Personalizados, donde vive la configuración de todos los campos propios de tu cuenta. Sirve para consultar qué campos tiene un objeto, corregir su definición, retirarlos temporalmente o borrarlos.

Si lo que quieres es crear un campo con el editor del formulario, empieza por Campos personalizados: editor, tipos y estados. Esta guía cubre lo que queda detrás: la fila de cada objeto.

Qué es un objeto

Un objeto es cada tipo de registro de Prolibu: Contactos (Contact), Compañías (Company), Negocios (Deal), Tickets (Ticket) y las actividades (Task, Call, Meeting, Note). La tabla usa esos nombres técnicos en inglés.

Abrir la tabla

1. Abre el menú lateral con la flecha de la esquina superior izquierda, si lo tienes plegado.
2. Baja hasta el grupo Desarrollo y pulsa Campos Personalizados.

La tabla muestra una fila por objeto, no una por campo. Si Contact tiene cinco campos propios, los cinco están dentro de la misma fila. Las columnas son Objeto asignado, Activo, Estado, Campos personalizados, Sobrescrituras, Creado por y las fechas de creación y actualización.

Leer lo que tiene un objeto

1. Busca la fila del objeto.
2. En la columna Campos personalizados, pulsa Ver JSON.
3. Lee la definición. Cada campo es un bloque con su clave técnica, su tipo (type) y su etiqueta (label).
4. Pulsa Copiar si quieres llevarte el texto, por ejemplo para reutilizarlo en otra fila.

La columna Sobrescrituras funciona igual. Suele estar vacía: se usa para modificar atributos del esquema principal del objeto, y conviene tocarla solo si conoces la ruta exacta y su efecto.

La tabla solo muestra el workspace activo

Cada fila pertenece a un workspace, el espacio de trabajo que eliges en la barra superior. Si la fila de un objeto se creó en otro workspace, no la verás mientras tengas el tuyo elegido, aunque siga existiendo.

Crear la configuración de un objeto que aún no tiene

Cada objeto admite una sola fila. Si el objeto todavía no aparece en la tabla, créala así:

1. Pulsa el botón + de la esquina inferior derecha. Se abre el panel Crear Campo personalizado.
2. En Objeto asignado, escribe para buscar y elige el objeto, por ejemplo Contact.
3. En el editor Campos personalizados, escribe la definición de tu primer campo. Este ejemplo crea un campo de texto llamado Tipo de cliente:

{
  "tipoDeCliente": {
    "isCustomField": true,
    "type": "string",
    "label": "Tipo de cliente"
  }
}

4. Enciende el interruptor Activo. Viene apagado.

5. Pulsa Crear.

tipoDeCliente es la clave técnica: sin espacios ni tildes, porque la usarás en importaciones, filtros y automatizaciones. Tipo de cliente es la etiqueta que verá quien rellene el formulario. isCustomField: true es obligatorio en cada campo. El valor se guarda dentro de customFields, así que la ruta del ejemplo es customFields.tipoDeCliente.

Al crear puede salir un error 503

Al crear una configuración nueva, la aplicación puede mostrar un error y dejar de responder (error 503) durante un minuto más o menos. Espera, recarga la página y comprueba con Ver JSON si la fila quedó creada antes de volver a pulsar Crear.

Si aparece «objectAssigned ya existe»

Prolibu rechaza la fila nueva con el aviso «objectAssigned ’…’ ya existe» cuando ese objeto ya tiene su fila. No crees otra: añade el campo a la existente, como se explica más abajo. Si no ves esa fila en la tabla, está en otro workspace:

1. En la barra superior, pulsa la X que hay junto al nombre del workspace. El selector queda en Ninguno y la tabla muestra las filas de todos los workspaces.
2. Busca la fila del objeto y edítala.
3. Al terminar, abre el selector y vuelve a elegir tu workspace.

Añadir o cambiar campos de un objeto

1. En la fila del objeto, pulsa el menú de tres puntos y elige Editar.

2. En el editor Campos personalizados, añade el bloque nuevo dentro de las llaves, separado del anterior por una coma:

{
  "tipoDeCliente": {
    "isCustomField": true,
    "type": "string",
    "label": "Tipo de cliente"
  },
  "numeroDeSedes": {
    "isCustomField": true,
    "type": "number",
    "label": "Número de sedes"
  }
}

3. Revisa tres cosas: que las claves y los textos lleven comillas dobles, que haya una coma entre bloques y que no sobre una coma después del último.
4. Pulsa Guardar.

Para copiar un campo, duplica su bloque dentro del mismo editor y dale una clave técnica y una etiqueta nuevas. Si repites la misma clave no obtienes dos campos: reemplazas el anterior.

Los tipos que puedes escribir en type están explicados en Campos personalizados: editor, tipos y estados. Para limitar qué valores acepta un campo, sigue Establecer reglas de validación para un campo.

No cambies la clave de un campo que ya tiene datos

Cambiar tipoDeCliente por otra clave no renombra los valores existentes: para Prolibu es un campo distinto. Si necesitas migrarlos, crea el campo nuevo, copia los valores con una importación o con un Script y elimina el anterior solo después de comprobar el resultado.

Comprobar que quedó bien

1. Abre el módulo del objeto y pulsa + para crear un registro de prueba. Con la fila Meeting, por ejemplo, abre el formulario Crear Reunión.
2. Baja hasta el final del formulario. Los campos que definiste aparecen en la sección Campos personalizados, después de los grupos propios del objeto.

3. Escribe un valor de prueba y guarda.
4. Vuelve a abrir el registro y confirma que el valor sigue ahí.

Cada tipo se dibuja con su propio control: un texto es una caja de escritura, un número trae flechas, un boolean aparece como interruptor, una fecha abre el calendario y una lista enum se convierte en desplegable. Para no mezclar datos reales, prueba antes con un registro inventado, por ejemplo uno con nombre DOC-….

También puedes mostrar el campo como columna desde Personalizar columnas del índice, usarlo en filtros o incluirlo como customFields.nombreTecnico en una importación.

Retirar temporalmente o eliminar

El menú de tres puntos de cada fila ofrece solo Editar y Eliminar. No hay opción Clonar en esta tabla: para copiar un campo se duplica su bloque, como se explicó arriba.

• Retirar sin borrar. Apaga el interruptor Activo de la fila. Los campos dejan de aparecer en el formulario, pero los valores ya guardados en los registros se conservan y vuelven a verse al reactivarla. Es la retirada reversible.
• Eliminar. Elige Eliminar en el menú de tres puntos y confirma. Es definitivo: no hay papelera ni restauración.
• Varias filas a la vez. Marca las casillas de la izquierda. Los tres puntos de arriba a la derecha (Más acciones) ofrecen entonces Editar seleccionados y Eliminar seleccionados.

Antes de eliminar una fila:

1. Pulsa Ver JSON y Copiar para guardar la definición en un archivo aparte.
2. Busca el campo en tus filtros, columnas guardadas, importaciones y Scripts.
3. Migra o retira esas dependencias.
4. Elimina la fila solo cuando nada la use.

Para llevarte los valores que tienen los registros en esos campos, exporta el objeto, no esta tabla. El paso a paso está en Exportar tus registros.