Thor.API.Operations
Interface tcLookupOperationsIntf

public interface tcLookupOperationsIntf

Method Summary

void	addLookupCode(java.lang.String psLookupCode) Adds a new lookup code
void	addLookupValue(java.lang.String psLookupCode, java.lang.String psValue, java.lang.String psDescriptiveValue, java.lang.String psLanguage, java.lang.String psCountry) Adds a new entry for the specified lookup
java.lang.String	getDecodedValueForColumnEncodedValue(java.lang.String strEncodeVal, java.lang.String userRole) For given encoded coloumn value ,return decoded value
java.lang.String	getLookupCodeForColumn(java.lang.String psColumnCode) Gets the lookup code of the lookup assigned to the specified column/field
Thor.API.tcResultSet	getLookupValues(java.lang.String psLookupCode) Gets the lookup values of the specified lookup
Thor.API.tcResultSet	getLookupValues(java.lang.String psLookupCode, java.util.Map poFilters) Gets the lookup values of the specified lookup
Thor.API.tcResultSet	getLookupValuesForColumn(java.lang.String psColumnCode) Gets the lookup values of the lookup assigned to the specified column/field
Thor.API.tcResultSet	getLookupValuesForColumn(java.lang.String psColumnCode, java.util.Map poFilters) Gets the lookup values of the lookup assigned to the specified column/field
Thor.API.tcResultSet	getLookupValuesForColumn(java.lang.String psColumnCode, java.util.Map poFilters, long obiOrOrcKey) Gets the lookup values of the lookup assigned to the specified column/field
Thor.API.tcResultSet	getLookupValuesForColumn(java.lang.String psColumnCode, java.util.Map poFilters, long obiOrOrcKey, com.thortech.xl.vo.ProvisioningData provData) Gets the lookup values of the lookup assigned to the specified column/field
void	removeLookupCode(java.lang.String psLookupCode) Removes an existing lookup code This API also deletes all the lookup values associated with this code
void	removeLookupValue(java.lang.String psLookupCode, java.lang.String psValue) Removes an existing entry for the specified lookup
void	updateLookupCode(java.lang.String psLookupCode, java.util.Map phAttributeList) Updates an existing lookup code
void	updateLookupValue(java.lang.String psLookupCode, java.lang.String psExistingLookupValue, java.util.Map phAttributeList) Updates an existing lookup value for the specified lookup
void	updateLookupValue(java.lang.String psLookupCode, java.lang.String psExistingValue, java.lang.String psNewValue, java.lang.String psDescriptiveValue, java.lang.String psLanguage, java.lang.String psCountry) Updates an existing entry for the specified lookup

Method Detail

getLookupCodeForColumn

public java.lang.String getLookupCodeForColumn(java.lang.String psColumnCode)
                                        throws Thor.API.Exceptions.tcAPIException,
                                               Thor.API.Exceptions.tcInvalidColumnException,
                                               Thor.API.Exceptions.tcNoLookupException,
                                               tcAPIException

Gets the lookup code of the lookup assigned to the specified column/field

Parameters:

psColumnCode - The Code for the column

Returns:

The lookup code of the lookup attached to the column

Throws:

tcAPIException

tcInvalidColumnException - - thrown if the Column Code does not exist

tcNoLookupException - - thrown if the specified column does not have a lookup attached to it.

getLookupValuesForColumn

public Thor.API.tcResultSet getLookupValuesForColumn(java.lang.String psColumnCode)
                                              throws Thor.API.Exceptions.tcAPIException,
                                                     Thor.API.Exceptions.tcInvalidColumnException,
                                                     Thor.API.Exceptions.tcNoLookupException,
                                                     tcAPIException

Gets the lookup values of the lookup assigned to the specified column/field

Parameters:

psColumnCode - The Code for the column

Returns:

a resultset containing the values

Throws:

tcAPIException

tcInvalidColumnException - - thrown if the Column Code does not exist

tcNoLookupException - - thrown if the specified column does not have a lookup attached to it.

getLookupValuesForColumn

public Thor.API.tcResultSet getLookupValuesForColumn(java.lang.String psColumnCode,
                                                     java.util.Map poFilters)
                                              throws Thor.API.Exceptions.tcAPIException,
                                                     Thor.API.Exceptions.tcInvalidColumnException,
                                                     Thor.API.Exceptions.tcNoLookupException,
                                                     tcAPIException

Gets the lookup values of the lookup assigned to the specified column/field

Parameters:

psColumnCode - The Code for the column

