com.waveset.object
Class LoadConfig

java.lang.Object
  extended bycom.waveset.object.PersistentObject
      extended bycom.waveset.object.LoadConfig
All Implemented Interfaces:
java.lang.Comparable, javax.naming.Referenceable, XmlObject

public class LoadConfig
extends PersistentObject

An object that encapsulates options for bulk loading.

Since there are many options to the loading process, it is convenient to encapsulate all of them into an object. This simplifes the argument list to the loading method, and also allows us to store option sets in the repository for repeated use.

Some options specifiy similar things, and will be interpreted using a certain priority.

Role Assignment

There are several ways for a role to be assigned. The loader will consult the following options in this order:

  1. If the "ignore role" flag is off, and there is a role in the load file, it will be used.
  2. If the "ignore role" flag is on, or there is no role in the load file the role rule is applied.
  3. If there is no role in the file, and the rule didn't find one, and there is a fixed role, use the fixed role.

Group Assignment

There are several ways for a group to be assigned. The loader will consult a set of options for group assignment similar to those for role assignment.


Nested Class Summary
 
Nested classes inherited from class com.waveset.object.PersistentObject
PersistentObject.Comparator, PersistentObject.InitialInstance
 
Field Summary
static java.lang.String ATT_CORRELATION
           
static java.lang.String ATT_CORRELATION_REQ
           
static java.lang.String ATT_ESTIMATED_ACCOUNTS
           
static java.lang.String ATT_EVENT
           
static java.lang.String ATT_EXTERNAL
           
static java.lang.String ATT_GENERATE_PASSWORDS
           
static java.lang.String ATT_IGNORE_GROUPS
           
static java.lang.String ATT_IGNORE_PASSWORDS
           
static java.lang.String ATT_IGNORE_ROLES
           
static java.lang.String ATT_INFILE
           
static java.lang.String ATT_LOGFILE
           
static java.lang.String ATT_MAX_ERRORS
           
static java.lang.String ATT_OUTFILE
           
static java.lang.String ATT_PREFIX
           
static java.lang.String ATT_PROVISION
           
static java.lang.String ATT_REPROVISION
           
static java.lang.String ATT_SOURCE
           
static java.lang.String ATT_TEST
           
static java.lang.String ATT_UPDATE_ATTRIBUTES
           
static java.lang.String ATT_UPDATE_EXISTING
           
static java.lang.String ATT_UPDATE_GROUPS
           
static java.lang.String ATT_UPDATE_ROLES
           
static java.lang.String code_id
           
static java.lang.String EL_CORKEYS
           
static java.lang.String EL_DEFAULT_PASSWORD
           
static java.lang.String EL_EVENT_RESOURCE
           
static java.lang.String EL_FIXED_GROUP
           
static java.lang.String EL_FIXED_ROLE
           
static java.lang.String EL_FORM_REF
           
static java.lang.String EL_GROUP_RULE
           
static java.lang.String EL_MERGE_ATTRIBUTES
           
static java.lang.String EL_ROLE_RULE
           
static java.lang.String EL_USER_ACCOUNT_CONFIRMATION_RULE
           
static java.lang.String EL_USER_NAME_GENERATION_RULE
           
 
Fields inherited from class com.waveset.object.PersistentObject
_trace, trace
 
Constructor Summary
LoadConfig()
          Build a new default load options object.
LoadConfig(org.w3c.dom.Element e)
          Build from an element.
LoadConfig(java.lang.String xml)
          Build a new default load options object.
 
Method Summary
protected  void addSubclassAttributes(java.lang.StringBuffer b)
          Each concrete subclass may append to the buffer an XML representation of any fields it adds to PersistentObject (if those field values must persist).
