† task_calendar_month ()

Is a function that returns the days which have the task in status “Not assigned/Assigned not done/Sent/Not sent” and completed tasks and “open” and “closed” events in a given month and year.

Input

parameters:

session: is the toke obtained in the session_init call

month: in numerical 1 up to 12

year: year in 4 digital numbers. Sample: 2012

type: ADMI|CASE|USR|CALLS|SCH|DUE

“ADMI” : returns the tasks of the admission. The ID input parameter is the admission_id referenced by the URL

“CASE”: returns the tasks and the events of the case. The ID input parameter is the case_id referenced by the URL

“USR”: returns the tasks assigned to the user, assigned to the rol but not assigned to the user, and events created by or assigned to the user. Is called from USER(CALENDAR) graphic object. The ID input parameter is the id that is referenced by the URL

“CALLS”: returns events with CALL type.

 “SCH”:  returns tasks not assigned or not programmed. Is called by SCHEDULE graphic object. There is no ID input parameter

“DUE”:  returns overdue tasks or open events. Will called by a  graphic object. The ID input parameter is a id reference /to show the pending tasks and open events of a defined user, or none to see all due tasks or open events

id: depending the type input parameter will be admission_id or case_id or id  ( can be an external ID like SOURCE/ID/NNNN )

Output

parameters:

result: is an string formed by rows of dates with the indicators like this:

DATE|PENDING_TASKS|COMPLETED_TASKS|OPEN_EVENTS|CLOSED_EVENTS#DATE_2|….

ErrorMsg: any fault in the call, either in the validation of input parameters, errors in the connection to the database or any other error, this parameter returns the error message produced

Request

sample:

task_calendar_month(“LCAAAAAAAAA”, “4”, “2012”, “CASE”, ”, “{label:}case_id{@source}”);

Response

sample:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<result>2012-01-01|2|2|1|1#2012-01-03|….</result>

<ErrorMsg></ErrorMsg>

Notes:

* Currently this function is only implemented for “CASE” and “ADMI” id_types