Impact of a BEx query change to universes and WebI documentsIntroduction Ever wondered about the impact of a BEx query change to your universes and Web Intelligence documents ? "If I change this, will I need to refresh the universe structure ? Will my Web Intelligence documents break ?". This article aims at clarifying these questions for Web Intelligence documents that use OLAP Universe(s) based on BEx query(ies). More specifically, it clarifies which BEx query change does impact Universes and Web Intelligence documents and which one is transparent to them. The first part of this article provides a summary table. The second part explains what to do to make the universe and Web Intelligence documents reflect the BEx query change. And finally, it covers each change scenario in details with more explanation and screen shots. Note: the results shown in this article are valid from Service Pack 2 of SAP Business Objects Enterprise XI 3.1. The structure update feature for OLAP Universes was improved a lot in Service Pack 2, and that patch level (or above) is a requirement for the scenarios detailed below. Note 2: in all this article, we are using some abbreviations in order to ease the reading. Web Intelligence and WebI stand for SAP BusinessObjects Web Intelligence. BEx for Business Explorer. LifeCycle Management Summary Below are 2 views of the same information : which BEx Query changes require updates and which do not the expected behaviour for each type of BEx Query change means the BEx query change does not break existing universes and Web Intelligence documents and the change is transparently taken into account (typically when only object values are affected by the change, and the query structure remains identical) means the BEx query change does not break existing universes and Web Intelligence documents, however the universe / document should be updated to take the change into account (typically when an object is added to the query) means the BEx query change does break the universe or Web Intelligence document, and an update is required to repair it (typically when an object is deleted from the query) Which BEx Query change require Universe and Web Intelligence updates ? BEx Query Changes that do not require any Universe or Web Intelligence document update Details Characteristics Add / Change characteristics restriction (i.e. single to multi, value to restrict) Change order for Characteristics Existing Web Intelligence documents will continue to work and the new value restrictions will take immediate effect Web Intelligence documents will continue to work, the order of Characteristic and Key Figures in the BEx query is ignored by Web Intelligence and the Universe Web Intelligence documents will continue to work, a Characteristic in Free Characteristic or Rows / Columns is viewed as the same thing by Universe and Web Intelligence documents Move characteristics to/from Free Characteristic section Key Figures Change order for Key Figures Web Intelligence documents will continue to work, the order of Characteristic and Key Figures in the BEx query is ignored by the Web Intelligence documents Web Intelligence documents will continue to work and the new value restrictions or calculation function will immediately take effect Change Restricted or Calculated Key Figure definition Structures Change Structure (add / move / delete elements) Changing a structure is equivalent to changing the order of Characteristic or Key Figures and is transparent to the Web Intelligence documents. Web Intelligence documents will continue to work Variables Change User-Exit Variable definition Changing a user-exit function definition is equivalent to changing a calculated key figure definition: it is transparent to Web Intelligence documents which will continue to work, the new variable values take immediate effect Hierarchies Add / Change Axis Hierarchy This feature is not exposed to the Universe and Web Intelligence documents, hence any change to its definition will not affect the hence any change to its definition will not affect the universe or document in any way Conditions / Exceptions Add / Change Axis Condition Conditions are not exposed to the Universe and Web Intelligence documents. hence any change to its definition will not affect the universe or document in any way Exceptions are not exposed to the Universe and Web Intelligence documents. . however the new characteristic will not be available when adding or editing queries until the universe is updated Existing Web Intelligence documents will only break if they use the object (characteristic) that was deleted Delete Characteristic if existing doc does not use the object Key Figures Add Key Figure Existing Web Intelligence documents will continue to work.universe or document in any way Expand to a specific Hierarchy Level This feature is not exposed to the Universe and Web Intelligence documents. hence any change to its definition will not affect the universe or document in any way Add / Change Axis Exception Details BEx Query Changes that do not break existing documents but require a Universe update to be taken into account Characteristics Add Characteristic Existing Web Intelligence documents will continue to work. however the new key figure will not be available when adding / editing queries until the universe is updated Existing Web Intelligence documents will only break if they use the object (key figure) that was deleted Delete Key Figure if existing doc does not use the object BEx Query Changes that break Details existing documents and universe. . for variable." You might get some "Some objects are no longer available in the universe. (Error: WIS 00001)" error when refershing the Web intelligence report. (WIJ20004).. failed to execute.hence require an update Hierarchies Add / Change Hierarchy enabled for a Characteristic Delete Characteristic if the existing doc uses the object Key Figures Delete Key Figure if the existing doc uses the object Variables Add / Change Characteristic Variable Web Intelligence documents are very likely to fail with an MDX error.. for variable. or some "The current query contains unresolvable objects.. Example: "(WIS 10901) The MDX query. failed to execute.." You might get some "Some objects are no longer available in the universe. Example: "(WIS 10901) The MDX query. See your Business Objects administrator.." when editing the query Web Intelligence documents are very likely to fail with an MDX error. (WIJ20004).. See your Business Objects administrator.. or some "The current query contains unresolvable objects.... (Error: WIS 00001)" error when refershing the Web intelligence report.." when editing the query Existing Web Intelligence documents will only break if they use the object (key figure) that was deleted The change of hierarchies selected for a characteristic impacts the universe structure and will require an update Existing Web Intelligence documents will only break if they use the object (characteristic) that was deleted Add / Change Hierarchy Variable Expected behaviour for each type of BEx Query change BEx Query change Universe structure update required ? Web Intelligence document update required ? What happens if I do not update existing universes or Web Intelligence documents ? . e. single to multi. the order of Characteristic and Key Figures in the BEx query is ignored by Web Intelligence and the Universe Web Intelligence documents will continue to work. a Characteristic in Free Characteristic or Rows / Columns is viewed as the same thing by Universe and Web Intelligence documents Move characteristics to/from Free Characteristic section Key Figures Add Key Figure Existing Web Intelligence documents will continue to work. however the new key figure will not be available when adding / editing queries until the universe is updated Existing Web Intelligence documents will only break if they use the object (key figure) that was deleted Delete Key Figure if existing doc does not use the object .Characteristics Add / Change characteristics restriction (i. however the new characteristic will not be available when adding or editing queries until the universe is updated Existing Web Intelligence documents will only break if they use the object (characteristic) that was deleted Delete Characteristic if existing doc does not use the object if it does use it Change order for Characteristics Web Intelligence documents will continue to work. value to restrict) Add Characteristic Existing Web Intelligence documents will continue to work and the new value restrictions will immediately take effect Existing Web Intelligence documents will continue to work. " You might get some "Some objects are no longer available in the universe. (WIJ20004). Example: "(WIS 10901) The MDX query. failed to execute." when editing the query Web Intelligence documents are very likely to fail with an MDX error. (Error: WIS 00001)" error when refershing the Web intelligence report..if it does use it Change order for Key Figures Web Intelligence documents will continue to work.. failed to execute.. the order of Characteristic and Key Figures in the BEx query is ignored by the Web Intelligence documents Web Intelligence documents will continue to work and the new value restrictions or calculation function will immediately take effect Change Restricted or Calculated Key Figure definition Structures Change Structure (add / move / delete elements) Changing a structure is equivalent to changing the order of Characteristic or Key Figures and is transparent to the Web Intelligence documents.. for variable. or some "The current Add / Change Hierarchy Variable ...." You might get some "Some objects are no longer available in the universe.. See your Business Objects administrator... Web Intelligence documents will continue to work Variables Add / Change Characteristic Variable Web Intelligence documents are very likely to fail with an MDX error. See your Business Objects administrator.. Example: "(WIS 10901) The MDX query. for variable. (Error: WIS 00001)" error when refershing the Web intelligence report.. or some "The current query contains unresolvable objects. (WIJ20004).query contains unresolvable objects. hence any change to its definition will not affect the universe or document in any way Exceptions are not exposed to the Universe and Web Intelligence documents." when editing the query Change User-Exit Variable definition Changing a user-exit function definition is equivalent to changing a calculated key figure definition: it is transparent to Web Intelligence documents which will continue to work. the new variable values take immediate effect. This feature is not exposed to the Universe and Web Intelligence documents. hence any change to its definition will not affect the universe or document in any way This feature is not exposed to the Universe and Web Intelligence documents. Hierarchies Add / Change Hierarchy enabled for a Characteristic Add / Change Axis Hierarchy The change of hierarchies selected for a characteristic impacts the universe structure and will require an update. hence any change to its definition will not affect the universe or document in any way Add / Change Axis Exception . hence any change to its definition will not affect the universe or document in any way Expand to a specific Hierarchy Level Conditions / Exceptions Add / Change Axis Condition Conditions are not exposed to the Universe and Web Intelligence documents. Update Universe in Web Intelligence To correctly update a Web Intelligence document. If the query panel does not automatically pick up the latest universe changes. It will force the new . go the query properties panel and select the same universe from the selection window. and added metadata. Objects deleted from the BEx query will be deleted from the Universe.How to update a Universe and Web Intelligence document ? Universe Structure Refresh wizard Universe Designer allows updates of an existing OLAP universe with a wizard accessible from View > Refresh Structure. you will need to edit the query and drag and drop the objects that need to be updated. respectively BEx query objects that have changed or added. The wizard will ask for a few options on what to do with updated metadata. single to multiple value) Restrict to a single value The BEx query is updated with a new characteristic restriction. which returns the right data (new filter is applied) without any error: Restrict to multiple values The BEx query is updated with a new characteristic restriction. In our example. the characteristic Country is filtered to the hierarchy node "ASIA_PAC". Detailed Use Cases Add / Change characteristics restriction (restrict to a single value. In our example. from there. . the characteristic Country is filtered to hierarchy nodes "ASIA_PAC" and "EUROPE".universe to be loaded and you will. The universe structure does not require any update: Nor does the Web Intelligence document. be able to apply the desired changes. . However the new object will not be available from the Query Panel until the Universe is refreshed.The universe structure does not require any update: Nor does the Web Intelligence document. A new class and dimension objects appear for that characteristic. Refresh the universe structure to add the Sales Person characteristic. which returns the right data (new filter is applied) without any error: Add Characteristic or Key Figure We are adding the Sales Person object as a free characteristic to the BEx query: Existing Web Intelligence documents refresh without error. Refreshing the universe structure will return the following information: . the added elements are available in the Query Panel: The same applies to key figures : they will appear as new measure objects in the universe. we can see that the Sales Person is no longer usable: The deleted object (Characteristic or Key Figure) is part of the Web Intelligence document Let's remove the key figure "Order Quantity". and will not be available to Web Intelligence documents until the universe structure is updated. Delete Characteristic or Key Figure The deleted object (Characteristic or Key Figure) is not part of the Web Intelligence document Let's remove the Sales Person object from the BEx query (this object is not used in the Web Intelligence report). And when editing the Web Intelligence document.Refreshing the Web Intelligence report refreshes fine. Refreshing the universe structure will remove the Sales Person objects: The Web Intelligence report refreshes fine (note the Sales Person object is not used in the report): And when editing the Web Intelligence report. as this change behaves in the rendering of the BEx query. Nothing is updated in the universe: .Refreshing the Web Intelligence report will turn into an error: An error is returned as well when editing the query: The Query Panel now displays the updated universe. and the query can be rebuilt accordingly: Change order for Characteristics or Key Figures Changing the order of objects in a BEx query does not require an update of the OLAP universe or the Web Intelligence reports. Refreshing the universe structure will remove multiple elements: . we are changing the hierarchy selected for a free characteristic : from "Country Hierarchy 01" to "Country Hierarchy 02". The universe must be refreshed for this change to be taken into account. Elements of the "Country" class are updated.Refreshing the Web Intelligence report works fine too without any universe update: Add / Change Hierarchy enabled for a Characteristic Change the value of the hierarchy In this scenario. Then. we are replacing the selected hierarchy "Country Hierarchy 02" by a hierarchy variable "Country Hierarchy Variable (RIG)". the Web Intelligence report refreshes fine: Change a hierarchy value by a hierarchy variable In this scenario. an error (likely WIS 00001) is returned: An error (likely WIJ 20004) is also returned when editing the query: Once you clicked OK on the error message. the Query Panel displays the updated universe and the query can be rebuilt accordingly When running the rebuilt query. the Hierarchy variable that will be called each time the Country hierarchy is invoked: The Web Intelligence report will not refresh immediately after the universe update.and also add a new filter. the user will get prompted by the hierarchy variable to pick a hierarchy: . Then. Moving object from the Rows/Columns sections into the Free Characteristic section is equivalent to changing the order of characteristics and essentially transparent to the universe and Web Intelligence.Move characteristics to/from Free Characteristic section Move characteristic to Free Characteristic section The addition of a new object (that is not initially part of the BEx query) is explained in the section above Add Characteristic. we change the definition of the Restricted Key Figure Gross Weight in kg Online Sales : . Moving the characteristic from the Free Characteristic section to the Rows or Columns section is equivalent to changing the order of characteristics and essentially transparent to the universe and Web Intelligence. Move characteristic from the Free Characteristic section Deletion of object from the Free Characteristic section is explained in the section belowDelete Characteristic or Key Figure. Change Restricted Key Figure or Calculated Key Figure definition We start with a Web Intelligence document that displays a calculated and restricted key figures. No universe or Web Intelligence document update is required. No universe or Web Intelligence document update is required. Change Structure (add / move / delete elements) Change order of the elements selected in the structure In this scenario. we are changing the order of elements selected in a structure. and observe the change is taken into account. without error.We can refresh the Web Intelligence document right away. hence is transparent to the Web Intelligence document and universe structure. . and observe the change is taken into account. The calculation formula is processed by BW in all cases. We can refresh the Web Intelligence document right away. There is no need to update the universe: The same is true for Calculated Key Figures. without error. There is no need to update the universe: Change the selection of the elements in the structure We are now changing the selection of elements. without error. There is no need to update the universe: Delete some elements from the structure We are now deleting elements from the structure. and observe the change is taken into account. We can refresh the Web Intelligence document right away. . Let's consider the characteristic (that you plan to apply a variable on) is not used in the Query of the Web Intelligence report Let's add a new characteristic in the BEx query and restrict it via a variable: Here is the updated BEx query: Refreshing the structure of the universe adds some new elements: . you will get the same behavior as the one that is described in the section "4. and observe the change is taken into account.We can refresh the Web Intelligence document right away. There is no need to update the universe: Add / Change Variable Add an optional characteristic variable If the characteristic (that you plan to apply a variable on) is used in the Query of the Web Intelligence report. without error.2 Change a hierarchy value by a hierarchy variable". mono. here is the rendered report: At the opposite. 'Product2\LovSelect a single product (optional)Base'.'A'. if the user selects a value.primary_key)"/> </CONDITION> </FILTER> </OPTIONAL> Note the <OPTIONAL> tag as it is an optional characteristic variable. if the user does not select any value.And here what we see in the universe: The definition of the Filter is: <OPTIONAL> <FILTER KEY="\[\!V000001\]"> <CONDITION OPERATORCONDITION="Equal"> <CONSTANT TECH_NAME="@Prompt('Select a single product (optional)'. The Web Intelligence report refreshes fine and the user is prompted to select a value: As the variable is optional. here is a sample result (corresponding to the selected value in the prompt): . when prompted. primary_key.\[0000001111\]'})"/> </CONDITION> </FILTER> </OPTIONAL> .mono.Add a default value to the optional characteristic variable The universe structure needs to be update: Here are the classes and condition objects in the updated universe: The definition of the updated Filter is: <OPTIONAL> <FILTER KEY="\[\!V000001\]"> <CONDITION OPERATORCONDITION="Equal"> <CONSTANT TECH_NAME="@Prompt('Select a single product (optional)'.. 'Product2\LovSelect a single product (optional)Base'.'A'.\{'1111':'\[Z_PRODUCT\]. 'A'. .When refreshing the Web Intelligence report. the user is prompted to select a value. and the default value is already selected: If the user does not choose any value. so that the rendered report is: Change Optional variable to Mandatory variable Let's change the Optional characteristic variable into Mandatory and let's keep the default value The universe structure needs to be updated: The definition of the Filter is now: <FILTER KEY="\[\!V000001\]"> <CONDITION OPERATORCONDITION="Equal"> <CONSTANT TECH_NAME="@Prompt('Select a single product (optional)'. the default value will be taken into account. Because there is no value selected by default (no default value). .mono.'Product2\LovSelect a single product (optional)Base'. \{'1111':'\[Z_PRODUCT\]..\[0000001111\]'})"/> </CONDITION> </FILTER> When refreshing the Web Intelligence report. Because there is a default value.primary_key)"/> </CONDITION> </FILTER> When refreshing the Web Intelligence report. this is similar to previous section.primary_key. Remove the Default value of the Mandatory variable The universe structure needs to be updated: Then the Filter definition is <FILTER KEY="\[\!V000001\]"> <CONDITION OPERATORCONDITION="Equal"> <CONSTANT TECH_NAME="@Prompt('Select a single product (optional)'. the user is prompted to choose a value.'Product2\LovSelect a single product (optional)Base'.mono.'A'. the user is prompted to select a value. the Run Query button is grayed out till a value is selected. 2 Change a hierarchy value by a hierarchy variable".primary_key)"/> </CONDITION> </FILTER> </OPTIONAL> The behavior then is the same as the one described in the "4.'Country\Lovselect a countryBase'.mono. The universe needs to be updated if the added hierarchy is applied on a characteristic that is part of the Web Intelligence report (an error is shown when refreshing the Web Intelligence report and the query needs to be rebuilt).'A'.Hierarchy Variable Let's use the following BEx query: Here is the definition of the Filter object that corresponds to the Hierarchy Variable: The definition of the Filter object is: <OPTIONAL> <FILTER KEY="\[\!V000002\]"> <CONDITION OPERATORCONDITION="Equal"> <CONSTANT TECH_NAME="@Prompt('select a country'. Hierarchy Node variable Let's replace the Hierarchy Variable by the same Hierarchy Variable coupled with a Hierarchy Node Variable: . You need to re-add the changed object (Node Level01 Country in the above example) and run the query: . Some new objects are added in the universe (hidden to the end user who creates or refreshes the Web Intelligence report).2 Change a hierarchy value by a hierarchy variable"). Obviously refreshing the Web Intelligence report fails (because the Filter is not the same and the Characteristic on which the hierarchy node variable is applied is not the same from SAP BusinessObjects point of view): Editing the query: The Query Panel now displays the updated universe.The Universe structure needs to be refreshed as the Filter definition changes with the 2 prompts (one corresponding to the Hierarchy Node Variable and a second one corresponding to the Hierarchy Variable). and the query can be rebuilt accordingly (same as "4. hence any change to its definition will not affect the universe or document in any way. This feature is only available in BEx and ignored in Web Intelligence. You can however implement the same functionality using filters in the Web Intelligence document. Add / Change Axis Condition Conditions are not exposed to the Universe and Web Intelligence document. either query filter or report filter. . Expand to a specific Hierarchy Level The Expand To a Hierarchy Level is not taken into account in any Web Intelligence report. This feature is only available in BEx and ignored in Web Intelligence.Add/Change BEx display Add / Change Axis Hierarchy The Axis Hierarchy is not taken into account in any Web Intelligence report. You can however implement the same functionality using Alerts in the Web Intelligence document. hence any change to its definition will not affect the universe or document in any way. *********** .Add / Change Axis Exception Exceptions are not exposed to the Universe and Web Intelligence document.