Edit D:\app\Administrator\product\11.2.0\dbhome_1\olap\api\doc\doc-files\prevrel.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <title>New Features in Previous Releases (Oracle OLAP Java API Reference)</title>
  </head>

<table summary="" border="0" width="100%" cellpadding="1" cellspacing="0">
<tr>
<TD>
<TABLE summary="" BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
<td align="right" valign="top" rowspan="3"><em><b>Oracle&reg; OLAP Java API Reference<br>11<i>g</i> Release 2 (11.2)</b><br>E10794-01<br>Beta Draft</em></td>
</tr>
</table>

<h1>New Features in Previous Releases</h1>

<P>
This page contains descriptions of the features of the Oracle OLAP Java API that were new in previous releases of Oracle Database.

This release of the Oracle OLAP Java API does not contain any new features. What is new, however, is that the documentation for this release uses a different version of the Global sample schema. Also, all of the examples query an analytic workspace that is defined and built by an example program that uses the Oracle OLAP Analytic Workspace Java API.

<P>
The Global schema used by the example programs in this release has more tables than the Global schema used by the Oracle OLAP Java API documentation in earlier releases. The names of some of the columns in the tables are different, also.
The examples in this release use OLAP metadata objects that map to data in an analytic workspace. The examples in earlier releases of this documentation used OLAP Catalog metadata objects that map to columns in the tables of a relational schema.

<P>
Because the focus of the documentation for the 10.2.0.3 release is on defining, building, and querying analytic workspaces, the examples no longer include programs that use classes from the <CODE>oracle.olapi.metadata.mtm</CODE> package. The <CODE>mtm</CODE> classes map OLAP metadata objects to columns in relational tables or views. For an analytic workspace, that mapping is performed by classes in the Oracle OLAP Analytic Workspace Java API.

<hr>

<P>
The features of the Oracle OLAP Java API that are new in Oracle OLAP 10<I>g</I> Release 2 (10.2.0.2) are the following:
</P

<UL>
  <P><LI type="disc"><a href="#posPeriodsAgo">NumberSource.positionalPeriodsAgo</a></LI></P>
</UL>

<a  name="posPeriodsAgo"></a>
<h3>Introducing the NumberSource.positionalPeriodsAgo Method
</h3>

<P>
The <CODE>NumberSource.positionalPeriodsAgo(MdmLevelHierarchy hierarchy, MdmLevel offsetLevel, int offset)</CODE> method selects the elements of the <CODE>NumberSource</CODE> for an <CODE>MdmMeasure</CODE> at positions offset from the elements specified by members of a level of a hierarchy of a time dimension. This method is similar to the <CODE>lead</CODE> or <CODE>lag</CODE> methods, except that it does not expect that the time hierarchy is based on a Gregorian calendar.

<P>
If the value of the <CODE>offset</CODE> parameter is positive, then this method functions like the <CODE>lag</CODE> method. If the <CODE>offset</CODE> value is negative, then this method functions like the <CODE>lead</CODE> method.

<hr>

<P>
The new features of the Oracle OLAP Java API in Oracle OLAP 10<I>g</I> Release 2 (10.2.0.1) are the following:
</P

<UL>
  <P><LI type="disc"><a href="#custommember">Custom dimension members</a></LI></P>
  <P><LI type="disc"><a href="#model">Model objects</a></LI></P>
  <P><LI type="disc"><a href="#placeholder">Placeholder Source objects</a></LI></P>
  <P><LI type="disc"><a href="#xdpchar">Characteristics of an ExpressDataProvider</a></LI></P>
</UL>

<P>
For a list of the new classes in the OLAP Java API, see <a href="#newclasses">New OLAP Java API Classes</a>.
</P>

<P>
For a list of classes that have new methods, see <a href="#newmethods">Classes With New Methods</a>.
</P>

<P>
For a list of the new example programs in this release, see <a href="#exprog"> New Example Programs</a>.
</P>

<a  name="custommember"></a>
<h3>Introducing Custom Dimension Members
</h3>

