Se ha añadido una nueva API para tiempo y asistencia a partir BioStar 2.8.13.
Para 'Cómo usar TA API swagger', consulte el siguiente enlace:
[BioStar 2 API para TA] Cómo usar e iniciar con BioStar 2 API para TA
Cómo agregar un nuevo registro de marcación modificado
BioStar 2 TA permite a los usuarios agregar registros de marcación modificados a los registros de eventos existentes.
Puede buscar sus registros y hacer clic en ellos para agregar / editar registros de marcación.
Puede hacer clic en el botón 'Agregar' para agregar un nuevo registro de marcación modificado. Para agregar un nuevo registro de marcación modificado, debe insertar su TIME & Punch Type. Puede encontrar la API PUT /tna/punch_logs/modified en su TA Swagger.
Parte 1. Buscar los registros de marcación
[POST]: /tna/punch_logs/modified
[Encabezados]
*Se requieren encabezados de desplazamiento y límite.
[Parámetros]
Nombre | Tipo | *M/O | Explicación | Valor |
Fecha | Cuerda | M | Fecha del registro que contiene los registros de marcación | AAAA-MM-DD |
Day_start_time | Largo | M | Hora de inicio del día utilizada para buscar registros de marcación en minutos usando el reloj de 24 horas | Ej. «60», «480» |
Retrieve_only_modified | Booleano | O | Indica si sólo se deben recuperar los registros modificados |
|
User_id | Cuerda | M | ID de usuario de los registros |
|
* M – Obligatorio, O – Opcional
[Ejemplo de modelo de valor/parámetros]
{ "fecha": "2022-04-06", "day_start_time": 0, "retrieve_only_modified": verdadero, "user_id": "1" } |
[Respuesta: exitosa]
{ "message": "Procesado correctamente", "message_key": "EXITOSO", "idioma": "en", "status_code": "EXITOSO", "total": 3, "registros": [ { "modified_log": { "id": 7, "device_datetime": "2022-04-06 08:00:00", "tipo": "PUNCH_TYPE_CHECK_IN", "usuario": { "user_id": "1", "name": "Administrador" }, "device_datetime_format_string": "2022/04/06 08:00:00" }, "device_datetime": "2022-04-05T23:00:00.000Z", "device_datetime_long": 1649199600000, "tipo": "PUNCH_TYPE_CHECK_IN", "modified_by_user": { "user_id": "1", "name": "Administrador" } }, { "modified_log": { "id": 9, "device_datetime": "2022-04-06 12:00:00", "tipo": "PUNCH_TYPE_BREAK_START", "usuario": { "user_id": "1", "name": "Administrador" }, "device_datetime_format_string": "06/04/2022 12:00:00" }, "device_datetime": "2022-04-06T03:00:00.000Z", "device_datetime_long": 1649214000000, "tipo": "PUNCH_TYPE_BREAK_START", "modified_by_user": { "user_id": "1", "name": "Administrador" } }, { "modified_log": { "id": 8, "device_datetime": "2022-04-06 17:00:00", "tipo": "PUNCH_TYPE_CHECK_OUT", "usuario": { "user_id": "1", "name": "Administrador" }, "device_datetime_format_string": "06/04/2022 17:00:00" }, "device_datetime": "2022-04-06T08:00:00.000Z", "device_datetime_long": 1649232000000, "tipo": "PUNCH_TYPE_CHECK_OUT", "modified_by_user": { "user_id": "1", "name": "Administrador" } } ] } |
La respuesta anterior representa los mismos resultados que la captura de pantalla siguiente.
Parte 2. Agregar nuevos registros de marcación modificados
[PUT]: /tna/punch_logs/modified
[Encabezados]
*Se requieren encabezados de desplazamiento y límite.
[Parámetros]
Nombre | Tipo | *M/O | Explicación | Valor |
Trozas | Arreglo | O | Registros ya existentes |
|
Logs.modified_log | Datos | O | Registros modificados ya existentes |
|
Logs.modified_log.id | Cuerda | O | ID de registro modificado |
|
Logs.modified_log.device_datetime | Fecha y hora | O | Hora del dispositivo del registro modificado |
|
Logs.modified_log.type | Cuerda | O | Código de tipo punch de registros modificado |
|
Logs.modified_log.user.user_id | Cuerda | O | ID de usuario |
|
Logs.modified_log.nombrede.usuario | Cuerda | O | Nombre del usuario |
|
Logs.modified_logdevice_datetime_format_string | Cuerda | O | Fecha y hora del dispositivo de registro modificado en formato de cadena |
|
... |
|
|
|
|
Logs.original_log | Datos | O |
|
|
Logs.modified_log | Datos | O | Nueva información de registro modificada |
|
Logs.modified_log.dispositivo | Datos | O | Nuevo dispositivo de registro modificado |
|
Logs.modified_log.user.user_id | Cuerda | O | ID de usuario del nuevo registro modificado |
|
Logs.modified_log.formatted_type.code | Cuerda | O | Nuevo código de tipo punch de registro modificado |
|
Logs.modified_log.formatted_type.id | Cuerda | O | Nuevo código de tipo punch de registro modificado |
|
Logs.modified_log.tipo_formatted.description | Cuerda | O | Descripción del código de tipo punch del nuevo registro modificado |
|
Logs.modified_log.formatted_datetime | Fecha y hora | O | Fecha y hora del nuevo registro modificado |
|
Logs.modified_log.device_datetime | Fecha y hora | O | Fecha y hora del dispositivo del nuevo registro modificado |
|
Logs.modified_log.device_datetime_format_string | Fecha y hora | O | Nueva cadena de formato datetime del dispositivo del registro modificado |
|
Logs.modified_log.type | Cuerda | O | Nuevo tipo de punzón de registro modificado |
|
... |
|
|
|
|
* M – Obligatorio, O – Opcional * No se enumeran todos los parámetros. Consulte el cuerpo de respuesta a continuación.
[Ejemplo de modelo de valor/parámetros]
{ "registros": [ { "modified_log": { "id": 7, "device_datetime": "2022-04-06 08:00:00", "tipo": "PUNCH_TYPE_CHECK_IN", "usuario": { "user_id": "1", "name": "Administrador" }, "device_datetime_format_string": "2022/04/06 08:00:00" }, "device_datetime": "2022-04-05T23:00:00.000Z", "device_datetime_long": 1649199600000, "tipo": "PUNCH_TYPE_CHECK_IN", "modified_by_user": { "user_id": "1", "name": "Administrador" }, "rowEditable": false }, { "modified_log": { "id": 9, "device_datetime": "2022-04-06 12:00:00", "tipo": "PUNCH_TYPE_BREAK_START", "usuario": { "user_id": "1", "name": "Administrador" }, "device_datetime_format_string": "06/04/2022 12:00:00" }, "device_datetime": "2022-04-06T03:00:00.000Z", "device_datetime_long": 1649214000000, "tipo": "PUNCH_TYPE_BREAK_START", "modified_by_user": { "user_id": "1", "name": "Administrador" }, "rowEditable": false }, { "modified_log": { "id": 8, "device_datetime": "2022-04-06 17:00:00", "tipo": "PUNCH_TYPE_CHECK_OUT", "usuario": { "user_id": "1", "name": "Administrador" }, "device_datetime_format_string": "06/04/2022 17:00:00" }, "device_datetime": "2022-04-06T08:00:00.000Z", "device_datetime_long": 1649232000000, "tipo": "PUNCH_TYPE_CHECK_OUT", "modified_by_user": { "user_id": "1", "name": "Administrador" }, "rowEditable": false }, { "original_log": {}, "modified_log": { "dispositivo": {}, "usuario": { "user_id": "1" }, "formatted_type": { "código": "PUNCH_TYPE_BREAK_END", "id": "PUNCH_TYPE_BREAK_END", "description": "Break End" }, "formatted_datetime": "2022-04-06 13:00:00", "device_datetime": "2022-04-06 13:00:00", "device_datetime_format_string": "2022/04/06 05:00:00", "tipo": "PUNCH_TYPE_BREAK_END" }, "rowEditable": true } ], "user_id": "1" } |
[Respuesta: exitosa]
{ "message": "Procesado correctamente", "message_key": "EXITOSO", "idioma": "en", "status_code": "EXITOSO" } |
Ahora has agregado un nuevo registro de marcación modificado. Veamos cómo se ve en BioStar 2 TA.
Parte 3. Agregar nuevos registros de marcación a través de POSTMAN
