ancoreMate Spaces 和 Access (预览版)

控制对 Qlik Cloud® 的访问:读取租户、创建空间、添加成员并更改其空间角色、共享空间内容以及读取用户和组。 Qlik®、Qlik Cloud® 和 Qlik Sense® 是 QlikTech International AB 的商标。ancoreMate 不与 Qlik 关联或认可。

此连接器在以下产品和区域中可用:

Service Class Regions
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域 :
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
Logic Apps 标准 除以下各项外的所有 逻辑应用区域 :
     - Azure 政府区域
     - Azure 中国区域
     - 美国国防部(DoD)
Power Apps 高级 除以下各项外的所有 Power Apps 区域 :
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
Power Automate 高级 除以下各项外的所有 Power Automate 区域 :
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
联系人
Name ancoreSoft
URL https://ancorecloud.com/
Email support@ancoresoft.com
连接器元数据
Publisher ancoreSoft
Website https://ancorecloud.com/
隐私策略 https://ancoresoft.com/legal/ancoremate/privacy/
Categories IT作;生产力

ancoreMate Spaces 和 Access

控制对 Qlik Cloud® 的访问:读取租户、创建空间、添加成员并更改其空间角色、共享空间内容以及读取用户和组。

Qlik®、Qlik Cloud® 和 Qlik Sense® 是 QlikTech International AB 的商标。ancoreMate 不与 Qlik 关联或认可。

Publisher

ancoreSoft

Prerequisites

  • 具有 ancoreMate 订阅的 ancoreCloud 帐户。 有关详细信息和https://docs.ancoresoft.com/文档,请参阅https://ancorecloud.com/。
  • 有权访问要自动执行的内容的 Qlik Cloud 用户。 无需在 Qlik Cloud 中创建 OAuth 客户端、客户端 ID 或 API 密钥。

支持的操作

添加空间成员

将用户或组分配给具有给定角色的空间。

添加空间成员角色

将角色添加到空间中的用户或组,并保留现有角色;根据需要添加成员。

创建或更新空间

创建一个空间,或者在给定空间 ID 时更新现有空间的名称和说明。

创建空间共享

与用户或组共享空间的项。

删除空间

删除空格。 空间必须为空。

删除空间共享

从空间中删除共享。

获取 Qlik 连接

返回 ancoreMate 是否已连接到 Qlik Cloud 租户以及哪个租户和 Qlik 用户。

获取当前用户

返回 Qlik Cloud 用户 ancoreMate 已连接。

获取组

返回一组租户。

获取空间

返回一个包含其设置的空间。

获取空间成员

将用户或组的一个分配返回一个空间。

获取空间共享

返回空间的一个共享。

获取租户

返回租户的名称、主机名和状态。

获取用户

返回租户的用户。

列出用户组

列出租户组。 使用筛选器搜索,例如名称 eq “Finance”。

列出空间成员

列出分配给具有其角色的空间的用户和组。

列出空间共享

列出直接从空间共享的项。

列表空间类型

列出租户中可用的空间类型。

列表空间

列出连接的 Qlik Cloud 用户可以看到的空间。

列出用户

列出租户的用户。 使用筛选器搜索,例如名称 co “anna”。

删除空间成员

从空间中删除用户或组。

删除空间成员角色

从空间中的用户或组中删除角色;没有剩余角色,成员将从空间中删除。

发送 Qlik Cloud 请求

对于没有自己的操作的操作,请在 /api/v1/ 下调用 Qlik Cloud 租户的任何 REST API,并具有已连接用户的权限。

设置空间成员

为用户或组提供空间中的给定角色,并在需要时添加成员。

更新空间成员

替换空间中用户或组的角色。

更新空间共享

更改共享的角色。