poFilters - The filter name-value pair

Returns:

a resultset containing the values

Throws:

tcAPIException

tcInvalidColumnException - - thrown if the Column Code does not exist

tcNoLookupException - - thrown if the specified column does not have a lookup attached to it.

getLookupValuesForColumn

public Thor.API.tcResultSet getLookupValuesForColumn(java.lang.String psColumnCode,
                                                     java.util.Map poFilters,
                                                     long obiOrOrcKey,
                                                     com.thortech.xl.vo.ProvisioningData provData)
                                              throws Thor.API.Exceptions.tcAPIException,
                                                     Thor.API.Exceptions.tcInvalidColumnException,
                                                     Thor.API.Exceptions.tcNoLookupException,
                                                     tcAPIException

Gets the lookup values of the lookup assigned to the specified column/field

Parameters:

psColumnCode - The Code for the column

poFilters - The filter name-value pair

obiOrOrcKey - is the key of obi or orc depending of what type of form it is

provData - provisioning data value object representing the

Returns:

a resultset containing the values

Throws:

tcAPIException

tcInvalidColumnException - - thrown if the Column Code does not exist

tcNoLookupException - - thrown if the specified column does not have a lookup attached to it.

getLookupValuesForColumn

public Thor.API.tcResultSet getLookupValuesForColumn(java.lang.String psColumnCode,
                                                     java.util.Map poFilters,
                                                     long obiOrOrcKey)
                                              throws Thor.API.Exceptions.tcAPIException,
                                                     Thor.API.Exceptions.tcInvalidColumnException,
                                                     Thor.API.Exceptions.tcNoLookupException,
                                                     tcAPIException

Gets the lookup values of the lookup assigned to the specified column/field

Parameters:

psColumnCode - The Code for the column

poFilters - The filter name-value pair

obiOrOrcKey - is the key of obi or orc depending of what type of form it is

Returns:

a resultset containing the values

Throws:

tcAPIException

tcInvalidColumnException - - thrown if the Column Code does not exist

tcNoLookupException - - thrown if the specified column does not have a lookup attached to it.

getLookupValues

public Thor.API.tcResultSet getLookupValues(java.lang.String psLookupCode)
                                     throws Thor.API.Exceptions.tcAPIException,
                                            Thor.API.Exceptions.tcInvalidLookupException,
                                            tcAPIException

Gets the lookup values of the specified lookup

Parameters:

psLookupCode - The Code for the lookup definition

Returns:

a resultset containing the values and the descriptive values

Throws:

tcAPIException

tcInvalidLookupException - - thrown if the Lookup Code does not exist

getLookupValues

public Thor.API.tcResultSet getLookupValues(java.lang.String psLookupCode,
                                            java.util.Map poFilters)
                                     throws Thor.API.Exceptions.tcAPIException,
                                            Thor.API.Exceptions.tcInvalidLookupException,
                                            tcAPIException

Gets the lookup values of the specified lookup

Parameters:

psLookupCode - The Code for the lookup definition

poFilters - Key-value set

Returns:

a resultset containing the values and the descriptive values

Throws:

tcAPIException

tcInvalidLookupException - - thrown if the Lookup Code does not exist

addLookupValue

public void addLookupValue(java.lang.String psLookupCode,
                           java.lang.String psValue,
                           java.lang.String psDescriptiveValue,
                           java.lang.String psLanguage,
                           java.lang.String psCountry)
                    throws Thor.API.Exceptions.tcAPIException,
                           Thor.API.Exceptions.tcInvalidLookupException,
                           Thor.API.Exceptions.tcInvalidValueException,
                           tcAPIException

Adds a new entry for the specified lookup

Parameters:

psLookupCode - The Code for the lookup definition

psValue - The value that will be stored in the database

psDescriptiveValue - A descriptive version of the value to be added

psLanguage - The language for the entry being added. Leave blank to accept the default (en)

psCountry - The country for the specified entry. Leave blank to accept the default (US)

Throws:

tcAPIException

tcInvalidLookupException - - thrown if the Lookup Code does not exist

tcInvalidValueException - - thrown if the value cannot be added to the lookup (because it is a duplicate, etc)

removeLookupValue

public void removeLookupValue(java.lang.String psLookupCode,
                              java.lang.String psValue)
                       throws Thor.API.Exceptions.tcAPIException,
                              Thor.API.Exceptions.tcInvalidLookupException,
                              Thor.API.Exceptions.tcInvalidValueException,
                              tcAPIException

Removes an existing entry for the specified lookup

