mobile_task_insert_from_optional ( session, task_id_optional)

Definitively removed from API in version 2.7.29

Insert an optional task as a pending task for the user.

Returns the inserted task.

Input Parameters

session	The session ID
task_id_optional	The ID of an optional task (retrieved from mobile_task_get_optionals)
user	The user ID (DEPRECATED)
language	The language code in ISO format (DEPRECATED)

Output Parameters

result	An XML containing task list with the inserted task
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

XML Format

Contains a <task> object referred to the inserted optional task

Task Format

ref	The task ID
name	The task name
date	The task scheduled date
type	The task type, 1 for form task, 0 for device task
form	If form task, this contains a form ID
device_type	If device task, can be "continuous_pulseoxymetry", "pulseoxymetry", "spirometry", "activity"

Example

Request

sample:

mobile_task_insert_from_optional( LC**************.********”, “1234”);

Response

sample:

<?xml version="1.0" encoding="UTF-8"?>
<result>
  <task_list>
    <task>
      <ref>1725</ref>
      <name/>
      <date>2014-04-30 15:22:11</date>
      <type>1</type>
      <form>
        <ref>1886</ref>
        <data>
          <status>OPEN</status>
          <name>CUSTOM MESSAGE</name>
          <description>CUSTOM MESSAGE</description>
          <parent_type>TASK</parent_type>
          <parent_id>1725</parent_id>
          <parent_status>ASSIGNED/NOT DONE</parent_status>
          <parent_name>Custom message</parent_name>
          <questions>
            <question>
              <question_id>1</question_id>
              <description>Please include the text to be sent</description>
              <num_dec/>
              <mandatory>N</mandatory>
              <exclusive>N</exclusive>
              <tabulation>0</tabulation>
              <type>TEXT</type>
              <value/>
            </question>
          </questions>
        </data>
      </form>
    </task>
  </task_list>
</result>
<ErrorMsg></ErrorMsg>

Browser not supported