Extender con código
Cuando la configuración no alcanza, Nxar se extiende con código en cuatro frentes. Esta sección es para desarrolladores que trabajan sobre un workspace (los del propio cliente o de un partner); no hace falta conocer el código de Nxar.
| Pieza | Qué es | Para |
|---|---|---|
| Logic Components | Funciones JavaScript que corren en el servidor, en un sandbox, con un SDK (ctx) para leer y escribir registros, llamar integraciones, mandar emails, generar PDFs | Lógica de negocio que no entra en una automation, integraciones con APIs externas, el backend de un Visual Component, verificadores de webhooks |
| Visual Components | Componentes React que se montan en Record Pages, App Pages, botones del encabezado, pantallas de un Stepper o páginas públicas, con un SDK (sdk) y la librería Nxar.* | UI a medida: paneles, editores, dashboards, diálogos, páginas públicas (la aprobación de una cotización) |
| Public API | API HTTP versionada (/public/v1) con API keys: CRUD de registros con tus permisos y sharing, y endpoints custom que exponen un Logic Component o una automation | Integrar Nxar con tus sistemas, recibir webhooks firmados |
| External Identity | Registro y login de los usuarios finales de tu app contra Nxar (/public/v1/auth) | Portales de clientes, apps móviles, ecommerce |
¿Cuál necesito?
- ¿Renderiza UI? → Visual Component. Si además necesita datos de afuera o escribir con lógica, le ponés un Logic Component de backend (
sdk.runLogic). - ¿Solo procesa datos, llama APIs o decide algo al guardar? → Logic Component, invocado desde una automation, un Stepper, un endpoint o un Visual.
- ¿Otro sistema tiene que hablar con Nxar? → Public API (con API key) o un endpoint custom con firma HMAC (webhooks).
- ¿Tus clientes finales tienen que loguearse en tu app? → External Identity.
Antes de escribir código
Probá primero lo que ya existe: una automation con condiciones, fórmulas y el nodo Llamar Integración cubre muchísimos casos sin código; un report embebido cubre la mayoría de las visualizaciones; un formulario público cubre la captura de datos. Lo que se configura se mantiene solo; lo que se programa lo mantenés vos.
Por dónde empezar
| Página | Qué cubre |
|---|---|
| Logic Components | Crear uno, el contrato del handler, el SDK ctx completo, debugging |
| Visual Components | Crear uno, dónde se monta (scopes), props, estilos, preview, ejemplos |
| SDK de Visual Components | El objeto sdk completo: datos, navegación, diálogos, toasts, header actions, límites |
| Nxar UI library | Los componentes Nxar.*, iconos y clases Tailwind disponibles en el iframe |
| Component Library | El sitio de referencia con cada componente en vivo |
| Public API | API keys, endpoints de datos, endpoints custom, webhooks HMAC, audit |
| External Identity | Register, login, refresh y reset para los usuarios de tu app |
Dónde vive cada cosa en Configuración
- Constructor de app → Logic Components / Visual Components: crear y editar componentes (requiere acceso a Configuración).
- Integraciones y API → Access Tokens: tokens personales para la CLI de metadata. → Endpoints: API Config (habilitar la Public API, API keys), Endpoints y webhooks, Audit Logs.
- Acceso y seguridad → Usuarios externos: External Identity.
- Datos y paquetes → Marketplace: los paquetes son la forma de distribuir conjuntos de componentes, automations y entidades listos para instalar.
Last updated on