com.hp.ucmdb.api.configuration
Interface ConfigurationService

public interface ConfigurationService

Infrastructure settings management.

Method Summary

java.util.Map<java.lang.String,ConfigParameter>	getAllConfigParameters(java.util.Locale locale, boolean displayableInUI) Returns all ConfigParameters.
ConfigParameter	getConfigParameter(java.lang.String parameterName, java.util.Locale locale) Returns the specified ConfigParameter.
java.lang.String	getConfigParameterValue(java.lang.String parameterName) Returns default value for specified ConfigParameter.
DefaultOwnerSetting	getDefaultOwnerCIPrototype() Returns the default owner CI prototype for UCMDB.
void	setConfigParameterDefaultValue(java.lang.String parameterName, java.lang.String value) Sets default value for the specified ConfigParameter.
void	setConfigParameterValue(java.lang.String parameterName, java.lang.String value) Sets value for specified ConfigParameter for the current customer.
void	setDefaultOwnerCIPrototype(CI defaultOwnerPrototype, java.lang.String ownershipRelationClassName, boolean linkFromOwnerToCI) Sets the default owner CI prototype for UCMDB.

Method Detail

getAllConfigParameters

java.util.Map<java.lang.String,ConfigParameter> getAllConfigParameters(java.util.Locale locale,
                                                                       boolean displayableInUI)

Returns all ConfigParameters.

Parameters:

locale - Locale for retrieving display values; if null, no localization applied

displayableInUI - if true only ConfigParameters with isDisplayInUI=true return, else all available ConfigParameters

Returns:

Map (ConfigParameter name -> ConfigParameter)

getConfigParameter

ConfigParameter getConfigParameter(java.lang.String parameterName,
                                   java.util.Locale locale)

Returns the specified ConfigParameter.

Parameters:

parameterName - ConfigParameter name

locale - Locale for retrieving display values; if null, no localization applied

Returns:

ConfigParameter

setConfigParameterDefaultValue

void setConfigParameterDefaultValue(java.lang.String parameterName,
                                    java.lang.String value)

Sets default value for the specified ConfigParameter. This value is used for all customers without explicitly defined values.

Parameters:

parameterName - ConfigParameter name

value - new default value

getConfigParameterValue

java.lang.String getConfigParameterValue(java.lang.String parameterName)

Returns default value for specified ConfigParameter.

Parameters:

parameterName - ConfigParameter name

Returns:

default value

setConfigParameterValue

void setConfigParameterValue(java.lang.String parameterName,
                             java.lang.String value)

Sets value for specified ConfigParameter for the current customer.

Parameters:

parameterName - ConfigParameter name

value - new value

setDefaultOwnerCIPrototype

void setDefaultOwnerCIPrototype(CI defaultOwnerPrototype,
                                java.lang.String ownershipRelationClassName,
                                boolean linkFromOwnerToCI)

Sets the default owner CI prototype for UCMDB.

This CI is used by various functions when an owner must be attached to another CI for identification purposes, but no such owner CI exists.

The given CI is a prototype that is used to either identify, create, or re-create the default owner CI for the next invocation of such functions. The current default owner is untouched unless the given CI is identified to the current owner CI.

Parameters:

defaultOwnerPrototype - the CI.

ownershipRelationClassName - the relation class name that will be used to create the relations between the default owner and the CIs.

linkFromOwnerToCI - true if the link should be created from the owner to the CI, false if it should be created in the other direction.

getDefaultOwnerCIPrototype

DefaultOwnerSetting getDefaultOwnerCIPrototype()

Returns the default owner CI prototype for UCMDB.

See setDefaultOwnerCIPrototype(com.hp.ucmdb.api.types.CI, java.lang.String, boolean) for details.

Some or all of the values in the DefaultOwnerSetting structure can be null or empty, according to the parameters saved in the UCMDB.

The default owner CI may or may not exist in the UCMDB, or it may exist but have a different UcmdbId. (It might have a different ID if it has been reconciled.) However, this prototype (if not null), can be used safely in data-in operations (TopologyUpdateService).