protected  void addSubclassElements(java.lang.StringBuffer b)
          Each concrete subclass may append to the buffer an XML representation of any fields it adds to PersistentObject (if those field values must persist).
 java.lang.String getAccountPrefix()
          Get the prefix that will be added to each account name during loading.
 Rule getConfirmationRule()
           
 ObjectRef getConfirmationRuleRef()
           
 java.lang.String getCorrelationKey()
          Get the correlation key.
 Rule getCorrelationRule()
           
 ObjectRef getCorrelationRuleRef()
           
 EncryptedData getDefaultPassword()
          Get the default password.
 boolean getDoProvision()
          Return true if resource account provisioning is to be performed after a new Waveset account has been created.
 int getEstimatedAccounts()
           
 Form getForm()
           
 ObjectRef getFormRef()
          Get the reference to the fixed group.
 ObjectGroup getGroup()
          Get the fixed group.
 ObjectRef getGroupRef()
          Get the reference to the fixed group.
 Rule getGroupRule()
          Resolve the reference to the group rule, and return the rule object.
 ObjectRef getGroupRuleRef()
          Get the reference to the group rule.
 java.lang.String getInFile()
          Get the name of the input exchange file.
 java.io.InputStream getInStream()
          Get the input stream.
 java.lang.String getLogFile()
          Get the name of the output log file.
 java.io.OutputStream getLogStream()
          Get the log output stream.
 int getMaxErrors()
          Return the maximum number of errors to be allowed during the load.
 java.util.ArrayList getMergeAttributes()
          Get the list of attributes that are to be merged.
 java.lang.String getOutFile()
          Get the name of the output object file.
 java.io.OutputStream getOutStream()
          Get the exception output stream.
 java.util.ArrayList getReferences()
          Return the list of references within this object.
 boolean getReProvision()
          Returns true if resource accounts are to be reprovisioned after an existing Waveset is encountered.
 Resource getResource()
          Get the resolved resource
 ObjectRef getResourceRef()
          Get the event load resource
 Role getRole()
          Get the fixed role.
 ObjectRef getRoleRef()
          Get the reference to the fixed role.
 Rule getRoleRule()
          Resolve the role rule reference, and return the rule object.
 ObjectRef getRoleRuleRef()
          Get the reference to the role rule.
 java.lang.String getSource()
          Get the name of the exchange file source.
 Type getType()
          Returns the associated Type object.
 Rule getUserAccountConfirmationRule()
           
 ObjectRef getUserAccountConfirmationRuleRef()
           
 Rule getUserNameGenerationRule()
           
 ObjectRef getUserNameGenerationRuleRef()
           
 boolean isCorrelationRequired()
          Get the correlation required flag.
 boolean isEventLoad()
          Test the event load flag
 boolean isExternalUsers()
          Get the external users flag.
 boolean isGeneratePasswords()
          Get the generate passwords flag.
 boolean isIgnoreGroups()
          Get the ignore groups flag.
 boolean isIgnorePasswords()
          Get the ignore passwords flag.
 boolean isIgnoreRoles()
          Get the ignore roles flag.
 boolean isTestMode()
          Get the test mode flag.
 boolean isUpdateAttributes()
          Get the update existing account flag.
 boolean isUpdateGroups()
          Get the update groups flag.
 boolean isUpdateRoles()
          Get the update roles flag.
static void main(java.lang.String[] args)
           
protected  void parseSubclassAttributes(org.w3c.dom.Element e)
          Each concrete subclass should parse from the XML buffer any persisted subclass-specific fields (generally, the same ones that it writes into the buffer).
