Abstract:
A computer readable medium includes executable instructions to create a report; augment the report with metadata including a report identifier and parameter information; and export the report and metadata to a non-report electronic document.

Description:
CROSS-REFERENCE TO RELATED APPLICATION 
     This application is a continuation-in-part of U.S. Ser. No. 11/137,710, filed May 24, 2005, now abandoned entitled “Apparatus and Method for Inserting Portions of Reports into Electronic Documents”, the contents of which are incorporated by reference. This application also claims priority to the U.S. Ser. No. 60/719,790, filed Sep. 23, 2005, entitled “Apparatus and Method for Augmenting a Report with Metadata for Export to a Non-Report Document”, the contents of which are incorporated by reference. 
    
    
     FIELD OF THE INVENTION 
     The present invention relates generally to utilizing electronic reports. More particularly, the present invention relates to utilizing electronic reports in non-report documents. 
     BACKGROUND OF THE INVENTION 
     There are a number of commercially available products to produce reports from stored data. For instance, Business Objects Americas of San Jose, Calif., sells a number of widely used report generation products, including Crystal Reports™, Business Objects OLAP Intelligence™, and Business Objects Enterprise™. As used herein, the term report refers to information automatically retrieved (i.e., in response to computer executable instructions) from a data source (e.g., a database, a data warehouse, and the like), where the information is structured in accordance with a report schema that specifies the form in which the information should be presented. A non-report is an electronic document that is constructed without the automatic retrieval (i.e., in response to computer executable instructions) of information from a data source. Examples of non-report electronic documents include typical business application documents, such as a word processor document, a spreadsheet document, a presentation document, and the like. 
     A report document is generally created by a specialized tool including executable instructions to access and format data. A report document where the content does not include external data, either saved within the report or accessed live, is a template document for a report rather than a report document. Unlike, other non-report documents that may optionally import external data within a document, a report document by design is primarily a medium for accessing, formatting, and presenting external data. 
     A report design tool contains executable instructions specifically designed to facilitate working with external data sources. In addition to instructions regarding external data source connection drivers, these instructions may include advanced filtering of data, instructions for combining data from different external data sources, instructions for updating join structures and relationships in report data, and instructions including logic to support a more complex internal data model (that may include additional constraints, relationships, and metadata). 
     In contrast to a spreadsheet type application, a report generation tool generally is not limited to a table structure but can support a range of structures. A report design tool is designed primarily to support imported external data, whereas a spreadsheet application equally facilitates manually entered data and imported data. In both cases, a spreadsheet application applies a spatial logic that is based on the table cell layout within the spreadsheet in order to interpret data and perform calculations on the data. In contrast, a report design tool is not limited to logic that is based on the display of the data, but rather can interpret the data and perform calculations based on the original (or a redefined) data structure and meaning of the imported data. Spreadsheet applications work within a looping calculation model, whereas report generation tools may support a range of calculation models. Although there may be an overlap in the function of a spreadsheet document and a report document, the applications used to generate these documents contain instructions with different assumptions concerning the existence of an external data source and different logical approaches to interpreting and manipulating imported data. 
     The commonly owned parent patent application entitled “Apparatus and Method for Inserting Portions of Reports into Electronic Documents”, U.S. Ser. No. 11/137,710, filed May 24, 2005, discloses techniques for adding metadata to a portion of a report and then exporting the portion of the report and the associated metadata to a non-report electronic document. The contents of the foregoing application are incorporated herein by reference. It would be highly desirable to extend the functionality of the technology described in the foregoing application to include entire reports. In particular, it would be highly desirable to export entire reports into non-report electronic documents, while still allowing refresh and related operations on the exported report. 
     It is against this background that a need arose to develop the apparatus and method described herein. 
     SUMMARY OF THE INVENTION 
     The invention includes a computer readable medium with executable instructions to create a report; augment the report with metadata including a report identifier and parameter information; and export the report and metadata to a non-report electronic document. 
     The invention also includes a computer readable medium with executable instructions to receive at a non-report electronic document a report with metadata; and analyze the metadata to initiate a refresh of the report. 
    
    
     
       BRIEF DESCRIPTION OF THE DRAWINGS 
       For a better understanding of the nature and objects of the invention, reference should be made to the following detailed description taken in conjunction with the accompanying drawings, in which: 
         FIG. 1  illustrates processing operations associated with an embodiment of the invention. 
         FIG. 2  illustrates components and process flow associated with an embodiment of the invention. 
         FIG. 3  illustrates a graphical user interface that may be used in accordance with an embodiment of the invention. 
         FIG. 4  illustrates components and process flow associated with an alternate embodiment of the invention. 
     
    
    
     Like reference numerals refer to corresponding parts throughout the several views of the drawings. 
     DETAILED DESCRIPTION 
       FIG. 1  illustrates processing operations associated with an embodiment of the invention. Initially, a report document is created using a reporting tool  100 . A request is then processed for the export of the report to a non-report document. Metadata is then added to the report. Various forms of metadata used in accordance with embodiments of the invention are discussed below. The report and the metadata are then exported  104 . The report and the metadata are then opened in a non-reporting application  106 . The non-reporting application may be on the same computer or a different computer than the computer that generated the report. Typically, one computer will generate a report and export the report (with the metadata) over a network to a second computer. Next, a request to refresh the report is processed  108 . The parent object for the exported document is then located  110 . A check is then made to determine if the user has refresh rights to the report object  112 . If so, the report instance is refreshed in the reporting system  114 . The data and report content from the refreshed report is then exported to the non-report document  116 . If the user does not have refresh rights, the latest report instance with the same parameters is identified  118 . Data and report content from this instance is then exported to the non-report document  116 . Finally, data and report content in the non-report document are updated  122 . 
     The invention combines functionality from a reporting system in terms of creating the export document and coordinating a report refresh with functionality in a non-reporting application such as Microsoft Word™ or Excel™. The report document is exported in order to be compatible with these non-reporting applications. Metadata regarding the original source report and its data sources is added to the exported document. At a minimum, the metadata provides information for identifying the source report and the parameters used within the source report. It can include additional metadata such as report server name, drill down path information, export dll information, export format and options, prompts for the report, logon information (UserID, but not password stored), report language, etc. The metadata system is extensible. 
     With the exported document open in the non-reporting application, it is possible to trigger a refresh of the source report (or to open an existing instance of the report document) and to import the updated data/report content into the exported document within the non-reporting application. 
     Refresh options are based on having permission to refresh the report object. In one implementation, an additional range of options exist for selecting whether to refresh the non-report document by refreshing the report, accessing the latest report instance, or selecting a specific report instance. Additionally, options for how to handle the refresh in the non-report document include: replacing all of the existing report content, inserting the new report content in a new page, creating trending information based on the original report data as it compares with the updated report data, maintaining modifications in the non-report document including formatting changes to the original report data and additional content. 
       FIG. 2  provides a more detailed overview of components and processing operations associated with an embodiment of the invention. The following example is in the context of non-reporting applications sold by Microsoft Corporation, Redmond, Wash., and reporting applications sold by Business Objects Americas, San Jose Calif. To enable the exported documents for Microsoft&#39;s LiveOffice product, some custom information is embedded in the exported document, during the export time. This custom information is subsequently used by LiveOffice. 
     The processing associated with  FIG. 2  can be characterized as follows:
         a. When a Business Objects Enterprise server  200  opens a report document using a Report Engine  202 , it passes in information  204  about the server name (e.g., the name of the CMS server) and the CUID (i.e., the report ID) of the report.   b. The Report Engine  202  then stores this information. When an export call is made from the Business Objects Enterprise side, Report Engine  202  passes this information  206 .   c. The Exporter or Export DLL  208  then uses this information and appends any additional information (like the export format DLL name, the format type, the format options, etc.) and creates a string in a pre-determined syntax. The syntax of this string is mutually agreed upon between the export DLL  208  and the non-report application (e.g., LiveOffice  212 ). This string is then encrypted and embedded in the exported document as a custom property. LiveOffice exporting is enabled by default, but can be turned off. This results in an exported document with custom properties  210 .       

       FIG. 3  illustrates an example of the custom property for the exported document when opened in a non-report application (e.g., an MS-Office application).  FIG. 3  illustrates a properties field with a BO-LiveOfficeInfo file specified. Note that the property is encrypted for security purposes. The custom property set like this does not create any compatibility problems in the exported document, as it does not affect the data area of the document. 
     Returning to  FIG. 2 , the exported document is processed as follows.
         d. A user opens the document in a non-report application  212  (e.g., MS-Office that has a LiveOffice plug-in). In LiveOffice, along with other UI elements, there is an option to ‘Refresh’  214  the document.   e. LiveOffice then reads the custom property from the document and decrypts it (the encryption method is also mutually agreed upon between export DLL and LiveOffice). Once decrypted, it parses the string and then talks (e.g., through a report application server  216 ) to the specified server (e.g., CMS server  200 ) with the relevant information. Then it gets the document re-exported through Business Objects Enterprise  200  and replaces the document in-place in the MS-Office application  212 .       

     Within the LiveOffice context, when the meta-data for the report is accessed, the parent object for the report is identified and located. If the user has refresh rights, the report object is used to refresh and get the latest context. If the user does not have refresh rights, the latest report instance running with the same parameter values is used to get the new content. 
       FIG. 4  illustrates an unmanaged LiveOffice implementation in which the BO-Enterprise system is absent. Therefore, the server Name and the report CUID are not used. Instead the ‘report name’ and optionally report parameters are used. The LiveOffice client uses the report name embedded in the exported document to refresh. Other than this difference, the rest of this workflow is same as in  FIG. 2 . 
     The unmanaged LiveOffice workflow enables systems that do not include the BO-Enterprise system to create metadata when a report object is exported such that the exported document based on a report document can be refreshed. 
     The following table lists various metadata that may be attached to a file in accordance with various embodiments of the invention. 
     
       
         
               
               
             
           
               
                   
               
             
             
               
                 CMSName 
                 The name of the CMS server. 
               
               
                 CUID 
                 The CUID (or report ID) for the report in 
               
               
                   
                 the BO-Enterprise 
               
               
                 LocalReportFileName 
                 The path name of the report file. This will 
               
               
                   
                 be used by Unmanaged LiveOffice. 
               
               
                 DrillDownContext&lt;token 
                 The group path of the Drill Down context 
               
               
                 separator&gt; 
                 to use, if the document is exported from a 
               
               
                   
                 drill down view. This string will have a 
               
               
                   
                 format like “0-4-6” i.e., numbers separated 
               
               
                   
                 by hyphen (‘-’). 
               
               
                 ParameterInfo 
                 This is the name and value of the 
               
               
                   
                 parameters used for the report. The syntax 
               
               
                   
                 of the &lt;report parameter info&gt; is as 
               
               
                   
                 follows: 
               
               
                   
                 &lt;param Name&gt;“[“&lt;param value&gt;”]” for 
               
               
                   
                 each parameter. If there is more than one 
               
               
                   
                 value for the parameter, they are comma 
               
               
                   
                 separated. 
               
               
                   
                 For parameters with multiple values, all the 
               
               
                   
                 values are encoded in a single string. 
               
               
                   
                 For instance, assume the following case: 
               
               
                   
                 Country = “Canada” 
               
               
                   
                 Provinces = “BC”, “ON” 
               
               
                   
                 Cities = “Vancouver”, “St, Edwards” 
               
               
                   
                 The embedded string should be 
               
               
                   
                 ParameterInfo= 
               
               
                   
                 Country[Canada] 
               
               
                   
                 Provinces[BC,ON] 
               
               
                   
                 Cities[Vancouver,St\002C 
               
               
                   
                 Edwards] 
               
               
                 ExportDllId 
                 The name of the export DLL used to create 
               
               
                   
                 this document. For instance, crxf_xls.dll, 
               
               
                   
                 crxf_rtf.dll etc. 
               
               
                 ExportFormatIndex 
                 The index of the export format. For 
               
               
                   
                 instance, 1 for “RTFEditable” when export 
               
               
                   
                 DLL is crxf_rtf. 
               
               
                 ExportOptions 
                 The format options used for the export. 
               
               
                   
                 This will be a string of properties. If this 
               
               
                   
                 string contains any of the reserved 
               
               
                   
                 characters, then they are escaped. 
               
               
                   
               
             
          
         
       
     
     Embodiments of the invention support refresh operations at a granular level. Individual data elements may be tagged with metadata. This allows identification of specific components in a non-report document that need to be refreshed. Thus, specific sections of a document may be refreshed. 
     Aspects of the non-report document that are based on imported report content should not be removed when the data is refreshed. The invention supports the export of report information into an existing non-report document (rather than creating a new non-report document). The techniques of the invention may be used to export information from multiple reports into a single non-report document. The exported information may include specific parts of a report (e.g., a specific chart or page). The non-report document may be used to schedule refreshing of select aspects of the report document. 
     An embodiment of the present invention relates to a computer storage product with a computer-readable medium having computer code thereon for performing various computer-implemented operations. The media and computer code may be those specially designed and constructed for the purposes of the present invention, or they may be of the kind well known and available to those having skill in the computer software arts. Examples of computer-readable media include, but are not limited to: magnetic media such as hard disks, floppy disks, and magnetic tape; optical media such as CD-ROMs, DVDs and holographic devices; magneto-optical media; and hardware devices that are specially configured to store and execute program code, such as application-specific integrated circuits (“ASICs”), programmable logic devices (“PLDs”), ROM devices, and RAM devices. Examples of computer code include machine code, such as produced by a compiler, and files containing higher level code that are executed by a computer using an interpreter. For example, an embodiment of the invention may be implemented using Java, C++, or other object-oriented programming language and development tools. Another embodiment of the invention may be implemented in hardwired circuitry in place of, or in combination with, machine-executable software instructions. 
     While the present invention has been described with reference to the specific embodiments thereof, it should be understood by those skilled in the art that various changes may be made and equivalents may be substituted without departing from the true spirit and scope of the invention as defined by the appended claims. In addition, many modifications may be made to adapt a particular situation, material, composition of matter, method, process step or steps, to the objective, spirit and scope of the present invention. All such modifications are intended to be within the scope of the claims appended hereto. In particular, while the methods disclosed herein have been described with reference to particular steps performed in a particular order, it will be understood that these steps may be combined, sub-divided, or re-ordered to form an equivalent method without departing from the teachings of the present invention. Accordingly, unless specifically indicated herein, the order and grouping of the steps is not a limitation of the present invention.