Configuration items enable you to create a hierarchy of items within a configuration.
To add configuration items:
In the Studio Projects view, double-click any entity configuration specification to open it in an entity Configuration Specification editor.
Click the Details tab.
In the Details tab data tree area, do one of the following:
Right-click a configuration item that will be the parent of the new configuration item in the hierarchy.
Right-click in the white space to add a configuration item at the top level.
Select Configuration Items, then select Add Item.
The Create Configuration Item dialog box appears.
Enter a name for the configuration item, then click OK.
The new configuration item appears in the Details tab data tree area.
Select the new configuration item.
On the Details tab Details subtab, select minimum and maximum quantities in the Multiplicity fields.
Set the Minimum field to a non-zero value to indicate that the configuration item is required in the configuration and that the specified number of items will be created automatically in UIM when an instance of the configuration is created.
See ”Details Tab” for more information about the fields on this subtab.
Add characteristics to the configuration item.
See "Adding Characteristics to Configuration Items" for more information.
Add specification options to the configuration item.
See "Adding Specification Options to Configuration Items" for more information.
From the File menu, select Save.
Characteristics enable you to add attributes to the configuration item.
Note:
When necessary, you can override the default values defined for a characteristic at the data schema level. The override applies only to the characteristic as it is used in a specific configuration specification. See "Overriding Default Values of Characteristics in Entity Specifications".When adding characteristics to configuration items, you can add existing characteristics or you can create new characteristics to add to the configuration item. See the following topics for more information:
To add existing characteristics to configuration items:
In the Solution view, double-click any entity configuration specification.
The entity Configuration Specification editor opens.
Click the Details tab.
In the Details tab data tree area, right-click a configuration item and select Select Characteristic.
The Select Characteristic dialog box appears. See "Select Characteristic Dialog Box" for more information.
Select a characteristic from the list and click OK.
The characteristic is added to the configuration item in the Details tab data tree.
From the File menu, select Save.
You can create new characteristics to add to a configuration item.
To add a new characteristic to configuration items:
In the Solution view, double-click any entity configuration specification.
The entity Configuration Specification editor opens.
Click the Details tab.
In the Details tab data tree area, right-click a configuration item and select Add Characteristic.
The Create Characteristic dialog box appears.
Select Create new element and then click Next
The Common Details dialog box appears. From this point, the procedure is the same as that for other simple data elements. See ”Creating New Simple Data Elements.”
Click Finish.
The characteristic is added to the configuration item in the Details tab data tree.
In the Details tab data tree, select the characteristic.
In the Details tab subtabs, define the attribute information for the characteristic.
See ”Design Studio Common Editor Tabs” for more information about the fields on these subtabs.
From the File menu, select Save.
Specification options enable UIM users to associate entities to configuration items. There are two kinds of specification options:
Assignments (or allocations) mean that a resource (such as a logical device or pipe) is consumed by the configuration.
References indicated the interest in or significance of an entity to the configuration. The entity is not consumed, but referenced.
In Design Studio, when you add specifications as reference or assignment options to a configuration item, entities based on the specification will be available for assignment or reference in UIM. The entities that are available to assign or reference depend on the specification type. For example, you can use a service configuration to assign telephone numbers, but you cannot use a network configuration to assign telephone numbers.
You can add existing specifications as specification options to configuration items or create new specifications in process of adding them. See the following topics for more information:
To add existing specifications to configuration items:
In the Solution view, double-click any entity configuration specification.
The entity configuration specification editor opens.
Click the Details tab.
In the Details tab data tree area, select a configuration item.
Click the Specification Options tab.
In the Item Option Type field, select an option type.
You can select Assignment or Reference. The default value is None. See "Configuration Specification Editor Specification Options Subtab" for more information.
Click Add.
The Specification Option dialog box appears.
Click Select.
The Selection Dialog dialog box appears.
Select a specification, then click OK.
The specification name appears in the Specification field of the Specification Option dialog box.
Click OK.
The entity specification appears in the Specification Options tab.
From the File menu, select Save.
Adding New Specification Options to Configuration Items
You can create new specification options to add to the configuration item.
To add a new specification option to configuration items:
In the Solution view, double-click any entity configuration specification.
The entity Configuration Specification editor opens.
In the Configuration area, select a configuration item.
Click the Specification Options tab.
In the Item Option Type field, select an option type.
You can select Assignment or Reference. The default value is None. See "Configuration Specification Editor Specification Options Subtab" for more information.
Click Add.
The Specification Option dialog box appears.
Click New.
The New Studio Entity dialog box appears. See ”Selecting Entity Types” for information about selecting entity types in the dialog box.
Select an entity type, then click Next.
The Entity Specification Wizard appears.
Create the new specification.
See "Creating New Specifications" for more information.
In the Specification Option dialog box, click OK.
From the File menu, select Save.
You can define ruleset extension points for the entire configuration. When adding rules to configurations, you can add existing rules or you can create new rules to add to the configuration. See the following topics for more information:
You can add existing rules to a configuration.
To add rules to a configuration:
In the Solution view, double-click any entity configuration specification.
The entity Configuration Specification editor opens.
Click the Rules tab.
Click Select.
The Selection Dialog dialog box appears, containing a list of available ruleset extension points.
Select a rule in the list.
Click OK.
The rule that you selected is displayed in the Ruleset Extension Point area.
You can create new rules to add to a configuration.
To add a new rule to a configuration:
In the Solution view, double-click any entity configuration specification.
The entity Configuration Specification editor opens.
Click the Rules tab.
Click Add.
The Ruleset Extension Point Wizard appears.
In the Project field, select the name of the project to which the new rule should be added.
In the Name field, enter a name for the new rule.
The name you enter appears in UIM.
(Optional) Select a location.
By default, Design Studio saves the entity to your default workspace location. You can enter a folder name in the Folder field or select a location different from the system-provided default. To select a different location:
Click the Folder field Browse button.
Navigate to the directory in which to save the entity.
Click OK.
Click Finish.
The rule that you added is displayed in the Ruleset Extension Point column.
Tags are keywords that you can use to categorize data elements and instances of entities. Tags help you filter and search for data elements that are associated with specific Oracle Communications applications. See ”Working with Tags” for more information.
You can create your own tags and associate your tags to configuration items that you add to Service, Place, Logical Device, Logical Device Account, and Network entity Configuration specifications. Associating tags with configuration items that you add to Configuration specifications enables UIM users to search for tags using the Tags Search page. At run time, the tag is visible (on the Configuration Summary page) for all instances of entities that were created from the Configuration specification. These tags are also visible in the getConfiguration and getConfigurationDifferences web service operations, which are included in the Service Fulfillment web service. The getConfiguration web service operation response contains the tag information from the request.
Note:
You cannot associate tags with configuration items that you add to Pipe Configuration specifications.To associate a tag with configuration items:
Create a new tag in a Model project.
When creating the new tag, complete the optional step to define the Build Directives attribute with the system-delivered Generate Inventory Runtime Tag tag. See ”Creating Tags” for more information.
Create a dependency between the Model project and the Design Studio for Inventory project in which you intent to save the Configuration specification.
See ”Managing Project Dependencies” for more information.
Open the Configuration Specification editor for the entity with which you want to associate the tag.
On the Details tab, select a configuration item.
Click the Tags tab.
Click Add.
A list of tags appears. The list includes all user-defined tags with a Build Directives attribute defined as Generate Inventory Runtime Tag.
Select a tag from the list and click OK.
The tag appears on the Tags tab and is now associated with the configuration item.
Deploy the Design Studio for Inventory Cartridge project to the run-time environment.
UIM users can search for tags using the Tags Search page. At run time, the tag is visible (on the Configuration Summary page) for all instances of entities that were created from the Configuration specification. See UIM Help for more information.