psdi.app.dpldasset.virtual

Class PromoteNode

java.lang.Object

psdi.mbo.Mbo

psdi.app.dpldasset.virtual.PromoteNode

All Implemented Interfaces:

java.rmi.Remote, PromoteSetAttributeFlags, PromoteNodeRemote, MboConstants, MboRemote, MaxRemoteProxy

public class PromoteNode
extends Mbo
implements PromoteNodeRemote, PromoteSetAttributeFlags

PromoteNode (PROMOTE object) is based on a view showing DPLDASSET values, but it also has non-peristent attributes showing

1. the asset a node is already linked to, if any,
2. the parent of that asset, and
3. the parent of the node in deployedasset.

The Mbo is acted upon by the PROMOTE escalation action and by the Promote to Assets dialog.

Attribute Name	Description
ASSETCLASS	Asset Class
ASSETNUM	Asset linked through reconciliation links
ASSETSITEID	Site of asset linked through reconciliation links
CLASSSTRUCTUREID	Classification for created assets
DESCRIPTION	Description
DOMAINNAME	Domain Name
DPLDSITEID	Site Id
GUID	Actual CI's GUID
ITEMNUM	Item number for created rotating assets
LOCATION	Location to which created assets will be assigned. Location of parent is used if parent is known.
NODEID	Node Id
NODENAME	Node Name
ORGID	Organization for created assets
PARENTASSETNUM	Asset linked through reconciliation links to parent node. This asset will be the parent of the promoted asset.
PARENTSITEID	Site of parent asset. If present, this site will be used for the promoted asset.
PROMOTECHILDREN	If checked, promote all child partitions along with these nodes, regardless of whether they were selected in the Computers list. This field will be enabled when children exist for the node.
SERIALNUMBER	Serial Number
SITEID	Site for created assets
STATUS	Initial status for created assets
HASH	The unique ID which is used to identify a partition from a discovery perspective. This field can be used by reconciliation to link and audit authorized partitions.
ISPROMOTED	Promoted?
PARENTID	Parent Node Id
PARTITION	If this is a partition?
PLATFORMBASE	Indicates if the computer is distributed or mainframe

Since:

7.2

Author:

James Pittard

See Also:

#PromoteValues

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	MSG_GROUP_PROMOTION
static MXLogger	PROMOTION_LOGGER

Fields inherited from class psdi.mbo.Mbo

MULTILANGCOPY, phantomList, phantomQueue

Fields inherited from interface psdi.app.dpldasset.virtual.PromoteNodeRemote

ASSET, CHILDREN, COMPUTERSYSTEM, DEFAULTS_NOERROR, DEPLOYEDASSET, PARENTASSET, STATUS_ALREADY_LINKED, STATUS_ALREADY_PROMOTED, STATUS_NEWLY_PROMOTED, STATUS_NOT_SET, STATUS_PROMOTION_ERROR

Fields inherited from interface psdi.mbo.MboConstants

ALLROWS, CHANGEDBY_USER, COUNT_ADDITIONS, COUNT_AFTERSAVE, COUNT_DATABASE, COUNT_DELETED, COUNT_EXISTING, DBCONFIG, DELAYVALIDATION, DELAYVALIDATIONONLY, DISCARDABLE, GOTCOMPLETEWHERE, HIDDEN, NO_RELATEDMBOS_OF_OWNERSCHILDREN_FETCH, NOACCESSCHECK, NOACTION, NOADD, NOCOMMIT, NODELETE, NONE, NOOVERWRITE, NOSAVE, NOSETVALUE, NOUPDATE, NOVALIDATION, NOVALIDATION_AND_NOACTION, NOVALIDATION_AND_NOACTION_ALLOWCROSSOVER, READONLY, REBUILD, REQUIRED, SAMEVALUEVALIDATION, SETBYPARENT, USER

Constructor Summary

Constructors

Constructor and Description
PromoteNode(MboSet ms) Constructor

Method Summary

Methods