获取凭据

  1. 创建连接并选择 “登录”。
  2. 使用 ancoreCloud 帐户登录。
  3. 第一次,输入 Qlik Cloud 租户,例如 company.eu.qlikcloud.com,在 Qlik Cloud 登录并批准 ancoreMate 的访问权限。 稍后的登录将列出 ancoreCloud 帐户的 Qlik Cloud 连接:继续其中一个连接,或者添加另一个租户或 Qlik 用户。 每个连接都适用于在其登录中选择的 Qlik Cloud 连接;其他人和他们一样留下来。
  4. 如果 Qlik 云管理员需要它,则管理员在 Qlik 云管理(Integrations > OAuth)中批准 ancoreMate 一次。

入门

使用 “添加空间成员 ”为新团队成员提供对项目空间的访问权限,或使用筛选器 列出空间 ,以报告存在哪些空间以及管理这些空间的人员。

已知问题和限制

  • 更改空间成员需要有权管理 Qlik Cloud 中的空间。
  • 仅支持 Qlik 云租户;不支持 Qlik Sense 客户端管理的(本地)部署。
  • 应用 Qlik 云速率限制。 当 Qlik Cloud 限制请求时,操作会失败,状态为 429;流的重试策略会自动重试。
  • 每个连接都适用于一个 Qlik Cloud 租户和 Qlik 用户,该用户在其登录中选择。 若要与多个租户或 Qlik 用户合作,例如开发和生产,请为每个租户或用户创建一个连接;一个流可以使用其中几个流。

部署说明

使用说明部署包含文件和apiDefinition.swagger.jsonapiProperties.json此文件夹的自定义连接器。

操作

列出用户

列出租户的用户。 使用筛选器搜索,例如名称 co “anna”。

列出用户组

列出租户组。 使用筛选器搜索,例如名称 eq “Finance”。

列出空间共享

列出直接从空间共享的项。

列出空间成员

列出分配给具有其角色的空间的用户和组。

列表空间

列出连接的 Qlik Cloud 用户可以看到的空间。

列表空间类型

列出租户中可用的空间类型。

创建或更新空间

创建一个空间,或者在给定空间 ID 时更新现有空间的名称和说明。

创建空间共享

与用户或组共享空间的项。

删除空间

删除空格。 空间必须为空。

删除空间共享

从空间中删除共享。

删除空间成员

从空间中删除用户或组。

删除空间成员角色

从空间中的用户或组中删除角色;没有剩余角色,成员将从空间中删除。

发送 Qlik Cloud 请求

对于没有自己的操作的操作,请在 /api/v1/ 下调用 Qlik Cloud 租户的任何 REST API,并具有已连接用户的权限。

更新空间共享

更改共享的角色。

更新空间成员

替换空间中用户或组的角色。

添加空间成员

将用户或组分配给具有给定角色的空间。

添加空间成员角色

将角色添加到空间中的用户或组,并保留现有角色;根据需要添加成员。

获取 Qlik 连接

返回 ancoreMate 是否已连接到 Qlik Cloud 租户以及哪个租户和 Qlik 用户。

获取当前用户

返回 Qlik Cloud 用户 ancoreMate 已连接。

获取用户

返回租户的用户。

获取租户

返回租户的名称、主机名和状态。

获取空间

返回一个包含其设置的空间。

获取空间共享

返回空间的一个共享。

获取空间成员

将用户或组的一个分配返回一个空间。

获取组

返回一组租户。

设置空间成员

为用户或组提供空间中的给定角色,并在需要时添加成员。

列出用户

列出租户的用户。 使用筛选器搜索,例如名称 co “anna”。

参数

名称 密钥 必需 类型 说明
Fields
fields string

每个实体请求的字段的逗号分隔字符串。

Filter
filter string

用于查询的高级筛选。

Sort
sort string

要排序依据的字段,带有 +/- 前缀,指示排序顺序。

Limit
limit integer

要返回的最大项数,介于 1 到 5000 之间。

返回

用户项的列表。

Body
UserList

列出用户组

列出租户组。 使用筛选器搜索,例如名称 eq “Finance”。

参数

名称 密钥 必需 类型 说明
Filter
filter string

用于查询的高级筛选。

Sort
sort string

要排序的可选资源字段名称,例如

系统组
systemGroups boolean

