FORGE

Reporting

  1. Open Reporting from the Workspace navigation.

  2. Wait for Reporting to finish checking your permissions. If you do not have access, the page shows a permission message instead of the reporting workspace.

  3. Use the folder tree to browse reporting folders.

  4. Use the breadcrumb to confirm which folder you are currently viewing.

  5. Review the report list. Each report shows details such as name, description, status, owner, and modified date.

  6. To run a report, select the report’s Run action.

  7. Enter any required preview parameters. Required parameters must be filled in before the report can run.

  8. Wait for the report to finish processing. When it is ready, the preview opens in a modal or preview area.

  9. If the report output includes a grid, sort the grid from the column headers as needed.

  10. Select Export PDF after a successful run if you need a PDF copy. The PDF keeps the current visible grid sort order and converts interactive grids into static report tables.

  11. To edit a report, select the report’s Edit action. This opens the report in Report Builder.

  12. In Report Builder, use the Designer tab to arrange report items visually.

  13. Use the JSON tab when you need to edit the report definition directly.

  14. Use the Preview tab to review generated output before publishing or exporting.

  15. Select Save Draft to save your current report changes. New reports create an initial draft revision, and existing reports create a new draft revision.

  16. Select Publish when the draft is ready to become the active report version. Active reports run from the published definition; draft reports run from the draft definition.

  17. To create or organize folders, use New Folder when your role allows it.

  18. To upload a report definition, select Upload File and choose one .json report definition. Reporting validates the file before creating the report.

  19. If upload validation finds blocking errors, review the validation dialog. The report is not created until the errors are resolved.

  20. To manage access, select a report’s Permissions action or choose Manage Permissions from a report or folder context menu.

  21. In the permissions drawer, review direct entries, inherited folder entries, owner access, and the current effective permission.

  22. Use Add user or group to grant access to users or roles, choose the permission level, then save the drawer.

  23. If you are a Reporting Admin, BusinessUnitAdmin, or WS Admin user, use the Owner Access section to change the report owner when needed.

  24. Use Report Management for broader library administration, such as creating, renaming, or deleting folders; moving reports between folders; and managing folder-level or report-level access.

  25. Use Return To Builder or Close to leave Report Management and go back to the report design surface.

2:44 PM

Provide details instructions for creating a report, editing a report, granting permission access to a report.

2:48 PM

Below are detailed user-guide steps based only on the Reporting help and reporting documentation in this folder.

Creating A Report

  1. Open Reporting from the Workspace navigation.

  2. Confirm you have reporting access. If access is denied, Reporting shows a permission message instead of the workspace.

  3. To create a fixed-layout operational report, open Report Builder.

  4. In Report Builder, enter a clear report name so the report is easy to find later in the saved report rail or Reporting library.

  5. Use the Designer workspace tab to build the report visually.

  6. Add and arrange report items in the layout workspace.

  7. Configure each report item’s properties, such as position, size, content, dataset fields, visibility rules, formatting, or expressions.

  8. If the report uses parameters or filters, configure the parameter type so preview users receive the correct input control.

  9. For controlled filters such as status, define allowed lookup or multi-select options so users can choose valid values.

  10. Use shared assets when the report needs images. Select the Image Asset Library button to browse or manage reusable company images.

  11. Use shared Text Blocks when the report needs reusable copy such as remit-to information, footer text, or standard notes.

  12. Use the JSON tab only when you need to edit the report definition directly.

  13. Use the Preview tab to test generated output.

  14. Fill in any required preview parameters. Preview and export stop with a validation popup until required values are entered.

  15. Select Save Draft to save the report. A new saved report creates a stable report record and an initial draft revision.

  16. Review the preview again after saving. Processor-backed live preview and generated PDF output use the latest saved draft revision.

  17. Select Publish when the draft is ready to become the active report version.

  18. Return to Reporting to find the report in the reporting folder/file library.

Editing A Report

  1. Open Reporting from the Workspace navigation.

  2. Use the folder tree to locate the folder that contains the report.

  3. Use the breadcrumb to confirm the current folder path.

  4. Find the report in the file list. The list shows the report name, description, status, owner, and modified date.

  5. Select the report’s Edit action.

  6. The report opens in Report Builder.

  7. Use the Designer tab to make visual layout changes.

  8. Use the report item properties to update exact placement, sizing, formatting, expressions, datasets, filters, visibility, or other item behavior.

  9. Use the JSON tab if direct report-definition editing is needed.

  10. Use the Preview tab to test the edited report.

  11. If preview processing fails, review the error shown in the Preview panel.

  12. Select Save Draft after making changes. Saving an existing report creates a new draft revision.

  13. If the report was previewed before the latest changes, treat the old preview as stale until the draft is saved again.

  14. Select Publish when the saved draft should become the active report revision.

  15. Run the report from Reporting to confirm the published or draft version behaves as expected. Active reports run against the published definition; draft reports run against the draft definition.

Granting Permission Access To A Report

  1. Open Reporting from the Workspace navigation.

  2. Locate the report using the folder tree and file list.

  3. Select the report’s Permissions action, or open the report or folder context menu and choose Manage Permissions.

  4. Review the permissions drawer.

  5. Check the current effective permission for the report.

  6. Review direct report access entries.

  7. Review inherited folder entries if the report inherits folder access.

  8. Review owner access for the report.

  9. Select Add user or group.

  10. Choose one or more users or roles.

  11. Set the permission level for each new access row, such as view or edit access.

  12. Save the permissions drawer.

  13. Remember that removing one direct entry may not remove effective access if another access path still applies.

  14. Do not expect to remove direct entries for the current report or folder owner; owner entries cannot be removed from the drawer.

  15. If you are a Reporting Admin, BusinessUnitAdmin, or WS Admin user, use the Owner Access section when the report owner needs to change.

  16. Select Change Owner to open the owner selector, or use Assume Ownership when that action is available.

  17. For broader access administration, open Report Management from Report Builder.

  18. In Report Management, use folder-level access when multiple reports should inherit the same access rules.

  19. Use explicit report access when a specific report needs direct user or role grants.

  20. Save folder or report access changes before leaving Report Management.

  21. Select Return To Builder or Close to exit Report Management.