Análisis de Desarrollo

Agendamientos de Ordenes
Bogotá, 02/03/2018

TABLA DE CONTENIDO

1.INTRODUCCIÓN ................................................................................................................................................. 2
1.1.Términos y Abreviaturas (Opcional) ..................................................................................................... 2
1.2.Descripción Funcional Actual (Obligatorio) .......................................................................................... 2
2. DESCRIPCIÓN GENERAL DEL CAMBIO ............................................................................................................... 2
2.1.Objetivo y Alcance (Obligatorio) .......................................................................................................... 2
2.2.Beneficios * Colocamos la misma tabla del brief ................................... Error! Bookmark not defined.
3.REQUERIMIENTOS FUNCIONALES (Obligatorio) .................................................. Error! Bookmark not defined.
4.REQUERIMIENTOS NO FUNCIONALES (Obligatorio) ............................................ Error! Bookmark not defined.
4.1 Rendimiento ........................................................................................... Error! Bookmark not defined.
4.2 Tiempo de disponibilidad mínimo requerido ......................................... Error! Bookmark not defined.
4.3 Número máximo de transacciones esperadas ....................................... Error! Bookmark not defined.
4.4 Número promedio de transacciones esperadas por minuto .................. Error! Bookmark not defined.
4.5 Proyección de crecimiento ..................................................................... Error! Bookmark not defined.
4.6 Aseguramiento y Control (Obligatorio) .................................................. Error! Bookmark not defined.
4.7 Seguridad de la información y Auditoría (Obligatorio) .......................... Error! Bookmark not defined.
5. FACTIBILIDAD DEL REQUERIMIENTO O CAMBIO (Obligatorio) ........................... Error! Bookmark not defined.
6. SUPUESTOS Y RESTRICCIONES (Opcional)........................................................... Error! Bookmark not defined.
7. RIESGOS (Obligatorio) ......................................................................................... Error! Bookmark not defined.
7.1. Categorización de Riesgo (Obligatorio) ................................................. Error! Bookmark not defined.
8. AUTORIZACIONES DE OTRAS ÁREAS INVOLUCRADAS (FIRMAS) ......................... Error! Bookmark not defined.
 Análisis de Desarrollo
Agendamientos de Ordenes
Bogotá, 02/03/2018

1. INTRODUCCIÓN

1.1.Términos y Abreviaturas (Diligenciamiento Opcional)

[Diligenciar únicamente por las áreas usuarias, realice breve descripción y organice alfabéticamente]

1.2. Descripción Funcional Actual (Diligenciamiento Obligatorio)

Actualmente el sistema de MGL no cuenta con la funcionalidad de agendar OT en el sistema de WFM.

2. DESCRIPCIÓN GENERAL DEL CAMBIO

2.1. Objetivo y Alcance (Diligenciamiento Obligatorio)

Específicamente el presente desarrollo contempla el Agendamientos de órdenes de trabajo en WFM
Distribuidos de la siguiente forma:

a. Consultar capacidad de agendamiento en WFM:

b. Construir formulario de Agendamientos:

c. Agendar, actualizar y cancelar ordenes de OT en WFM desde MGL.

d. Construir cinco servicios rest para el seguimiento de la agenda.

3. REQUERIMIENTOS FUNCIONALES.

a. Consultar la capacidad de agendamiento en WFM: Se solicita crear dentro del panel de Ordenes de Trabajo un
formulario para consultar la capacidad de agendamiento dicho formulario deberá capturar:

{
"date":["2018-03-08"], (una fecha o n fechas para consultar capacidad de agendamiento)
"location": "DNA102", (Este valor deberá ser parametrizable en una tabla en MGL se deberá almacenar
TIPO_TRABAJO/CIUDAD/CODIGO)
"appt_number": "20202333678",(Identificador de la Ot en MGL)
"document_id": "345676",(Identificacion del usuario en sesión MGL)
"return_time_slot_info": 0, (Siempre es Cero)

"activity_field": (Datos de la orden de trabajo)

[
{"name":"worktype_label","value": "INT" },(Tipo de trabajo en MGL debe ser un código de 3 letras)
{"name": "XA_WorkOrderSubtype","value": "IN23"},(Sub tipo de trabajo en MGL)
{"name": "XA_Red","value": "Bidireccional"},(Tecnologia)
{"name": "XA_Idcity","value": "1"},(OPCIONAL)
{"name": "Node","value": "1"}(OPCIONAL)
],
"infoOrderAct":
[
 Análisis de Desarrollo
Agendamientos de Ordenes
Bogotá, 02/03/2018

{"name":"origen","value":"W"},(Valor parametrizable por ahora siempre debe ser W)

{"name":"cantServicios","value":"1"},(OPCIONAL)
{"name":"tipoTrabajo","value":"INT"},(OPCIONAL)
{"name":"subtipoTrabajo","value":"IN23"},(OPCIONAL)
{"name": "servAfectado","value": "Telefonia"},(OPCIONAL)
{"name": "tecnologia","value": "docsis"}(OPCIONAL)
]
}
Información que será encapsulada desde la clase: otMglBean.java y tendrá el llamado al webservices: capacity en la
clase AgendamientoWorkForceManager.java

