执行action

POST /action-executions

基本信息

Note:此端点在Alfresco 5.2和更高版本中可用。

执行action

可以针对由targetId指定的节点执行action。例如：

{
  "actionDefinitionId": "copy",
  "targetId": "4c4b3c43-f18b-43ff-af84-751f16f1ddfd",
  "params": {
      "destination-folder": "34219f79-66fa-4ebf-b371-118598af898c"
  }
}

使用上面显示的请求正文执行POST将导致由targetId标识的节点被键destination-folder复制到对象params中指定的目标文件夹中。

targetId是可选的，但是当前targetId必须是有效的节点ID。今后将可以针对不同的实体类型或在不需要实体文本的情况下执行action。

在params对象中提供给action的参数将转换为期望的类型，如果可能，可以使用DefaultTypeConverter类。此外：

节点ID可以以其简短形式提供（隐式工作区（implicit workspace）：//SpacesStore prefix）
方面名称可以使用其简短形式提供，例如 cm:versionable 或 cm:auditable

在此示例中，我们使用上述QName解析度将cm：versionable方面添加到节点：

{
  "actionDefinitionId": "add-features",
  "targetId": "16349e3f-2977-44d1-93f2-73c12b8083b5",
  "params": {
      "aspect-name": "cm:versionable"
  }
}

actionDefinitionId是list action返回的action定义的ID（例如GET / action-definitions）。

该action将被asynchronously执行和与202 HTTP响应表示已成功接受请求。响应主体包含待执行action的唯一ID。该ID可以用于比如将执行与服务器日志中的输出相关联的情况。

请求方式：POST

请求API ：/action-executions

响应等级（状态202）

action执行请求已接受并等待执行。

{
  "entry": {
    "id": "string"
  }
}

响应内容类型 applicaiton/json

Body参数（actionBodyExec）

request body示例

{
  "actionDefinitionId": "string",
  "targetId": "string",
  "params": {}
}

回应信息

状态码	原因
400	无效的参数：action必需的actionDefinitionId丢失
401	验证失败
404	actionDefinitionId或targetId不存在
default	意外错误

返回结果示例

{
  "error": {
    "errorKey": "string",
    "statusCode": 0,
    "briefSummary": "string",
    "stackTrace": "string",
    "descriptionURL": "string",
    "logId": "string"
  }
}

Alfresco API

基本信息

响应等级（状态202）

Body参数（actionBodyExec）

回应信息