Primavera Integration API 7.0

com.primavera.integration.client.bo.object
Class ProjectBudgetChangeLog

java.lang.Object
  extended by com.primavera.integration.client.BOBase
      extended by com.primavera.integration.client.bo.BusinessObject
          extended by com.primavera.integration.client.bo.object.ProjectBudgetChangeLog

public class ProjectBudgetChangeLog
extends BusinessObject

The project budget change log is used to track changes made from the original budget. You can set the status of the change as pending, approve or not approved, assign a responsible person, and specify the amount of the change. The project budget change log applies to each WBS and project.

See Also:   Quick reference of ProjectBudgetChangeLog fields


Constructor Summary
ProjectBudgetChangeLog(Session session)
          Class constructor specifying the Session.
ProjectBudgetChangeLog(Session session, ObjectId objId)
          Class constructor specifying the Session and ObjectId of the object.
ProjectBudgetChangeLog(Session session, com.primavera.infr.db.PrmRowSet rowSet, int iIndex)
          Class constructor called internally after objects are retrieved from the server.
 
Method Summary
 ObjectId create()
          Creates this ProjectBudgetChangeLog object in the database.
static ObjectId[] create(Session session, ProjectBudgetChangeLog[] projectbudgetchangelogs)
          Creates multiple ProjectBudgetChangeLog objects in the database.
 void delete()
          Deletes this ProjectBudgetChangeLog object from the database.
static void delete(Session session, ProjectBudgetChangeLog[] projectbudgetchangelogs)
          Deletes multiple ProjectBudgetChangeLog objects from the database.
static java.lang.String[] getAllFields()
          Gets all fields for this business object.
 Cost getAmount()
          Gets the amount of budget change.
 java.lang.String getChangeNumber()
          Gets the change number that is automatically incremented according to when changes are added.
 java.util.Date getCreateDate()
          Gets the date this log of budget changes was created.
 java.lang.String getCreateUser()
          Gets the name of the user that created this log of budget changes.
 java.util.Date getDate()
          Gets the date of this budget change entry.
static java.lang.String[] getDefaultXMLExportFields()
          Gets the fields that are exported by the XML exporter when no fields are specified.
static java.lang.String[] getFilterableFields()
          Gets all fields that can be filtered.
static java.lang.String[] getInternalAllFields()
          An internal method that should not be called directly by client code.
static java.util.Set<java.lang.String> getInternalAllFieldsSet()
          An internal method that should not be called directly by client code.
static java.lang.String[] getInternalDefaultLoadFields()
          An internal method that should not be called directly by client code.
 boolean getIsBaseline()
          Gets the boolean value indicating if this business object is related to a Project or Baseline.
 java.util.Date getLastUpdateDate()
          Gets the date this log of budget changes was last updated.
 java.lang.String getLastUpdateUser()
          Gets the name of the user that last updated this log of budget changes.
static java.lang.String[] getMinimumXMLExportFields()
          Gets all fields that are always exported at a minimum by the new flat XML exporter
 ObjectId getObjectId()
          Gets the unique ID generated by the system.
 java.lang.String getProjectId()
          Gets the short code that uniquely identifies the project.
 ObjectId getProjectObjectId()
          Gets the unique ID of the associated project.
 java.lang.String getReason()
          Gets the description of the reason for the budget change request.
static java.lang.String[] getRequiredCreateFields()
          Gets all fields that must be set before calling create() on this business object.
 java.lang.String getResponsible()
          Gets the person responsible for the change.
 BudgetChangeStatus getStatus()
          Gets the status of this budget change request.
 java.lang.String getWBSCode()
          Gets the short code assigned to each WBS element for identification.
 java.lang.String getWBSName()
          Gets the name of the WBS element.
 ObjectId getWBSObjectId()
          Gets the unique ID of the WBS element to which the budget change log applies.
static java.lang.String[] getWritableFields()
          Gets all writable fields for this business object.
static ProjectBudgetChangeLog load(Session session, java.lang.String[] fields, ObjectId objId)
          Loads a single ProjectBudgetChangeLog object from the database.
static BOIterator<ProjectBudgetChangeLog> load(Session session, java.lang.String[] fields, ObjectId[] objIds)
          Loads multiple ProjectBudgetChangeLog objects from the database.
 Project loadProject(java.lang.String[] fields)
          Loads an associated Project object from the database.
 WBS loadWBS(java.lang.String[] fields)
          Loads an associated WBS object from the database.
 void setAmount(Cost c)
          Sets the amount of budget change.
 void setChangeNumber(java.lang.String s)
          Sets the change number that is automatically incremented according to when changes are added.
 void setDate(java.util.Date d)
          Sets the date of this budget change entry.
 void setObjectId(ObjectId o)
          Sets the unique ID generated by the system.
 void setProjectObjectId(ObjectId o)
          Sets the unique ID of the associated project.
 void setReason(java.lang.String s)
          Sets the description of the reason for the budget change request.
 void setResponsible(java.lang.String s)
          Sets the person responsible for the change.
 void setStatus(BudgetChangeStatus enm)
          Sets the status of this budget change request.
 void setWBSObjectId(ObjectId o)
          Sets the unique ID of the WBS element to which the budget change log applies.
 java.lang.String toString()
          Returns a string representation of the object.
 void update()
          Updates this ProjectBudgetChangeLog object in the database.
