Tabla de Contenidos

Generalidades

Método

POST

Formato

http://#ip:#puerto/services/ismartwebdoc/?format=json

Puertos posibles

  1. 8000

Direcciones ip posibles

  1. 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.

  1. Id: WEB
  2. Contraseña: en7dE93z

Otros

Para los ejemplos, se ha utilizado “Postman v8.0.4”


Relación de maquinaria

Procedimiento

XATJ_UNY_RELACION_MAQUINARIA

Resultados

  1. S_NRO_SERIE VARCHAR(20),
  2. S_NOMBRE VARCHAR(60),
  3. S_ESTADO VARCHAR(10),
  4. 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:

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

  1. P_NROS_SERIE VARCHAR(4096)

Resultados

  1. S_NRO_SERIE VARCHAR(20),
  2. S_NOMBRE VARCHAR(60),
  3. S_ITO VARCHAR(1)

Comportamiento

  1. El procedimiento recibe una lista de números de serie de maquinaria separados por una coma en el parámetro P_NROS_SERIE.
  2. Devuelve una lista compuesta de los siguientes campos:
    1. S_NRO_SERIE: el mismo que el recibido como parámetro.
    2. 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
    3. 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 2022/01/14 14:26 Consulta de activos

Juanma 2021/12/15 09:26 Documento inicial