Sunday, November 13, 2011

Oracle SOA Suite 11g - Metadata Labels in the MDS Repository


Oracle SOA Suite 11g - Metadata Labels in the MDS Repository:

A metadata label is a means of selecting a particular version of each object from a metadata repository partition. Document versions belonging to a label are not deleted by automatic purging, unless the label is explicitly deleted. In this way, creating a label guarantees that a view of the metadata as it was at the time the label was created remains available until the label is deleted.

You can use a label to view the metadata as it was at the point in time when the label was created. You can use the commands to support logical backup and recovery of an application's metadata contained in the partition.

Labels are supported only in database-based repositories.

The following topics describe how to manage labels:


· Creating Metadata Labels
· Deleting Metadata Labels
· Listing Metadata Labels
· Promoting Metadata Labels

  1. Creating Metadata Labels


To create a label for a particular version of objects in a partition in an MDS Repository, you use the WLST command createMetadataLabel. For example, to create a label named prod1 for the application soa-infra, use the following command:

wls:/offline> connect ()
Please enter your username: weblogic
Please enter your password:
Please enter your server URL [t3://localhost:7001] :t3://soahost:soaport
Connecting to t3://nft-soa-vip1:8004 with userid weblogic...
Successfully connected to managed Server 'SOA1' that belongs to domain 'SOACoreDomain'.
wls:/SOACoreDomain/serverConfig> createMetadataLabel (application='soa-infra', server='SOA1', name='prod1')
Executing operation: createMetadataLabel.
Created metadata label "prod1".
wls:/SOACoreDomain/serverConfig>
If the application has more than one version, you must use the applicationVersion parameter to specify the version.

  1. Deleting Metadata Labels

To delete a metadata label, you use the WLST command deleteMetadataLabel. For example, to delete a label named prod1 for the application soa-infra use the following command:
deleteMetadataLabel (application='soa-infra', server='SOA1', name='prod1')
If the application has more than one version, you must use the applicationVersion parameter to specify the version.

  1. Listing Metadata Labels

You can list the metadata labels for a particular application. To do so, use the WLST command listMetadataLabel. For example, to list the labels for the application soa-infra, use the following command:
listMetadataLabels(application='soa-infra', server='SOA1')
If the application has more than one version, you must use the applicationVersion parameter to specify the version.

  1. Promoting Metadata Labels

You can promote documents associated with a metadata label so that they are now the last version. That is, you can promote them to the tip. Promote a label if you want to roll back to an earlier version of all of the documents captured by the label.
To promote a label to the tip, use the WLST command promoteMetadataLabel. For example to promote the label prod1, use the following command:
promoteMetadataLabel(application='soa-infra', server='SOA1', name='prod1')
If the application has more than one version, you must use the applicationVersion parameter to specify the version.


Saturday, November 12, 2011

Oracle SOA Suite - Utility for bulk import of Xref data.


Oracle SOA Suite - Utility for bulk import of Xref data:

In 10g, we had the xrefimport tool to bulk import the data from file to the XREF_DATA table but in Oracle SOA Suite 11g or Oracle SOA Suite 12c, there is no out of box solution to bulk import the data to XREF_DATA table.
We have implemented a utility to bulk import the data to XREF_DATA table and thought of sharing because it may help the people whoever looking for the utility.

The utility will generate the Xref data file (XREFData.LST) based on the data available in the staging table (XREF_STG) and using the java program the file contents are imported to XREF_DATA table.

The steps to import the bulk data:

1. Create the temporary table XREF_STG with the required cross reference columns (as per your requirement).
E.g.: To load cross reference data for ITEM_ No and ASSET_INT_ID


2. Insert all the records to the XREF_STG table (without generating the file using the script the sample file can be modified manually to import the data).

3.
Execute the below script sql script(xref_import.sql), this will generate the XREFData.LST file based on the data available in the XREF_STG table; Change the XREF table and the column names before executing the script.
/***************************************************************************
* This script will select records to insert into cross-reference table from XREF_STG table and * * *create the file XREFData.LST
*****************************************************************************/
SET HEADING OFF
SET PAGESIZE 0
SET LINESIZE 100
SET FEEDBACK OFF
SET TRIMSPOOL ON
SET TRIMOUT ON
SET SERVEROUTPUT ON
SPOOL XREFData
SELECT '<xref xmlns="http://xmlns.oracle.com/xref">',
'<table name="oramds:/apps/EAIMetaData/Xref/OM_ASSET_INT_ID_ITEM_NO.xref">',
'<columns>',
'<column name="ASSET_INT_ID"/>',
'<column name="ITEM_NO"/>',
'</columns>',
'<rows>'
FROM DUAL;
SELECT '<row><cell colName="ASSET_INT_ID">'||ASSET_INT_ID||
'</cell><cell colName="ITEM_NO">'||ITEMNO||'</cell></row>'
FROM XREF_STG;
SELECT '</rows>',
'</table>',
'</xref>'
FROM DUAL;
DELETE FROM XREF_STG
/
SPOOL OFF
commit
EXIT