用例：创建引用窗体 use-case-creating-a-refer-a-friend-form

创建竞争Web表单，其中包含各种问题和用于输入朋友联系信息的字段，如下所示：

您的消息 ​字段允许您为被推荐人输入消息。 反向链接还必须输入其​ 姓氏、名字 ​和​ 电子邮件。

在字段中输入的信息存储在称为访客表的特定表中。

与被推荐人相关的字段内容将在用户档案创建脚本和发送给他们的消息中使用。

首先，创建脚本以将反向链接链接到被推荐人。

它包含以下说明：

ctx.recipient.visitor.@id = xtk.session.GetNewIds(1)
ctx.recipient.visitor.@forwardUrl = "APP5"
ctx.recipient.visitor.@referrerEmail = ctx.recipient.@email
ctx.recipient.visitor.@referrerFirstName = ctx.recipient.@firstName
ctx.recipient.visitor.@referrerLastName = ctx.recipient.@lastName

在页面标识块中输入的姓氏、名字和电子邮件地址被标识为反向链接姓氏、名字和电子邮件地址。 这些字段将重新插入到发送给裁判的消息正文中。

APP5值与Web窗体的内部名称匹配：利用此信息，可了解被推荐人的来源，即将访客链接到基于其创建的Web窗体。

利用存储框，您可以收集信息并将其存储在数据库中。

然后，创建链接到在步骤1中创建的信息服务的投放模板。 它将在信息服务的​ Choose scenario ​字段中选择。

用于创建反向链接选件消息的投放模板包含以下信息：

此模板具有以下特性：

• 选择访客表作为目标映射。

  

• 被推荐人的联系信息以及有关反向链接的信息均取自访客表。 可使用个性化按钮插入内容。

  

• 此模板包含竞争表格和订阅链接的链接，供被推荐人订阅新闻稿。

  通过个性化块插入订阅链接。 默认情况下，它允许您订阅用户档案到​ 新闻稿 ​服务。 可以根据您的需要更改此个性化块，例如，为收件人订阅其他服务。

• 内部名称（此处为“referrer”）将在消息投放脚本中使用，如下所示。

创建用于投放订阅消息的第二个脚本。

// Updtate visitor to have a link to the referrer recipient
ctx.recipient.visitor.@referrerId = ctx.recipient.@id
ctx.recipient.visitor.@xtkschema = "nms:visitor"
ctx.recipient.visitor.@_operation = "update"
ctx.recipient.visitor.@_key = "@id"
xtk.session.Write(ctx.recipient.visitor)

// Send email to friend
nms.delivery.QueueNotification("referrer",
<delivery>
<targets>
  <deliveryTarget>
    <targetPart type='query' exclusion='false' ignoreDeleteStatus='false'>
      <where>
        <condition expr={'@id IN ('+ ctx.recipient.visitor.@id +')' }/>
      </where>
    </targetPart>
   </deliveryTarget>
  </targets>
 </delivery>)

Publish竞争表，并向初始目标的收件人发送邀请。 当其中一个邀请朋友时，将创建基于​ 反向链接选件 ​模板的投放。

被推荐人已添加到​ Administration > Visitors node ​中的访客文件夹：

其个人资料包含其反向链接输入的信息。 它基于在表单脚本中输入的配置进行存储。 如果他们决定订阅新闻稿，将保存在收件人表中。