The following procedure describes how to create a conceptual model in Design Studio and implement it in a run-time environment.
Note:
Before implementing conceptual models, you must first:Generate the Common Model Base Data project into your workspace. See "Generating the Common Model Base Data Project" for more information.
Import any existing products. See "Importing Products" for more information.
Complete product-to-service mapping. See "Working with Mapping Rules" for more information.
When implementing conceptual models, you:
Create a Model project to contain the conceptual model.
See "Creating Model Projects" for more information.
Define a dependency between the Model project and the Common Model Base Data project.
See "Managing Project Dependencies" for more information.
Design the conceptual model.
See "Designing Conceptual Models" for more information.
Realize the conceptual model.
See "Realizing Conceptual Model Entities into Application Entities" for more information.
Synchronize the conceptual model entities and application entities throughout the design cycle.
See "Synchronizing Conceptual Model Entities with Application Entities" for more information.
Build and package the application projects that contain the realized application entities.
See "Building and Packaging Projects" for more information.
Deploy the application projects to a run-time environment.
See "Deploying Cartridge Projects" for more information.
To build a representation of a service domain in Design Studio, you must first generate the Common Model Base Data project. The Common Model Base Data project contains predefined rules and data for processing the entities and actions in your conceptual model, such as action codes, relationship rules, and entities that support conceptual modeling. This data is foundational to the conceptual model design required for service fulfillment solutions.
Note:
Only one Common Model Base Data project can exist in a single workspace.To generate the Common Model Base Data project:
In the Solution view, right-click and select Design Pattern.
The Design Pattern wizard appears.
Expand the Model Project folder.
Select Common Model Base Data, and click Next.
The Introduction page appears.
Read the information about the Common Model Base Data cartridge project, and click Next.
The Select Project Name page appears.
In the Base Project Name field, enter a name that begins with OracleComms_Model_.
The name that you enter here must include the prefix OracleComms_Model_.
Click Summary.
The Summary page appears.
Review the information on the Summary page and click Finish.
Design Studio creates a new project in the workspace. The project contains data and entities that you can use as a starting point for your conceptual model.
You import products into Design Studio when new products are added to your product catalog. See "About Importing Products from AIA Servers" for more information about importing products from an Application Integration Architecture (AIA) server.
To import products:
Define web service endpoints for the products that you must import.
See "Defining Web Service Endpoints" for more information.
In the Solution view, right-click and select Import, and then select Import Product.
The Import Product wizard appears.
From the Address URL list, select an endpoint.
(Optional) To include the parent specifications of the products you import, select Import Parent Product.
Click Add.
In the Product Name field, enter the name of the product to import.
Click Next.
(If prompted) Enter the user name and password required to access the web service endpoint and click OK.
See "Clearing Web Service Security Credentials" for information on resetting the web service credentials if needed during a Design Studio session.
The Product Import result page appears. This page includes a table that lists all of the products for import, the ID, and the status.
Deselect the Import check box for any products that you do not want to import.
In the Data Dictionary field, select the data schema into which you will add the product attributes.
In the Project field, select the project in which to include the product.
Click Finish.
Defining Web Service Endpoints
Clearing Web Service Security Credentials
A web service endpoint is a URL where files or services can be accessed by client applications. In Design Studio, you define web service endpoints to specify the web service IP address (or the fully qualified domain name) and port where your products are located. This information is required to import products.
To define the endpoints of web services for importing products:
From the Window menu, select Preferences, then select Oracle Design Studio, and then select Product Import Endpoints.
The Product Import Endpoints preference page appears.
In the Endpoints table, select New.
In the Name field, enter a descriptive name.
In the Endpoint field, enter the web service IP address (or the fully qualified domain name) and port where the product is located.
Select the Secure Web Service check box to require a user name and password for access.
See "Clearing Web Service Security Credentials" for more information.
Create additional endpoints for each web service that is to be called by the Product Import wizard.
Typically, one or two endpoints are defined.
Click Apply.
Click OK.
After you define the web service endpoints, you use them in the Import wizard when selecting which endpoint to use to import products.
When Design Studio calls the web service where your product is located, it may be required to pass credentials for web service security. You specify whether the web service requires credentials when you define the web service endpoint in the Product Import Endpoints preference page. See "Defining Web Service Endpoints" for more information.
If you specify that the endpoint supports security, users are prompted for a user name and password the first time the web service is called during a Design Studio session. The credentials are stored for the duration of the Design Studio session. If the credentials change during a session, you can clear and reset the credentials during the session.
To clear and reset web service security credentials during a Design Studio session:
From the Window menu, select Preferences, then select Oracle Design Studio, and then select Product Import Endpoints.
The Product Import Endpoints preference page appears.
Select the web service endpoint for which to clear credentials.
Click Clear Credentials.
The next time the Product Import wizard calls this web service endpoint, you will be prompted to re-enter the credentials.
You import products from Application Integration Architecture (AIA) servers using the same process as when you import products from other types of servers. See "Importing Products" for more information.
AIA servers, however, enable you to pass into Design Studio enriched metadata when this metadata is defined for a product or for data elements associated with a product. When you import products from AIA servers, Design Studio:
Displays languages defined for a product in the Product editor and supports language options in the Display Name and Description fields. See "Defining Language Preferences" for more information.
Displays product start date and end date information on the Product editor Properties tab, if that information is defined for the imported product. See "Product Editor Properties Tab" for more information.
Displays product version information in the Notes dialog box. See "Defining Entity Notes" for more information.
Note:
The documentation defined in the Notes dialog box is overwritten if you re-import the same product.Saves the version and start date information for data elements defined for a product on the Data Schema editor Notes tab. See "Notes Tab" for more information.
Saves the attribute definitions defined in the source system as data elements in the target data schema.Displays the product key on the Product editor Properties tab, if that information is defined for the imported product. The Key field value contains the product name that is defined in the source system.