static void update(Session session, ProjectBudgetChangeLog[] projectbudgetchangelogs)
          Updates multiple ProjectBudgetChangeLog objects in the database.
 
Methods inherited from class com.primavera.integration.client.bo.BusinessObject
equals, hashCode, isNull, setNull
 
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

ProjectBudgetChangeLog

public ProjectBudgetChangeLog(Session session)
Class constructor specifying the Session. This constructor is most commonly used when create() is intended to be called on this object.

Parameters:
session - the Session

ProjectBudgetChangeLog

public ProjectBudgetChangeLog(Session session,
                              ObjectId objId)
                       throws BusinessObjectException
Class constructor specifying the Session and ObjectId of the object. This constructor is most commonly used when update() will be called on this object.

Parameters:
session - the Session
objId - the ObjectId
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

ProjectBudgetChangeLog

public ProjectBudgetChangeLog(Session session,
                              com.primavera.infr.db.PrmRowSet rowSet,
                              int iIndex)
                       throws BusinessObjectException
Class constructor called internally after objects are retrieved from the server. Client code should use one of the other constructors for this class.

Parameters:
session - the Session
rowSet - the PrmRowSet retrieved from the server
iIndex - the row index in the PrmRowSet associated with this business object
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects
Method Detail

create

public ObjectId create()
                throws ServerException,
                       NetworkException,
                       BusinessObjectException
Creates this ProjectBudgetChangeLog object in the database.

Returns:
ObjectId the unique ID of the newly created ProjectBudgetChangeLog object
Throws:
ServerException - if a problem occurred on the server-side
NetworkException - if a problem occurred in the network layer
BusinessObjectException - if a problem occurred in the client-side business objects

create

public static ObjectId[] create(Session session,
                                ProjectBudgetChangeLog[] projectbudgetchangelogs)
                         throws ServerException,
                                NetworkException,
                                BusinessObjectException
Creates multiple ProjectBudgetChangeLog objects in the database.

Parameters:
session - the Session object
projectbudgetchangelogs - array of ProjectBudgetChangeLog objects to create
Returns:
ObjectId[] the array of unique IDs of newly created ProjectBudgetChangeLog objects
Throws:
ServerException - if a problem occurred on the server-side
NetworkException - if a problem occurred in the network layer
BusinessObjectException - if a problem occurred in the client-side business objects

load

public static ProjectBudgetChangeLog load(Session session,
                                          java.lang.String[] fields,
                                          ObjectId objId)
                                   throws ServerException,
                                          NetworkException,
                                          BusinessObjectException
Loads a single ProjectBudgetChangeLog object from the database.

Parameters:
session - the Session object
fields - fields to load
objId - unique ID of the ProjectBudgetChangeLog object
Returns:
ProjectBudgetChangeLog the ProjectBudgetChangeLog object
Throws:
ServerException - if a problem occurred on the server-side
NetworkException - if a problem occurred in the network layer
BusinessObjectException - if a problem occurred in the client-side business objects

load

public static BOIterator<ProjectBudgetChangeLog> load(Session session,
                                                      java.lang.String[] fields,
                                                      ObjectId[] objIds)
                                               throws ServerException,
                                                      NetworkException,
                                                      BusinessObjectException
Loads multiple ProjectBudgetChangeLog objects from the database.

Parameters:
session - the Session object
fields - fields to load
objIds - object ids of the ProjectBudgetChangeLog objects
Returns:
BOIterator a business object iterator used to get the results of the load request
Throws:
ServerException - if a problem occurred on the server-side
NetworkException - if a problem occurred in the network layer
BusinessObjectException - if a problem occurred in the client-side business objects

update

public void update()
            throws ServerException,
                   NetworkException,
                   BusinessObjectException
Updates this ProjectBudgetChangeLog object in the database.

Overrides:
update in class BOBase
Throws:
ServerException - if a problem occurred on the server-side
NetworkException - if a problem occurred in the network layer
BusinessObjectException - if a problem occurred in the client-side business objects

update

public static void update(Session session,
                          ProjectBudgetChangeLog[] projectbudgetchangelogs)
                   throws ServerException,
                          NetworkException,
                          BusinessObjectException
Updates multiple ProjectBudgetChangeLog objects in the database.

