共享表单与视图
百会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"。