protected  void parseSubclassElements(org.w3c.dom.Element e)
          Each concrete subclass should parse from the XML buffer any persisted subclass-specific elements (generally, the same ones that it writes into the buffer).
 void setAccountPrefix(java.lang.String s)
          Set the prefix that will be added to each account name during loading.
 void setConfirmationRule(Rule rule)
           
 void setConfirmationRuleRef(ObjectRef ref)
           
 void setCorrelationKey(java.lang.String s)
          Set the correlation key.
 void setCorrelationRequired(boolean b)
          Set the correlation required flag.
 void setCorrelationRule(Rule rule)
           
 void setCorrelationRuleRef(ObjectRef ref)
           
 void setDefaultPassword(EncryptedData ed)
          Set the default password string.
 void setDoProvision(boolean b)
          Sets the resource account provisioning option.
 void setEstimatedAccounts(int num)
           
 void setExternalUsers(boolean b)
          Set the external users flag.
 void setFormRef(ObjectRef ref)
          Get the reference to the fixed group.
 void setGeneratePasswords(boolean b)
          Set the generate passwords flag.
 void setGroup(ObjectGroup group)
          Set the fixed group.
 void setGroupRef(ObjectRef ref)
          Set the reference to the group.
 void setGroupRule(Rule rule)
          Set the group rule, specified as an object.
 void setGroupRule(java.lang.String name)
          Set the group rule, specified by name.
 void setGroupRuleRef(ObjectRef ref)
          Set the reference to the group rule.
 void setIgnoreGroups(boolean b)
          Set the ignore roles flag.
 void setIgnorePasswords(boolean b)
          Set the ignore passwords flag.
 void setIgnoreRoles(boolean b)
          Set the ignore roles flag.
 void setInFile(java.lang.String s)
          Set the name of the input exchange file.
 void setInStream(java.io.InputStream is)
          Set the input stream.
 void setLogFile(java.lang.String s)
          Set the name of the output log file.
 void setLogStream(java.io.OutputStream os)
          Set the log output stream.
 void setMaxErrors(int i)
          Specify the maximum number of errors to be allowed during the load.
 void setMergeAttributes(java.util.ArrayList l)
          Set the merge attributes list.
 void setOutFile(java.lang.String s)
          Set the name of the output object file.
 void setOutStream(java.io.OutputStream os)
          Set the exception output stream.
 void setReProvision(boolean b)
          Sets the resource account reprovisioning option.
 void setResourceRef(ObjectRef ref)
          Set the load resource
 void setRole(Role role)
          Set the fixed role.
 void setRoleRef(ObjectRef ref)
          Set the reference to the role.
 void setRoleRule(Rule rule)
          Set the role rule reference, given a rule object.
 void setRoleRule(java.lang.String name)
          Set the reference to the role rule by name.
 void setRoleRuleRef(ObjectRef ref)
          Set the reference to the role rule.
 void setSource(java.lang.String s)
          Set the name of the exchange file source.
 void setTestMode(boolean b)
          Set the test mode flag.
 void setUpdateAttributes(boolean b)
          Set the update existing account flag.
 void setUpdateGroups(boolean b)
          Set the update groups flag.
 void setUpdateRoles(boolean b)
          Set the update roles flag.
 void setUserAccountConfirmationRule(ObjectRef ref)
           
 void setUserAccountConfirmationRule(Rule rule)
           
 void setUserNameGenerationRule(ObjectRef ref)
           
 void setUserNameGenerationRule(Rule rule)
           
 
Methods inherited from class com.waveset.object.PersistentObject
addCommonElements, addEndTag, addMemberObjectGroup, addMemberObjectGroup, addPersistentAttributes, addStartTag, addSummaryAttributes, addXmlHeader, attributesMatch, attributesMatch, attributesMatch, checkReference, checkReferences, clearId, cloneAs, cloneObject, compareTo, create, create, create, create, createLastModItem, createLastModItem, createLastModItemList, directObjectGroupMember, dump, dumpFile, equals, fakeId, getAttribute, getAttributeValues, getAttributeValues, getAuthReferences, getAuthType, getBasicAttributes, getBasicAttributes, getBasicAttributes, getCache, getCounterValue, getCreateDate, getCreator, getDisplayableName, getDisplayName, getElementName, getEncryptedValues, getId, getIdOrName, getInitialInstances, getLastMod, getLastModDate, getLastModifier, getLastModItemId, getLockInfo, getMemberObjectGroupRefs, getMemberObjectGroupRefsUpTo, getMemberObjectGroups, getName, getNameOrId, getProperties, getProperty, getPropertyAsString, getPropertyList, getQueryableAttributes, getReference, getRuleDrivenMemberObjectGroupRefs, getRuleDrivenMemberObjectGroupRefsUpTo, getRuleDrivenMemberObjectGroups, getSubtype, getSummaryAttributes, getSummaryString, hasEncryptedData, hashCode, identityEquals, isAlias, isHidden, isId, isProtected, isProtectedFromDelete, isReferencedIn, listOperationalAttributes, listQueryableAttributes, listQueryableReferenceAttributes, listSummaryAttributes, objectGroupMember, objectGroupMemberRef, parseCommonElement, parseCommonElements, parsePersistentAttributes, parseXml, parseXml, prepareForSerialization, prepareToSerialize, println, reEncrypt, reEncryptSubclassAttributes, removeMemberObjectGroup, removeProperty, resolve, resolve, resolve, resolveArray, resolveArrayByFetching, resolveObjectReference, resolveObjectReferences, resolveReference, resolveSummaryAttributes, resolveSummaryAttributes, ruleDrivenObjectGroupMemberRef, setAuthType, setAuthType, setCache, setCreateDate, setCreator, setDisplayName, setDisplayName, setHidden, setIsAlias, setLastMod, setLastMod, setLastModDate, setLastModifier, setMemberObjectGroupRef, setMemberObjectGroupRefs, setMemberObjectGroups, setName, setProperties, setProperty, setPropertyList, setProtected, setProtectedFromDelete, setRuleDrivenMembersCache, setSubtype, setTrace, toString, toXml, toXml, toXml, toXmlFile, visit
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

