{"id":24344,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/getitemaudits-1\/"},"modified":"2025-02-17T12:03:57","modified_gmt":"2025-02-17T20:03:57","slug":"getitemaudits-1","status":"publish","type":"page","link":"https:\/\/docs.extraview.com\/v25\/extraview-25\/web-services-interface-1\/getitemaudits-1\/","title":{"rendered":"getItemAudits"},"content":{"rendered":"

The getItemAudits actionreturns all the changes to a filtered list of item records, from a specified point in time to the current time.<\/p>\n

\n\tInput<\/h3>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

Class<\/p>\n<\/td>\n

\n

Name<\/p>\n<\/td>\n

\n

Type<\/p>\n<\/td>\n

\n

Required<\/p>\n<\/td>\n

\n

Details<\/p>\n<\/td>\n<\/tr>\n

\n

ItemHistoryRequest<\/p>\n<\/td>\n

\n

userId<\/p>\n<\/td>\n

\n

String<\/p>\n<\/td>\n

\n

Yes<\/p>\n<\/td>\n

\n

The caller’s user ID<\/p>\n<\/td>\n<\/tr>\n

\n

ItemHistoryRequest<\/p>\n<\/td>\n

\n

password<\/p>\n<\/td>\n

\n

String<\/p>\n<\/td>\n

\n

Yes<\/p>\n<\/td>\n

\n

The caller’s password<\/p>\n<\/td>\n<\/tr>\n

\n

ItemHistoryRequest<\/p>\n<\/td>\n

\n

returnRawXML<\/p>\n<\/td>\n

\n

 <\/p>\n<\/td>\n

\n

 <\/p>\n<\/td>\n

\n

 <\/p>\n<\/td>\n<\/tr>\n

\n

ItemHistoryRequest<\/p>\n<\/td>\n

\n

startTimeSlice<\/p>\n<\/td>\n

\n

Date<\/p>\n<\/td>\n

\n

Yes<\/p>\n<\/td>\n

\n

The cutoff timestamp value is not included in the issues generated by this command; that is, the comparison is item timestamp is greater than cutoff timestamp<\/em><\/p>\n<\/td>\n<\/tr>\n

\n

ItemHistoryRequest<\/p>\n<\/td>\n

\n

endTimeSlice<\/p>\n<\/td>\n

\n

Date<\/p>\n<\/td>\n

\n

No<\/p>\n<\/td>\n

\n

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

\n

ItemHistoryRequest<\/p>\n<\/td>\n

\n

userNameMask<\/p>\n<\/td>\n

\n

String<\/p>\n<\/td>\n

\n

No<\/p>\n<\/td>\n

\n

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 stored in the behavior setting<\/p>\n<\/td>\n<\/tr>\n

\n

ItemHistoryRequest<\/p>\n<\/td>\n

\n

filters<\/p>\n<\/td>\n

\n

Array[]<\/p>\n<\/td>\n

\n

No<\/p>\n<\/td>\n

\n

List of filters for the history<\/p>\n<\/td>\n<\/tr>\n

\n

Field<\/p>\n<\/td>\n

\n

id<\/p>\n<\/td>\n

\n

boolean<\/p>\n<\/td>\n

\n

No<\/p>\n<\/td>\n

\n

 <\/p>\n<\/td>\n<\/tr>\n

\n

Field<\/p>\n<\/td>\n

\n

name<\/p>\n<\/td>\n

\n

boolean<\/p>\n<\/td>\n

\n

No<\/p>\n<\/td>\n

\n

 <\/p>\n<\/td>\n<\/tr>\n

\n

Field<\/p>\n<\/td>\n

\n

value<\/p>\n<\/td>\n

\n

boolean<\/p>\n<\/td>\n

\n

No<\/p>\n<\/td>\n

\n

 <\/p>\n<\/td>\n<\/tr>\n

\n

Field<\/p>\n<\/td>\n

\n

childOfFieldId<\/p>\n<\/td>\n

\n

boolean<\/p>\n<\/td>\n

\n

No<\/p>\n<\/td>\n

\n

 <\/p>\n<\/td>\n<\/tr>\n

\n

Field<\/p>\n<\/td>\n

\n

repeatingRowField<\/p>\n<\/td>\n

\n

boolean<\/p>\n<\/td>\n

\n

No<\/p>\n<\/td>\n

\n

 <\/p>\n<\/td>\n<\/tr>\n

\n

Field<\/p>\n<\/td>\n

\n

textAreaField<\/p>\n<\/td>\n

\n

boolean<\/p>\n<\/td>\n

\n

No<\/p>\n<\/td>\n

\n

 <\/p>\n<\/td>\n<\/tr>\n

\n

Field<\/p>\n<\/td>\n

\n

typeOfUserField<\/p>\n<\/td>\n

\n

boolean<\/p>\n<\/td>\n

\n

No<\/p>\n<\/td>\n

\n

 <\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

\n\tOutput<\/h3>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

Class<\/p>\n<\/td>\n

\n

Name<\/p>\n<\/td>\n

\n

Type<\/p>\n<\/td>\n

\n

Required<\/p>\n<\/td>\n

\n

Details<\/p>\n<\/td>\n<\/tr>\n

\n

ItemHistoryResponse<\/p>\n<\/td>\n

\n

success<\/p>\n<\/td>\n

\n

boolean<\/p>\n<\/td>\n

\n

Yes<\/p>\n<\/td>\n

\n

True is succeeded False if failed<\/p>\n<\/td>\n<\/tr>\n

\n

ItemHistoryResponse<\/p>\n<\/td>\n

\n

returnCode<\/p>\n<\/td>\n

\n

String<\/p>\n<\/td>\n

\n

No<\/p>\n<\/td>\n

\n

See Appendix for details<\/p>\n<\/td>\n<\/tr>\n

\n

ItemHistoryResponse<\/p>\n<\/td>\n

\n

returnMessage<\/p>\n<\/td>\n

\n

String<\/p>\n<\/td>\n

\n

No<\/p>\n<\/td>\n

\n

Human readable message<\/p>\n<\/td>\n<\/tr>\n

\n

ItemHistoryResponse<\/p>\n<\/td>\n

\n

xml<\/em><\/p>\n<\/td>\n

\n

String<\/p>\n<\/td>\n

\n

No<\/p>\n<\/td>\n

\n

The number of field records in the child array<\/p>\n<\/td>\n<\/tr>\n

\n

ItemHistoryResponse<\/p>\n<\/td>\n

\n

itemRecords<\/p>\n<\/td>\n

\n

Array[]<\/p>\n<\/td>\n

\n

Yes<\/p>\n<\/td>\n

\n

An array of itemRecords objects<\/p>\n<\/td>\n<\/tr>\n

\n

ItemRecord<\/p>\n<\/td>\n

\n

numberOfItemRecordFields<\/p>\n<\/td>\n

\n

int<\/p>\n<\/td>\n

\n

Yes<\/p>\n<\/td>\n

\n

The number of field records in the child array<\/p>\n<\/td>\n<\/tr>\n

\n

ItemRecord<\/p>\n<\/td>\n

\n

itemRecordFields<\/p>\n<\/td>\n

\n

Array[]<\/p>\n<\/td>\n

\n

Yes<\/p>\n<\/td>\n

\n

An array of ItemRecordField objects<\/p>\n<\/td>\n<\/tr>\n

\n

ItemRecordField<\/p>\n<\/td>\n

\n

fieldId<\/p>\n<\/td>\n

\n

String<\/p>\n<\/td>\n

\n

Yes<\/p>\n<\/td>\n

\n

The id of the field<\/p>\n<\/td>\n<\/tr>\n

\n

ItemRecordField<\/p>\n<\/td>\n

\n

fieldTitle<\/p>\n<\/td>\n

\n

String<\/p>\n<\/td>\n

\n

Yes<\/p>\n<\/td>\n

\n

The title of the field<\/p>\n<\/td>\n<\/tr>\n

\n

ItemRecordField<\/p>\n<\/td>\n

\n

fieldValue<\/p>\n<\/td>\n

\n

String<\/p>\n<\/td>\n

\n

Yes<\/p>\n<\/td>\n

\n

The value of the field<\/p>\n<\/td>\n<\/tr>\n

\n

ItemRecordField<\/p>\n<\/td>\n

\n

row<\/p>\n<\/td>\n

\n

boolean<\/p>\n<\/td>\n

\n

Yes<\/p>\n<\/td>\n

\n

The repeating row value<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

\n\tExample<\/h3>\n

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

The getItemAudits actionreturns all the changes to a filtered list of item records, from a specified point in time to the current time. Input Class Name Type Required Details ItemHistoryRequest userId String Yes The caller’s user ID ItemHistoryRequest password String Yes The caller’s password ItemHistoryRequest returnRawXML       ItemHistoryRequest startTimeSlice Date Yes The cutoff…<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":24321,"menu_order":37,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_lmt_disableupdate":"no","_lmt_disable":"","_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"class_list":["post-24344","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"\ngetItemAudits - Product Documentation<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/web-services-interface-1\/getitemaudits-1\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"getItemAudits - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"The getItemAudits actionreturns all the changes to a filtered list of item records, from a specified point in time to the current time. Input Class Name Type Required Details ItemHistoryRequest userId String Yes The caller’s user ID ItemHistoryRequest password String Yes The caller’s password ItemHistoryRequest returnRawXML       ItemHistoryRequest startTimeSlice Date Yes The cutoff...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/web-services-interface-1\/getitemaudits-1\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-02-17T20:03:57+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/web-services-interface-1\/getitemaudits-1\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/web-services-interface-1\/getitemaudits-1\/\",\"name\":\"getItemAudits - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\"},\"datePublished\":\"2024-02-15T22:53:34+00:00\",\"dateModified\":\"2025-02-17T20:03:57+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/web-services-interface-1\/getitemaudits-1\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.extraview.com\/v25\/extraview-25\/web-services-interface-1\/getitemaudits-1\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/web-services-interface-1\/getitemaudits-1\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/docs.extraview.com\/v25\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"ExtraView 25\",\"item\":\"https:\/\/docs.extraview.com\/v25\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Web Services Interface\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/web-services-interface-1\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"getItemAudits\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\",\"url\":\"https:\/\/docs.extraview.com\/v25\/\",\"name\":\"ExtraView Product Documentation\",\"description\":\"ExtraView Documentation\",\"publisher\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/docs.extraview.com\/v25\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#organization\",\"name\":\"ExtraView Corporation\",\"url\":\"https:\/\/docs.extraview.com\/v25\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"contentUrl\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"width\":512,\"height\":512,\"caption\":\"ExtraView Corporation\"},\"image\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"getItemAudits - Product Documentation","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/docs.extraview.com\/v25\/extraview-25\/web-services-interface-1\/getitemaudits-1\/","og_locale":"en_US","og_type":"article","og_title":"getItemAudits - Product Documentation","og_description":"The getItemAudits actionreturns all the changes to a filtered list of item records, from a specified point in time to the current time. Input Class Name Type Required Details ItemHistoryRequest userId String Yes The caller’s user ID ItemHistoryRequest password String Yes The caller’s password ItemHistoryRequest returnRawXML       ItemHistoryRequest startTimeSlice Date Yes The cutoff...","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/web-services-interface-1\/getitemaudits-1\/","og_site_name":"Product Documentation","article_modified_time":"2025-02-17T20:03:57+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/web-services-interface-1\/getitemaudits-1\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/web-services-interface-1\/getitemaudits-1\/","name":"getItemAudits - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v25\/#website"},"datePublished":"2024-02-15T22:53:34+00:00","dateModified":"2025-02-17T20:03:57+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/web-services-interface-1\/getitemaudits-1\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.extraview.com\/v25\/extraview-25\/web-services-interface-1\/getitemaudits-1\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/web-services-interface-1\/getitemaudits-1\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.extraview.com\/v25\/"},{"@type":"ListItem","position":2,"name":"ExtraView 25","item":"https:\/\/docs.extraview.com\/v25\/"},{"@type":"ListItem","position":3,"name":"Web Services Interface","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/web-services-interface-1\/"},{"@type":"ListItem","position":4,"name":"getItemAudits"}]},{"@type":"WebSite","@id":"https:\/\/docs.extraview.com\/v25\/#website","url":"https:\/\/docs.extraview.com\/v25\/","name":"ExtraView Product Documentation","description":"ExtraView Documentation","publisher":{"@id":"https:\/\/docs.extraview.com\/v25\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docs.extraview.com\/v25\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/docs.extraview.com\/v25\/#organization","name":"ExtraView Corporation","url":"https:\/\/docs.extraview.com\/v25\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/","url":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","contentUrl":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","width":512,"height":512,"caption":"ExtraView Corporation"},"image":{"@id":"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/"}}]}},"taxonomy_info":[],"featured_image_src_large":false,"author_info":{"display_name":"carl.koppel","author_link":"https:\/\/docs.extraview.com\/v25\/author\/carl-koppel\/"},"comment_info":0,"_links":{"self":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24344","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/comments?post=24344"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24344\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24321"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/media?parent=24344"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}