Parameters:
session - the Session object
projectbudgetchangelogs - array of ProjectBudgetChangeLog objects to update
Throws:
ServerException - if a problem occurred on the server-side
NetworkException - if a problem occurred in the network layer
BusinessObjectException - if a problem occurred in the client-side business objects

delete

public void delete()
            throws ServerException,
                   NetworkException,
                   BusinessObjectException
Deletes this ProjectBudgetChangeLog object from the database.

Overrides:
delete in class BOBase
Throws:
ServerException - if a problem occurred on the server-side
NetworkException - if a problem occurred in the network layer
BusinessObjectException - if a problem occurred in the client-side business objects

delete

public static void delete(Session session,
                          ProjectBudgetChangeLog[] projectbudgetchangelogs)
                   throws ServerException,
                          NetworkException,
                          BusinessObjectException
Deletes multiple ProjectBudgetChangeLog objects from the database.

Parameters:
session - the Session object
projectbudgetchangelogs - array of ProjectBudgetChangeLog objects to delete
Throws:
ServerException - if a problem occurred on the server-side
NetworkException - if a problem occurred in the network layer
BusinessObjectException - if a problem occurred in the client-side business objects

loadProject

public Project loadProject(java.lang.String[] fields)
                    throws ServerException,
                           NetworkException,
                           BusinessObjectException
Loads an associated Project object from the database.

Parameters:
fields - fields to load
Returns:
Project the Project object
Throws:
ServerException - if a problem occurred on the server-side
NetworkException - if a problem occurred in the network layer
BusinessObjectException - if a problem occurred in the client-side business objects

loadWBS

public WBS loadWBS(java.lang.String[] fields)
            throws ServerException,
                   NetworkException,
                   BusinessObjectException
Loads an associated WBS object from the database.

Parameters:
fields - fields to load
Returns:
WBS the WBS object
Throws:
ServerException - if a problem occurred on the server-side
NetworkException - if a problem occurred in the network layer
BusinessObjectException - if a problem occurred in the client-side business objects

getResponsible

public java.lang.String getResponsible()
                                throws BusinessObjectException
Gets the person responsible for the change.

Returns:
the value in the field Responsible
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

setResponsible

public void setResponsible(java.lang.String s)
                    throws BusinessObjectException
Sets the person responsible for the change.

Parameters:
s - the value to set this field to
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

getAmount

public Cost getAmount()
               throws BusinessObjectException
Gets the amount of budget change.

Returns:
the value in the field Amount
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

setAmount

public void setAmount(Cost c)
               throws BusinessObjectException
Sets the amount of budget change.

Parameters:
c - the value to set this field to
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

getDate

public java.util.Date getDate()
                       throws BusinessObjectException
Gets the date of this budget change entry.

Returns:
the value in the field Date
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

setDate

public void setDate(java.util.Date d)
             throws BusinessObjectException
Sets the date of this budget change entry.

Parameters:
d - the value to set this field to
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

getReason

public java.lang.String getReason()
                           throws BusinessObjectException
Gets the description of the reason for the budget change request.

Returns:
the value in the field Reason
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

setReason

public void setReason(java.lang.String s)
               throws BusinessObjectException
Sets the description of the reason for the budget change request.

Parameters:
s - the value to set this field to
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

getChangeNumber

public java.lang.String getChangeNumber()
                                 throws BusinessObjectException
Gets the change number that is automatically incremented according to when changes are added. This can be changed to any number. This field must contain a valid value in order to create this type of business object in the database.

Returns:
the value in the field ChangeNumber
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

setChangeNumber

public void setChangeNumber(java.lang.String s)
                     throws BusinessObjectException
Sets the change number that is automatically incremented according to when changes are added. This can be changed to any number. This field must contain a valid value in order to create this type of business object in the database.

Parameters:
s - the value to set this field to
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

getStatus

public BudgetChangeStatus getStatus()
                             throws BusinessObjectException
Gets the status of this budget change request. Possible values are 'Pending', 'Approved', and 'Not Approved'.

Returns:
the value in the field Status
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

setStatus

public void setStatus(BudgetChangeStatus enm)
               throws BusinessObjectException
Sets the status of this budget change request. Possible values are 'Pending', 'Approved', and 'Not Approved'.

Parameters:
enm - the value to set this field to
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

getObjectId

public ObjectId getObjectId()
                     throws BusinessObjectException
Gets the unique ID generated by the system.

Overrides:
getObjectId in class BusinessObject
Returns:
the value in the field ObjectId
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

setObjectId

public void setObjectId(ObjectId o)
                 throws BusinessObjectException
Sets the unique ID generated by the system.

Overrides:
setObjectId in class BusinessObject
Parameters:
o - the value to set this field to
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

getProjectObjectId