<p>The Oracle OLAP Java API now supports the creation of custom dimension members, which are  virtual members that you can use in specifying a query. When you create a custom dimension member, you provide a <code>Source</code> that supplies a value for a measure or attribute that is dimensioned by the custom member. The value that the <CODE>Source</CODE> supplies can be the result of a calculation that uses the measure or attribute values specified by other dimension members.
</P>
<p>
Custom dimension members are instances of the classes that implement the new <code>MdmMember</code> interface. You can create a custom member for an <code>MdmStandardDimension</code>, an <code>MdmTimeDimension</code>, or an <code>MdmMeasureDimension</code>. To create a custom member, you use methods of an <CODE>MdmCustomObjectFactory</CODE> or convenience methods on the dimension objects.
</p>
<P>
In implementing custom dimension members, Oracle OLAP uses <CODE>Model</CODE> objects, which are another new feature of the API. A custom member has an associated <code>MdmModel</code>, which is an implementation of the <code>Model</code> interface. The <CODE>MdmModel</CODE> assigns the value specified by the custom member to the object dimensioned by the member.
</P>

<a  name="model"></a>
<h3>Introducing the OLAP Java API Model
</h3>

<p>An OLAP Java API <CODE>Model</CODE> represents a set of assignments that apply to a <code>Source</code>. An assignment specifies a value and a set of <CODE>Source</CODE> elements. An assignment of a <CODE>Model</CODE> is represented by an <CODE>Assignment</CODE> object. The set of <CODE>Source</CODE> elements for which the <CODE>Model</CODE> assigns a  value is represented by one or more <CODE>Qualification</CODE> objects.
</p>
<p>The <code>MdmModel</code> class and its subclasses implement the <code>Model</code> interface for <code>MdmObject</code> objects. The <code>CustomModel</code> class implements the interface for an object that you can explicitly create and that is not necessarily associated with an <code>MdmObject</code>.
</p>

<a  name="placeholder"></a>
<h3>Introducing the Placeholder Source
</h3>

<p>Because the calculations specified by the <code>Assignment</code> objects of a <code>Model</code> can apply to any <code>Source</code> that has the same inputs as the <code>Model</code>, the OLAP Java API requires a way to represent the <code>Source</code> to which Oracle OLAP is currently applying the <code>Model</code>. The role of representing the current dimensioned <code>Source</code> is taken by a placeholder <code>Source</code>, which is a new type of <code>Source</code>.
</p>
<p>The OLAP Java API has placeholder <code>Source</code> objects for the different data types. You get a placeholder <code>Source</code> by first getting a <code>FundamentalMetadataObject</code> object for a placeholder of a specific data type from your <code>FundamentalMetadataProvider</code>. You then call the <code>getSource</code> method of the <code>FundamentalMetadataObject</code>. 
</p>

<a  name="xdpchar"></a>
<h3>Specifying Characteristics of an ExpressDataProvider
</h3>
<P>
With new constructors of the <CODE>ExpressDataProvider</CODE> class, you can now specify certain characteristics when creating an <CODE>ExpressDataProvider</CODE>. By passing in a <CODE>java.util.Locale</CODE> object to a constructor, you create an <CODE>ExpressDataProvider</CODE> that provides the <CODE>String</CODE> objects of an analytic workspace in the language specified by a <CODE>Locale</CODE> object. By passing in a <CODE>java.util.Properties</CODE> object, you create an <CODE>ExpressDataProvider</CODE> that has the specified properties. For an explanation of those properties, see the description of the <CODE>ExpressDataProvider</CODE> class.
</P>

<a name="newclasses"></a>
<h3>New OLAP Java API Classes
</h3>

<p>This section describes the new classes in the OLAP Java API.
</p>

<h4>New Classes in the oracle.olap.data.source Package
</h4>
<p>The following table lists the new classes in the <code>oracle.olapi.data.source</code> package and provides brief descriptions of them.
</p>

