使用消息目录,您可以为 Vault 扩展的最终用户提供本地化的体验。例如,您可以根据验证标准向用户显示本地化的错误消息。为此,请创建一个自定义的消息组和相关的消息。
创建之后,消息组可立即供自定义代码调用。当运行时,用户会看到以他们的首选语言显示的消息。如果不存在任何翻译,Vault 将使用基本语言中的默认值。
对于消息组和消息的限制
以下限制会影响消息组和消息:
- 一个消息组可以包含最多 500 条消息。
- 消息文本不能超过 1,500 个字符或 5 行。
- 当创建消息默认值或编辑现有的值时,所使用的全部令牌必须遵循
${token_name}
格式,其中的“token_name”是一个字符串,它以字母开头,后跟任意数量的字母和下划线。例如${email_input} 并非有效的电子邮件地址
。
如何创建消息组
要创建新的消息组:
- 从管理 > 配置 > 消息目录中,单击消息组页面上的创建。
- 为组输入一个标签。系统不会向最终用户或开发人员显示标签字段的值。
- 可选:Vault 自动填充名称字段。您可以根据需要编辑此字段。开发人员会使用此名称来调用消息组。
- 单击保存。
如何删除消息组
注意:在删除消息组之前,请确保此操作不会损坏任何现有的 Vault 扩展。
要删除消息组:
- 选择一个消息组。
- 在此组的编辑页面上,单击删除。
- 单击对话框中的继续。
如何向消息组添加消息
要向消息组添加消息:
- 选择一个消息组。
- 在消息组记录详细信息页面上,单击消息部分中的创建。
- 为消息输入一个名称。开发人员会使用此名称来调用消息。
- 输入默认值。对于组中的所有消息,此字段是通用的。
- 单击保存。
- 重复这些步骤,以添加额外的消息。
如何从消息组中删除消息
注意:在删除消息之前,请确保此操作不会损坏任何现有的 Vault 扩展。
要从消息组中删除消息:
- 选择一个消息组。
- 在消息组记录详细信息页面上,选择一条消息。
- 在查看消息页面上,单击删除。
- 单击对话框中的继续。
如何编辑消息
要编辑消息:
- 选择一个消息组。
- 在消息组记录详细信息页面上,选择一条消息。
- 在查看消息页面上,单击编辑。
- 如果需要,为消息输入一个新的名称。开发人员会使用此名称来调用消息。
- 如果需要,输入一个新的默认值。对于组中的所有消息,对此字段进行的更改是通用的。
- 如果需要,输入一个新的值(可选)。此字段通常是为当前用户的语言翻译的消息。如果不存在任何翻译或者删除了此值,那么无论用户的语言设置如何,Vault 都将使用默认值。尽管可以通过更改您配置文件中的语言以及在此输入此值来提供翻译,但建议使用批量翻译工具。
- 单击保存。
如何翻译消息
使用批量翻译工具的字段标签选项来翻译消息。在导出的 CSV 中,消息具有 message__sys
类型。它们的键遵循 Messagegroup#Message
模式。例如:person_validation__c#email_format__c
。