Preguntas Frecuentes (FAQ)

FoxServer es como darle una "puerta moderna" a tu aplicación VFP que ya funciona perfectamente. Imagínate que tu sistema VFP es como una oficina con empleados expertos, pero solo tiene una puerta vieja que requiere estar físicamente ahí. FoxServer construye múltiples puertas modernas: una para la web, otra para móviles, otra para integraciones.

En términos prácticos: Tu cliente podrá consultar su estado de cuenta desde su celular, tu vendedor podrá verificar stock desde la calle, y otros sistemas podrán "hablar" con tu VFP automáticamente.

Una API es simplemente una forma para que diferentes programas "conversen" entre sí. Es como tener un traductor que permite que tu sistema VFP entienda las peticiones que vienen de una página web, una app móvil, o incluso Excel.

¡Para nada! Tu lógica de negocio queda exactamente igual. Solo necesitas crear un servicio API con algunas funciones VFP que devuelvan los datos que quieres compartir. Es como agregar "ventanillas de atención" a tu sistema sin cambiar lo que hay adentro.

* Ejemplo: Crear un servicio Web para consultar el estado de cuenta de un cliente
DEFINE CLASS Cobranzas AS ApiController OLEPUBLIC
    PROCEDURE pEstadoCuenta(req, res) HELP "GET: cobranzas/estado/{codigo}"
        LOCAL cCodigoCliente
        cCodigoCliente = req.Params.codigo
        * Aquí usas tu lógica VFP normal
        * para consultar el estado de cuenta
        SELECT * FROM facturas WHERE cliente = cCodigoCliente INTO CURSOR temp
        IF RECCOUNT("temp") > 0
            res.Status(200).Json(THIS.CursorToJson("temp"))
        ELSE
            res.Status(404).Json("{'error': 'Cliente no encontrado'}")
        ENDIF
    ENDPROC
ENDDEFINE

Si sabes programar en VFP, ya tienes el 80% del conocimiento necesario. FoxServer se encarga de toda la parte técnica complicada (HTTP, JSON, seguridad). Tú solo te enfocas en crear clases que devuelvan datos.

Lo que necesitas saber: Trabajar con clases. Lo que NO necesitas aprender: Protocolos web, formatos JSON, configuración de servidores.

Para montar un entorno de desarrollo necesitas lo básico que probablemente ya tienes:

• Visual FoxPro 9.0/10.0/10.1/10.2 (32/64) bit (que ya usas)
• Windows 7 o superior (Windows 10/11 es mejor)
• .NET Framework 4.7.2 (se instala automáticamente si no lo tienes)
• 4GB de RAM mínimo (8GB recomendado)

Es muy probable que tu computadora actual ya cumpla todos estos requisitos.

La instalación es muy sencilla. Básicamente consta de un par de instaladores que puedes descargar desde el apartado Instalaciones y seguir las indicaciones.

Las licencias se manejan a través de suscripciones a Patreon con diferentes niveles según tus necesidades:

Importante: Tu aplicación VFP existente NO se "conecta" mágicamente con FoxServer. Lo que necesitas hacer es crear un proyecto API REST completamente nuevo usando WinFx.app que exponga tus datos a través de endpoints web.

Proceso real paso a paso:

1. Crear proyecto API nuevo: Usas WinFx.app para generar un proyecto compatible con FoxServer
2. Reutilizar tu lógica: Copias y adaptas el código de tu aplicación original (PRG, funciones, clases)
3. Adaptar para servidor: Eliminas todo lo que sea interfaz de usuario (formularios, mensajes, diálogos)
4. Exponer como endpoints: Conviertes tus funciones en servicios web

* Archivo: ClientesController.prg (NUEVO proyecto API)
DEFINE CLASS ClientesController AS ApiController OLEPUBLIC
    
    PROCEDURE pConsultarCliente(req, res) HELP "GET: cliente/{codigo}"
        LOCAL cCodigo, loResultado
        cCodigo = req.Params.codigo
        
        * Aquí ADAPTAS tu lógica existente
        * (copiada de tu aplicación original pero SIN interfaces)
        loResultado = THIS.BuscarClienteEnBD(cCodigo)  && Tu función adaptada
        
        IF loResultado.encontrado
            res.Status(200).Json(THIS.ToJson(loResultado))
        ELSE
            res.Status(404).Json('{"error": "Cliente no encontrado"}')
        ENDIF
    ENDPROC
    
    * Función adaptada de tu sistema original
    FUNCTION BuscarClienteEnBD(cCodigo)
        LOCAL loResult
        * Tu lógica de negocio ADAPTADA (sin MESSAGEBOX, sin formularios)
        SELECT * FROM clientes WHERE codigo = cCodigo INTO CURSOR temp
        
        loResult = THIS.NewObject("cliente,encontrado")
        IF RECCOUNT("temp") > 0
            loResult.cliente = THIS.CursorToObject("temp")
            loResult.encontrado = .T.
        ELSE
            loResult.encontrado = .F.
        ENDIF
        
        RETURN loResult
    ENDFUNC
    