La consulta devolvería una respuesta:

Con la cual se pasaría a la construcción del formulario.

REGLAS DE NEGOCIO:

Para la consulta del servicio se debe enviar mínimo una fecha con su correspondiente orden de trabajo y todos los valores
requeridos por el servicio.

//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

b. Construir formulario de Agendamientos: Se solicita crear dentro del panel de Ordenes de Trabajo un formulario que
permita recibir toda la información para realizar un agendamiento de OT en WFM:

Este formulario se construirá de acuerdo a la información recibida del webservice: capacity. El cual
Nos devolverá información sobre la cantidad de cupos que hay en una determinada franja según las fechas
consultadas.
 Análisis de Desarrollo
Agendamientos de Ordenes
Bogotá, 02/03/2018

REGLAS DE NEGOCIO:

Se debe tener en cuenta al construir el formulario para Agendar las restricciones que devuelve el servicio y las
restricciones que existen para la CCMM.

////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

c. Agendar, actualizar y cancelar ordenes de OT en WFM: para realizar el agendamiento se debe ingresa

{
"head":{"date": "2018-03-06","idTransaccion": "12"},
"data":{
"commands":
{"command":
[{"date": "2018-03-06",(Fecha de agendamiento seleccionada por el usuario)
"external_id": "DNA102",(Codigo parametrizado en MGL indica ciudad por tipo de trabajo)
"appointment":
{"appt_number": "80202502",(Numero de orden de trabajo en MGL)
"customer_number": "1010343533",(Numero cuenta Matriz)
"worktype_label": "INT",(Tipo de trabajo Basica en MGL)
"time_slot": "14-17",( La franja o el tiempo de la VT)
"name": "Carol Uribe",
"duration": "60",
"cell": 3143256656,
"phone": "3214318140",
"address": "Calle: CL 3A Placa: 5c-31 Sur Apto: CASA Com: BOG Div: TVC",(Dirección de la CCMM)
"city": "BOGOTA",(Ciudad de la CCMM)
"state": "BOGOTA D C",(Ciudad de la CCMM)
"zip": "001",(Codigo ZIP de la ciudad)
"coordx": "-74.07778845",(Datos del GEO coordenadas en X)
"coordy": "4.589795808",( Datos del GEO coordenadas en Y)
"properties": {
"property": [
{"label": "activity_notes","value": "PRUEBAS DE NUEVA VERSION OFSC"},
{"label": "XA_Idcity","value": "BOG"},
{"label": "XA_FechaCreacion","value": "2017-12-13"},
{"label": "XA_Regional","value": "TVC"},
{"label": "XA_TipoOrdenSupervision","value": "TC"},
{"label": "Node","value": "LHS"},
{"label": "XA_WorkOrderSubtype","value": "IN23"},
{"label": "XA_Bucket","value": "DNA102"},
{"label": "XA_Red","value": "Bidireccional"},
{"label": "XA_NombreNodo","value": "LACHES SANTA ANA BIDACTCS"},
{"label": "XA_NombreCompleto","value": "Saho Uribe"},
{"label": "XA_DireccionActual","value": "Calle: CL 3 Placa: 5-31 Apto: CASA Com: BOG Div: TVC"},
{"label": "XA_SLASuscriptor","value": "36"},
{"label": "XA_EstadoSLA","value": "EN CUMPLIMIENTO"},
{"label": "XA_IndicadorEstadoSLA", "value": "C"},
{"label": "XA_SLACumplimiento","value": "2"},
{"label": "XA_IndicadorReincidencias","value": "N"},
{"label": "XA_TipoOrdenMGW","value": "O"},
{"label": "XA_Distrito","value": "40444244E"},
{"label": "XA_UnidadGestion","value": "4"},
{"label": "XA_Area","value": "404"},
{"label": "XA_Zona","value": "404442"},
 Análisis de Desarrollo
Agendamientos de Ordenes
Bogotá, 02/03/2018

{"label": "XA_Contacto","value": "prueba"},

{"label": "XA_Telefonouno","value": "3214318140"},
{"label": "XA_NumeroMarker", "value": "A09271640"},
{"label": "XA_Marker", "value": "1"},
{"label": "XA_Confirmation_Mail","value": "0"},
{"label": "XA_Telefonodos_Contacto", "value": "0"},
{"label": "XA_Celular", "value": "0"},
{"label": "XA_Celular2","value": "VALOR"},
{"label": "XA_NombreCorrespondencia","value": "prueba"},
{"label": "XA_OrigenOrden","value": "1"},
{"label": "XA_ValidacionMateriales_SoftClose","value": "1"},
{"label": "XA_ValidacionActivPeligrosa_SoftClose", "value": "1"},
{"label": "XA_ValidacionFirma_SoftClose","value": "1"},
{"label": "XA_Telefonodos","value": 3143256656 },
{"label": "XA_NumeroReincidenciasOT","value": 1 },
{"label": "XA_NumeroCancelaciones","value": 0 },
{"label": "XA_NumeroReincidenciasServicios","value": 0},
{"label": "XA_NumeroReincidenciasCalidad","value": 0},
{"label": "XA_CodigoHash", "value": "ARTOC_1"},
{"label": "XA_TipoCliente","value": "31" },
{"label": "XA_Estrato","value": "2" },
{"label": "XA_Calendario","value": "TC"},
{"label": "XA_RentaCliente","value": "38585.00"},
{"label": "XA_Saldo","value": "38585.00"},
{"label": "XA_UltimoPago","value": "38585.00"},
{"label": "XA_FechaUltimoPago","value": "20170515"},
{"label": "XA_InformacionCatastral","value":
"<InfoCatastral><item1>...................................<\/item1><item2>SANTAFE<\/item2><item3>NG - NG -
CBU104<\/item3><item4>...................................<\/item4><\/InfoCatastral>"},
{"label": "XA_ServiciosOT","value": "1MT" },
{"label": "XA_Servicios_Afectados","value": "89"},
{"label": "XA_HogaresActivos","value": "0" },
{"label": "XA_EspecialistaComercial","value": "CRM User"},
{"label": "XA_CodigoEspecialistaComercial","value": "007"},
{"label": "XA_Prioridad","value": "2"}]}
}
}
]
}
}
}

Con la información interpretada en el formulario y seleccionada por el usuario se requiere que cuando el usuario de
clik en Agendar se almacene una agenda de OT en WFM y en MGL.

Para la opción de reagendar se deberá ingresar:

{
"head":{"date": "2015-01-30", "idTransaccion": "1005"},
"data":
{
"commands":
{
"command":
{
 Análisis de Desarrollo
Agendamientos de Ordenes
Bogotá, 02/03/2018

"date": "2015-01-30",(Fecha nueva del reagendamiento)

"appointment":
{
"appt_number": "2260",(Numero de la orden de trabajo)
"worktype_label": "INT",(Tipo de trabajo)
"time_slot": "07-10",(Franja de horario seleccionada para el nuevo agendamiento)
"name": "SORAYA PAREDES",
"properties":
{
"property":[
{"label": "XA_RazonDeReagendacion", "value": "Incidente Masivo aun Abierto"},(Razón por la cual se reagenda)
{"label": "XA_order_comments","value": "okokokokoko"}]} (Comentarios)
}
}
}
}
}
Para la opción de cancelar se deberá seleccionar:
- La agenda que se cancela.

REGLAS DE NEGOCIO:

Solo podrán modificar agendas los usuarios que tengan el rol específico para realizar esta tarea. Si se modifica algún
campo de la agenda y este campo esta en WFM se deberá realizar la modificación tanto en MGL como en WFM.

d. Construir cinco servicios rest para el seguimiento de la agenda:

PRIMER SERVICIO:

Enrutar(Asignar recurso): Servicio por el cual WFM nos va a informar el técnico y el aliado que va a tener la orden.

Se recibirá una entrada:

{
"user":
{"now": "2018-01-24T15:41:11-05:00",
"login": "soap",
"auth_string": "c513681655270afdb75e6e9ccbaa6319",
"company": "amx-co.test"},

"idMensaje": "1",(Identificador del mensaje)

"orden": "20202059",(Identificador de la orden de trabajo)
"origenId": "TOA",(Origen de la orden)
"idBucket": "10", (Codigo de la ciudad por tipo de trabajo )
"idOrdenEta": "13"(Identificador de la orden en WFM)
}

Con esta información se captura el id del técnico y se consume el servicio: getResorce(); para obtener nombres,
apellidos e identificación del técnico como también el nombre del aliado para actualizar la orden en MGL.

SEGUNDO SERVICIO:

Iniciar VT(Comenzar Orden): Servicio por el cual WFM indica a MGL que se ha iniciado una VT.
 Análisis de Desarrollo
Agendamientos de Ordenes
Bogotá, 02/03/2018

{
"user":
{"now": "2018-01-24T15:41:11-05:00",
"login": "soap",
"auth_string": "c513681655270afdb75e6e9ccbaa6319",
"company": "amx-co.test"},

"idMensaje": "1",(Identificador del mensaje)

"orden": "20202059",(Identificador de la orden de trabajo)
"origenId": "TOA",(Origen de la orden)
"idTecnico": "3456", (Identificador del tecnico)
"fechaInicio": "2018-01-24T15:41:11-05:00"(Fecha de inicio de la orden)
}

Con esta información capturamos la fecha de inicio y actualizamos en MGL.

TERCER SERVICIO:

No_Done: Informa que la actividad se pone como no realizada y se indica el cambio de estado (se cerró una OT no
exitosa).

Recibirá una entrada de esta forma:

{
"user":
{"now": "2018-01-24T15:41:11-05:00",
"login": "soap",
"auth_string": "c513681655270afdb75e6e9ccbaa6319",
"company": "amx-co.test"},

"idMensaje": "1",(Identificador del mensaje)

"orden": "20202059",(Identificador de la orden de trabajo)
"idTecnico": "1032377346", (Identificador del tecnico)
"razon": "13"(Identificador de la razón por la cual no fue realizada)
}

Con la respuesta de este servicio se deberá actualizar en MGL la agenda como no realizada.

CUARTO SERVICIO:

Soft_Close: Informa las actividades y los materiales que se utilizaron en la OT (Cierre previo al cierre final).

{
"user":{"now": "2018-01-31T10:43:45-05:00",
"login": "soap",
"auth_string": "e193cd0649d4feb64b31201a1280a380",
"company": "amx-co.test"},

"idMensaje": 1762853, (Identificador del mensaje)

"appt_number": "20202078",(Identificador de la orden de trabajo)
"origenId": "TOA",(Origen de la orden)
"iims1": "AA1", (Código de causa en el IIMS)
"iims2": "AA2", (Código de causa en el IIMS)
 Análisis de Desarrollo
Agendamientos de Ordenes
Bogotá, 02/03/2018

"iims3": "AA3",(Código de causa en el IIMS)

"tecnicoId": "1032377346", (Identificador del tecnico)
"actividades":"&lt;BillingActivities&gt;&lt;BillingActivity name=&#039;INSTALACION EMPAQUETADO
CABLEADO&#039; must_be_executed=&#039;true&#039; executed=&#039;true&#039;
material_required=&#039;true&#039; activity_code=&#039;IEMCA&#039; &gt;&lt;Material code=&#039;2&#039;
name=&#039;TAP DC 16&#039; family=&#039;&#039; min=&#039;0&#039; max=&#039;10&#039;
real=&#039;1&#039; units=&#039;UN&#039; area=&#039;206&#039; /&gt;&lt;Material
code=&#039;200&#039;(Actividades y Materiales)
"cambios": "1",(Cambios realizados)
"observacion": "Pruebas Carol", (Observaciones realizadas)
"razon": "OK",
"respuestaEncuesta": "1",
"im": "1"
}

QUINTO SERVICIO:

Hard_close: Informa que se ha cerrado o completado la orden exitosamente.

{
"user":{
"now": "2018-01-10T10:42:13-05:00",
"login": "soap",
"auth_string": "71302c05e4e04f82bdfdd87b05d04c35",
"company": "amx-co.test"
},
"IdMensaje": "12", (Identificador del mensaje)
"idOT": "20202078",(Identificador de la orden de trabajo)
"Origen": "TOA",(Origen de la orden)
"IdTecnico": "1032377346",(Identificador del tecnico)
"coordenadas": "12345",(Posicion indicada por el tecnico)
"recaudo": "10000",(Total recaudo)

"valorRecaudado": "9000",(Recaudo con descuento)

"notasRecaudo": "descuento",(Notas del recaudo)
"notasFirma": "notas carol",
"razon": "12",(Identificador de la razon)
"RespuestaEncuesta": "ok",(Respuesta de la encuesta)
"fechaSalidaTecnico": "31/01/2018",(Fecha de salida del tecnico)
"equiposADevolver": "0",
"iims1": "1",
"iims2": "2",
"iims3": "3"