配置卡上下文变量

您可以配置卡上下文变量以定制和控制卡上的特定元素。

准备工作

了解上下文变量的工作原理。 更多信息，请参阅上下文变量。

关于本任务

卡片上下文变量与页面上下文变量和静态值的交互方式如下：
  • 如果将带有上下文变量的卡片添加到没有任何页面上下文变量的页面上，则该卡片会加载卡片上下文变量的默认值。
  • 如果添加了与卡片上下文同名的页面上下文变量，则卡片会自动使用页面上下文的值。
  • 在侧板上，您可以将卡片配置为使用静态值，该值会覆盖任何页面上下文变量。 您还可以配置卡片使用不同的页面上下文变量，而不管其名称如何。
  • 如果删除了已配置的页面上下文变量，卡片上将显示错误信息。 您需要重新配置卡片，以使用任何其他现有的页面上下文变量。

程序

  1. 如果要在创建卡片后添加上下文，请打开卡片库并单击要添加上下文的卡片名称。
  2. 在 " 上下文 " 部分中，单击 配置。
  3. 单击 添加变量。
  4. 在 标签 字段中，输入变量的唯一名称。
  5. 在 类型 列表中，选择相应的数据类型。
  6. 在 值 字段中，输入基于类型选择的值。
    例如，如果选择字符串数组，那么值必须是[a1b2',c1d2']格式。
    注: 提供的值是一个示例，以便您可以使用上下文来配置和测试卡。 您可以在页面级别配置该值。
  7. 单击添加。
  8. 单击 完成。

配置重复使用的通用卡示例

您可以创建通用卡片，并在多个页面中重复使用。 要显示内容，可以配置静态值或页面上下文变量，以便在不同页面上有效使用相同的卡片。

  1. 创建一张通用卡片。

    使用 "卡片生成器，创建一个表卡，显示特定国家的位置记录，并将国家值作为上下文传递给它。

    1. 在主业务对象字段中，选择 "Location。
    2. 设置以下查询：

      country Equals Variable $country

      下面的图片显示了用于检索国家位置信息的表卡的查询配置。编辑查询对话框显示表卡所需的查询配置。

    3. 配置名为country 的上下文变量，将类型设为 "String，并在值字段中输入 "USA。

    4. 在列中，添加 "id、"locationName、"city"和 "coordinates"。 卡片会根据查询显示 id、locationName,城市和坐标。

  2. 添加同一通用卡的多个实例。

    使用页面生成器创建一个页面，用于显示不同国家的位置信息。 为您创建的新卡添加多个实例。 默认情况下，所有卡片看起来都是一样的，因为它们使用的是默认上下文值--USA。

    第一张卡保持原样，因为它已经显示了您需要跟踪的美国信息。

  3. 配置通用卡以使用静态上下文。
    1. 在第二张卡上，单击溢出菜单图标，然后单击视图属性 > 配置。
    2. 将源代码更改为 "Static value。
    3. 在值字段中输入 "Canada。

  4. 创建页面上下文变量。

    配置名为countryName 的页面上下文变量，将类型设为 "String，并在值字段中输入 "UK。

  5. 配置通用卡以使用页面上下文。

    1. 在第三张卡上，单击溢出菜单图标，然后单击视图属性 > 配置。
    2. 将源代码更改为 "Page context。
    3. 在页面上下文变量字段中，选择 "countryName。

    下图显示的是根据上下文变量重复两次以显示不同数据的单个通用卡片。一个页面上的三张卡片显示三个不同的国家地点

下一步

在卡片查询中的标签、页脚或页眉字段中使用上下文变量。 更多信息，请参阅向卡片添加查询。