You can import data from an external source into Design Studio workspace or load earlier versions of cartridge projects with legacy data definitions. This allows you to utilize the imported data or components and modify based on requirement.
When importing Activation cartridge projects into Design Studio, see the following topics:
The import functions are used to import data from an external source into your Design Studio workspace. For example, if you have purchased cartridges from Oracle, you can import them into Design Studio and reuse their components when you build Activation Service cartridges. Additionally, if an Activation Service cartridge has already been created by a coworker, you can obtain the configuration by importing it into your Design Studio workspace. Lastly, you can load data directly from an Oracle Communications ASAP environment. This approach is useful when you want to obtain a complete snapshot of all the data in an ASAP environment.
Design Studio for Activation supports loading of earlier versions of cartridge projects with legacy data definitions (that do not use the Data Dictionary). The legacy data definitions are migrated during import into a design time Data Dictionary that contains all of the data definitions within a single Data Dictionary file.
After importing an existing licensed cartridge, you will be prompted on where to store the Data Dictionary content for the cartridge. You can choose any one of the following locations:
The Activation project associated with the existing licensed cartridge.
A specified project (you may create a new project for the Data Dictionary or choose an existing project).
Note:
An existing Activation cartridge that is imported, modified, and exported using the latest version of Design Studio is importable in earlier versions of Design Studio. This allows modifications to legacy cartridges using the latest version of Design Studio.You can use the following methods to import data into your Design Studio workspace:
Import from a cartridge project. See "Importing Projects" for more information.
Import from a SAR file. See "Importing Activation Cartridges from SAR Files" for more information.
Import from an ASAP environment. See "Importing Cartridges from Environments" for more information.
You import Activation Network cartridges (from a location outside of your workspace) to set up your workspace. Cartridges can be imported in a zipped (zip or TAR files) or unzipped format.
Solution designers can import several network cartridges into the workspace to utilize their components (such as atomic actions, action processors, and NE templates) when setting up Activation Service cartridges. Solution designers can also import a suitable service cartridge as a starting point and modify it as needed.
Developers can import one or more network cartridges into their workspace (instead of building them from scratch) to use as starting point for creating new cartridges (for example, to make minor changes to cartridges for the next release) or to compare with other cartridges. See "Creating New Activation Cartridge Projects" for more information about creating new cartridges.
Note:
To import cartridges into your workspace, you can zip up cartridge projects in ZIP or TAR format and export them to an archive file. This method produces a snapshot of the entire workspace as originally created (including one or multiple environments and SAR file) and includes any custom artifacts.This method is useful when you have a project that contains a complex configuration with multiple dependencies between cartridges (for example, one or more Activation Service cartridges that depend on one or more Activation Network cartridges).
While it is possible to manually recreate the configuration by importing each of the SAR files from the original cartridges, some data loss may occur if you have custom artifacts that were not included in the original SAR file.
Note:
To obtain Activation Network cartridges from Oracle, you can retrieve individual SAR files from the portal and import them into Design Studio. Each cartridge is self-contained (no dependencies exist).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 cartridges 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, 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.To import a cartridge from a SAR file:
Select File, then select Import.
The Import-Select dialog box appears.
Select 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 suitable 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.
Cartridges that were created in Design Studio populate the Cartridge Type field automatically with the correct type (this is a non-editable field).
Note:
For cartridges not created in Design Studio, you must select the type of cartridge 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 are added appear.
(Optional) Select the location of the data schema entities.
Note:
The default location of the data schema entities for the cartridge 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, see "Importing Activation Cartridge Projects" for more information about read-only statuses and working with sealed and unsealed cartridges.If you have an existing ASAP implementation, you can point Design Studio at an ASAP environment and import the configuration (service model, JAR files, and network elements) contained in that environment. This feature eliminates the need to manually run scripts that extract data from an environment into a SAR file and import that SAR file into Design Studio.
You can use this feature to obtain a snapshot of an environment configured from multiple sources, such as insert scripts, XML, or multiple Design Studio instances. In this scenario, it is possible to load the service model and network element configuration into Design Studio directly from an ASAP environment.
Additionally, importing from an existing ASAP environment is useful when you have just begun using Design Studio as a service modeling tool and you have an existing ASAP implementation.
To import a cartridge from an environment:
Select Studio, then select Show Environment Perspective.
The Cartridge Management editor opens.
In the Environment view, select a Design Studio environment.
In the Cartridges area, click Query.
The Test Environment Connection dialog box appears.
Enter the Cartridge Management Web Services user name and password and click OK.
You are now connected to the environment on which ASAP is running. In the Cartridges area, the list of cartridges is refreshed.
Select a cartridge.
In the Deployed Versions area, the deployed versions of this cartridge are available.
Select a deployed version and click Import.
Click Finish.