public ObjectId getProjectObjectId()
                            throws BusinessObjectException
Gets the unique ID of the associated project. This field is automatically loaded by default whenever this type of business object is loaded from the database.

Returns:
the value in the field ProjectObjectId
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

setProjectObjectId

public void setProjectObjectId(ObjectId o)
                        throws BusinessObjectException
Sets the unique ID of the associated project. This field is automatically loaded by default whenever this type of business object is loaded from the database.

Parameters:
o - the value to set this field to
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

getWBSObjectId

public ObjectId getWBSObjectId()
                        throws BusinessObjectException
Gets the unique ID of the WBS element to which the budget change log applies. This field is automatically loaded by default whenever this type of business object is loaded from the database. This field must contain a valid value in order to create this type of business object in the database.

Returns:
the value in the field WBSObjectId
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

setWBSObjectId

public void setWBSObjectId(ObjectId o)
                    throws BusinessObjectException
Sets the unique ID of the WBS element to which the budget change log applies. This field is automatically loaded by default whenever this type of business object is loaded from the database. This field must contain a valid value in order to create this type of business object in the database.

Parameters:
o - the value to set this field to
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

getProjectId

public java.lang.String getProjectId()
                              throws BusinessObjectException
Gets the short code that uniquely identifies the project.

Returns:
the value in the field ProjectId
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

getWBSCode

public java.lang.String getWBSCode()
                            throws BusinessObjectException
Gets the short code assigned to each WBS element for identification. Each WBS element is uniquely identified by concatenating its own code together with its parents' codes.

Returns:
the value in the field WBSCode
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

getWBSName

public java.lang.String getWBSName()
                            throws BusinessObjectException
Gets the name of the WBS element.

Returns:
the value in the field WBSName
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

getCreateDate

public java.util.Date getCreateDate()
                             throws BusinessObjectException
Gets the date this log of budget changes was created.

Returns:
the value in the field CreateDate
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

getLastUpdateDate

public java.util.Date getLastUpdateDate()
                                 throws BusinessObjectException
Gets the date this log of budget changes was last updated.

Returns:
the value in the field LastUpdateDate
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

getCreateUser

public java.lang.String getCreateUser()
                               throws BusinessObjectException
Gets the name of the user that created this log of budget changes.

Returns:
the value in the field CreateUser
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

getLastUpdateUser

public java.lang.String getLastUpdateUser()
                                   throws BusinessObjectException
Gets the name of the user that last updated this log of budget changes.

Returns:
the value in the field LastUpdateUser
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

getIsBaseline

public boolean getIsBaseline()
                      throws BusinessObjectException
Gets the boolean value indicating if this business object is related to a Project or Baseline.

Returns:
the value in the field IsBaseline
Throws:
BusinessObjectException - if a problem occurred in the client-side business objects

getRequiredCreateFields

public static java.lang.String[] getRequiredCreateFields()
Gets all fields that must be set before calling create() on this business object. Generally the array will contain one field in each position, but if this business object requires either one field or another field to be set, both of those fields will appear in an element of the returned array separated by '|'. For example, if this business object requires field A to always be set, and field B or field C to be set, one element in the returned array will contain A, and one element will contain B|C.

Returns:
String[] an array of required create fields

getFilterableFields

public static java.lang.String[] getFilterableFields()
Gets all fields that can be filtered.

Returns:
String[] an array of filterable fields

getInternalDefaultLoadFields

public static java.lang.String[] getInternalDefaultLoadFields()
An internal method that should not be called directly by client code.

Returns:
String[] an internal array

getAllFields

public static java.lang.String[] getAllFields()
Gets all fields for this business object.

Returns:
String[] an array of all fields

getInternalAllFields

public static java.lang.String[] getInternalAllFields()
An internal method that should not be called directly by client code.

Returns:
String[] an internal array

getInternalAllFieldsSet

public static java.util.Set<java.lang.String> getInternalAllFieldsSet()
An internal method that should not be called directly by client code.

Returns:
String[] an internal array

getWritableFields

public static java.lang.String[] getWritableFields()
Gets all writable fields for this business object.

Returns:
String[] an array of writable fields

getDefaultXMLExportFields

public static java.lang.String[] getDefaultXMLExportFields()
Gets the fields that are exported by the XML exporter when no fields are specified.

Returns:
String[] an array of field names

getMinimumXMLExportFields

public static java.lang.String[] getMinimumXMLExportFields()
Gets all fields that are always exported at a minimum by the new flat XML exporter

Returns:
String[] an array of exported fields

toString

public java.lang.String toString()
Returns a string representation of the object. The output is in XML.

Overrides:
toString in class java.lang.Object
Returns:
String a string representation of the object.

Primavera Integration API 7.0

Copyright © 2003, 2009, Oracle and/or its affiliates. All rights reserved.