Mayo 2015
Contenido Pantalla de Tareas .............................................................................................................................. 3 Conexión a Datos. ............................................................................................................................... 5
GetAuthorizer ......................................................................................................................... 6
GetProjects ............................................................................................................................. 9
InsertTask .............................................................................................................................. 11
Login ...................................................................................................................................... 16
SearchTask ............................................................................................................................ 19
ActionTask............................................................................................................................. 21 CASO 1: Aceptar Tarea .............................................................................................................. 22 CASO 2: Terminar Tarea ............................................................................................................ 23 CASO 3: Cancelar una Tarea ...................................................................................................... 24 CASO 4: Delegar una Tarea ....................................................................................................... 25
GetTasksByUser ........................................................................................................................ 28
Mayo 2015
Pantalla de Tareas Se describirá breve y gráficamente la pantalla de una nueva tarea básica, posteriormente para continuar con la ñexplicación detallada de los métodos para conexión a los Datos necesarios para generar las mismas. A rasgos generales se representa la pantalla de una Tarea Nueva a través de la siguiente imagen: Dónde:
Referencia: Folio generado después de guardar. Usuario: Toma la entidad autenticada en el sitio. Fecha: Es la fecha y hora que se toma al momento de crear una nueva tarea. Fecha Inicio: Fecha que se elige para dar inicio a la tarea. Vencimiento: Fecha de vencimiento de la Tarea. Proyecto al cual se asociará la tarea. Descripción de Tarea: Nota o Referencia de lo que conlleva la tarea nueva. Tiempo Estimado: Tiempo estimado de duración de la tarea. Prioridad Central: Prioridad seleccionable de la Tarea (Alta, Media, Baja) Responsable: Entidad a quien se le asignará la Tarea. Etapa: Etapa de la tarea que empezará (Alta, Aceptada, Terminada, Cancelada, Delegada)
Mayo 2015
Después de “Grabar” la tarea se cuenta con los siguientes botones de acciones.
Actualiza: Guarda modificaciones sobre la tarea. Nuevo: Genera una nueva pantalla de tarea Autorizar: Asigna, Delega (Se selecciona un nuevo Autorizante), Termina y/ Cancela la Tarea Generada. (Flujo de Tarea).
Mayo 2015
Conexión a Datos. Se realizará dicha conexión a través de un Web Service. Se accederá a él a través de la siguiente URL: http://187.160.239.179/wsxPortalMobile/wsXportalMobile.asmx Se desplegarán 7 métodos en pantalla.
Mayo 2015
GetAuthorizer
Éste método es el encargado de devolver los autorizantes por tarea, esto con el objetivo de poblar a un combo en la pantalla de Tareas. Para invocar dicho método se deberá de dar clic en . El resultado arrojará una cadena string en formato JSON.
Mayo 2015
Dónde:
“Índice” es el valor del autorizante y “Entidad” es el nombre descriptivo del ítem del combo.
Mayo 2015
La estructura SOAP para el método GetAuthorizer es la siguiente: POST /wsxPortalMobile/wsXportalMobile.asmx HTTP/1.1 Host: 187.160.239.179 Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "http://tempuri.org/GetAuthorizer"
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length string
Mayo 2015
GetProjects Éste método devuelve los Proyectos existentes por usuario para poblar el combo de proyectos en la página de tareas. Para invocar dicho método se capturará el Índice de usuario devuelto por el método de Login, para el ejemplo que estamos manejando seria 2341 y posteriormente se dará click en .
El resultado arrojará una cadena string en formato JSON.
Mayo 2015
Dónde:
“Índice” es el valor y “Proyecto” es la descripción del proyecto.
La estructura SOAP para el método GetProjects es la siguiente:
POST /wsxPortalMobile/wsXportalMobile.asmx HTTP/1.1 Host: 187.160.239.179 Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "http://tempuri.org/GetProjects" string
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length string
Mayo 2015
InsertTask Éste método será detonado a la hora de dar click en guardar dentro de la pantalla de Tareas. Para invocar dicho método se deberá proporcionar de los parámetros “strSql” y “strValues” en el textbox presentado, posteriormente clic en .
El resultado arrojara un valor string: Donde se regresa el nuevo folio de la tarea cuando se insertó correctamente la tarea
Mayo 2015
Y se devuelve un 0 en caso contrario.
Los Valores a insertar se describen a continuación: PARAMETROS
DE
ENTRADA
PARA
EL
WEB
SERVICE
DE
INSERTTASK
strSql: INSERT INTO catSeguimiento (Indice, xuUsuario, xhFecha, xtHorario_Hora_Inicio, Fecha_Inicio, xtHorario_Hora_Fin, Fecha_Vencimiento, xtProyecto_Proyecto, xtTipoEntregable_Entregable, xtSector_Sector, xtArea_Area, xtModulo_Modulo, xtContratosxProyecto_Contrato, xmDescripcion_Tarea, xzeMails, Tiempo_Estimado, Tiempo_Evaluado, xqRequerimiento, Asunto, xmDescripcion, Prioridad, xtTarea_Etapa, xtZona_Grupo, x3Autorizante_Responsable, xmRespuesta, Tiempo_Real, xeAvance_Avance, xfFecha_Termino, xkBitacora_Indice, xkComentarioTarea_Indice, xkWorkFlowHistory_Indice, xtEntidad_Responsable, Fecha, xkProgramacion_Indice, xtEmpresa_Empresa, xzEmail, xrSin_Empalme, xrImportada_Project, Tiempo_R, IndiceRequerimiento, x9Cambio_Asociacion, xkRegAvance_Indice, Horas, Fecha_Atencion, xkWFHSeguimiento_Indice, idGestion, Predecesora, xkSeguimiento_Indice2, xrTareas_Dependientes, xqEntregable, Fecha_WFHInicio, Fecha_WFHFin, CampoCalculo, Etapa_Requerimiento, xrRequerimiento, xqReqPlan, xtViewProcesoReq_Proceso, ReqProceso) VALUES (@Indice, @xuUsuario, @xhFecha, @xtHorario_Hora_Inicio, @Fecha_Inicio, @xtHorario_Hora_Fin, @Fecha_Vencimiento, @xtProyecto_Proyecto, @xtTipoEntregable_Entregable, @xtSector_Sector, @xtArea_Area, @xtModulo_Modulo, @xtContratosxProyecto_Contrato, @xmDescripcion_Tarea, @xzeMails, @Tiempo_Estimado, @Tiempo_Evaluado, @xqRequerimiento, @Asunto, @xmDescripcion, @Prioridad, @xtTarea_Etapa, @xtZona_Grupo, @x3Autorizante_Responsable, @xmRespuesta, @Tiempo_Real, @xeAvance_Avance, @xfFecha_Termino, @xkBitacora_Indice, @xkComentarioTarea_Indice, @xkWorkFlowHistory_Indice, @xtEntidad_Responsable, @Fecha, @xkProgramacion_Indice, @xtEmpresa_Empresa, @xzEmail, @xrSin_Empalme, @xrImportada_Project, @Tiempo_R, @IndiceRequerimiento, @x9Cambio_Asociacion, @xkRegAvance_Indice, @Horas, @Fecha_Atencion, @xkWFHSeguimiento_Indice, @idGestion, @Predecesora, @xkSeguimiento_Indice2, @xrTareas_Dependientes, @xqEntregable, @Fecha_WFHInicio, @Fecha_WFHFin, @CampoCalculo, @Etapa_Requerimiento, @xrRequerimiento, @xqReqPlan, @xtViewProcesoReq_Proceso, @ReqProceso)
Mayo 2015
strValues:Indice|T-79288]xuUsuario|2341]xhFecha|20150528 09:18:09]xtHorario_Hora_Inicio|]Fecha_Inicio|20150528 00:00:00]xtHorario_Hora_Fin|]Fecha_Vencimiento|20150531 00:00:00]xtProyecto_Proyecto|]xtTipoEntregable_Entregable|]xtSector_Sector|123]xtArea_Area|4] xtModulo_Modulo|6]xtContratosxProyecto_Contrato|8]xmDescripcion_Tarea|descripcion_prueba]xzeM ails|
[email protected]]Tiempo_Estimado|0.00]Tiempo_Evaluado|0.00]xqRequerimiento|]Asunto| ]xmDescripcion|]Prioridad|]xtTarea_Etapa|]xtZona_Grupo|]x3Autorizante_Responsable|2602]xmResp uesta|respuesta]Tiempo_Real|]xeAvance_Avance|]xfFecha_Termino|]xkBitacora_Indice|]xkComentari oTarea_Indice|T79286]xkWorkFlowHistory_Indice|]xtEntidad_Responsable|]Fecha|]xkProgramacion_Indice|]xtEmpres a_Empresa|]xzEmail|]xrSin_Empalme|]xrImportada_Project|]Tiempo_R|]IndiceRequerimiento|]x9Camb io_Asociacion|]xkRegAvance_Indice|]Horas|]Fecha_Atencion|]xkWFHSeguimiento_Indice|]idGestion| ]Predecesora|]xkSeguimiento_Indice2|]xrTareas_Dependientes|]xqEntregable|]Fecha_WFHInicio|]Fe cha_WFHFin|]CampoCalculo|]Etapa_Requerimiento|]xrRequerimiento|]xqReqPlan|]xtViewProcesoReq_P roceso|]ReqProceso|]
Descripción de los parámetros
Mayo 2015
Mayo 2015
La estructura SOAP para el método InsertTask es la siguiente:
POST /wsxPortalMobile/wsXportalMobile.asmx HTTP/1.1 Host: 187.160.239.179 Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "http://tempuri.org/InsertTask" string string
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length string
Mayo 2015
Login Éste método será detonado a la hora de loguearse en el sitio. Para invocar dicho método se deberá proporcionar valores a los parámetros “user” y “pass” en el textbox presentado, posteriormente clic en .
Usuario valido para Login: user: velizondo pass: xPortal+2013 El resultado arrojara una cadena string en formato JSON, donde: Si el usuario está activo devolverá el Indice de usuario el cual servirá de parámetro de entrada para diversos métodos del webservice aquí mencionados y el nombre del usuario ( Entidad ) correspondiente a dicho Indice el cual servirá para mostrar en la pantalla de tarea el nombre del usuario en sesión.
Mayo 2015
De lo contrario devolverá un No
Mayo 2015
La estructura SOAP del método Login es la siguiente: POST /wsxPortalMobile/wsXportalMobile.asmx HTTP/1.1 Host: 187.160.239.179 Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "http://tempuri.org/Login" string string HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length
string
Mayo 2015
SearchTask Éste método será detonado a la hora de dar búsqueda a una tarea en la pantalla de tareas. Para invocar dicho método se deberá proporcionar valores a los parámetros de los textbox presentados, posteriormente clic en .
El resultado arrojara una cadena string en formato JSON
Mayo 2015
La estructura SOAP para el método SearchTask es la siguiente: POST /wsxPortalMobile/wsXportalMobile.asmx HTTP/1.1 Host: 187.160.239.179 Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "http://tempuri.org/SearchTask" string string string string string string string string string
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length string
Mayo 2015
ActionTask En este método se tiene una gama variada de operaciones referentes al flujo de la tarea las cuales se describirán a continuación.
Action: Abarca números del 1 al 4 para diversas acciones. IndiceR: Índice de registro el cual es devuelto en el método de InsertTask. Authorizer: Autorizante a elegir (Solo aplica cuando se delega una tarea).
Mayo 2015
CASO 1: Aceptar Tarea
Después de haber guardado una Tarea (utilizando el InsertTask) deberán de aparecer varios botones entre ellos el de Autorizar
Al dar click en Autorizar deberá de aparecer alguna opción (nosotros sugerimos un popup) donde aparezca un botón de Aceptar Tarea. Al aceptar la tarea dando click se debe de detonar nuestro método ActionTask con el valor de Action = 1 tal como indica la imagen de arriba. Con esto ya se aceptaría la tarea siempre y cuando el método regrese un valor 1 de esta manera:
Una vez aceptada la tarea, se deberá redirigir dentro de la misma ventana popup con el siguiente formato el cual es el grid que se muestra en la pagina 4 del manual
Mayo 2015
CASO 2: Terminar Tarea
Al utilizar Action = 2 estamos dicendole al webservice que la tarea será terminada y será detonado desde la imagen de la palomita verde.
Mayo 2015
Una vez terminada la tarea exitosamente (devolviendo el método en cuestión ActionTask el valor de 1) deberán de redirigirse a una pantalla con el mensaje “No existen más Autorizaciones”)
CASO 3: Cancelar una Tarea
Al utilizar Action = 3 estamos dicendole al webservice que la tarea será cancelada y será detonado desde la imagen de la tacha roja.
Mayo 2015
Una vez cancelada la tarea exitosamente (devolviendo el método en cuestión ActionTask el valor de 1) deberán de redirigirse a una pantalla con el mensaje “No existen más Autorizaciones”)
CASO 4: Delegar una Tarea
Al utilizar Action = 4 estamos dicendole al webservice que la tarea será delegada y será detonado desde la imagen de la palomita verde.
Mayo 2015
A diferencia de los casos anteriores, aquí se deberá de seleccionar a un autorizante desde un combo (combo que será poblado con el método de nuestro webservice GetAuthorizer)
Una vez delegada la tarea exitosamente (devolviendo el método en cuestión ActionTask el valor de 1) deberán de redirigirse a una pantalla con el mensaje “No existen más Autorizaciones”)
Mayo 2015
La estructura SOAP para el método ActionTask es: POST /wsxPortalMobile/wsXportalMobile.asmx HTTP/1.1 Host: 187.160.239.179 Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "http://tempuri.org/ActionTask" int string string
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length int
Mayo 2015
GetTasksByUser Éste método devuelve información pertinente a las tareas relacionadas con el usuario. Para invocar dicho método se deberá introducir valor al parámetro IdUser que es el Índice del Usuario Autenticado (El cual se obtiene del método login en caso de que se haya autenticado exitosamente)
El resultado arrojará una cadena string en formato JSON.
Mayo 2015
Dónde:
“Índice” es el valor.
La estructura SOAP para el método GetTaskByUser es la siguiente:
POST /wsxPortalMobile/wsXportalMobile.asmx HTTP/1.1 Host: 187.160.239.179 Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "http://tempuri.org/GetTasksByUser" string
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length string
Mayo 2015
GetCurrentNotifications Este método devuelve las 5 tareas más recientes que en el sistema se mostrarían como notificaciones. Como parámetros de entrada se tienen: user: Es el valor del usuario autenticado el cual devuelve el método de Login. status: Se pueden capturar dos valores para estatus, el 197 para mostrar las 5 tareas asignadas al usuario autenticado más recientes y el 220 para mostrar las 5 tareas más recientemente aceptadas por el usuario autenticado.
El resultado arrojará una cadena string en formato JSON de esta manera:
Mayo 2015
La estructura SOAP para el método GetCurrentNotifications es la siguiente: POST /wsxPortalMobile/wsXportalMobile.asmx HTTP/1.1 Host: 187.160.239.179 Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "http://tempuri.org/GetCurrentNotifications" string string
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length string
Mayo 2015