自适应卡片模板化 SDK
有了自适应卡片模板化 SDK,就可以轻松地使用任何受支持的平台上的实际数据来填充卡片模板。
有关此方面的内容,请参阅自适应卡片模板化概述
重要
2020 年 5 月候选发布版本中的中断性变更
我们正在努力工作,力求尽早发布模板,我们已经在做最后的冲刺了! 发布之前,我们需要进行一些小的中断性变更。
- 绑定语法已从
{...}
更改为${...}
。- 例如:
"text": "Hello {name}"
变为"text": "Hello ${name}"
- 例如:
- JavaScript API 不再包含
EvaluationContext
对象。 只需将数据传递到expand
函数。 有关完整的详细信息,请参阅 SDK 页。 - .NET API 经过了重新设计,以便更紧密地匹配 JavaScript API。 有关完整详细信息,请查看以下内容。
可以通过 npm 和 CDN 获取 adaptivecards-templating 库。 如需完整文档,请查看包链接。
npm install adaptivecards-templating
<script src="https://unpkg.com/adaptivecards-templating/dist/adaptivecards-templating.min.js"></script>
以下示例假定你还安装了 adaptivecards 库来呈现卡。
如果不打算呈现卡,可以删除 parse
和 render
代码。
import * as ACData from "adaptivecards-templating";
import * as AdaptiveCards from "adaptivecards";
// Define a template payload
var templatePayload = {
"type": "AdaptiveCard",
"version": "1.0",
"body": [
{
"type": "TextBlock",
"text": "Hello ${name}!"
}
]
};
// Create a Template instance from the template payload
var template = new ACData.Template(templatePayload);
// Expand the template with your `$root` data object.
// This binds it to the data and produces the final Adaptive Card payload
var cardPayload = template.expand({
$root: {
name: "Matt Hidinger"
}
});
// OPTIONAL: Render the card (requires that the adaptivecards library be loaded)
var adaptiveCard = new AdaptiveCards.AdaptiveCard();
adaptiveCard.parse(cardPayload);
document.getElementById('exampleDiv').appendChild(adaptiveCard.render());
dotnet add package AdaptiveCards.Templating
// Import the library
using AdaptiveCards.Templating;
var templateJson = @"
{
""type"": ""AdaptiveCard"",
""version"": ""1.2"",
""body"": [
{
""type"": ""TextBlock"",
""text"": ""Hello ${name}!""
}
]
}";
// Create a Template instance from the template payload
AdaptiveCardTemplate template = new AdaptiveCardTemplate(templateJson);
// You can use any serializable object as your data
var myData = new
{
Name = "Matt Hidinger"
};
// "Expand" the template - this generates the final Adaptive Card payload
string cardJson = template.Expand(myData);
除了预生成函数外,还可以将自定义函数添加到自适应表达式库中。
下面的示例中添加了 stringFormat 自定义函数,并使用该函数设置字符串的格式。
string jsonTemplate = @"{
""type"": ""AdaptiveCard"",
""version"": ""1.0"",
""body"": [{
""type"": ""TextBlock"",
""text"": ""${stringFormat(strings.myName, person.firstName, person.lastName)}""
}]
}";
string jsonData = @"{
""strings"": {
""myName"": ""My name is {0} {1}""
},
""person"": {
""firstName"": ""Andrew"",
""lastName"": ""Leader""
}
}";
AdaptiveCardTemplate template = new AdaptiveCardTemplate(jsonTemplate);
var context = new EvaluationContext
{
Root = jsonData
};
// a custom function is added
AdaptiveExpressions.Expression.Functions.Add("stringFormat", (args) =>
{
string formattedString = "";
// argument is packed in sequential order as defined in the template
// For example, suppose we have "${stringFormat(strings.myName, person.firstName, person.lastName)}"
// args will have following entries
// args[0]: strings.myName
// args[1]: person.firstName
// args[2]: strings.lastName
if (args[0] != null && args[1] != null && args[2] != null)
{
string formatString = args[0];
string[] stringArguments = {args[1], args[2] };
formattedString = string.Format(formatString, stringArguments);
}
return formattedString;
});
string cardJson = template.Expand(context);
问: 我为什么会遇到 AdaptiveTemplateException expand()
?
A. 如果错误消息看上去类似于 '<offending item>' at line, '<line number>' is malformed for '$data : ' pair"。
请确保为 "$data" 提供的值是有效的 json,如数字、布尔值、对象和数组,或确保正确使用了自适应模板语言的语法,条目在数据上下文中的行号处。
问: 我为什么会遇到 ArgumentNullException expand()
?
A. 如果错误消息看起来类似于 "Check if parent data context is set, or please enter a non-null value for '<offending item>' at line, '<line number>'"。
它指示不存在所请求的数据绑定的数据上下文。 请确保设置了根数据上下文,如果存在,请确保有数据上下文可用于行号所指示的当前绑定。
问: RFC 3389 格式的日期/时间(例如“2017-02-14T06:08:00Z”)在与模板一起使用时为何不可用于 TIME/DATE 函数?
A. .NET SDK NuGet 版本 1.0.0-rc.0 具有此行为。 它已在后续版本中得到更正。 json.Net 反序列化程序的默认行为会更改日期/时间格式字符串,后续版本中已禁用该行为。 请使用 formatDateTime() 函数将日期/时间字符串的格式设置为 RFC 3389(如本例中所示),或者你可绕过 TIME/DATE 函数,只使用 formatDateTime()。 要详细了解 formatDateTime(),请转到此处。