<table class="Informal" title="New Classes in the oracle.olap.data.source Package" summary="This table lists the new classes in the oracle.olap.data.source package and includes brief descriptions of them." dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0">
  <thead>
    <tr align="left" valign="top">
      <th align="left" valign="bottom" id="r1c1_t2">Class</th>
      <th align="left" valign="bottom" id="r1c2_t2">Description</th>
    </tr>
  </thead>
  <tbody>
    <tr align="left" valign="top">
      <td align="left" headers="r1c1_t2"><code>Model</code></td>
      <td align="left" headers="r1c2_t2">An interface for an object that contains <code>Assignment</code> objects. This interface is implemented by the <code>MdmModel</code> and <code>CustomModel</code> classes.</td>
    </tr>
    <tr align="left" valign="top">
      <td align="left" headers="r1c1_t2"><code>CustomModel</code></td>
      <td align="left" headers="r1c2_t2">A <code>Model</code> that an application can explicitly create.</td>
    </tr>
    <tr align="left" valign="top">
      <td align="left" headers="r1c1_t2"><code>Assignment</code></td>
      <td align="left" headers="r1c2_t2">A class that contains one or more <code>Qualification</code> objects and a <code>Source</code> that Oracle OLAP uses to calculate a value to assign.</td>
    </tr>
    <tr align="left" valign="top">
      <td align="left" headers="r1c1_t2"><code>Qualification</code></td>
      <td align="left" headers="r1c2_t2">An abstract class that represents an element of a <code>Source</code> for an <code>Assignment</code> of a <code>Model</code>. A <code>Qualification</code> identifies the element of an input <code>Source</code> to which the <code>Assignment</code> applies.</td>
    </tr>
    <tr align="left" valign="top">
      <td align="left" headers="r1c1_t2"><code>LiteralQualification</code></td>
      <td align="left" headers="r1c2_t2">A concrete class that extends <code>Qualification</code> and that represents a literal value that identifies an element of an input <code>Source</code>, such as a member of a dimension.</td>
    </tr>
    <tr align="left" valign="top">
      <td align="left" headers="r1c1_t2"><code>ModelSolutionDefinition</code></td>
      <td align="left" headers="r1c2_t2">A <code>SourceDefinition</code> that has information about solving a <code>CustomModel</code>.</td>
    </tr>
    <tr align="left" valign="top">
      <td align="left" headers="r1c1_t2"><code>PlaceholderDefinition</code></td>
      <td align="left" headers="r1c2_t2">A <code>SourceDefinition</code> for a placeholder <code>Source</code>.</td>
    </tr>
  </tbody>
</table>

<h4>New Classes in the oracle.olap.metadata.mdm Package
</h4>
<p>The following table lists the new classes in the <code>oracle.olapi.metadata.mdm</code> package and provides brief descriptions of them.
</p>

<table class="Informal" title="New Classes in the oracle.olap.metadata.mdm Package" summary="This table lists the new classes in the oracle.olap.metadata.mdm package and includes brief descriptions of them." dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0">
  <thead>
    <tr align="left" valign="top">
      <th align="left" valign="bottom" id="r1c1_t3">Class</th>
      <th align="left" valign="bottom" id="r1c2_t3">Description</th>
    </tr>
  </thead>
  <tbody>
    <tr align="left" valign="top">
      <td align="left" headers="r1c1_t3"><code>MdmModel</code></td>
      <td align="left" headers="r1c2_t3">An abstract class that implements the <code>Model</code> interface for <code>MdmObject</code> objects.</td>
    </tr>
    <tr align="left" valign="top">
      <td align="left" headers="r1c1_t3"><code>MdmDimensionCalculationModel</code></td>
      <td align="left" headers="r1c2_t3">An <code>MdmModel</code> of a specific data type for an <code>MdmPrimaryDimension</code>.</td>
    </tr>
    <tr align="left" valign="top">
      <td align="left" headers="r1c1_t3"><code>MdmDimensionedObjectModel</code></td>
      <td align="left" headers="r1c2_t3">An abstract class that extends <code>MdmModel</code> for dimensioned objects.</td>
    </tr>
    <tr align="left" valign="top">
      <td align="left" headers="r1c1_t3"><code>MdmAttributeModel</code></td>
      <td align="left" headers="r1c2_t3">An <code>MdmDimensionedObjectModel</code> for <code>MdmAttribute</code> objects.</td>
    </tr>
    <tr align="left" valign="top">
      <td align="left" headers="r1c1_t3"><code>MdmMeasureModel</code></td>
      <td align="left" headers="r1c2_t3">An <code>MdmDimensionedObjectModel</code> for <code>MdmMeasure</code> objects.</td>
    </tr>
    <tr align="left" valign="top">
      <td align="left" headers="r1c1_t3"><code>MdmMember</code></td>
      <td align="left" headers="r1c2_t3">An interface for a custom dimension member.</td>
    </tr>
    <tr align="left" valign="top">
      <td align="left" headers="r1c1_t3"><code>MdmStandardMember</code></td>
      <td align="left" headers="r1c2_t3">An implementation of <code>MdmMember</code> for an <code>MdmStandardDimension</code>.</td>
    </tr>
    <tr align="left" valign="top">
      <td align="left" headers="r1c1_t3"><code>MdmTimeMember</code></td>
      <td align="left" headers="r1c2_t3">An implementation of <code>MdmMember</code> for an <code>MdmTimeDimension</code>.</td>
    </tr>
  </tbody>
