getChangedItems

The getChangedItems command returns all the changes to item records, from a specified point in time to the current time.

Input

Class

Name

Type

Required

Details

ItemHistoryRequest

userId

String

Yes

The callers user name

ItemHistoryRequest

password

String

Yes

The callers password

ItemHistoryRequest

returnRawXML

 

 

 

ItemHistoryRequest

startTimeSlice

Date

Yes

The cutoff timestamp value is not included in the issues generated by this command; that is, the comparison is "item timestamp is greater than the cutoff timestamp."

ItemHistoryRequest

endTimeSlice

Date

No

The endTimeSlice is optional. If it omitted, there is no constraint on the end of the cutoff period. If it provided, the value must be greater than the value of cutoff. This is used to limit the items for which history is generated.

ItemHistoryRequest

userNameMask

String

No

The optional userNameMask may be used to override the behavior setting named USERNAME_DISPLAY, for the duration of the execution of a single API call. This allows the developer to return the user names in a different format than the system-wide default.

ItemHistoryRequest

filters

Array []

No

List of filters for the history.

ItemHistoryRequest

startTimeSlice

Date

Yes

The cutoff timestamp value is not included in the issues generated by this command; that is, the comparison is "item timestamp is greater than the cutoff timestamp."

Field

id

String

Yes

 

Field

name

String

No

 

Field

value

String

No

 

Field

childOfFieldId

String

No

 

Field

repeatingRowField

boolean

No

 

Field

textAreaField

boolean

No

 

Field

typeOfUserField

boolean

No

 

Output

Class

Name

Type

Required

Details

ItemHistoryResponse

success

boolean

Yes

True is succeeded False if failed

ItemHistoryResponse

returnCode

String

No

See Appendix for details

ItemHistoryResponse

returnMessage

String

No

Human readable message

ItemHistoryResponse

xml

String

No

A list of AttachmentBeans

ItemHistoryResponse

itemRecords

Array []

No

The date the attachment was added to the item

ItemRecord

numberOfItemRecordFields

int

Yes

The number of field records in the child array

ItemRecord

numberOfItemRecordFields

int

Yes

An array of ItemRecordField objects

ItemRecordField

fieldId

String

Yes

The id of the field

ItemRecordField

fieldTitle

String

Yes

The title of the field

ItemRecordField

fieldValue

String

Yes

The value of the field

ItemRecordField

row

int

Yes

The repeating row value

Example

public static void testGetChangedItems(EVItemServiceStub stub) {
    try {
        GetChangedItemsDocument reqEnvelope = GetChangedItemsDocument.Factory.newInstance();
        ItemHistoryRequest request = reqEnvelope.addNewGetChangedItems().addNewRequest();
        Calendar startCal = new GregorianCalendar();
        startCal.add(Calendar.DATE, -30);
        // look back 30 days ago
        Calendar endCal = new GregorianCalendar();
        request.setUserId(ServiceClientHelper.ADMIN_USER_ID);
        request.setPassword(ServiceClientHelper.ADMIN_PASSWORD);
        request.setStartTimeSlice(startCal);
        request.setEndTimeSlice(endCal);
        request.setReturnRawXML(true);
        GetChangedItemsResponseDocument resEnvelope = stub.getChangedItems(reqEnvelope);
        ItemHistoryResponse response = resEnvelope.getGetChangedItemsResponse().getReturn();
        if (response.getSuccess()) {
            System.out.println("success: [" + response.getReturnCode() + "] : " +
                response.getReturnMessage());
            System.out.println("XML Report:n" + response.getXml());
            for (ItemRecord record: response.getItemRecordsArray()) {
                System.out.println(" ++++++++++++++ ");
                System.out.println(" + New Record + ");
                for (ItemRecordField field: record.getItemRecordFieldsArray()) {
                    System.out.println(" + New Field + ");
                    System.out.println(" - Field Id: " + field.getFieldId());
                    System.out.println(" - Value: " + field.getFieldValue());
                    System.out.println(" - Title: " + field.getFieldTitle());
                    System.out.println(" - Row: " + field.getRow());
                }
            }
        } else {
            System.out.println("failure: [" + response.getReturnCode() + "] : " +
                                              response.getReturnMessage());
        }
    } catch (Exception e) {
        e.printStackTrace();
        System.err.println("nnn");
    }
}