返回系统组(例如

Limit
limit integer

要返回的最大项数,介于 1 到 5000 之间。

返回

组项的列表。

Body
GroupList

列出空间共享

列出直接从空间共享的项。

参数

名称 密钥 必需 类型 说明
空间 ID
spaceId True string

包含共享的空间的 ID。

群组标识符
groupId string

共享资源的组的 ID。

Name
name string

共享资源的名称。

资源标识符 (ID)
resourceId string

共享资源的 ID。

资源类型
resourceType string

共享资源的类型。

类型
type string

共享的类型。

用户 ID
userId string

共享资源的用户的 ID。

Limit
limit integer

要返回的最大项数,介于 1 到 5000 之间。

返回

空间共享项的列表。

列出空间成员

列出分配给具有其角色的空间的用户和组。

参数

名称 密钥 必需 类型 说明
空间 ID
spaceId True string

工作分配空间的 ID。

被分配者 ID
assigneeId string

筛选特定 assigneeid 的分配。

类型
type string

工作分配的类型。

Limit
limit integer

要返回的最大项数,介于 1 到 5000 之间。

返回

空间成员项的列表。

列表空间

列出连接的 Qlik Cloud 用户可以看到的空间。

参数

名称 密钥 必需 类型 说明
Action
action string

空间上的操作。

Name
name string

要搜索和筛选的空间名称。

所有者 ID
ownerId string

要筛选依据的空间 ownerId。

Sort
sort string

要作为排序依据的字段。

类型
type string

要筛选的空间的类型(s)。

Limit
limit integer

要返回的最大项数,介于 1 到 5000 之间。

返回

空间项的列表。

Body
SpaceList

列表空间类型

列出租户中可用的空间类型。

参数

名称 密钥 必需 类型 说明
Limit
limit integer

要返回的最大项数,介于 1 到 5000 之间。

返回

空间项的列表。

创建或更新空间

创建一个空间,或者在给定空间 ID 时更新现有空间的名称和说明。

参数

名称 密钥 必需 类型 说明
Name
name True string

空间的名称。

类型
type True string

共享、托管等空间的类型。

描述
description string

空间的说明。

空间 ID
spaceId string

要更新的空间。 留空以创建新空间。

返回

空间是一种安全上下文,它允许用户控制容器而不是资源本身,从而简化访问控制的管理。

Body
Space

创建空间共享

与用户或组共享空间的项。

参数

名称 密钥 必需 类型 说明
空间 ID
spaceId True string

共享空间的 ID。

类型
type True string

类型。

Roles
roles True array of string

分配给 assigneeId 的角色。

被分配者 ID
assigneeId True string

基于类型的 userId 或 groupId。

资源标识符 (ID)
resourceId True string

共享项的资源 ID。

资源类型
resourceType True string

共享项的资源类型。

返回

空间共享。

Body
SpaceShare

删除空间

删除空格。 空间必须为空。

参数

名称 密钥 必需 类型 说明
空间 ID
spaceId True string

要删除的空间的 ID。

删除空间共享

从空间中删除共享。

参数

名称 密钥 必需 类型 说明
共享 ID
shareId True string

要删除的共享的 ID。

空间 ID
spaceId True string

共享所属空间的 ID。

删除空间成员

从空间中删除用户或组。

参数

名称 密钥 必需 类型 说明
分配 ID
assignmentId True string

要删除的分配的 ID。

空间 ID
spaceId True string

工作分配空间的 ID。

删除空间成员角色

从空间中的用户或组中删除角色;没有剩余角色,成员将从空间中删除。

参数

名称 密钥 必需 类型 说明
空间
spaceId True string

空间。

类型
type string

成员是用户(默认值)还是组。

用户或组 ID
assigneeId True string

用户或组的 ID。

Roles
roles True array of string

要删除的角色,例如生成者。

返回

空格成员。

发送 Qlik Cloud 请求

对于没有自己的操作的操作,请在 /api/v1/ 下调用 Qlik Cloud 租户的任何 REST API,并具有已连接用户的权限。

参数

名称 密钥 必需 类型 说明
Method
method True string

HTTP 方法。

路径
path True string

/api/v1/下面的路径,例如空格或应用/1234/reloads/logs。

Query
query string

如 URL 中的查询参数,例如 limit=10&name=Sales。

Body
body object

POST、PUT、PATCH 和 DELETE 的 JSON 正文,例如要删除的项的 ID。

返回

Qlik Cloud 的 JSON 响应保持不变。

响应
object

更新空间共享

更改共享的角色。

参数

名称 密钥 必需 类型 说明
共享 ID
shareId True string

要更新的共享的 ID。

空间 ID
spaceId True string

共享所属空间的 ID。

Roles
roles True array of string

共享授予的角色,例如使用者。

返回

空间共享。

Body
SpaceShare

更新空间成员

替换空间中用户或组的角色。

参数

名称 密钥 必需 类型 说明
分配 ID
assignmentId True string

要更新的分配的 ID。

空间 ID
spaceId True string

工作分配空间的 ID。

Roles
roles array of string

分配给 assigneeId 的角色。

返回

空格成员。

添加空间成员

将用户或组分配给具有给定角色的空间。

参数

名称 密钥 必需 类型 说明
空间 ID
spaceId True string

工作分配空间的 ID。

类型
type True string

分配类型,例如用户或组。

Roles
roles True array of string

分配给 assigneeId 的角色。

被分配者 ID
assigneeId True string

基于类型的 userId 或 groupId。

返回

空格成员。

添加空间成员角色

将角色添加到空间中的用户或组,并保留现有角色;根据需要添加成员。

参数

名称 密钥 必需 类型 说明
空间
spaceId True string

空间。

类型
type string

成员是用户(默认值)还是组。

用户或组 ID
assigneeId True string

用户或组的 ID。

Roles
roles True array of string

要添加的角色,例如使用者或生成者。

返回

空格成员。

获取 Qlik 连接

返回 ancoreMate 是否已连接到 Qlik Cloud 租户以及哪个租户和 Qlik 用户。

返回

ancoreMate 与 Qlik Cloud 之间的连接。

Body
Connection

获取当前用户

返回 Qlik Cloud 用户 ancoreMate 已连接。

返回

用户对象。

Body
User

获取用户

返回租户的用户。

参数

名称 密钥 必需 类型 说明
用户 ID
userId True string

用户的唯一标识符。

Fields
fields string

每个实体请求的字段的逗号分隔字符串。

返回

用户对象。

Body
User

获取租户

返回租户的名称、主机名和状态。

返回

租户。

Body
Tenant

获取空间

返回一个包含其设置的空间。

参数

名称 密钥 必需 类型 说明
空间 ID
spaceId True string

要检索的空间的 ID。

返回

空间是一种安全上下文,它允许用户控制容器而不是资源本身,从而简化访问控制的管理。

Body
Space

获取空间共享

返回空间的一个共享。

参数

名称 密钥 必需 类型 说明
共享 ID
shareId True string

要检索的共享的 ID。

空间 ID
spaceId True string

共享所属空间的 ID。

返回

空间共享。

Body
SpaceShare

获取空间成员

将用户或组的一个分配返回一个空间。

参数

名称 密钥 必需 类型 说明
分配 ID
assignmentId True string

要检索的分配的 ID。

空间 ID
spaceId True string

工作分配空间的 ID。

返回

空格成员。

获取组

返回一组租户。

参数

名称 密钥 必需 类型 说明
群组标识符
groupId True string

组的唯一标识符。

返回

表示组文档。

Body
Group

设置空间成员

为用户或组提供空间中的给定角色,并在需要时添加成员。

参数

名称 密钥 必需 类型 说明
空间
spaceId True string

空间。

类型
type string

成员是用户(默认值)还是组。

用户或组 ID
assigneeId True string

用户或组的 ID。

Roles
roles array of string

角色,例如使用者、参与者、制作者或调解人。 如果没有角色,成员将被删除。

返回

空格成员。

定义

连接

ancoreMate 与 Qlik Cloud 之间的连接。

名称 路径 类型 说明
Connected
connected boolean

ancoreMate 是否连接到 Qlik Cloud。

Qlik Cloud 租户
tenantHost string

连接的 Qlik Cloud 租户的主机名。

Qlik 用户
qlikUserName string

连接的 Qlik Cloud 用户的名称。

连接位置
connectedAt date-time

建立连接的时间。

组

表示组文档。

名称 路径 类型 说明
ID
id string

组的唯一标识符。

Name
name string

组的名称。

赫雷夫
links.self.href uri

链接到当前组文档。

Status
status string

组的状态。

租户 ID
tenantId string

与给定组关联的租户标识符。

创建时间
createdAt date-time

创建组记录时的时间戳。

创建者
createdBy string

创建角色的用户的 ID。

更新者
updatedBy string

上次更新此角色的用户的 ID。

描述
description string

自定义组的说明。

提供程序类型
providerType string

组的提供程序类型。

分配的角色
assignedRoles array of object

角色引用数组。

ID
assignedRoles.id string

唯一的角色标识器。

Name
assignedRoles.name string

角色名称。

类型
assignedRoles.type string

角色的类型。

Level
assignedRoles.level string

角色级别。

上次更新时间
lastUpdatedAt date-time

上次更新组记录时的时间戳。

GroupList

组项的列表。

名称 路径 类型 说明
物品
value array of Group

这些项。

空间

空间是一种安全上下文,它允许用户控制容器而不是资源本身,从而简化访问控制的管理。

名称 路径 类型 说明
ID
id string

空间的唯一标识符,例如 62716f4b39b865ece543cd45。

Roles
meta.roles array of string

在此空间中分配给当前用户的角色列表。

动作
meta.actions array of string

当前用户在此空间中允许的操作列表。

可分配角色
meta.assignableRoles array of string

可以在此空间中分配的角色列表。

Name
name string

空间的名称。

类型
type string

共享、托管等空间的类型。

赫雷夫
links.self.href string

定义资源的 URL。

赫雷夫
links.assignments.href string

定义资源的 URL。

所有者 ID
ownerId string

空间所有者的 ID。

租户 ID
tenantId string

租户的 ID,例如 xqGQ0k66vSR8f9G7J-vYtHZQkiYrCpct。

创建时间
createdAt date-time

创建空间的日期和时间。

创建者
createdBy string

创建空间的用户的 ID。

更新时间
updatedAt date-time

更新空间的日期和时间。

描述
description string

空间的说明。

SpaceList

空间项的列表。

名称 路径 类型 说明
物品
value array of Space

这些项。

SpaceMember

空格成员。

名称 路径 类型 说明
ID
id string

ID。

类型
type string

分配类型,例如用户或组。

赫雷夫
links.self.href string

定义资源的 URL。

赫雷夫
links.space.href string

定义资源的 URL。

Roles
roles array of string

分配给用户或组的角色。

空间 ID
spaceId string

空间的唯一标识符。

租户 ID
tenantId string

租户的唯一标识符。

创建时间
createdAt date-time

创建空间的日期和时间。

创建者
createdBy string

创建分配的用户的 ID。

更新时间
updatedAt date-time

更新空间的日期和时间。

更新者
updatedBy string

更新分配的用户的 ID。

被分配者 ID
assigneeId string

基于类型的 userId 或 groupId。

SpaceMemberList

空间成员项的列表。

名称 路径 类型 说明
物品
value array of SpaceMember

这些项。

SpaceShare

空间共享。

名称 路径 类型 说明
ID
id string

ID。

类型
type string

类型。

赫雷夫
links.self.href string

定义资源的 URL。

赫雷夫
links.space.href string

定义资源的 URL。

Roles
roles array of string

分配给 assigneeId 的角色。

空间 ID
spaceId string

空间 ID。

Disabled
disabled boolean

如果共享已禁用(仅对链接共享有效)。

租户 ID
tenantId string

租户 ID。

创建时间
createdAt date-time

创建位置。

创建者
createdBy string

创建共享的用户的 ID。

更新时间
updatedAt date-time

更新时间。

更新者
updatedBy string

更新共享的用户的 ID。

被分配者 ID
assigneeId string

基于类型的 userId 或 groupId。

资源标识符 (ID)
resourceId string

共享资源的 ID。

资源名称
resourceName string

共享资源的名称。

资源类型
resourceType string

共享资源的类型。

SpaceShareList

空间共享项的列表。

名称 路径 类型 说明
物品
value array of SpaceShare

这些项。

SpaceTypeItem

类型的名称。

类型的名称。

SpaceTypeItemList

空间项的列表。

名称 路径 类型 说明
物品
value array of SpaceTypeItem

这些项。

Tenant

租户。

名称 路径 类型 说明
ID
id string

唯一租户标识符。

Name
name string

租户的显示名称。

赫雷夫
links.self.href string

定义资源的 URL。

Region
region string

租户所在的区域。

Status
status string

租户的状态。

已创建
created date

创建租户记录的时间戳(1970-01-01T00:00:00.001Z for static tenants)。

主机名
hostnames array of string

映射到租户的不区分大小写的主机名的列表。

数据中心
datacenter string

租户所在的数据中心。

最近更新
lastUpdated date

上次更新租户记录的时间戳(1970-01-01T00:00:00.001Z for static tenants)。

由用户创建
createdByUser string

创建租户的用户 ID。

上次更新状态
statusLastUpdatedAt date-time

上次更改租户状态时的时间戳。

启用分析创建
enableAnalyticCreation boolean

启用分析创建。

启用应用打开反馈
enableAppOpeningFeedback boolean

启用应用打开反馈。

向专业人员自动分配“创建共享空间”角色
autoAssignCreateSharedSpacesRoleToProfessionals boolean

自动为专业人员分配共享空间角色。

向专业人员自动分配数据服务参与者角色
autoAssignDataServicesContributorRoleToProfessionals boolean

自动向专业人员分配数据服务参与者角色。

自动向专业人员分配专用分析内容创建者角色
autoAssignPrivateAnalyticsContentCreatorRoleToProfessionals boolean

自动将专用分析内容创建者角色分配给专业人员。

User

用户对象。

名称 路径 类型 说明
ID
id string

唯一的用户标识符。

Name
name string

用户的名称。

Email
email string

用户的电子邮件地址。

赫雷夫
links.self.href uri

定义资源的 URL。

Locale
locale string

表示最终用户的语言标记。

Status
status string

租户中用户的状态。

图片
picture string

链接到用户的头像的静态 URL。

主题
subject string

标识提供者中的唯一用户标识器。

租户 ID
tenantId string

用户所属的租户。

Zoneinfo
zoneinfo string

表示最终用户的时区。

创建时间
createdAt date-time

创建用户记录时的时间戳。

邀请到期时间
inviteExpiry number

指示邀请何时过期的 Unix 时间戳。

分配的角色
assignedRoles array of object

角色引用数组。

ID
assignedRoles.id string

唯一的角色标识器。

Name
assignedRoles.name string

角色名称。

类型
assignedRoles.type string

角色的类型。

Level
assignedRoles.level string

角色级别。

上次更新时间
lastUpdatedAt date-time

上次更新用户记录时的时间戳。

分配的组
assignedGroups array of object

组引用的数组。

ID
assignedGroups.id string

唯一的组标识器。

Name
assignedGroups.name string

组名称。

提供程序类型
assignedGroups.providerType string

组的提供程序类型。

分配的角色
assignedGroups.assignedRoles array of object

角色引用数组。

items
assignedGroups.assignedRoles object

表示存储在数据库中的角色实体。

分配的范围
assignedScopes array of string

分配给用户的作用域数组。

首选区域设置
preferredLocale string

表示最终用户的首选语言标记。

首选 Zoneinfo
preferredZoneinfo string

表示最终用户的首选时区。

UserList

用户项的列表。

名称 路径 类型 说明
物品
value array of User

这些项。

对象

这是类型“object”。