0 / 0
Generating reports for factsheets and model entries (AI Factsheets)
Generating reports for factsheets and model entries (AI Factsheets)

Generating reports for factsheets and model entries (AI Factsheets)

Generate a report from a factsheet or model entry in PDF, HTML, and DOCX format so you can share or print the details about a model being tracked in a model inventory.

Generating reports from AI Factsheets

Capture all of the details about a model or model entry in a report that you can share, print, or archive. You can customize report templates to meet the needs of your organization.

Requirements

This feature requires that the model inventory contain a Platform assets catalog. To check for a Platform assets catalog:

  1. Click the Manage tab in the model inventory.
  2. If there is no Platform assets catalog, a notification indicates that a Platform assets catalog has not yet been created.
    • If you have the administrator role, click the link in the notification and follow the steps to create the Platform Asssets Catalog.
    • If you are not an administrator, ask an administrator to create the Platform assets catalog for your organization.

Generating a report from a factsheet

  1. Open a model factsheet from a project, space, or catalog. Export a report from model factsheet
  2. Click Export report . Note: If the model inventory does not contain a Platform assets catalog you are prompted to ask your system admin to create one.
  3. Choose a format option.
  4. Save the report.

Generating a report from a model entry page

  1. Open a model entry page in the model inventory.

    Export a report from model inventory

  2. Click Export report . Note: If the model inventory does not contain a Platform assets catalog you are promped to create one.
  3. Choose a format option.
  4. Choose what to include in the report:
    • Basic report contains the set of facts visible on the Overview and Assets tabs.
    • Full report contains all data from the Basic report and details about the models and deployments in the model entry.
  5. Save the report.

Creating a custom report template

If the default report templates provided with AI Factsheets do not meet your needs, you can download a default report template, customize it for your needs, and upload the new template. Currently, you must use the AI Factsheets API to download the template, but you can upload it from the Model inventory UI.

Follow these steps to create a custom report template.

To download a report template to edit:

  1. Use the GET endpoint for /v1/aigov/report_templates in the IBM Watson Data API to list the available templates. Note the id for the template you want to download.
  2. Use the GET endpoint /v1/aigov/report_templates/{template_id}/content with the template id to download the template file.
  3. Open the <report-name>.ftl file in an editor.
  4. Edit the template, using instructions from Apache FreeMarker or the API commands.

To add a custom template to the model inventory:

  1. Open the model inventory and click the Manage tab.
  2. Click Add template.
  3. Specify a name for the template and an optional description.
  4. Choose the type of template: model or model entry. Note that the reports are available for external models as well as Watson Machine Learning models.
  5. Upload the updated FTL file. Restriction: The ftl file that you upload must not import any other files. Support is not yet available for import statements in the ftl file.

The custom template displays in the Report templates section and will be available for creating reports. Click Edit or Delete from the action menu for a custom template to update the template details or to remove the template.

Learn more

Learn about viewing model entries and factsheets.

Parent topic: Managing an inventory of model assets.