code_id

public static final java.lang.String code_id
See Also:
Constant Field Values

ATT_INFILE

public static final java.lang.String ATT_INFILE
See Also:
Constant Field Values

ATT_LOGFILE

public static final java.lang.String ATT_LOGFILE
See Also:
Constant Field Values

ATT_OUTFILE

public static final java.lang.String ATT_OUTFILE
See Also:
Constant Field Values

ATT_SOURCE

public static final java.lang.String ATT_SOURCE
See Also:
Constant Field Values

ATT_CORRELATION

public static final java.lang.String ATT_CORRELATION
See Also:
Constant Field Values

ATT_PREFIX

public static final java.lang.String ATT_PREFIX
See Also:
Constant Field Values

ATT_PROVISION

public static final java.lang.String ATT_PROVISION
See Also:
Constant Field Values

ATT_REPROVISION

public static final java.lang.String ATT_REPROVISION
See Also:
Constant Field Values

ATT_EXTERNAL

public static final java.lang.String ATT_EXTERNAL
See Also:
Constant Field Values

ATT_IGNORE_PASSWORDS

public static final java.lang.String ATT_IGNORE_PASSWORDS
See Also:
Constant Field Values

ATT_GENERATE_PASSWORDS

public static final java.lang.String ATT_GENERATE_PASSWORDS
See Also:
Constant Field Values

ATT_IGNORE_ROLES

public static final java.lang.String ATT_IGNORE_ROLES
See Also:
Constant Field Values

ATT_IGNORE_GROUPS

public static final java.lang.String ATT_IGNORE_GROUPS
See Also:
Constant Field Values

ATT_CORRELATION_REQ

public static final java.lang.String ATT_CORRELATION_REQ
See Also:
Constant Field Values

ATT_UPDATE_EXISTING

public static final java.lang.String ATT_UPDATE_EXISTING
See Also:
Constant Field Values

ATT_UPDATE_ATTRIBUTES

public static final java.lang.String ATT_UPDATE_ATTRIBUTES
See Also:
Constant Field Values

ATT_TEST

public static final java.lang.String ATT_TEST
See Also:
Constant Field Values

ATT_MAX_ERRORS

public static final java.lang.String ATT_MAX_ERRORS
See Also:
Constant Field Values

ATT_UPDATE_GROUPS

public static final java.lang.String ATT_UPDATE_GROUPS
See Also:
Constant Field Values

ATT_UPDATE_ROLES

public static final java.lang.String ATT_UPDATE_ROLES
See Also:
Constant Field Values

ATT_EVENT

public static final java.lang.String ATT_EVENT
See Also:
Constant Field Values

ATT_ESTIMATED_ACCOUNTS

public static final java.lang.String ATT_ESTIMATED_ACCOUNTS
See Also:
Constant Field Values

EL_ROLE_RULE

public static final java.lang.String EL_ROLE_RULE
See Also:
Constant Field Values

EL_FIXED_ROLE

public static final java.lang.String EL_FIXED_ROLE
See Also:
Constant Field Values

EL_GROUP_RULE

public static final java.lang.String EL_GROUP_RULE
See Also:
Constant Field Values

EL_USER_NAME_GENERATION_RULE

public static final java.lang.String EL_USER_NAME_GENERATION_RULE
See Also:
Constant Field Values

EL_USER_ACCOUNT_CONFIRMATION_RULE

public static final java.lang.String EL_USER_ACCOUNT_CONFIRMATION_RULE
See Also:
Constant Field Values

EL_FIXED_GROUP

public static final java.lang.String EL_FIXED_GROUP
See Also:
Constant Field Values

EL_CORKEYS

public static final java.lang.String EL_CORKEYS
See Also:
Constant Field Values

EL_EVENT_RESOURCE

public static final java.lang.String EL_EVENT_RESOURCE
See Also:
Constant Field Values

EL_MERGE_ATTRIBUTES

public static final java.lang.String EL_MERGE_ATTRIBUTES
See Also:
Constant Field Values

EL_DEFAULT_PASSWORD

public static final java.lang.String EL_DEFAULT_PASSWORD
See Also:
Constant Field Values

EL_FORM_REF

public static final java.lang.String EL_FORM_REF
See Also:
Constant Field Values
Constructor Detail

