A.5. templates Macros

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

<%= input('cpus') %>

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

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

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

使用 every_ record 宏的 load_ hosts 宏来加载 1000 批处理中的记录，以减少内存消耗。

如果要过滤报告的主机列表，您可以添加选项 搜索： 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 -%>

此宏仅适用于作业模板。

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