====== Generalidades ======
=== Método ===
POST
=== Formato ===
http://#ip:#puerto/services/ismartwebdoc/?format=json
=== 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
}
]
}
]
}
----
== Control de cambios del documento ==
--- //[[juanma@smartastur.com|Juanma]] 2022/01/14 14:26// Consulta de activos
--- //[[juanma@smartastur.com|Juanma]] 2021/12/15 09:26// Documento inicial