LoadConfig

public LoadConfig()
Build a new default load options object.


LoadConfig

public LoadConfig(org.w3c.dom.Element e)
           throws WavesetException
Build from an element.


LoadConfig

public LoadConfig(java.lang.String xml)
           throws WavesetException
Build a new default load options object. Now that we're a PersistentObject, we don't need this.

Method Detail

setEstimatedAccounts

public void setEstimatedAccounts(int num)

getEstimatedAccounts

public int getEstimatedAccounts()

getType

public Type getType()
Returns the associated Type object.

Specified by:
getType in class PersistentObject

getReferences

public java.util.ArrayList getReferences()
Return the list of references within this object.

Overrides:
getReferences in class PersistentObject

getInFile

public java.lang.String getInFile()
Get the name of the input exchange file.


setInFile

public void setInFile(java.lang.String s)
Set the name of the input exchange file.


getInStream

public java.io.InputStream getInStream()
Get the input stream.


setInStream

public void setInStream(java.io.InputStream is)
Set the input stream. Overrides the input file name if both are specified.


getLogFile

public java.lang.String getLogFile()
Get the name of the output log file.


setLogFile

public void setLogFile(java.lang.String s)
Set the name of the output log file.


getLogStream

public java.io.OutputStream getLogStream()
Get the log output stream.


setLogStream

public void setLogStream(java.io.OutputStream os)
Set the log output stream. This overrides the log file name if both are specified.


getOutFile

public java.lang.String getOutFile()
Get the name of the output object file.

This file will be contain the XML representations of any objects in the input file that could not be processed.


setOutFile

public void setOutFile(java.lang.String s)
Set the name of the output object file.


getOutStream

public java.io.OutputStream getOutStream()
Get the exception output stream.


setOutStream

public void setOutStream(java.io.OutputStream os)
Set the exception output stream. This overrides the out file name if both are specified.


getSource

public java.lang.String getSource()
Get the name of the exchange file source.


setSource

public void setSource(java.lang.String s)
Set the name of the exchange file source.


getCorrelationKey

public java.lang.String getCorrelationKey()
Get the correlation key.


setCorrelationKey

public void setCorrelationKey(java.lang.String s)
Set the correlation key.


getAccountPrefix

public java.lang.String getAccountPrefix()
Get the prefix that will be added to each account name during loading.


setAccountPrefix

public void setAccountPrefix(java.lang.String s)
Set the prefix that will be added to each account name during loading.


getRoleRef

public ObjectRef getRoleRef()
Get the reference to the fixed role.


getRole

public Role getRole()
             throws WavesetException
Get the fixed role.

Throws:
WavesetException

setRoleRef

public void setRoleRef(ObjectRef ref)
Set the reference to the role.


setRole

public void setRole(Role role)
Set the fixed role.


getRoleRuleRef

public ObjectRef getRoleRuleRef()
Get the reference to the role rule.


setRoleRuleRef

public void setRoleRuleRef(ObjectRef ref)
Set the reference to the role rule.


setRoleRule

public void setRoleRule(java.lang.String name)
Set the reference to the role rule by name.


setRoleRule

public void setRoleRule(Rule rule)
Set the role rule reference, given a rule object.


getRoleRule

public Rule getRoleRule()
                 throws WavesetException
Resolve the role rule reference, and return the rule object.

Throws:
WavesetException

getGroupRef

public ObjectRef getGroupRef()
Get the reference to the fixed group.


getGroup

public ObjectGroup getGroup()
                     throws WavesetException
Get the fixed group.

Throws:
WavesetException

setGroupRef

public void setGroupRef(ObjectRef ref)
Set the reference to the group.


setGroup

public void setGroup(ObjectGroup group)
Set the fixed group.


getGroupRuleRef

public ObjectRef getGroupRuleRef()
Get the reference to the group rule.


setGroupRuleRef

public void setGroupRuleRef(ObjectRef ref)
Set the reference to the group rule.


setGroupRule

public void setGroupRule(java.lang.String name)
Set the group rule, specified by name.


setGroupRule

public void setGroupRule(Rule rule)
Set the group rule, specified as an object.


getGroupRule

public Rule getGroupRule()
                  throws WavesetException
Resolve the reference to the group rule, and return the rule object.

Throws:
WavesetException

getCorrelationRule

public Rule getCorrelationRule()
                        throws WavesetException
Throws:
WavesetException

