Importing Activation Cartridges from SAR Files

A SAR file is one method for storing an ASAP configuration within a single artifact. Import cartridges from SAR files when you want to load into Design Studio cartridges that have been packaged in a SAR file. For example, when new Oracle Activation Network cartridge projects are available, they are packaged into a SAR file and posted to the portal in a zipped format (TAR file) for download. You can download the TAR file, then extract the SAR file from the TAR file.

Additionally, when you build a new Activation Service cartridge project, Design Studio generates a SAR file. When you have finished creating the service model, you can email the SAR file to another Design Studio user for import or check it into a source control system.

Note:

Importing activation cartridges from deployable archive (SAR) files using the Activation Archive Import Wizard creates an activation project that has only limited information compared to what was available when the cartridge was originally built. Oracle recommends that you distribute and deploy Design Studio Projects rather than SAR files.

If you want to make changes to activation cartridges that you imported from deployable archive (SAR) files using the Activation Archive Import Wizard, then you must also manually copy the build.xml file to the src/ directory.

To import a cartridge from a SAR file:

From the File menu, select Import.

The Import-Select dialog box appears.
Select Oracle Communications Design Studio Wizards, then select Activation Archive (SAR) and click Next.

The Activation Archive Import Wizard appears in both the cases.
In the Activation Archive Import Wizard, click Browse to search for a SAR file that contains the network cartridge you need to create your service cartridge.

After you select a SAR file, the fields in the wizard populate automatically for your cartridge.
Click Next.

Cartridge projects that were created in Design Studio populate the Cartridge Type field automatically with the correct type (this is a non-editable field).

Note:

For cartridge projects not created in Design Studio, you must select the type of cartridge project you are importing.
Click Next.

The names of the two data schema entities (one entity for simple data elements and one entity for data structures) to which all the atomic action parameters of this cartridge project are added appear.
(Optional) Select the location of the data schema entities.

Note:

The default location of the data schema entities for the cartridge project is the cartridge project that is being imported.
Click Finish to start the import.

A new Activation Service cartridge project appears in the Studio Projects view.

Note:

Before working with an imported cartridge project, see "Importing Activation Cartridge Projects" for more information about read-only statuses and working with sealed and unsealed cartridge projects.