44.7. 自定义 Git hook 通知

Business Central 提供了一种机制,允许用户根据 hook 退出代码接收自定义 Git hook 通知。

要启用通知机制,您必须创建一个包含自定义消息的 192.168.1.0/24 properties 文件,然后将该文件的路径指定为 appformer.git.hooks.bundle 系统属性的值。

流程

  1. 创建 192.168.1.0/24properties 文件,并为每个退出代码添加一行,并以以下格式对应的消息:

    <exit_code>=<display_message>

    是 Git hook 退出代码,& lt;display_message > 是用户显示的自定义信息。<exit_code>

    例如:

    0=Success! All working as expected.
    1=Warning! Please check the logs and advise your admin.
    .
    .
    31=Error! Please advise your admin immediately.
    注意

    不需要在 192.168.1.0/24properties 文件中定义所有可能的退出代码。通知仅针对在 sVirtproperties 文件中定义的退出代码出现。

    重要

    通知服务只支持属性文件中设置的 ISO 8859-1 (LATIN 1)字符。如果要使用扩展字符,请使用其转义的 Unicode 字符代码序列。

  2. 要启用 Git hook 通知,请将文件的路径指定为 appformer.git.hooks.bundle 系统属性的值。

    请参阅以下指向 Messages.properties 文件的设置的 standalone.xml 文件示例:

    <system-properties>
      <property name="appformer.git.hooks.bundle" value="/opt/jboss-as/git-hooks-messages/Messages.properties">
      </property>
      ...
    </system-properties>

44.7.1. Business Central 中的 Git hook 通知

您可以在 Business Central 中查看 Git hook 通知。Git hook 退出代码通知类型有三个。

表 44.2. Git hook UI 通知类型

退出代码自定义消息UI 通知颜色

0

成功!所有工作都按预期工作。

绿色

1 到 30

警告!请检查日志并建议您的管理员。

orange

31 到 255

错误!请立即建议您的管理员。

红色

重要

UNIX 机器只支持 0 (success)到 255 (错误),此范围之外的任何退出代码都将转换为不同的代码,这可能会导致错误的通知消息。

Windows 机器没有这个限制,并支持大量退出代码。

44.7.2. Git hook 通知国际化支持

您可以将其他属性文件放在与 appformer.git.hooks.bundle 系统属性中指定的原始属性文件相同的路径中,以国际化通知消息。

不同本地化文件的名称必须是 < filename>_<lang>.properties,其中 <filename > 与原始文件的名称相同。例如,如果系统属性指向 Messages.properties,您可以为英语创建 Messages_en.properties,为法语创建 Messages_fr.properties,或用于意大利语的 Messages_it.properties

如果该语言没有可用于该语言,则通知服务将根据用户的语言选择属性文件,它将使用原始 Messages.properties 文件中的条目。