getCorrelationRuleRef

public ObjectRef getCorrelationRuleRef()

setCorrelationRuleRef

public void setCorrelationRuleRef(ObjectRef ref)

setCorrelationRule

public void setCorrelationRule(Rule rule)

getUserNameGenerationRule

public Rule getUserNameGenerationRule()
                               throws WavesetException
Throws:
WavesetException

getUserNameGenerationRuleRef

public ObjectRef getUserNameGenerationRuleRef()

setUserNameGenerationRule

public void setUserNameGenerationRule(ObjectRef ref)

setUserNameGenerationRule

public void setUserNameGenerationRule(Rule rule)

getConfirmationRule

public Rule getConfirmationRule()
                         throws WavesetException
Throws:
WavesetException

getConfirmationRuleRef

public ObjectRef getConfirmationRuleRef()

setConfirmationRuleRef

public void setConfirmationRuleRef(ObjectRef ref)

setConfirmationRule

public void setConfirmationRule(Rule rule)

getUserAccountConfirmationRule

public Rule getUserAccountConfirmationRule()
                                    throws WavesetException
Throws:
WavesetException

getUserAccountConfirmationRuleRef

public ObjectRef getUserAccountConfirmationRuleRef()

setUserAccountConfirmationRule

public void setUserAccountConfirmationRule(ObjectRef ref)

setUserAccountConfirmationRule

public void setUserAccountConfirmationRule(Rule rule)

getDoProvision

public boolean getDoProvision()
Return true if resource account provisioning is to be performed after a new Waveset account has been created.


setDoProvision

public void setDoProvision(boolean b)
Sets the resource account provisioning option. If this is set to false, then no resource accounts will be provisioned after a new Waveset account has been created. Resource accounts may be provisioned later with the Session.reProvision method.

Note that this option affects the behavior of new account creation only. When the loader discovers an account that already exists, resource provisioning is controlled by an option specified with the setReProvosion method.

See Also:
setReProvision(boolean)

getReProvision

public boolean getReProvision()
Returns true if resource accounts are to be reprovisioned after an existing Waveset is encountered.


setReProvision

public void setReProvision(boolean b)
Sets the resource account reprovisioning option. If this is set to false, then no resource accounts will be reprovisioned after an existing Waveset account has been detected.

Note that this option affects the behavior of the loader when existing accounts are detected. Resource provisioning for new accounts is controlled by the option specified with the setDoProvosion method.

See Also:
setDoProvision(boolean)

getMaxErrors

public int getMaxErrors()
Return the maximum number of errors to be allowed during the load.


setMaxErrors

public void setMaxErrors(int i)
Specify the maximum number of errors to be allowed during the load. The load will abort if this count is exceeded. As errors are detected, the XML representation of the object being processed will be saved in the output object file.


isExternalUsers

public boolean isExternalUsers()
Get the external users flag.


setExternalUsers

public void setExternalUsers(boolean b)
Set the external users flag.

When set, the accounts created in Waveset will be marked as "external". When an account is marked external, Waveset will not attempt to update or remove any resource accounts that may currently exist, only the Waveset user account object will be updated.

This option is not currently used, and I forget the reason why it was there.


isCorrelationRequired

public boolean isCorrelationRequired()
Get the correlation required flag.


setCorrelationRequired

public void setCorrelationRequired(boolean b)
Set the correlation required flag.

When set, new accounts will never be created, we will only update existing accounts found through the correlation key.

This can be used if you suspect that the correlation keys are inaccurate, and want to avoid creating a bunch of "garabge" accounts that have to be deleted after the keys are fixed.

Any object that does not correlation to an existing account will be added to the output exchange file.


isUpdateAttributes

public boolean isUpdateAttributes()
Get the update existing account flag.


setUpdateAttributes

public void setUpdateAttributes(boolean b)
Set the update existing account flag.

When set, if we encounter an existing account during the load, we will modify all of its attributes to match those found in the loaded user object. Normally, existing account attributes are not modified.

This can be used to repair attributes that were loaded incorrectly the first time.


getMergeAttributes

public java.util.ArrayList getMergeAttributes()
Get the list of attributes that are to be merged.


setMergeAttributes

public void setMergeAttributes(java.util.ArrayList l)
Set the merge attributes list. The objects in the ArrayList should be a String. See _mergeAttributes definition for a description of this behavior


isUpdateGroups

public boolean isUpdateGroups()
Get the update groups flag.