ENDDEFINE

¡Por supuesto! FoxServer trabaja con tus tablas DBF, bases de datos SQL Server, MySQL, o cualquier fuente de datos que ya uses en VFP. No necesitas migrar ni cambiar nada de tu estructura actual.

Los formularios y reportes siguen funcionando igual. FoxServer no interfiere con tu aplicación de escritorio. Simplemente agrega la capacidad de que otros sistemas consulten tus datos. Puedes tener tu aplicación VFP corriendo normal y FoxServer respondiendo consultas web al mismo tiempo.

Una vez que tienes tu proyecto API en ejecución, cualquier página web puede obtener datos usando JavaScript simple:

// En tu página web
fetch('http://tuservidor.com/api/cliente/12345')
  .then(response => response.json())
  .then(data => {
    document.getElementById('nombre').innerHTML = data.cliente.nombre;
    document.getElementById('saldo').innerHTML = data.cliente.saldo;
  });

Es decir, tu página web "pregunta" a tu sistema VFP y obtiene la respuesta automáticamente.

FoxServer está diseñado con seguridad en mente. Tu sistema VFP nunca está expuesto directamente. FoxServer actúa como un "guardián" que:

• Valida todas las peticiones antes de llegar a VFP
• Maneja autenticación con tokens JWT
• Registra todos los accesos en logs
• Permite configurar qué datos se pueden consultar

Es más seguro que tener tu VFP corriendo directamente en red.

FoxServer maneja múltiples conexiones simultáneas sin problemas. Está optimizado para responder rápido y usar eficientemente los recursos. En pruebas reales maneja cientos de consultas por minuto sin afectar el rendimiento de tu aplicación VFP principal.

Sí, tienes control total. Puedes:

• Activar la seguridad con JWT (JSON Web Tokens) y hacer todos tus endpoints privados
• Exponer públicamente ciertos endpoints con el modificador de acceso public

FoxServer NO interfiere directamente con tu aplicación legacy - son procesos completamente independientes.

El soporte varía según tu nivel de suscripción:

Contacto: rodriguez.irwin@gmail.com

Sí, puedes cancelar cuando quieras desde Patreon. Si cancelas, FoxServer sigue funcionando hasta el final del período pagado, después pasa al modo de evaluación con limitaciones.

Es un caso perfecto para FoxServer. Creas un proyecto API REST que conecte con tu ERP existente:

Paso 1: Crear el controlador API (archivo .prg separado)

** facturasApiBackend.prg
define class facturasApiBackend as ApiController olepublic
    procedure pFacturasCliente(req, res) help "GET: facturas/{codigo} public"
        local loRes, cCodigo
        loRes = this.newobject("status,data,message")
        cCodigo = req.params.codigo
        
        * Aquí puedes reutilizar la lógica de tu ERP existente
        select numero, fecha, total, estado ;
        from facturas ;
        where cliente = cCodigo ;
        order by fecha desc ;
        into cursor facturas_cliente
        
        loRes.status = "ok"
        loRes.data = this.TableToJsonObject("facturas_cliente", .t.)
        loRes.message = "Facturas obtenidas correctamente"
        
        use in facturas_cliente
        res.status(200).json(this.toJson(loRes))
    endproc
enddefine

Paso 2: Tu cliente accede a tuempresa.com/api/facturas/12345 y obtiene sus facturas en tiempo real, sin tocar tu ERP legacy.

El API actúa como "puente" entre tu sistema VFP y el mundo web.

Perfecto. Creas un endpoint que consulte tu tabla de inventarios y una app web simple que funcione en cualquier celular:

FoxServer es ideal para esto. Tu tienda online (WooCommerce, Shopify, etc.) puede consultar precios y stock en tiempo real desde tu ERP VFP, y también puede enviar pedidos automáticamente.

Absolutamente. Puedes crear dashboards web que muestren gráficos, reportes y estadísticas en tiempo real desde tus datos VFP. Es especialmente útil para gerencia que quiere ver números desde cualquier lugar.

Con FoxServer puedes crear un portal web seguro donde tu contador acceda solo a los reportes que necesita, sin tener que instalar tu sistema completo en su computadora.