</table>

<a name="newmethods"></a>
<h3>Classes With New Methods
</h3>

<p>The following classes in the <code>oracle.olapi.data.source</code> package have new factory or accessor methods related to an OLAP Java API <code>Model</code> or to custom dimension members.
</p>
<ul>
<li type="disc">
<p><code>ConstantListDefinition</code>
</p>
</li>
<li type="disc">
<p><code>DataProvider</code>
</p>
</li>
<li type="disc">
<p><code>FundamentalMetadataProvider</code>
</p>
</li>
<li type="disc">
<p><code>Source</code>
</p>
</li>
<li type="disc">
<p><code>SourceDefinition</code>
</p>
</li>
</ul>

<p>The following classes in the <code>oracle.olapi.metadata.mdm</code> package have new factory, accessor, or other methods related to an OLAP Java API <code>Model</code> or to custom dimension members.
</p>
<ul>
<li type="disc">
<p><code>Mdm10&#095;1&#095;0&#095;3&#095;NamingConvention</code>
</p>
</li>
<li type="disc">
<p><code>Mdm10&#095;1&#095;0&#095;3&#095;ObjectVisitor</code>
</p>
</li>
<li type="disc">
<p><code>MdmCustomObjectFactory</code>
</p>
</li>
<li type="disc">
<p><code>MdmMeasure</code>
</p>
</li>
<li type="disc">
<p><code>MdmMeasureDimension</code>
</p>
</li>
<li type="disc">
<p><code>MdmPrimaryDimension</code>
</p>
</li>
<li type="disc">
<p><code>MdmSource</code>
</p>
</li>
<li type="disc">
<p><code>MdmStandardDimension</code>
</p>
</li>
<li type="disc">
<p><code>MdmTimeDimension</code>
</p>
</li>
</ul>

<p>In the <code>oracle.express.olapi.data.full</code> package, the <CODE>ExpressDataProvider</CODE> class has new constructors and some of its <CODE>createCursorManager</CODE> methods take new input parameters. With these new features an application can specify a language for an analytic workspace, or specify other characteristics of the <CODE>ExpressDataProvider</CODE> or <CODE>CursorManager</CODE> objects, or both.
</p>

<a  name="exprog"></a>
<h3>New Example Programs
</h3>

<p>New example programs demonstrate the use of <code>Model</code> objects, custom dimension members, and placeholder <code>Source</code> objects. They contain the complete code for the examples that appear in <I>Oracle OLAP Developer's Guide to the OLAP API</I>.
</p>

<p>The new example programs are the following:
</p>
<ul>
<li type="disc">
<p><code>CreateCustomDimensionMember.java</code>
</p>
</li>
<li type="disc">
<p><code>CreateCustomMeasureDimensionMember.java</code>
</p>
</li>
<li type="disc">
<p><code>ImplementingExtractAsACustomModel.java</code>
</p>
</li>
<li type="disc">
<p><code>CreateDependentAssignment.java</code>
</p>
</li>
<li type="disc">
<p><code>CreateCustomMemberWithAggVal.java</code>
</p>
</li>
<li type="disc">
<p><code>CreateColorAttribute.java</code>
</p>
</li>
</ul>

</body>
</html>

Ms-Dos/Windows Unix Write backup

jsp File Browser version 1.2 by www.vonloesch.de