A.6. templates Macros

使用 输入 宏，您可以自定义模板可以使用的输入数据。您可以定义输入名称、类型和用户可用的选项。如需报告模板，您只能使用用户输入。当您定义新输入并保存模板时，您可以在模板正文的 ERB 语法中引用输入。

<%= input('cpus') %>

这会从用户输入 cpus 加载值。

使用 load_hosts 宏，您可以生成完整的主机列表。

<%- load_hosts().each_record do |host| -%>
<%=     host.name %>

使用带有 each_record 宏的 load_hosts 宏以以 1000 批量加载记录，以减少内存消耗。

如果要过滤报告的主机列表，您可以添加选项 search: input('Example_Host'):

<% load_hosts(search: input('Example_Host')).each_record do |host| -%>
<%=  host.name %>
<% end -%>

在这个示例中，您首先创建一个输入，用于优化 load_hosts 宏检索的搜索标准。

使用 report_row 宏，您可以创建一个格式化的报告来简化分析。report_row 宏需要 report_render 宏生成输出。

<%- load_hosts(search: input('Example_Host')).each_record do |host| -%>
<%-   report_row(
        'Server FQDN': host.name
      ) -%>
<%- end -%>
<%= report_render -%>

Server FQDN
host1.example.com
host2.example.com
host3.example.com
host4.example.com
host5.example.com
host6.example.com

您可以通过添加另一个标头来向报告添加额外的列。以下示例在报告中添加 IP 地址：

<%- load_hosts(search: input('host')).each_record do |host| -%>
<%-   report_row(
      'Server FQDN': host.name,
           'IP': host.ip
      ) -%>
<%- end -%>
<%= report_render -%>

Server FQDN,IP
host1.example.com,10.8.30.228
host2.example.com,10.8.30.227
host3.example.com,10.8.30.226
host4.example.com,10.8.30.225
host5.example.com,10.8.30.224
host6.example.com,10.8.30.223

这个宏只可用于报告模板。

使用 report_render 宏，您可以为报告创建输出。在模板渲染过程中，您可以选择您要报告的格式。支持 YAML、JSON、HTML 和 CSV 格式。

<%= report_render -%>

这个宏仅适用于作业模板。

使用这个宏，您可以呈现特定的模板。您还可以启用并定义要传递给模板的参数。

使用 相依 宏，您可以声明传递的值为 true 或 false，无论该值是整数还是布尔值还是字符串。

这个宏有助于避免在模板包含多个值类型时混淆。例如，布尔值 true 与字符串值 "true" 不同。使用这个宏，您可以声明您希望模板解释值并避免混淆。

您可以使用数据源 声明 值，如下所示：

truthy?(“true”) => true
truthy?(1) => true
truthy?(“false”) => false
truthy?(0) => false

宏充当了与真实宏相同的用途。

使用 falsy 宏，您可以声明 中传递的值是否为 true 或 false，无论该值是整数还是布尔值还是字符串。

您可以使用 falsy 来声明值，如下所示：

falsy?(“true”) => false
falsy?(1) => false
falsy?(“false”) => true
falsy?(0) => true