Modifier and Type	Method and Description
void	addCreatedMemo() Update the memo for the asset creation transaction to reflect the fact that this asset was promoted.
void	assetLinkedSetReadOnlyAttr() If an authorized asset is already linked, then no promotion attributes can be set
void	clearClassification() Set classstructureid to null from Clear Classification in Classification menu.
DeployedAssetRemote	getDeployedAsset() Gets and caches computer linked through nodeid.
AssetRemote	getLinkedAsset() Gets and caches a reference to the asset linked through reconlinks.
AssetRemote	getLinkedParentAsset(boolean promoting) Gets and caches linked parent asset through reconlinks.
void	init() Set field flags.
int	promote(PromoteValuesRemote defaults, boolean topLevelSelection, boolean promotedByParent) Promote nodes and optionally their children using the default values passed.
void	setAttributeFlags()
int	setDefaults(PromoteValuesRemote defaults, boolean fromApplyDefaultsButton) For the promotion values section of the promotion dialog, set the defaults as allowed and needed.
void	setDeployedAsset(DeployedAssetRemote deployedAsset) Set computer reference and related field values and flags.
void	setLinkedAsset(AssetRemote assetMbo) Set asset reference and related field values and flags.
void	setLinkedParentAsset(AssetRemote assetMbo) Sets linked parent asset and associated field values and flags.
void	setPromotedTrue() Set the tloamispromoted flag to true on the related computer record.

Methods inherited from class psdi.mbo.Mbo

add, addMboSetForRequiredCheck, addToDeleteForInsertList, andEvaluateConditions, appValidate, blindCopy, canDelete, checkFieldAccess, checkMethodAccess, checkMethodAccess, checkQualifiedRestriction, checkSiteOrgAccessForSave, clear, copy, copy, copy, copyFake, copyValue, copyValue, createComm, delete, delete, determineRequiredFieldsFromERM, duplicate, enableMethod, evaluateCondition, evaluateCondition, evaluateCtrlConditions, evaluateCtrlConditions, evaluateRestriction, excludeObjectForPropagate, findAllNullRequiredFields, fireEvent, generateAutoKey, generateContentUID, getAlwaysFlags, getAttrRestrictionFlag, getAttrRestrictions, getBoolean, getByte, getBytes, getCheckpoint, getClientLocale, getClientTimeZone, getCommLogOwnerNameAndUniqueId, getCondition, getDatabaseValue, getDate, getDeleteForInsertList, getDocLinksCount, getDomainFilterWhere, getDomainIDs, getDouble, getExistingMboSet, getFetchIndex, getFieldExceptions, getFlags, getFloat, getIgnoreLockCheck, getInitialValue, getInsertCompanySetId, getInsertItemSetId, getInsertOrganization, getInsertSite, getInstanciatedMboSet, getInstanciatedMboValue, getInt, getIntegrationService, getKeyValue, getLanguageRecordRowStamp, getLinesRelationship, getList, getLockedByDisplayName, getLockedByUserID, getLong, getMatchingAttr, getMatchingAttr, getMatchingAttrs, getMaxMessage, getMboData, getMboDataSet, getMboForAttribute, getMboForAttributeStatic, getMboInitialValue, getMboList, getMboLogger, getMboRecordData, getMboServer, getMboSet, getMboSet, getMboSet, getMboSetInfo, getMboValue, getMboValueData, getMboValueData, getMboValueData, getMboValueInfoStatic, getMboValueInfoStatic, getMessage, getMessage, getMessage, getMessage, getMXTransaction, getName, getOrgForGL, getOrgSiteForMaxvar, getOwner, getProfile, getPropagateKeyFlag, getProxy, getRecordIdentifer, getRecordMboName, getRelatedWhere, getRelatedWhere, getRelationshipNameToLangTable, getRowRestrictionFlag, getRowStamp, getSecurityLogger, getSiteOrg, getSqlLogger, getString, getString, getStringInBaseLanguage, getStringInSpecificLocale, getStringTransparent, getSynonymValueWhere, getTenantId, getThisMboSet, getTranslator, getUniqueIdentifer, getUniqueIDName, getUniqueIDValue, getUserInfo, getUserName, getValidateOrder, hasFieldAccess, hasHierarchyLink, hasLockSaveRights, hasRelatedQbe, hasUniqueID, initFieldFlagsOnMbo, initRelationship, isAutoKeyed, isBasedOn, isChangeByUserWhenSetFromLookup, isEAuditFieldModified, isESigFieldModified, isFlagSet, isForDM, isLocked, isLocked, isLockedByMe, isMasterTenant, isMboLockedByMe, isModified, isModified, isNew, isNull, isOptionGranted, isSelected, isSkipCopyField, isValid, isZombie, lock, modify, moveFieldFlagsToMboValue, needCallInitFieldFlag, orEvaluateConditions, propagateKeyValue, removeRelatedSet, rollbackToCheckpoint, select, setAppDefaultValue, setApplicationError, setApplicationRequired, setAutokeyFields, setCopyDefaults, setDefaultValue, setDefaultValues, setDeleted, setEAuditFieldModified, setESigFieldModified, setFetchIndex, setFieldFlag, setFieldFlag, setFieldFlag, setFieldFlag, setFieldFlag, setFieldFlag, setFieldFlags, setFlag, setFlag, setFlags, setForDM, setHierarchyLink, setIgnoreRecordLockCheck, setLangCodeDefault, setMLValue, setModified, setNewMbo, setPropagateKeyFlag, setPropagateKeyFlag, setProxy, setReadonlyWhenParentIsReadonly, setReferencedMbo, setReferencedMbo, setUniqueIDValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValueFromSequence, setValueNull, setValueNull, sigopGranted, sigopGranted, sigopGranted, sigOptionAccessAuthorized, smartFill, smartFind, smartFind, smartFindByObjectName, smartFindByObjectName, smartFindByObjectNameDirect, startCheckpoint, thisToBeUpdated, toBeAdded, toBeDeleted, toBeSaved, toBeUpdated, toBeValidated, undelete, unlock, unselect, useDataSecurity, validate, validateAttributes, validateKeyUniqueness, valueChanged

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface psdi.mbo.MboRemote

