AgileApps Support Wiki Pre Release

Difference between revisions of "History object"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Line 35: Line 35:
| Related To || related_to || <tt>{object_id}:{record_id}</tt>
| Related To || related_to || <tt>{object_id}:{record_id}</tt>


|- <!-- SPACER ROW -->
|-  
| colspan="3" bgcolor="lightblue" style="height:6px" |
| colspan="3" bgcolor="lightblue" style="height:6px" | <!-- SPACER ROW -->
|-
|-
|  || ||  
History Created By || history_created_by || For an incoming email, the history record's created_by field has the system ID. This field records the ID of the sender, if the from address is recognized.
|-
|-
| || ||  
| Submitter Photo ID || submitter_photo_id || The reference ID for the user photo that appears to the left of the activity note in the history.
|-
|-
| || ||  
| Enumerated Field Tracker || enumerated_field_tracker || {{TBD|Sherwin}}
|-
|-
| || ||  
| Entity Id || entity_id || Internal. Identifies the source of an activity record that originated outside the system.
|-
|-
| || ||  
| Resolved || resolved || not used
|-
|-
|  || ||  
| Visible to Customer || visible_to_customer || This flag is true for activity notes that are shown in the service portal, where a portal user (as distinct from an internal user) can see them.
 
|-
| Helpful Count || helpful_count || rowspan="2"|These counts are used for comments on articles posted in the knowledge base, |-
where users can vote them up or down.
|-
| Unhelpful Count || unhelpful_count ||
|-
| Hours Spent || hours_spent || not used
   
|-
| colspan="3" bgcolor="lightblue" style="height:6px" | <!-- SPACER ROW -->
|-
| From User ID || from_user_id || Sender's ID, for outgoing messages
|-
| Original Message || original_email_message || rowspan="4"| Incoming email fields.
|-
| Sender Name || from_name ||
|-
| Attachments || attachments ||  
|-
| Email Headers || email_headers ||
|}
|}


===Standard Fields===
===Standard Fields===
{{:Standard Field Parameters}}
{{:Standard Field Parameters}}

Revision as of 23:52, 11 November 2014

The History object keeps track of activities related to a record. In the UI, history is shown below the record details.

Fields

Label Field name Notes
Category category Identifies the type of activity.
For example:
  • 2 - Updated this case*
  • 4 - Closed this case
  • 11 - Completed this task
  • 25 - Changed field value* (only applies to Audited Fields
  • 29 - Added a note.
  • 61 - Sent mail
*Category 25 is used when a case field is modified. Category 2 does not appear to be used.

For a complete list, see GearIcon.png > Customization > Global Picklists > History Category'

Description description

Varies, depending on the activity category.
For category 25 (audited field modified), the structure is:
{#structure-identifier^field-label^old-value^new-value^00005}

Example:

{#field_audit.recordname_modified_old_to_new
^#fieldlabel.c3a93f70aa004de6aeb5f9073eb1f759.subject
^Original case title
^Revised case title
^000005}

(If multiple audited fields were modified during a record update, there is one history entry per field.)

Related To related_to {object_id}:{record_id}
History Created By history_created_by For an incoming email, the history record's created_by field has the system ID. This field records the ID of the sender, if the from address is recognized.
Submitter Photo ID submitter_photo_id The reference ID for the user photo that appears to the left of the activity note in the history.
Enumerated Field Tracker enumerated_field_tracker __TBD: Sherwin__
Entity Id entity_id Internal. Identifies the source of an activity record that originated outside the system.
Resolved resolved not used
Visible to Customer visible_to_customer This flag is true for activity notes that are shown in the service portal, where a portal user (as distinct from an internal user) can see them.
Helpful Count helpful_count These counts are used for comments on articles posted in the knowledge base, |-

where users can vote them up or down.

Unhelpful Count unhelpful_count
Hours Spent hours_spent not used
From User ID from_user_id Sender's ID, for outgoing messages
Original Message original_email_message Incoming email fields.
Sender Name from_name
Attachments attachments
Email Headers email_headers

Standard Fields

Standard Field Parameters