REST API Methods > REST APIs for POST Method > Creator - Share Forms and Views

Creator - Share Forms and Views


共享表单与视图

 
          百会Creator的REST方式Web API允许应用程序拥有者通过HTTP POST方法在百会Creator表单中与其他用户共享表单和视图。同时您将从调用的方法中得到一个格式化的XML/JSON回复。

哪些人可以共享表单和视图? 

       只有拥有有效的API key的应用程序拥有者可以在百会Creator应用中共享表单和视图。


要求的网址

       下面为以XML和JSON格式书写的用于共享表单和视图要求加入的链接网址:

XML格式 : http://creator.baihui.com/api/xml/<applicationName>/<formName> (or) <viewname>/share/
JSON格式 : http://creator.baihui.com/api/json/
<applicationName>/<formName> (or) <viewname>/share/

要求的参量

           要求的参量由应用名、表单名(或视图名)和邮件名三部分组成。


项目
描述
applicationName
以deluge脚本指定的应用名。参见http://creator.baihui.com/api/reference/查看用deluge脚本命名的应用名。
formName/viewName
以deluge脚本指定的应用名中被共享的表单或视图的名称。参见http://creator.baihui.com/api/reference/查看用deluge脚本命名的应用名。
mailids 用于共享应用的邮件名,使用逗号加以隔开,例如:test@baihui.com, test1@baihui.com 

表单示例 ( POST 格式方法 ) 


<form method=
"POST action ="http://creator.baihui.com/api/xml/<applicationName>/<formName> (or)<viewName>/share/">

<textarea rows=10 cols=27 name="mailids" id="mailids" value="[mailids seperated by commas]"> </textarea>

<input type="hidden" name ="apikey" id="apikey" value="[APIKEY]">
<input type="hidden" name ="apikey" id="apikey" value="[Ticket]">
</form>



请求示例

          与一个邮件名为test@baihui.com的用户共享名为"employee"的应用中一个名为"Employee_Details"的表单的示例。


<form method="POST action ="http://creator.baihui.com/api/xml/employee/Employee_Details/cancelshare/">

<input type="textarea" name="mailids" value="test@baihui.com">

<input type="hidden" name ="apikey" id="apikey" value="7be221b9e0c6b859f2932463d5388409">
<input type="hidden" name ="ticket" id="ticket" value="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx">
<input type="submit" value="Share">

</form>




XML格式应答示例


<response>
<share operation="add">
<application name="employee">
<form name="Employee_Details"/>
<mailids>
<mailid>test@baihui.com</mailid>
</mailids>

<status>Success</status>
</application>
</share>
</response>



JSON格式应答示例


{"response":
[
{
"status":"Success",
"mailids":["test@baihui.com"],
"application":[{"name":"employee"},
{"form":[{"name":"Employee_Details"}]}],
"share":[{"operation":"add"}]
}
]
}


      如果在应答格式中出现错误,对应的错误代码及错误信息将显示出来。请参考此专题Error codes and description,获悉错误代码显示列表相关信息。

      当记录添加进数据库后,应答信息将显示数据及提示信息如"Success"。

 

 


取消共享

 
          百会Creator的REST方式Web API允许应用程序拥有者通过HTTP POST方法在百会Creator表单中与其他用户取消共享表单和视图。同时您将从调用的方法中得到一个格式化的XML/JSON回复。

哪些人可以取消共享表单和视图? 

       只有拥有有效的API key的应用程序拥有者可以在百会Creator应用中与现有的应用共享者取消共享表单和视图。



要求的网址

          下面一行为以XML和JSON格式书写的用于取消共享表单和视图要求加入的链接网址:

XML格式 : http://creator.baihui.com/api/xml/<applicationName>/<formName> (or) <viewname>/cancelshare/
JSON格式 : http://creator.baihui.com/api/json/
<applicationName>/<formName> (or) <viewname>/cancelshare/


要求的参量

             要求的参量由应用名、表单名(或视图名)和邮件名三部分组成。


项目 描述
applicationName
以deluge脚本指定的应用名。参见http://creator.baihui.com/api/reference/查看用deluge脚本命名的应用名。
formName/viewName
以deluge脚本指定的应用名中被取消共享的表单或视图的名称。参见http://creator.baihui.com/api/reference/查看用deluge脚本命名的应用名。
mailids 用于共享应用的邮件名,使用逗号加以隔开,例如:test@baihui.com, test1@baihui.com 

表单示例 ( POST 格式方法 )


<form method=
"POST action ="http://creator.baihui.com/api/xml/<applicationName>/<formName> (or)<viewName>/cancelshare/">

<textarea rows=10 cols=27 name="mailids" id="mailids" value="[mailids seperated by commas]
"> </textarea>

<input type="hidden" name ="apikey" id="apikey" value="[APIKEY]">
<input type="hidden" name ="tickety" id="ticket" value="[Ticket]">
<input type="submit" value="Share">

</form>



请求示例

            取消同email为test@baihui.com的用户共享名为 "employee"的应用中一个名为"Employee_View"的表单的示例。


<form method="POST action ="http://creator.baihui.com/api/xml/employee/Employee_Details/cancelshare/">

<input type="textarea" name="mailids" value="test@baihui.com">

<input type="hidden" name ="apikey" id="apikey" value="7be221b9e0c6b859f2932463d5388409">
<input type="hidden" name ="ticket" id="ticket" value="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx">
<input type="submit" value="Share">

</form>




XML格式应答示例


<response>
<share operation="remove">
<application name="employee">
<form name="Employee_Details"/>
<mailids>
<mailid>test@baihui.com</mailid>
</mailids>

<status>Success</status>
</application>
</share>
</response>


JSON格式应答示例


{"response":
[
{
"status":"Success",
"mailids":["test@baihui.com"],
"application":[{"name":"employee"},
{"form":[{"name":"Employee_Details"}]}],
"share":[{"operation":"remove"}]
}
]
}


      如果在应答格式中出现错误,对应的错误代码及错误信息将显示出来。请参考此专题Error codes and description,获悉错误代码显示列表相关信息。

      当应用与其他用户成功共享后,应答信息将显示数据及提示信息如"Success"。

 



0 评论  从新到旧显示
发布评论




 此页的RSS