Is a function to retrieve a list of protocols associated by a program. If the mdc (major disease category) code is passed, only protocols associated with this category will be returned.

Input

parameters:

session: a token obtained by calling session_init ()

program: a program reference

mdc: an mdc (major diagnosis category} code

active: a choice to show just the active programs or all programs. Non active programs can only be retrieved by a Center Manager user’s active role.

Output

parameters:

protocols: an xml list of protocols

protocols: a protocol xml object

ref: protocol reference

name, description: protocol short name in the current session active language

active: Y|N If no reported, defalt value is “Y” (yes)

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:

protocol_list ( “LCAAAAAAAAAAAA”, “{controller://{label/{source/}}program_id”, “4” )

Response

sample:

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

<protocols>
  <protocol>
    <ref>{<source>
      </source>}<id>protocol_id</id>
    </ref>
    <name>sort_name</name>
    <description>text</description>{<active>{Y}|N</active>}<prot_code>PROTCODE</prot_code>
  </protocol>
</protocols>

Notes:

Revision pending

Browser not supported