searchTask

Descripción
Esta transacción busca tareas que coincidan con un conjunto de criterios determinado. El nivel de detalle devuelto varía en función de si el nivel de consulta se proporciona en la solicitud.
Servicios Web
Nombre de la operación: searchTask
Nombre del servicio: DWLBusinessServices
Ejemplo
Buscar tareas que se hayan asignado a un propietario de tareas específico.

Buscar tareas que tengan: un nombre de tarea, un estado de tarea y una fecha de vencimiento determinados dentro de un intervalo de fechas determinado.

Información de uso
Hay disponibles siete criterios de búsqueda:
  • Nombre de tarea
  • Tipo de categoría de tarea
  • Tipo de estado de tarea
  • Propietario de tarea
  • Nombre de entidad
  • InstancePK con nombre de entidad
  • Fecha de vencimiento inicial y fecha de vencimiento final de tarea
Como mínimo se necesita un criterio de búsqueda en la petición, y cada criterio adicional afinará aún más los resultados de la búsqueda.

Para facilitar la búsqueda de tareas activas o inactivas representadas por diferentes estados, se permiten varios estados de tarea en una petición de búsqueda. Se proporcionan seis estados de tarea predefinidos.

Las tareas con los estados predefinidos siguientes se consideran "activas":

1 = Nuevo
La tarea no tiene propietario.
2 = Pendiente
La tarea está asignada actualmente a un propietario de tareas.
3 = En curso
Se ha trabajado en la tarea.
6 = Devuelta
La tarea se ha devuelto para su corrección.
7 = Deteniendo
La tarea se está deteniendo.
8 = Detenida
La tarea se ha detenido.

Las tareas con los estados siguientes se consideran inactivas:

4 = Finalizado
La tarea se ha finalizado.
5 = Terminado
La tarea se ha terminado.

Esta transacción admite la función de Paginación.

Condiciones previas
No se aplica
Entrada obligatoria
Uno o más de los elementos siguientes:
  • TaskName
  • TaskCatType
  • TaskStatusType
  • TaskOwner
  • EntityName
  • InstancePK con EntityName
  • TaskDueDateStart y TaskDueDateEnd
Niveles de consulta
InquiryLevel:

Nivel 0: devuelve los resultados de búsqueda de la tarea y, además, para cada tarea devuelta, los elementos InstancePK y EntityName.

Nota: El nivel de consulta es opcional.
Valores de filtro
No se aplica
Comportamiento de la transacción
Se da soporte a los caracteres comodín (%) y de semejanza (?), para el elemento TaskName. Si se utilizan con un elemento de TaskName parcial, se admiten los caracteres comodín y de similitud sencillos, múltiples o en combinación.
Restricción: por lo general, los caracteres comodín no se pueden utilizar en los campos numéricos o de indicación de la hora.

Si no se proporciona un valor para TaskDueDateStart, pero sí se proporciona para TaskDueDateEnd, la respuesta de la transacción devolverá todas las tareas que venzan o que sean anteriores a la fecha final dada.

Si no se proporciona un valor para TaskDueDateEnd, pero sí se proporciona para TaskDueDateStart, la respuesta de la transacción devolverá todas las tareas que venzan o que sean posteriores a la fecha inicial dada.

Con la excepción de EntityName, las descripciones de entidad no se devuelven con el elemento InstancePK de la entidad.

Esta transacción permite buscar con los diversos estados de tarea como criterios.

Mensaje de petición
<TCRMTxType> searchTask

<TCRMTxObj> TaskSearchBObj

<TCRMObj> TaskSearchBObj

Objetos de respuesta
En función de la presencia del nivel de consulta:
Nota especial
No se aplica

Última actualización: 18 Feb 2019