MAPI Manual

NAME

SAVE_AGILE_BYSTENCIL_START

FUNCTION

Save agile by stencil, then start it

SYNOPSIS

agile_id, agile_title, keep_draft, funtemplate_id, funtemplate_stencil_id, xlabel_id_list, xlabel1...xlabelN

DESCRIPTION

This function allows users to update an existing agile or create a new one if not exists, then start this agile. If the ID of an existing agile is provided, the agile will be updated; otherwise, a new agile will be created.

Required Parameters

* action: SAVE_AGILE_BYSTENCIL_START.
* agile_title: agile title.
* keep_draft: specifies whether the draft will be saved or not. Value is "ON" or "OFF". "ON" means that the draft will be saved.
* funtemplate_id: the template ID.
* funtemplate_stencil_id: the stencil ID.
* xlabel1...xlabelN: specifies the values of the fields within the stencil. The fields are represented in the form of numbered xlabels.

* xlabel_id_list: contains the IDs of all the xlabels for this stencil. For more information about the xlabels for current stencils of function templates, see ADD_AGILE_BYSTENCIL.

Optional Parameters

* agile_id: agile ID. ID of the agile that needs to be updated.

RETURN DATA

The response contains the following attribute:

* msg: Success or error message.

ROLE PERMITTED

Manager

EXAMPLES

The following example shows a successful HTTP GET request and response. It creates a new agile since agile ID is not given in the request, and then starts this agile.

Request:

http://app02.yvntech.com/MapIHttpS/MapIS?action=SAVE_AGILE_BYSTENCIL_START&agile_title=new%20agile%20message%20demo&keep_draft=ON&funtemplate_id=100&funtemplate_stencil_id=2&xlabel10=12&xlabel11=164&xlabel12=2&xlabel13=Hello%20World&xlabel_id_list=10_1%2C11_25%2C12_22%2C13_10001&login_name=user@example.com&login_passwd=1111

Response:

<result tftype='1' infotype='0'>
    <field name='msg'>SUCCESS</field>
</result>



The following example finds the agile ID and updates this agile, then starts it.

Request:

http://app02.yvntech.com/MapIHttpS/MapIS?action=SAVE_AGILE_BYSTENCIL_START&agile_id=1100&agile_title=new%20agile%20message%20demo%20update&keep_draft=ON&funtemplate_id=100&funtemplate_stencil_id=2&xlabel10=12&xlabel11=164&xlabel12=2&xlabel13=Hello%20agile&xlabel_id_list=10_1%2C11_25%2C12_22%2C13_10001&login_name=user@example.com&login_passwd=1111

Response:

<result tftype='1' infotype='0'>
    <field name='msg'>SUCCESS</field>
</result>


TIPS

ENVIRONMENT

AUTHOR

YVN Tech

SEE ALSO

SAVE_AGILE_BYSTENCIL, START_AGILE

Mweb v2.0 YVNTECH 2014