练习 - 在 Power Pages 中生成和测试付款窗体
在 Power Pages 中集成付款方式时,您需要一个窗体和一个连接数据的关联表。 在本练习中,您将创建一个新表和窗体,以了解在集成付款方式时所需的先决条件。 如果您已有可用于本目的的表和窗体,则可以使用它们,然后跳到生成多步窗体。
创建付款联系人表
在创建表和窗体之前,最佳做法是在解决方案内生成这些资源。 解决方案是一个包,可用于在不同环境之间分组、管理和传输自定义、应用程序、组件和配置。
转到 Power Pages,然后登录到您添加了 Stripe 集成的租户。
从左侧导航菜单中选择解决方案,然后从上部菜单中选择 + 新建解决方案。
将解决方案命名为测试付款(或类似名称),然后使用默认发布者(如果您没有分配发布者)。
在测试付款解决方案中,从表菜单中选择 + 新建,然后选择表 > 表(高级属性)。
在右侧打开的新建表窗格中,将表命名为 Payment contact,将主列保留为 Name,然后选择保存。
转到 Payment contact 表后,从上部菜单中选择 + 新建,然后选择列。
将列命名为 Payment amount,针对数据类型选择货币,然后选择保存。
重要提示
在多步窗体上使用 Stripe 集成时,您需要一个货币列。 此列确定要向用户收取的费用。 如果没有货币列,则无法进行集成。
添加另一个名为 Email 的列,用于跟踪用户的电子邮件地址。 使用单行文本数据类型,其中格式为电子邮件。
现在,“payment contact”表已准备就绪。 在下一部分中,您将生成与此表关联的窗体,然后将其添加到您的 Power Pages 网站上的多步窗体中。
修改表的窗体
将“payment contact”表与站点上的多步窗体相关联时,您需要选择与“payment contact”表关联的窗体。 与新表关联的标准窗体可能不包含您希望用户填写的所有信息。若要解决此问题,您需要向现有的主信息窗体添加列。
从“payment contact”表中,在数据体验下选择窗体。
在窗体页面上,选择窗体类型为主的信息窗体,然后从上部菜单中选择编辑。
在打开的新建付款联系人窗体编辑器中,通过从列表中选择其名称将表列窗格中的以下列添加到左侧:
- 电子邮件
- 付款金额
注意
选择付款金额时,请确保使用付款金额列 WITHOUT(基准)。 此外,可以选择隐藏所有者,这可能有助于提高窗体的可读性。
选择窗体编辑器右上角的保存并发布。
现在应该已设置一个表和一个窗体,供用户进行付款。 在下一部分中,您将这些资源集成到 Power Pages 站点上的多步窗体中。
创建多步窗体组件
虽然窗体也与表直接关联,但您可以在 Power Pages 设计工作室中生成自定义窗体。 以下部分指导您如何生成多步窗体并将其与 Stripe 集成。
首先,从 Power Pages 主页中编辑您的 Power Pages 站点,以进入设计工作室。
转到您希望显示窗体的页面,或选择 + 页面以添加空白页面。
在页面的 + 添加部分区域中,在选择组件下选择多步窗体以创建新的多步窗体。
如果打开添加多步窗体窗口,请选择 + 新建多步窗体。
将窗体命名为类似于 Payment 的名称,然后选择完成以创建窗体。
在创建的窗体区域中,选择 + 添加第一步以添加窗体的第一步。
在打开的添加步骤窗口中,将步骤命名为收集信息,然后选择您之前创建的 Payment contact 表。 在选择窗体下,选择信息,然后选择确定。
注意
信息窗体就是您之前编辑的主窗体,其中已选择名称、电子邮件和付款金额字段。 如果隐藏所有者字段,则该字段不应显示在多步窗体上。
选择窗体上部的 + 添加步骤。
在打开的添加步骤窗口中,将步骤命名为付款。 选择您在上一步中使用的同一 Payment contact 表和信息窗体,然后选择确定。
仍然在窗体的第 2 步(共 2 个步骤)上,选择步骤设置。
从左侧导航窗口中转到应用集成,然后选择启用数字付款旁边的切换开关,以打开 Stripe 集成。 针对选择金额字段选择付款金额,然后选择确定以完成窗体。
您现在应该拥有完整的多步窗体,其中第一步要求用户输入姓名、电子邮件和付款金额,第二步显示提供的用户输入和附加的付款窗体。 价格金额也应该与付款金额字段相关联。
为了让用户查看窗体以及您对其进行测试,您需要修改窗体的权限。 为此,选择窗体上部的 + 新建权限。
在右侧打开的新建表权限窗格中,确保自动填充以下字段:
- 表 - Payment contact
- 访问类型 - 全局访问
-
权限目标
- 读取
- 创建
在新建表权限窗格下部选择 + 添加角色。 选择管理员和经过身份验证的用户角色,然后选择保存。
选择设计工作室右上角的同步,然后选择预览 > 桌面以预览页面。
当您预览窗体时,根据网页的设置方式,您可能会注意到您没有相应权限 消息。 若要查看窗体,您需要登录到网站。
如果您的网站使用 Power Pages 模板之一,请完成以下步骤:
选择网站右上角的登录。
在使用外部帐户登录下选择 Microsoft Entra ID。 登录到您的租户并接受权限请求。
如果您之前未登录过站点,请输入您的信息,选择保存,然后返回到付款窗体。
您的窗体现在应可见,并应类似于以下屏幕截图。
下一部分将介绍 Stripe 窗体的测试选项,包括您可以使用的测试卡片编号。
测试窗体
当您在 Power Pages 站点上测试 Stripe 付款时,Stripe 会提供一组测试卡片供您使用。 该列表还提供卡片品牌的关联 PaymentMethod 和令牌 ID。 有关完整列表,请转到测试卡片。
测试方法很简单,只需要您从列表中选择一张卡片,然后填写站点的窗体,类似于进行正常付款的方式。
从设计工作室的预览功能转到付款窗体,然后在姓名和电子邮件字段中输入您记住的信息。 确保您正在使用窗体的确认信息步骤。
注意
您输入的信息仅用于测试目的;不需要是与真实电子邮件地址关联的真实姓名
对于付款金额,输入任何数字,然后选择下一步。
注意
此数字的限制取决于单列的设置。 设置货币列时,您可以选择修改值限制。 您还可以指定货币的类型。
选择下一步后,系统会将您转到窗体的付款步骤。 在此步骤中,您可以从 Stripe 的文档中输入测试卡片编号。
选择卡片,然后输入任何测试卡片。 选择窗体下部的立即支付以完成该流程。 到期日期可以是任何未来日期,安全代码可以是任意三位数,邮政编码可以是任意五位数。
注意
您从收集信息步骤中提供的信息现在应显示在付款步骤的上部,但处于只读模式。
确认付款后,系统会将您转到摘要视图,其中显示交易记录的名称、电子邮件、付款金额和交易记录 ID。
若要确认付款已在内部成功,您可以查看 Payment contact 表中的记录。
若要在 Stripe 中确认,请转到交易记录页面,您的交易记录在该页面中应显示为已成功,其中交易记录 ID 显示在描述下。
后续步骤
现在,您已练习了如何开发和测试付款窗体,接下来您应该能够将此知识与您自己的公司或个人数据和用例集成。
从测试密钥切换到实时密钥时,请务必了解在存储 API 密钥时需要使用 Azure Key Vault。 对于使用实时密钥的付款集成,不接受 Dataverse 存储。 将密钥添加到 Azure Key Vault 时,请按照以下步骤操作:
从 Azure 中的应用注册页面中获取您的应用的名称。 Azure 门户中应用的名称是您的站点的名称,其中包含 Portals- 前缀。 如果站点名称为 Contoso Coffee,则 Azure 门户中的应用名称将为 Portals-Contoso Coffee。
在 Azure 门户中转到 Key Vaults,然后创建新的密钥保管库或使用现有密钥保管库。
创建新的密钥保管库时,您需要选择权限模型。 您可以选择 Azure 基于角色的访问控制或 Key Vault 访问策略。
将您的 Stripe 受限密钥作为密钥添加到密钥保管库。 有关如何在 Azure Key Vault 中创建密钥的详细信息,请转到使用 Azure 门户从 Azure Key Vault 设置和检索密钥。