将用户附加到端点
Attach users to endpoints
我已使用 KaaClient.attachUser() 方法(使用可信验证器)将用户附加到端点,并且我收到了从服务器返回的成功状态消息。但是,我在管理 UI 中的什么地方可以看到这个用户?此外,如果我尝试使用用户 ID 并尝试将配置更新推送到端点,我会在 Admin UI 上收到项目未找到错误。
目前没有允许列出所有附加用户的功能。只有在该用户已至少连接到客户端应用程序一次后,才能通过 Admin UI 更新用户(使用用户 ID)的配置架构的配置值:
KaaClient.attachUser(userId, ...)
要为不同的附加用户使用具有不同值的自定义用户配置架构,请尝试按照以下说明操作:
为所需的演示应用程序添加配置架构(在本指南中我们将使用事件演示):
- 以租户开发人员身份登录管理 UI
- 转到应用程序 -> 事件演示 -> 架构 -> 配置。点击
添加架构按钮
- 在 "Add configuration schema" 页面上单击创建新类型按钮
- 填写所有必填字段:名称(例如 EventUserSchema)、命名空间
(例如 org.kaa.kaaproject.demo.schema)、显示名称(事件用户
模式)等
- 将所有需要的字段添加到架构中(例如字段 "userKey" 和
"userValue" 类型为 "String" 字段 "count" 类型为 "Integer"
和默认值“42”):在每个字段的同一页面上单击添加
"Fields" 区域中的按钮,填写所有必需的数据包括字段
名称和字段类型,然后单击添加按钮。
- 在页面顶部添加所有字段后,单击“添加”按钮。
如果你做的一切都是正确的,版本为“2”的新配置模式
名称 "Event User Schema" 将列在页面上。如果你
导出它并用一个文件打开 reader 你会看到类似的东西
这个:
{
"type": "record",
"name": "EventUserSchema",
"namespace": "org.kaa.kaaproject.demo.schema",
"fields": [
{
"name": "userKey",
"type": [
{
"type": "string",
"avro.java.string": "String"
},
"null"
],
"displayName": "",
"displayPrompt": ""
},
{
"name": "userValue",
"type": [
{
"type": "string",
"avro.java.string": "String"
},
"null"
]
},
{
"name": "count",
"type": "int",
"by_default": 42
}
],
"version": 1,
"dependencies": [],
"displayName": "Event User Schema",
"description": ""
}
使用新创建的配置架构添加 SDK 配置文件:
- 转到应用程序 -> 事件演示 -> SDK 配置文件。点击添加SDK
配置文件按钮。
- 输入名称(例如 EventUserSDK),select 配置架构版本
(对于这种情况,版本应设置为 2),添加所需的事件
class 家庭(对于活动演示,我们需要 Chan Event Class 家庭),
select 值得信赖的验证者。
- 在同一页面上单击“添加 SDK 配置文件”按钮。
- 如果一切正常,名称为 "EventUserSDK" 的 SDK 配置文件和
配置 "v2" 将在 SDK 配置文件页面上列出。
- 在同一页面上,为新创建的 SDK 单击生成 SDK 按钮,
select 需要语言并点击生成 SDK 按钮下载新的
SDK.
用新下载的 SDK 替换客户端应用程序中的 SDK 库,重新构建您的应用程序。之后,您将能够在应用程序中使用与定义的配置模式相关的配置值:
kaaClient.getConfiguration().getCount();
kaaClient.getConfiguration().getUserKey();
kaaClient.getConfiguration().getUserValue();
这些值可以在 KaaClient.attachUser(...) 代码后使用。
在 运行 应用之后。如果用户成功附加并且您收到类似 Attach response: SUCCESS 的信息,配置值将设置为默认值(默认值在配置模式中描述)并且您将能够在适当的管理页面上为每个用户 ID 更改它们:
- 转到应用程序 > 事件演示 -> 用户 > 更新配置。
- 输入已经附加到 KaaClient 的用户 ID。
- Select 配置架构版本并填写所有值
配置正文区。
- 单击“更新配置”按钮。
将更改所有使用输入的用户 ID 的端点的配置值。
也可以通过 REST 设置配置方案和值。请参阅服务器 REST APIs documentation 页。
我已使用 KaaClient.attachUser() 方法(使用可信验证器)将用户附加到端点,并且我收到了从服务器返回的成功状态消息。但是,我在管理 UI 中的什么地方可以看到这个用户?此外,如果我尝试使用用户 ID 并尝试将配置更新推送到端点,我会在 Admin UI 上收到项目未找到错误。
目前没有允许列出所有附加用户的功能。只有在该用户已至少连接到客户端应用程序一次后,才能通过 Admin UI 更新用户(使用用户 ID)的配置架构的配置值:
KaaClient.attachUser(userId, ...)
要为不同的附加用户使用具有不同值的自定义用户配置架构,请尝试按照以下说明操作:
为所需的演示应用程序添加配置架构(在本指南中我们将使用事件演示):
- 以租户开发人员身份登录管理 UI
- 转到应用程序 -> 事件演示 -> 架构 -> 配置。点击 添加架构按钮
- 在 "Add configuration schema" 页面上单击创建新类型按钮
- 填写所有必填字段:名称(例如 EventUserSchema)、命名空间 (例如 org.kaa.kaaproject.demo.schema)、显示名称(事件用户 模式)等
- 将所有需要的字段添加到架构中(例如字段 "userKey" 和 "userValue" 类型为 "String" 字段 "count" 类型为 "Integer" 和默认值“42”):在每个字段的同一页面上单击添加 "Fields" 区域中的按钮,填写所有必需的数据包括字段 名称和字段类型,然后单击添加按钮。
- 在页面顶部添加所有字段后,单击“添加”按钮。 如果你做的一切都是正确的,版本为“2”的新配置模式 名称 "Event User Schema" 将列在页面上。如果你 导出它并用一个文件打开 reader 你会看到类似的东西 这个:
{ "type": "record", "name": "EventUserSchema", "namespace": "org.kaa.kaaproject.demo.schema", "fields": [ { "name": "userKey", "type": [ { "type": "string", "avro.java.string": "String" }, "null" ], "displayName": "", "displayPrompt": "" }, { "name": "userValue", "type": [ { "type": "string", "avro.java.string": "String" }, "null" ] }, { "name": "count", "type": "int", "by_default": 42 } ], "version": 1, "dependencies": [], "displayName": "Event User Schema", "description": "" }
使用新创建的配置架构添加 SDK 配置文件:
- 转到应用程序 -> 事件演示 -> SDK 配置文件。点击添加SDK 配置文件按钮。
- 输入名称(例如 EventUserSDK),select 配置架构版本 (对于这种情况,版本应设置为 2),添加所需的事件 class 家庭(对于活动演示,我们需要 Chan Event Class 家庭), select 值得信赖的验证者。
- 在同一页面上单击“添加 SDK 配置文件”按钮。
- 如果一切正常,名称为 "EventUserSDK" 的 SDK 配置文件和 配置 "v2" 将在 SDK 配置文件页面上列出。
- 在同一页面上,为新创建的 SDK 单击生成 SDK 按钮, select 需要语言并点击生成 SDK 按钮下载新的 SDK.
用新下载的 SDK 替换客户端应用程序中的 SDK 库,重新构建您的应用程序。之后,您将能够在应用程序中使用与定义的配置模式相关的配置值:
kaaClient.getConfiguration().getCount();
kaaClient.getConfiguration().getUserKey();
kaaClient.getConfiguration().getUserValue();
这些值可以在 KaaClient.attachUser(...) 代码后使用。
在 运行 应用之后。如果用户成功附加并且您收到类似 Attach response: SUCCESS 的信息,配置值将设置为默认值(默认值在配置模式中描述)并且您将能够在适当的管理页面上为每个用户 ID 更改它们:
- 转到应用程序 > 事件演示 -> 用户 > 更新配置。
- 输入已经附加到 KaaClient 的用户 ID。
- Select 配置架构版本并填写所有值 配置正文区。
- 单击“更新配置”按钮。 将更改所有使用输入的用户 ID 的端点的配置值。
也可以通过 REST 设置配置方案和值。请参阅服务器 REST APIs documentation 页。