Parameters:

psLookupCode - The Code for the lookup definition

psValue - The value of the entry to be removed

Throws:

tcAPIException

tcInvalidLookupException - - thrown if the Lookup Code does not exist

tcInvalidValueException - - thrown if the value does not exist

updateLookupValue

public void updateLookupValue(java.lang.String psLookupCode,
                              java.lang.String psExistingValue,
                              java.lang.String psNewValue,
                              java.lang.String psDescriptiveValue,
                              java.lang.String psLanguage,
                              java.lang.String psCountry)
                       throws Thor.API.Exceptions.tcAPIException,
                              Thor.API.Exceptions.tcInvalidLookupException,
                              Thor.API.Exceptions.tcInvalidValueException,
                              tcAPIException

Updates an existing entry for the specified lookup

Parameters:

psLookupCode - The Code for the lookup definition

psExistingValue - The value that is to be updated

psNewValue - The new value to be set. Leave blank to leave unchanged.

psDescriptiveValue - The descriptive version of the value. Leave blank to leave unchanged.

psLanguage - The language for the entry being added. Leave blank to leave unchanged.

psCountry - The country for the specified entry. Leave blank to leave unchanged.

Throws:

tcAPIException

tcInvalidLookupException - - thrown if the Lookup Code does not exist

tcInvalidValueException - - thrown if the value does not exist

addLookupCode

public void addLookupCode(java.lang.String psLookupCode)
                   throws Thor.API.Exceptions.tcAPIException,
                          Thor.API.Exceptions.tcDuplicateLookupCodeException,
                          tcAPIException

Adds a new lookup code

Parameters:

psLookupCode - The Code for the lookup definition to be added This API can add only lookups of type 'lookup' and not of type 'field'

Throws:

tcAPIException - - thrown if errors occur while saving the lookup definition

tcDuplicateLookupCodeException - - thrown if the Lookup Code already exists

removeLookupCode

public void removeLookupCode(java.lang.String psLookupCode)
                      throws Thor.API.Exceptions.tcInvalidLookupException,
                             Thor.API.Exceptions.tcAPIException,
                             tcAPIException

Removes an existing lookup code This API also deletes all the lookup values associated with this code

Parameters:

psLookupCode - The lookup code to be removed

Throws:

tcInvalidLookupException - - thrown if the Lookup Code does not exist

tcAPIException - - thrown if errors occur while removing the lookup definition

updateLookupCode

public void updateLookupCode(java.lang.String psLookupCode,
                             java.util.Map phAttributeList)
                      throws Thor.API.Exceptions.tcInvalidLookupException,
                             Thor.API.Exceptions.tcInvalidAttributeException,
                             Thor.API.Exceptions.tcAPIException,
                             tcAPIException

Updates an existing lookup code

Parameters:

psLookupCode - The lookup code to be updated

phAttributeList - List of attributes attributes the given lookup code to be updated with

Throws:

tcInvalidLookupException - - thrown if the Lookup Code does not exist

tcInvalidAttributeException - - thrown if the one or many of the provided attributes do not exist

tcAPIException - - thrown if errors occur while updating the lookup definition

updateLookupValue

public void updateLookupValue(java.lang.String psLookupCode,
                              java.lang.String psExistingLookupValue,
                              java.util.Map phAttributeList)
                       throws Thor.API.Exceptions.tcAPIException,
                              Thor.API.Exceptions.tcInvalidLookupException,
                              Thor.API.Exceptions.tcInvalidAttributeException,
                              Thor.API.Exceptions.tcInvalidValueException,
                              tcAPIException

Updates an existing lookup value for the specified lookup

Parameters:

psLookupCode - The Code for the lookup definition

psExistingLookupValue - The value that is to be updated

phAttributeList - List of attributes the given lookup value to be updated with

Throws:

tcAPIException - - thrown if errors occur while updating the lookup values

tcInvalidLookupException - - thrown if the Lookup Code does not exist

tcInvalidAttributeException - - thrown if the one or many of the provided attributes do not exist

tcInvalidValueException - - thrown if the lookup value do not exist

getDecodedValueForColumnEncodedValue

public java.lang.String getDecodedValueForColumnEncodedValue(java.lang.String strEncodeVal,
                                                             java.lang.String userRole)
                                                      throws Thor.API.Exceptions.tcAPIException,
                                                             tcAPIException

For given encoded coloumn value ,return decoded value

Parameters:

strEncodeVal -

userRole -

Returns:

decoded value

Throws:

tcAPIException