setUpdateGroups

public void setUpdateGroups(boolean b)
Set the update groups flag.


isUpdateRoles

public boolean isUpdateRoles()
Get the update roles flag.


setUpdateRoles

public void setUpdateRoles(boolean b)
Set the update roles flag.


isIgnorePasswords

public boolean isIgnorePasswords()
Get the ignore passwords flag.


isGeneratePasswords

public boolean isGeneratePasswords()
Get the generate passwords flag.


getDefaultPassword

public EncryptedData getDefaultPassword()
Get the default password.


isIgnoreGroups

public boolean isIgnoreGroups()
Get the ignore groups flag.


isIgnoreRoles

public boolean isIgnoreRoles()
Get the ignore roles flag.


setIgnorePasswords

public void setIgnorePasswords(boolean b)
Set the ignore passwords flag.

When this option is true, passwords in the exchange file will be ignored, and a new password will be generated.

When the option is false, we will attempt to use the password as the waveset account password and password for the associated resources. If provisioning is enabled, account creation may fail if the password does not adhere to any policies specified in the resources.

Note that currently the password must be represented in the exchange in its unencrypted form, since we cannot know the encryption key that was used when the file was generated.


setGeneratePasswords

public void setGeneratePasswords(boolean b)
Set the generate passwords flag.


setDefaultPassword

public void setDefaultPassword(EncryptedData ed)
Set the default password string.


setIgnoreRoles

public void setIgnoreRoles(boolean b)
Set the ignore roles flag.


setIgnoreGroups

public void setIgnoreGroups(boolean b)
Set the ignore roles flag.


isTestMode

public boolean isTestMode()
Get the test mode flag.


setTestMode

public void setTestMode(boolean b)
Set the test mode flag.

This option will exercise most of the logic in the loading process, but will prevent the actual creation of Waveset accounts and provisioning of resource accounts. This might be used to perform a validation pass on the exchange file before modifying the repository.


isEventLoad

public boolean isEventLoad()
Test the event load flag


getResourceRef

public ObjectRef getResourceRef()
Get the event load resource


setResourceRef

public void setResourceRef(ObjectRef ref)
Set the load resource


getResource

public Resource getResource()
                     throws WavesetException
Get the resolved resource

Throws:
WavesetException

getFormRef

public ObjectRef getFormRef()
Get the reference to the fixed group.


setFormRef

public void setFormRef(ObjectRef ref)
Get the reference to the fixed group.


getForm

public Form getForm()
             throws WavesetException
Throws:
WavesetException

addSubclassAttributes

protected void addSubclassAttributes(java.lang.StringBuffer b)
Description copied from class: PersistentObject
Each concrete subclass may append to the buffer an XML representation of any fields it adds to PersistentObject (if those field values must persist). PersistentObject's default implementation is a no-op.

NOTE: Any subclass that overrides this method must similarly override parseSubclassAttributes() so that the subclass attributes are restored.

Overrides:
addSubclassAttributes in class PersistentObject
See Also:


addSubclassElements

protected void addSubclassElements(java.lang.StringBuffer b)
Description copied from class: PersistentObject
Each concrete subclass may append to the buffer an XML representation of any fields it adds to PersistentObject (if those field values must persist). PersistentObject's default implementation is a no-op.

NOTE: Any subclass that overrides this method must similarly override parseSubclassElements() so that the subclass elements are restored.

Overrides:
addSubclassElements in class PersistentObject
See Also:


parseSubclassAttributes

protected void parseSubclassAttributes(org.w3c.dom.Element e)
                                throws WavesetException
Description copied from class: PersistentObject
Each concrete subclass should parse from the XML buffer any persisted subclass-specific fields (generally, the same ones that it writes into the buffer).

Overrides:
parseSubclassAttributes in class PersistentObject
Throws:
WavesetException
See Also:

PersistentObject's default implementation is a no-op.

, PersistentObject.parseXml(Element)

parseSubclassElements

protected void parseSubclassElements(org.w3c.dom.Element e)
                              throws WavesetException
Description copied from class: PersistentObject
Each concrete subclass should parse from the XML buffer any persisted subclass-specific elements (generally, the same ones that it writes into the buffer).

Overrides:
parseSubclassElements in class PersistentObject
Throws:
WavesetException
See Also:

PersistentObject's default implementation is a no-op.

, PersistentObject.parseXml(Element)

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception
Throws:
java.lang.Exception