Managing Object Instances

SAP BusinessObjects BI Platform 2025 creates instances from objects; for example, a report instance is created when you schedule a report object to run and finishes successfully. A report instance is a report object that includes specific report data; the report data can be retrieved from one or more data sources. Each instance includes data that is current at the time the report is processed.

Similarly, SAP BusinessObjects BI Platform 2025 platform creates a program instance when the Adaptive Job Server runs a scheduled program object. Unlike report instances, which can be viewed in their completed format, program instances exist as records in the object history. SAP BusinessObjects BI Platform 2025 stores the program's standard output and standard error in a text output file.

Instances Management:

You can view and manage all instances created on SAP BusinessObjects BI Platform 2025 by the following methods:

• Opening the Object History (CMC or BI Launch Pad)

• Using the Instance Manager (CMC only)

The following link displays the History dialog box for individual objects in CMC:

Viewing instance information

The following figure displays the History dialog box for individual objects in BI Launch Pad:

By default, copy of instances are saved in the document's history by default and stored in SAP BusinessObjects BI Platform 2025.

Keep instance in history and Limits options:

You would like to automatically delete the instance from the Output FRS to minimize the number of instances on the server.

• As a user: You can uncheck the Keep an instance in the history option in the destination property in a new scheduled job in BI Launch Pad (checked by default). The benefit is to delegate this clean up to any user, but the drawback is that users have to manage manually this history clean up.
• As an administrator: You can set up limits for instances on documents or folders in CMC. Document's history will be automatically cleaned up based on these limits. The benefit is to minimize automatically the number of instances and used space on the server (automatic clean up), but the drawback is to ask administrators to set it up in CMC.

Definition:

The Instance Manager lets you view and manage all instances in SAP BusinessObjects BI Platform 2025. You can use the Instance Manager to carry out the following tasks:

• Find specific instances.
• Select several instances and do batch operations on them (for example, pause, resume, or delete them).
• View detailed information for a single instance.

The default view of the Instance Manager shows all pending instances, sorted by title.

To find specific instances quickly, you can create filters in the Find instances that meet the following criteria section of the Instance Manager. You can base filters on one or more of the following criteria:

• Parent folder:

  Parent document folder (by default, search will search instances from the public document root folder).

• Owner:

  User who is owner of the instance.

• Status:

  Current status of instances. The most important status available from the list are:

  • Success:

    Instance is successfully created (scheduling job successful).

  • Failed:

    Instance isn't successfully created (scheduling job failed).

  • Running:

    Instance is currently in process (scheduling job running).

  • Paused:

    Instance is currently in pause (scheduling job paused).

  • Pending:

    Instance is currently not created (scheduling job not started).

  • Recurring:

    Next instance to create (recurring scheduling job).

• Object Type:

  Scheduled object type. Object types available are:

  • Analysis Workbook:

    Analysis for Office workbook object (MS Excel).

  • Program:

    Program object (executable, .BAT...).

  • Publication:

    Publication object.

  • Object Package:

    ZIP files.

  • Web Intelligence:

    Web Intelligence object.

  • Crystal Reports:

    Crystal Reports object.

• Completion Time:

  Creation time of instances.

• Next Run Time:

  Recurring scheduled jobs.

The following link shows Finding instances in the Instance Manager:

Finding instances in the Instance Manager

When you finish specifying the search criteria, choose Find. Only instances that meet all the criteria are displayed.

Actions:

In the display list, you can select any instance meeting the criteria and choose to:

• Delete it.
• Reschedule it.
• Get the History status.
• Send it (BI inbox, email).

Definition:

The Instances tile of the BI Launch Pad allows you to view all your instances available on an interval of time (specified using the Start date and End date). Instance tile is available on the Home tab in BI Launch Pad.

To find and view specific instances, just enter your criteria using:

• Instance Time
• Status: Success, Partial Success, Failed, Running, Recurring, Paused, or Expired
• Type: Publication, Analysis Workbook, Crystal Reports, Web Intelligence, Adobe Acrobat, Microsoft Excel, or Text
• Title
• Scheduled By

Criteria:

In instances, you can execute following actions on instances in BI Launch Pad if you are granted by an administrator:

• Run Now
• Re-schedule
• Pause
• Details
• Delete

• SAP BusinessObjects BI Platform 2025 generates instances from objects, such as reports or programs, which contain specific data current at the time of processing.
• Report instances can be viewed in their completed format, while program instances are stored as records with standard output and error in text files.
• Instances can be managed through the History dialog box for an object, the BI platform Instance Manager, or the BI Launch Pad Instance Tile.
• The Instance Manager allows for finding specific instances, performing batch operations, and viewing detailed information for a single instance.
• The BI Launch Pad Instance Tile enables finding and managing instances based on various criteria and performing actions like run, reschedule, pause, view details, or delete.