Tabla de Contenidos
Generalidades
Método
POST
Formato
Puertos posibles
- 8000
Direcciones ip posibles
- local: 192.168.3.81
Credenciales usuario
Estas credenciales no son precisas para la interfaz, pero se indican aquí para que el administrador de Smart pueda establecer restricciones o privilegios de acceso a tablas y procedimientos.
- Id: WEB
- Contraseña: en7dE93z
Otros
Para los ejemplos, se ha utilizado “Postman v8.0.4”
Relación de maquinaria
Procedimiento
XATJ_UNY_RELACION_MAQUINARIA
Resultados
- S_NRO_SERIE VARCHAR(20),
- S_NOMBRE VARCHAR(60),
- S_ESTADO VARCHAR(10),
- S_TIMESTAMP TIMESTAMP
Comportamiento
Devuelve la relación de todos los activos inventariados y su estado en el momento de la consulta.
Ha te tomarse esta consulta como algo preliminar, pues de esta relación completa de activos habrá que extraer los que no están sujetos al alquiler en el ámbito de la explotación de la empresa.
S_ESTADO podrá devolver dos valores:
- ALQUILADA: En el momento de la recogida la máquina se encuentra afecta a un contrato de alquiler.
- RECOGIDA: Maquinaria no afecta a un contrato de alquiler. Se incluyen máquinas averiadas, en revisión, etc.
S_TIMESTAMP devuelve la fecha y hora en el momento de iniciarse la consulta. Hay que tener en cuenta que el estado de la maquinaria es variable en el tiempo.
Ejemplo
Cuerpo del método post
{ "version" : "1.2", "metodo" : "Raw", "opciones" : { "metaData":true }, "comandos" : [ { "sql":"SELECT * FROM XATJ_UNY_RELACION_MAQUINARIA ROWS 10" } ] }
En el ejemplo, la cláusula “ROWS 10” limita el resultado a los primeros 10 registros. En “producción”, podría omitirse.
Resultado
{ "version": "1.2", "resultados": [ { "estado": "OK", "metaData": { "S_NRO_SERIE": { "tipo": "ftString", "etiqueta": "" }, "S_NOMBRE": { "tipo": "ftString", "etiqueta": "" }, "S_ESTADO": { "tipo": "ftString", "etiqueta": "" }, "S_TIMESTAMP": { "tipo": "ftDateTime", "etiqueta": "" } }, "datos": [ { "S_NRO_SERIE": "000272", "S_NOMBRE": "VIBRADOR ENAR ELE.TRIFAS.", "S_ESTADO": "RECOGIDA", "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" }, { "S_NRO_SERIE": "000273", "S_NOMBRE": "VIBRADOR ENAR ELEC. MONF", "S_ESTADO": "RECOGIDA", "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" }, { "S_NRO_SERIE": "000458", "S_NOMBRE": "ROZADORA NEUMAC FR-07", "S_ESTADO": "RECOGIDA", "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" }, { "S_NRO_SERIE": "001137", "S_NOMBRE": "TALADRO PERCUTOR MARCA HITACHI MODELO DV18DV", "S_ESTADO": "RECOGIDA", "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" }, { "S_NRO_SERIE": "001143", "S_NOMBRE": "COMPRESOR ESTACIONARIO MARCA INGERSOLLRAND MODELO BD2-100P-1", "S_ESTADO": "RECOGIDA", "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" }, { "S_NRO_SERIE": "000338", "S_NOMBRE": "MINIAMOLADORA MARCA HITACHI MODELO G12SR2", "S_ESTADO": "RECOGIDA", "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" }, { "S_NRO_SERIE": "000683", "S_NOMBRE": "COMPRESOR INDUSTRIAL MARCA INGERSOLLRAND MODELO BD10/500F/3", "S_ESTADO": "RECOGIDA", "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" }, { "S_NRO_SERIE": "001215", "S_NOMBRE": "SAI", "S_ESTADO": "RECOGIDA", "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" }, { "S_NRO_SERIE": "001216", "S_NOMBRE": "SAI", "S_ESTADO": "RECOGIDA", "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" }, { "S_NRO_SERIE": "001217", "S_NOMBRE": "SAI", "S_ESTADO": "RECOGIDA", "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" } ] } ] }
Consulta de activos
Procedimiento
XATJ_UNY_RELACION_ACTIVOS
Parámetros
- P_NROS_SERIE VARCHAR(4096)
Resultados
- S_NRO_SERIE VARCHAR(20),
- S_NOMBRE VARCHAR(60),
- S_ITO VARCHAR(1)
Comportamiento
- El procedimiento recibe una lista de números de serie de maquinaria separados por una coma en el parámetro P_NROS_SERIE.
- Devuelve una lista compuesta de los siguientes campos:
- S_NRO_SERIE: el mismo que el recibido como parámetro.
- S_NOMBRE: el nombre correspondiente al número de serie obtenido, en su caso, de la ficha de “activo”. En caso de que el número de serie no estuviera registrado en Smart, en este campo se devolverá el valor: INEXISTENTE
- S_ITO: En caso de que el producto asociado al activo figure en la colección “ITO”, se devolverá el valor “S”, y nada en cualquier otro caso.
Ejemplo
Cuerpo del método post
{ "version" : "1.2", "metodo" : "Raw", "opciones" : { "metaData":true }, "comandos" : [ { "sql":"SELECT * FROM XATJ_UNY_RELACION_ACTIVOS(:P_NROS_SERIE)", "params": { "P_NROS_SERIE" : "000001,012383,949343"} } ] }
Resultado
{ "version": "1.2", "resultados": [ { "estado": "OK", "metaData": { "S_NRO_SERIE": { "tipo": "ftString", "etiqueta": "" }, "S_NOMBRE": { "tipo": "ftString", "etiqueta": "" }, "S_ITO": { "tipo": "ftString", "etiqueta": "" } }, "datos": [ { "S_NRO_SERIE": "000001", "S_NOMBRE": "FRATASADORA MARCA ARTEL MODELO F90GE", "S_ITO": null }, { "S_NRO_SERIE": "012383", "S_NOMBRE": "MINIRETROEXCAVADORA MARCA TAKEUCHI MODELO TB015 CON CANOPI", "S_ITO": "S" }, { "S_NRO_SERIE": "949343", "S_NOMBRE": "INEXISTENTE", "S_ITO": null } ] } ] }