add, addMboSetForRequiredCheck, addToDeleteForInsertList, blindCopy, checkMethodAccess, clear, copy, copy, copy, copyFake, copyValue, copyValue, createComm, delete, delete, duplicate, evaluateCondition, evaluateCtrlConditions, evaluateCtrlConditions, excludeObjectForPropagate, generateAutoKey, getBoolean, getByte, getBytes, getCommLogOwnerNameAndUniqueId, getDatabaseValue, getDate, getDeleteForInsertList, getDocLinksCount, getDomainIDs, getDouble, getExistingMboSet, getFlags, getFloat, getIgnoreLockCheck, getInitialValue, getInsertCompanySetId, getInsertItemSetId, getInsertOrganization, getInsertSite, getInt, getKeyValue, getLinesRelationship, getList, getLockedByDisplayName, getLong, getMatchingAttr, getMatchingAttr, getMatchingAttrs, getMaxMessage, getMboData, getMboDataSet, getMboInitialValue, getMboList, getMboSet, getMboSet, getMboSet, getMboValueData, getMboValueData, getMboValueData, getMboValueInfoStatic, getMboValueInfoStatic, getMessage, getMessage, getMessage, getMessage, getMXTransaction, getName, getOrgForGL, getOrgSiteForMaxvar, getOwner, getPropagateKeyFlag, getRecordIdentifer, getSiteOrg, getString, getString, getStringInBaseLanguage, getStringInSpecificLocale, getStringTransparent, getThisMboSet, getUniqueIDName, getUniqueIDValue, getUserInfo, getUserName, hasHierarchyLink, hasLockSaveRights, isAutoKeyed, isBasedOn, isFlagSet, isForDM, isLocked, isLocked, isMasterTenant, isMboLockedByMe, isModified, isModified, isNew, isNull, isOptionGranted, isSelected, isZombie, lock, propagateKeyValue, rollbackToCheckpoint, select, setApplicationError, setApplicationRequired, setAutokeyFields, setCopyDefaults, setDeleted, setESigFieldModified, setFieldFlag, setFieldFlag, setFieldFlag, setFieldFlag, setFieldFlag, setFieldFlag, setFieldFlags, setFlag, setFlag, setFlags, setForDM, setIgnoreRecordLockCheck, setMLValue, setModified, setNewMbo, setPropagateKeyFlag, setPropagateKeyFlag, setReferencedMbo, setReferencedMbo, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValueNull, setValueNull, sigopGranted, sigopGranted, sigopGranted, sigOptionAccessAuthorized, smartFill, smartFind, smartFind, smartFindByObjectName, smartFindByObjectName, smartFindByObjectNameDirect, startCheckpoint, thisToBeUpdated, toBeAdded, toBeDeleted, toBeSaved, toBeUpdated, toBeValidated, undelete, unlock, unselect, validate, validateAttributes

Field Detail

PROMOTION_LOGGER

public static MXLogger PROMOTION_LOGGER

MSG_GROUP_PROMOTION

public static final java.lang.String MSG_GROUP_PROMOTION

See Also:

Constant Field Values

Constructor Detail

PromoteNode

public PromoteNode(MboSet ms)
            throws MXException,
                   java.rmi.RemoteException

Constructor

Parameters:

ms - PromotionEscalation set

Throws:

MXException

java.rmi.RemoteException

Method Detail

init

public void init()
          throws MXException

Set field flags.

Overrides:

init in class Mbo

Throws:

MXException

promote

