Configuración
Esta sección aborda la configuración de los procesos (processes).
GET /processes
Este método devuelve la lista de procesos accesibles para el usuario.
Parámetros de solicitud (Request parameters):
- company [obligatorio]: el nombre o Id. de la compañía.
- session [obligatorio]: el Id. de la sesión activa.
- id: El id del proceso, para mostrar solamente uno.
Respuesta (Response):
- status: devuelve "0" en caso de éxito y un código de error en cualquier otro caso.
- data: devuelve la lista de procesos y sus propiedades.
- message: "Success" o una información descriptiva del error en cualquier otro caso.
Ejemplo:
Request: {"type":"get", "url":"processes", "data":"company=demo04&session=QhuFhXB9MXprVKEfakhwaZxgA5osZg1o2NDaZeDunjRBX7cETnq6fehDH0K1&id=A0L1"} Reponse (success): "status": "0", "data": [ { "order": "00001", "id": "A0L1", "desc": "Robot Line 1", "calculation": "piezas", "cycleot": "0", "cyclet": "11", "maxcyclet": "0", "cycleq": "1", "npcauto": "0", "unit": "piezas", "minopers": "0", "opers": "3", "y0": "77,47", "g0": "87,15", "y1": "100", "g1": "100", "y2": "99,8", "g2": "99,8", "y3": "0", "g3": "0", "y4": "0", "g4": "0", "y5": "0", "g5": "0", "y6": "0", "g6": "0", "y7": "0", "g7": "0", "trace": "1", "next_processes": "", "resps": "", "stshort": "50", "prshort": "1", "microstop": "", "url": "", "lockrec": "525600", "man": "72", "genpstart": "0", "interign": "0", "limprodtosche": "0", "allowconf": "0", "type": "0", "requirenotify": "0", "wbs": "", "notifyratios": "0", "represent": "0", "excessordefect": "0", "schedulefields": "0", "img": "", "imgurl": "http://localhost/edinnm2/img/4444444444/Mach_A0L1_", "operationtime": "0" } ], "message": "Success"} Response (error): {"status":"1007", "data":"<a href='http:\/\/127.0.0.1:8080\/edinnM2\/help\/en\/API_Processes_Config.html'>for additional information follow this link<\/a>", "message":"Session not stablished"} |
GET /processes/{process}/reta
Este método devuelve la lista de procesos accesibles para el usuario.
Attributos requeridos:
Process [obligatorio]: la id del proceso
Parámetros de solicitud (Request parameters):
- company [obligatorio]: el nombre o Id. de la compañía.
- session [obligatorio]: el Id. de la sesión activa.
Respuesta (Response):
- status: devuelve "0" en caso de éxito y un código de error en cualquier otro caso.
- data: Devuelve el Id de las pestañas de favoritos que tenga asignados ese proceso, o "true" si no hay datos para ese proceso.
- message: "Success" o una información descriptiva del error en cualquier otro caso.
Ejemplo:
Request:
/processes/A0L1/reta
{
"session": 01qgmfcZmZ4nqg2eNGpxY4JlpmhJuKw1H31p5rtD1a112SSK8S8odROFIKgn
"company": DEMO04
}
Response:
{
"status": 0,
"Data":
{
true,
}
"message": "Success"
}
POST/processes
Este método crea un proceso. El usuario debe ser administrador.
Parámetros de solicitud (Request parameters, para obtener información adicional, revise la configuración del proceso):
- company [obligatorio]: el nombre o Id. de la compañía.
- session [obligatorio]: el Id. de la sesión activa.
- id [obligatorio]: el Id. del proceso.
- order: el orden relativo que se mostrará.
- desc: la descripción del proceso.
- calculation: el tipo de cálculo del proceso.
- cycleot: tiempo del recurso (persona) en segundos. Cuántos segundos del tiempo del ciclo (CycleT, ver a continuación) corresponden al trabajo del recurso (persona).
- cyclet:tiempo en segundos por ciclo de producción. Por favor, vea Velocidad máxima.
- maxcyclet: plantilla del tiempo de ciclo para aplicar al crear nuevas órdenes.
- cycleq: número de unidades esperadas por ciclo de producción. Por favor, vea Velocidad máxima.
- npcauto: indica el número de unidades de resultados con una velocidad mantenida para que el sistema actualice automáticamente la velocidad máxima del proceso. La actualización automática de la velocidad máxima se desconectará si este valor se deja en 0.
- unit: el id. de la unidad que produce el proceso.
- minopers: el número mínimo de personas que deben trabajar en un proceso en un momento determinado.
- opers: número máximo de personas que deben trabajar en un proceso en un momento determinado.
- y0: objetivo amarillo para disponibilidad.
- g0: objetivo verde para disponibilidad.
- y1: objetivo amarillo para velocidad.
- g1: objetivo verde para velocidad.
- y2: objetivo amarillo para calidad.
- g2: objetivo verde para calidad.
- y3: objetivo amarillo para disponibilidad productiva.
- g3: objetivo verde para disponibilidad productiva.
- y4: objetivo amarillo para la cantidad de MTBF.
- g4: objetivo verde para la cantidad de MTBF.
- y5: objetivo amarillo para MTBF.
- g5: objetivo verde para MTBF.
- y6: objetivo amarillo para MTTR.
- g6: objetivo verde para MTTR.
- y7: objetivo amarillo para el OCE.
- g7: objetivo verde para el OCE.
- trace: indica si las señales deben ser mandadas al registro (0 para inactivo, o 2 para activo).
- next_processes: la lista (separada por ,) de los próximos procesos en la línea.
- resps: la lista de responsables (Ids de Recursos).
- stshort: parada mínima (tiempo en segundos) para que se registre una orden como fallo (FAI) Paradas con menos tiempo del establecido se registrarán como Microparadas.
- prshort: tiempo de producción mínimo (tiempo en segundos) para que se registre la orden como producción. Este no puede ser 0 y debe ser correctamente configurado, considerando los parámetros del servidor. Contacta tu soporte técnico y solicita confirmar este valor de acuerdo a la opción "Check Status Every" en la ventana del monitor del servidor.
- microstop: estado que se usará automáticamente para justificar automáticamente las microparadas
- url: documento o aplicación que se abrirá cuando el usuario haga click en el icono
que aparecerá después de haber clicado en el proceso, en la ventana principal. Por favor vea cómo configurar URLs.
- lockrec: indica después de cuántos minutos los registros de tiempo y producción serán bloqueados para usuarios sin permiso de supervisión. Esto permite forzar las justificaciones antes de un tiempo determinado.
- man: combinación de bits para indicar cómo se monitorea el proceso manualmente.
- genpstart: si es marcado como 1, indicará al sistema que genere automáticamente un nuevo estado para indicar que se ha iniciado un nuevo trabajo, cada vez que se inserta un resultado con cantidad 0, si en la configuración de estado la opción de inicio de trabajo se ha marcado para uno, y no más de un estado.
- interign: si es marcado como 1, el proceso será ignorado a la hora de transferir informador desde o hacia otro sistema, como los ERPs. Por favor vea integración con otros sistemas.
- limprodtosche: si es marcado como 1, el proceso estará limitado estrictamente a seguir las órdenes de trabajo planificadas para él, y podrá ser visto desde la ventana de Ver Planificación.
- allowconf: si es marcado como 1, permitirá al usuario configurar el proceso y añadir más estados y resultados.
- type: indica, si es marcado como 1, que el proceso está dedicado a atender servicios. Esta marca, por ejemplo, mostrará el tiempo de trabajo de estos procesos como servicios en el informe FTE.
- requirenotify: este selector, si es marcado como 1, forzará al usuario a indicar las cantidades con el cierre de una orden en los elementos seleccionados.
- wbs: reservado para la programación avanzada de tareas.
- notifyratios: si se selecciona, el sistema notificará por correo electrónico (1) cuando el ratio seleccionado (OEE, Disponibilidad, Velocidad o Calidad) esté por debajo del objetivo amarillo, en cualquiera de los periodos definidos.
- represent: indica, cuando es marcado como 1, si el proceso es el representante de un área
- excessordefect: en el caso de que notifyratios esté configurada a Planificación, entonces éste incluirá la desviación en % de exceso o defecto de producción de las órdenes de trabajo para que sean notificadas.
- img: un imagen que se puede subir a un proceso para representarlo visualmente.
- schedulefields:
- operationtime: el tiempo que el proceso tiene registrado en operacion.
Respuesta (Response):
- status: devuelve "0" en caso de éxito y un código de error en cualquier otro caso.
- data: devuelve la lista de procesos y sus descripciones.
- message: "Success" o una información descriptiva del error en cualquier otro caso.
Ejemplo:
Content-Type: application/json Request: { "company": "demo01", "session": "LebEWTNf8GEhxfQeeGbBmVUlxmUIDLVdEoeVYrnWNzkdRXKxmgCNc92wnSjA", "order": "00001", "id": "1CON", "desc": "CONVEYOR 1", "calculation": "PIECES", "cyclet": "10", "maxcyclet": "0", "cycleq": "1", "npcauto": "0", "unit": "PIECES", "minopers": "0", "opers": "10", "y0": "60", "g0": "60", "y1": "90", "g1": "95", "y2": "95", "g2": "98", "y3": "60", "g3": "70", "y4": "0", "g4": "0", "y5": "0", "g5": "0", "y6": "0", "g6": "0", "y7": "60", "g7": "60", "trace": "0", "next_processes": "2ROT", "resps": "", "stshort": "180", "prshort": "10", "microstop": "MIC", "url": "", "lockrec": "120", "man": "9", "genpstart": "0", "interign": "0", "limprodtosche": "0", "allowconf": "0", "type": "0", "requirenotify": "0", "wbs": "", "notifyratios": "0", "represent": "0", "excessordefect": "0", "img": "", "operationtime": "22", "schedulefields": "2" } Reponse (success): { "status": "0", "data": true, "message": "Success" } |
POST /processes (ISA-95 compliant, para más información lea el documento de B2MML)
Este método crea un proceso usando datos B2MML codificados como JSON. El usuario debe ser administrador.
Parámetros de solicitud (Request parameters, para obtener información adicional, revise la configuración del proceso):
- company [obligatorio]: el nombre o Id. de la compañía.
- session [obligatorio]: el Id. de la sesión activa.
- data [obligatorio]: los datos que definen el proceso en formato B2MML codificado como JSON.
Ejemplo:
{ "SyncEquipment": { "ApplicationArea": { "Sender": {"ComponentID": "ERP","ConfirmationCode": "Always"}, "CreationDateTime": "2019-04-10T16:30:32" }, "DataArea": { "Sync": {"ActionCriteria": {"ActionExpression": { "@actionCode": "Add" }}}, "Equipment": { "ID": "WC1", "Description": "WorkCell 1", "Location": { "EquipmentID": "DEMO01", "EquipmentElementLevel": "Enterprise", "Location": { "EquipmentID": "P1", "EquipmentElementLevel": "Site", "Location": { "EquipmentID": "PL1", "EquipmentElementLevel": "ProductionLine" } } }, "EquipmentProperty": [ {"ID": "Id_Calc","Value": {"ValueString": "CycleT","DataType": "string","UnitOfMeasure":""}}, {"ID": "CycleQ","Value": {"ValueString": "4","DataType": "int","UnitOfMeasure":""}}, {"ID": "CycleT","Value": {"ValueString": "3600","DataType": "int","UnitOfMeasure":""}}, {"ID": "NPCAuto","Value": {"ValueString": "0","DataType": "byte","UnitOfMeasure":""}}, {"ID": "Id_Unit","Value": {"ValueString": "M3","DataType": "string","UnitOfMeasure":""}}, {"ID": "Opers","Value": {"ValueString": "3","DataType": "int","UnitOfMeasure":""}}, {"ID": "StShort","Value": {"ValueString": "60","DataType": "int","UnitOfMeasure":""}}, {"ID": "PrShort","Value": {"ValueString": "60","DataType": "int","UnitOfMeasure":""}}, {"ID": "MachNext","Value": {"ValueString": "WC2,WC3","DataType": "string","UnitOfMeasure":""}}, {"ID": "Trace","Value": {"ValueString": "1","DataType": "integer","UnitOfMeasure":""}}, {"ID": "Resps","Value": {"ValueString": "PERS1","DataType": "string","UnitOfMeasure":""}}, {"ID": "URL","Value": {"ValueString": "nombre_del_archivo","DataType": "string","UnitOfMeasure":""}}, {"ID": "Id_StTU","Value": {"ValueString": "FAI","DataType": "string","UnitOfMeasure":""}}, {"ID": "LockRec","Value": {"ValueString": "10080","DataType": "integer","UnitOfMeasure":""}}, {"ID": "Man","Value": {"ValueString": "7","DataType": "integer","UnitOfMeasure":""}}, {"ID": "Type","Value": {"ValueString": "7","DataType": "integer","UnitOfMeasure":""}}, {"ID": "GenPStart","Value": {"ValueString": "0","DataType": "integer","UnitOfMeasure":""}}, {"ID": "InterIgn","Value": {"ValueString": "7","DataType": "integer","UnitOfMeasure":""}}, {"ID": "LimProdToSche","Value": {"ValueString": "7","DataType": "integer","UnitOfMeasure":""}}, {"ID": "AllowConf","Value": {"ValueString": "7","DataType": "integer","UnitOfMeasure":""}} ] } } } } |
Ejemplo de respuesta:
{ "status":"0", "data":"{ \"ConfirmBOD\":{ \"ApplicationArea\":{ \"Sender\":{\"ComponentID\":\"EDINN\",\"ConfirmationCode\":\"Always\"}, \"CreationDateTime\":\"2019-11-12T12:16:18\" }, \"DataArea\":{ \"Confirm\":{\"ResponseCriteria\":{\"ResponseExpression\":{\"@actionCode\":\"Accepted\"}}}, \"BOD\":{\"Description\":\"Accepted WC1\",\"Note\":[]} } } }", "message":"Success" } |
DELETE/processes/{id}
Este método borra un proceso. El usuario debe ser administrador.
Atributos de solicitud (Request attribute):
- id [obligatorio]: el Id. de la sesión a borrar.
Parámetros de solicitud (Request parameters):
- company [obligatorio]: el nombre o Id. de la compañía.
- session [obligatorio]: el Id. de la sesión activa.
Ejemplo:
Content-Type: application/json Request: { "company": "demo01", "session": "LebEWTNf8GEhxfQeeGbBmVUlxmUIDLVdEoeVYrnWNzkdRXKxmgCNc92wnSjA" } Response (success): { "status": 0, "data": null, "message": "Success" } |