Objective Connect (预览版)
Objective Connect 是受信任的文件共享平台,允许组织与外部方共享敏感文档。 用户可以在几秒钟内创建专用工作区并邀请云中的参与者。 协作、报告、安全性和合规性功能使政府和受监管行业能够外部工作,同时保持心态。
此连接器在以下产品和区域中可用:
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 : - Azure 政府区域 - Azure 中国区域 - 美国国防部(DoD) |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| 连接器元数据 | |
|---|---|
| 发布者 | Objective Corporation |
正在创建连接
连接器支持以下身份验证类型:
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用:所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享,系统会提示其他用户显式创建新连接。
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| 密码 | securestring | 此 API 的密码 | True |
| 服务器区域。 (英国 - secure.objectiveconnect.co.uk, 澳新银行 - secure.objectiveconnect.com) | 字符串 | 指定 Objective Connect 服务器。 | True |
| 用户名 | securestring | 此 API 的用户名 | True |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| 上传文档内容 |
上传文档的内容 |
| 列出共享文档 |
按工作区 UUID 获取资产列表 |
| 列出工作区 |
获取请求用户有权查看的共享列表 |
| 列出文档版本 |
获取资产版本列表 |
| 创建工作区 |
创建工作区 |
| 创建文档 |
如果请求为 application:hal+json,则仅创建元数据。 如果请求是多部分:form-data,则会在一次调用中创建包含内容的文档。 |
| 删除参与者 |
从工作区中删除参与者 |
| 添加或更新参与者 |
邀请新参与者或编辑分配的角色 |
| 获取参与者 |
获取工作区参与者 |
| 获取工作区 |
按 ID 获取工作区 |
| 获取文档内容 |
返回文档的内容 |
| 获取文档版本 |
获取资产版本 |
| 获取文档版本内容 |
返回文档版本的内容 |
| 获取用户 |
获取用户 |
上传文档内容
上传文档的内容
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文档
|
assetUuid | True | string |
文档 UUID |
|
工作空间
|
shareUuid | True | string |
工作区 UUID |
|
文件内容
|
file | True | file |
要上传的文件内容 |
列出共享文档
按工作区 UUID 获取资产列表
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
shareUuid | True | string |
工作区 UUID |
|
长度
|
length | integer |
要检索的最大结果数 |
|
|
Offset
|
offset | integer |
返回值开始的结果(默认值为 0) |
|
|
父 UUID
|
parentUuid | string |
共享或父资产的 UUID。 如果提供,结果将限制为共享或资产的直接子级。 如果无效,则响应将为 200,其中包含空列表。 |
|
|
Query
|
query | string |
搜索查询字符串。 如果提供结果,结果将限制为名称以给定查询值开头的资产。 |
|
|
排序
|
sort | string |
排序顺序条件字符串。 可接受的值为
|
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
|
array of object | ||
|
annotationsCount
|
annotationsCount | integer |
annotationsCount |
|
commentCount
|
commentCount | integer |
commentCount |
|
内容版本
|
contentVersion | integer |
内容版本 |
|
创建日期
|
createdDate | string |
创建日期 |
|
扩展
|
extension | string |
扩展 |
|
文件大小
|
fileSize | integer |
文件大小 |
|
locked
|
locked | boolean |
locked |
|
模型
|
model | string |
模型 |
|
modifiedByUuid
|
modifiedByUuid | string |
modifiedByUuid |
|
modifiedDate
|
modifiedDate | string |
modifiedDate |
|
姓名
|
name | string |
姓名 |
|
pdfPreviewstatus
|
pdfPreviewstatus | string |
pdfPreviewstatus |
|
previewPageCount
|
previewPageCount | integer |
previewPageCount |
|
previewstatus
|
previewstatus | string |
previewstatus |
|
状态
|
status | string |
状态 |
|
类型
|
type | string |
类型 |
|
UUID(通用唯一识别码)
|
uuid | string |
UUID(通用唯一识别码) |
|
wopiRestricted
|
wopiRestricted | boolean |
wopiRestricted |
列出工作区
获取请求用户有权查看的共享列表
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
长度
|
length | integer |
要检索的最大结果数 |
|
|
Offset
|
offset | integer |
返回值开始的结果(默认值为 0) |
|
|
所有者
|
ownerUuid | string |
所有者的用户 UUID。 如果提供结果将仅限于此用户拥有的共享 |
|
|
参与者
|
participantUuid | string |
参与者的用户 UUID。 如果提供结果将仅限于此用户是参与者的共享 |
|
|
Query
|
query | string |
搜索查询字符串。 如果提供结果,结果将限制为包含给定查询值的名称的共享 |
|
|
排序
|
sort | string |
排序顺序条件字符串。 可接受的值为
|
|
|
工作组
|
workgroupUuid | string |
工作组 UUID。 如果提供,结果将仅限于属于工作组的共享 |
返回
- response
- array of ShareResponse
列出文档版本
获取资产版本列表
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文档
|
assetUuid | True | string |
文档 UUID |
|
工作空间
|
shareUuid | True | string |
工作区 UUID |
|
长度
|
length | integer |
要检索的最大结果数 |
|
|
Offset
|
offset | integer |
开始的结果(默认值为 0)。 |
返回
- response
- array of DocumentVersion
创建工作区
创建工作区
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
用户 UUID
|
userUuid | True | string |
用户 UUID |
|
Access
|
access | string | ||
|
代理人
|
agentShareToken | string |
代理令牌 |
|
|
Name
|
name | True | string |
Name |
|
组织
|
organisationUuid | string |
组织 UUID |
|
|
所有者
|
ownerUuid | string |
所有者 UUID |
|
|
概要
|
summary | string |
概要 |
|
|
唯一通用识别码 (UUID)
|
uuid | string |
唯一通用识别码 (UUID) |
返回
- Body
- ShareResponse
创建文档
如果请求为 application:hal+json,则仅创建元数据。 如果请求是多部分:form-data,则会在一次调用中创建包含内容的文档。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作区 UUID
|
shareUuid | True | string |
路径中的共享 uuid |
|
文件内容
|
file | True | file |
要上传的文件内容 |
|
文件名
|
name | True | string |
文件名 |
|
父 UUID
|
parentUuid | string |
(可选) |
|
|
概要
|
summary | string |
(可选) |
返回
删除参与者
从工作区中删除参与者
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
用户
|
uuid | True | string |
用户 UUID |
添加或更新参与者
邀请新参与者或编辑分配的角色
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
电子邮件
|
emails | True | array of string |
电子邮件 |
|
Message
|
message | string |
邀请邮件 |
|
|
roles
|
roles | array of string |
roles |
|
|
工作区 UUID
|
shareUuid | True | string |
唯一通用识别码 (UUID) |
|
参与者可见性
|
type | string |
STANDARD - 对其他参与者可见。 密件抄送 - 参与者将被其他人隐藏 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
|
array of object | ||
|
已接受
|
accepted | boolean |
已接受 |
|
电子邮件
|
string |
电子邮件 |
|
|
isOwner
|
isOwner | boolean |
isOwner |
|
模型
|
model | string |
模型 |
|
roles
|
roles | array of string |
roles |
|
shareUuid
|
shareUuid | string |
shareUuid |
|
类型
|
type | string |
类型 |
|
UUID(通用唯一识别码)
|
uuid | string |
UUID(通用唯一识别码) |
获取参与者
获取工作区参与者
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
用户
|
userUuid | string |
用户 UUID |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
|
array of object | ||
|
已接受
|
accepted | boolean |
已接受 |
|
电子邮件
|
string |
电子邮件 |
|
|
isOwner
|
isOwner | boolean |
isOwner |
|
joinedDate
|
joinedDate | string |
joinedDate |
|
模型
|
model | string |
模型 |
|
姓名
|
name | string |
姓名 |
|
roles
|
roles | array of string |
roles |
|
shareUuid
|
shareUuid | string |
shareUuid |
|
类型
|
type | string |
类型 |
|
UUID(通用唯一识别码)
|
uuid | string |
UUID(通用唯一识别码) |
获取工作区
获取文档内容
返回文档的内容
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文档
|
assetUuid | True | string |
唯一通用识别码 (UUID) |
|
工作空间
|
shareUuid | True | string |
唯一通用识别码 (UUID) |
获取文档版本
获取资产版本
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文档
|
assetUuid | True | string |
唯一通用识别码 (UUID) |
|
工作空间
|
shareUuid | True | string |
唯一通用识别码 (UUID) |
|
版本
|
version | True | integer |
文档的版本号 |
返回
- Body
- DocumentVersion
获取文档版本内容
返回文档版本的内容
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文档
|
assetUuid | True | string |
唯一通用识别码 (UUID) |
|
内容版本
|
contentVersion | True | integer |
文档的版本号 |
|
工作空间
|
shareUuid | True | string |
唯一通用识别码 (UUID) |
获取用户
获取用户
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Email
|
emailAddress | string |
要搜索的电子邮件地址 |
|
|
长度
|
length | integer |
要返回的结果数。 仅当使用偏移量时才使用。 |
|
|
Offset
|
offset | integer |
返回此位置后的结果 |
|
|
组织
|
orgUuid | string |
要搜索的组织 UUID |
|
|
排序
|
sort | string |
参数 - 排序的格式应为一个单词,指示排序字段为可选的“:d esc”标记(如果不存在升序)。 错误或空请求默认为升序名称。 可用的排序为 - firstName、lastName、email |
|
|
用户 UUID
|
uuids | array |
用户 uuids 列表 |
返回
- response
- array of UserResponse
定义
Access
- Access
- string
AssetReturnDocumentResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
commentCount
|
commentCount | integer | |
|
内容版本
|
contentVersion | integer | |
|
创建日期
|
createdDate | string | |
|
扩展
|
extension | string | |
|
文件大小
|
fileSize | integer | |
|
locked
|
locked | boolean | |
|
模型
|
model | string | |
|
modifiedByUuid
|
modifiedByUuid | string | |
|
modifiedDate
|
modifiedDate | string | |
|
姓名
|
name | string | |
|
parentUuid
|
parentUuid | string | |
|
previewPageCount
|
previewPageCount | integer | |
|
previewstatus
|
previewstatus | PreviewStatus | |
|
状态
|
status | AssetStatus | |
|
摘要
|
summary | string | |
|
类型
|
type | AssetType | |
|
UUID(通用唯一识别码)
|
uuid | string | |
|
wopiRestricted
|
wopiRestricted | boolean |
AssetStatus
AssetType
DocumentVersion
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
创建日期
|
createdDate | string | |
|
扩展
|
extension | string | |
|
文件大小
|
fileSize | integer | |
|
模型
|
model | string | |
|
状态
|
status | AssetStatus | |
|
UUID(通用唯一识别码)
|
uuid | string | |
|
版本
|
version | integer |
EndOnDateOptionalValue
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
目前
|
present | boolean | |
|
value
|
value | string |
NotificationPreference
- NotificationPreference
- string
PreviewStatus
ShareResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
Access
|
access | Access | |
|
connections
|
connections | integer | |
|
创建日期
|
createdDate | string | |
|
EndOnDateOptionalValue
|
endOnDateOptionalValue | EndOnDateOptionalValue | |
|
模型
|
model | string | |
|
modifiedDate
|
modifiedDate | string | |
|
姓名
|
name | string | |
|
organisationUuid
|
organisationUuid | string | |
|
ownerUuid
|
ownerUuid | string | |
|
安全
|
secure | boolean | |
|
ShareStatus
|
shareStatus | ShareStatus | |
|
状态
|
status | AssetStatus | |
|
SynchStatus
|
synchStatus | SynchStatus | |
|
UUID(通用唯一识别码)
|
uuid | string |
ShareStatus
- ShareStatus
- string
SynchStatus
- SynchStatus
- string
UserResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
禁用的
|
disabled | boolean | |
|
电子邮件
|
string | ||
|
firstName
|
firstName | string | |
|
hideEmailAddress
|
hideEmailAddress | boolean | |
|
lastName
|
lastName | string | |
|
模型
|
model | string | |
|
notificationPreferences
|
notificationPreferences | array of NotificationPreference | |
|
organisationUuid
|
organisationUuid | string | |
|
roles
|
roles | array of string | |
|
UserStatus
|
status | UserStatus | |
|
timezone
|
timezone | string | |
|
UUID(通用唯一识别码)
|
uuid | string |
UserStatus
- UserStatus
- string