public int promote(PromoteValuesRemote defaults,
          boolean topLevelSelection,
          boolean promotedByParent)
            throws MXException,
                   java.rmi.RemoteException

Promote nodes and optionally their children using the default values passed. Does not promote nodes that have already been promoted or are already linked to assets.

Specified by:

promote in interface PromoteNodeRemote

Parameters:

defaults - the default values to apply

topLevelSelection - defect 31698 - make the promoted node aware if it is promoted directly, or as a result of the Promote Children flag

promotedByParent - - if this is a child which is promoted because the parent is promoted.

Returns:

int

Throws:

MXException

java.rmi.RemoteException

setPromotedTrue

public void setPromotedTrue()
                     throws java.rmi.RemoteException,
                            MXException

Set the tloamispromoted flag to true on the related computer record.

Throws:

java.rmi.RemoteException

MXException

getLinkedAsset

public AssetRemote getLinkedAsset()
                           throws java.rmi.RemoteException,
                                  MXException

Gets and caches a reference to the asset linked through reconlinks. Called from init.

Specified by:

getLinkedAsset in interface PromoteNodeRemote

Throws:

MXApplicationException - if there is no asset for reconlink

java.rmi.RemoteException

MXException

See Also:

setLinkedAsset(AssetRemote)

setLinkedAsset

public void setLinkedAsset(AssetRemote assetMbo)
                    throws java.rmi.RemoteException,
                           MXException

Set asset reference and related field values and flags.

Specified by:

setLinkedAsset in interface PromoteNodeRemote

Parameters:

assetMbo -

Throws:

java.rmi.RemoteException

MXException

setDeployedAsset

public void setDeployedAsset(DeployedAssetRemote deployedAsset)
                      throws java.rmi.RemoteException,
                             MXException

Set computer reference and related field values and flags.

Specified by:

setDeployedAsset in interface PromoteNodeRemote

Parameters:

assetMbo -

Throws:

java.rmi.RemoteException

MXException

setLinkedParentAsset

public void setLinkedParentAsset(AssetRemote assetMbo)
                          throws java.rmi.RemoteException,
                                 MXException

Sets linked parent asset and associated field values and flags.

Specified by:

setLinkedParentAsset in interface PromoteNodeRemote

Parameters:

assetMbo -

Throws:

java.rmi.RemoteException

MXException

getLinkedParentAsset

public AssetRemote getLinkedParentAsset(boolean promoting)
                                 throws java.rmi.RemoteException,
                                        MXException

Gets and caches linked parent asset through reconlinks. Link records may have been created by reconciliation process or by promotion.

Specified by:

getLinkedParentAsset in interface PromoteNodeRemote

Parameters:

promoting - true if there must be a parent of a child

Throws:

MXApplicationException - if parent node does not have a reconlink, or if reconlink does not refer to an asset.

java.rmi.RemoteException

MXException

getDeployedAsset

public DeployedAssetRemote getDeployedAsset()
                                     throws java.rmi.RemoteException,
                                            MXException

Gets and caches computer linked through nodeid.

Specified by:

getDeployedAsset in interface PromoteNodeRemote

Throws:

MXApplicationException - if computer cannot be found.

java.rmi.RemoteException

MXException

setDefaults

public int setDefaults(PromoteValuesRemote defaults,
              boolean fromApplyDefaultsButton)
                throws java.rmi.RemoteException,
                       MXException

For the promotion values section of the promotion dialog, set the defaults as allowed and needed.

Specified by:

setDefaults in interface PromoteNodeRemote

Parameters:

siteid - Name of site from Promotion Values

Throws:

java.rmi.RemoteException

MXException

addCreatedMemo

public void addCreatedMemo()
                    throws java.rmi.RemoteException,
                           MXException

Update the memo for the asset creation transaction to reflect the fact that this asset was promoted.

Specified by:

addCreatedMemo in interface PromoteNodeRemote

Throws:

java.rmi.RemoteException

MXException

clearClassification

public void clearClassification()
                         throws MXException

Set classstructureid to null from Clear Classification in Classification menu.

Throws:

MXException

setAttributeFlags

public void setAttributeFlags()
                       throws MXException,
                              java.rmi.RemoteException

Specified by:

setAttributeFlags in interface PromoteSetAttributeFlags

Throws:

MXException

java.rmi.RemoteException

assetLinkedSetReadOnlyAttr

public void assetLinkedSetReadOnlyAttr()
                                throws MXException,
                                       java.rmi.RemoteException

If an authorized asset is already linked, then no promotion attributes can be set

Throws:

MXException

java.rmi.RemoteException