Knowledge Base

Appearance

Traceability > Audit Logs > Items ​

Technical Overview ​

  • There is multiple ways to create, update or delete an item in the Product-Live platform:
    • Using the app.product-live.com UI
      • Through the quick import feature (create and update)
      • Through the delete items (delete only)
      • Though the grid view (update only)
      • Through the detailed view (update only)
      • Through the collect view (update only)
    • Using the public (calcifer) API
      • Suggestions API (update only)
    • Using Data Factory
      • Through a job launch by a user through app.product-live.com or settings.product-live.com
      • Through a periodic job launch by the platform

Audit Logs ​

The following audit logs are available to date:

Audit LogDescription
item.createAn item has been created
item.updateAn item has been updated
item.deleteAn item has been deleted
item.readOne or multiple items have been read

item.create ​

  • Description: An item has been created.
  • Details:
    • accountId: The account unique identifier linked to the log
    • userId: The user unique identifier linked to the log
    • itemId: The id of the item
    • status: How went the create (value may be: SUCCESS, FAILURE)
    • updatedFieldList: The list of fields that have been created
    • actionOrigin: The origin of the action (value may be: QUICK_IMPORT, DF_TABLE_IMPORT_ITEMS, DF_EXCHANGE_RECEIVE_ITEMS)
    • triggeredBy: Value may be USER or CRON
    • issuedAt: The creation date of the item, in the format of an ISO string.
    • jobId: The job id that created the item if the creation was made through a job (actionOrigin is prefixed by DF_)
    • jobExecutionId: The job execution id that created the item
  • Example
json
{
  "Id": "3fd28929-228d-11ef-91f5-002248824020",
  "TimeGenerated [UTC]": "2024-06-04T16:12:33.7430000Z",
  "EntityType": "item",
  "PlType": "item.create_item",
  "Version": 1,
  "Details": {
    "accountId": "1",
    "userId": "1",
    "itemId":"14",
    "status": "SUCCESS"
    "updatedFieldList": {"EAN_13":"1234"},
    "actionOrigin": "QUICK_IMPORT",
    "triggeredBy": "USER",
    "issuedAt": "2024-06-04T16:12:33.7430000Z",
    "jobExecutionId": "63fe2ed0c21eae717b583128"
  },
  "Metadata": {}
}

item.update ​

  • Description: An item has been updated.
  • Details:
    • accountId: The account unique identifier linked to the log
    • userId: The user unique identifier linked to the log
    • itemId: The id of the item
    • status: How went the update (value may be: SUCCESS, FAILURE)
    • updatedFieldList: The list of fields that have been updated by the user
    • actionOrigin: The origin of the action (value may be: APP_GRID, APP_DETAIL, APP_COLLECT, APP_QUICK_IMPORT, API_SUGGESTIONS_APPLY, DF_TABLE_IMPORT_ITEMS, DF_EXCHANGE_RECEIVE_ITEMS)
    • triggeredBy: value may be USER or CRON
    • issuedAt: The update date of the item, in the format of an ISO string.
    • jobId: The id of the job if the update was made through a job (actionOrigin is prefixed by DF_)
    • jobExecutionId: The id of the job execution if the update was made through a job (actionOrigin is prefixed by DF_)
    • suggestionId: The id of the suggestion if the update was made through a suggestion (actionOrigin is APP_COLLECT, API_SUGGESTIONS_APPLY or DF_EXCHANGE_RECEIVE_ITEMS)
  • Example
json
{
  "Id": "3fd28929-228d-11ef-91f5-002248824020",
  "TimeGenerated [UTC]": "2024-06-04T16:12:33.7430000Z",
  "EntityType": "item",
  "PlType": "item.create_item",
  "Version": 1,
  "Details": {
    "accountId": "1",
    "userId": "1",
    "itemId":"14",
    "status": "SUCCESS"
    "updatedFieldList": {"KEY_LONG_TEXT":"hello"},
    "actionOrigin": "APP_COLLECT",
    "triggeredBy": "USER",
    "issuedAt": "2024-06-04T16:12:33.7430000Z",
    "suggestionId": "6"
  },
  "Metadata": {}
}

item.delete ​

  • Description: An item has been deleted
  • Details:
    • accountId: The account unique identifier linked to the log
    • userId: The user unique identifier linked to the log
    • itemId: The id of the item
    • status: How went the update (value may be: SUCCESS, FAILURE)
    • actionOrigin: The origin of the action (value may be: APP_DELETE_ACTION, DF_TABLE_DELETE_ITEM)
    • triggeredBy: value may be USER or CRON
    • issuedAt: The delete date of the item, in the format of an ISO string.
    • jobId: The id of the job if the update was made through a job (actionOrigin is DF_TABLE_DELETE_ITEM)
    • jobExecutionId: The id of the job execution if the update was made through a job (actionOrigin is DF_TABLE_DELETE_ITEM)

item.read ​

  • Description: One or multiple items have been read
  • Details:
    • accountId: The account unique identifier linked to the log
    • userId: The user unique identifier linked to the log
    • status: How went the update (value may be: SUCCESS, FAILURE)
    • actionOrigin: The origin of the action
      • value may be:
        • API_APP: Item read from app.product-live.com
        • API_ADMIN: Item read from admin.product-live.com (currently no screen enables it, but theoretically possible)
        • DF_TABLE_EXPORT_ITEMS: Item read from Data Factory task table-export-items
        • API_PUBLIC: Item read from public api api.product-live.com
    • triggeredBy: value may be USER or CRON
    • issuedAt: The read date of the item, in the format of an ISO string.
    • jobId: The id of the job if the read was made through a job (actionOrigin is DF_TABLE_EXPORT_ITEMS)
    • jobExecutionId: The id of the job execution if the read was made through a job (actionOrigin is DF_TABLE_EXPORT_ITEMS)
    • url: The url of the request if the action origin is API_PUBLIC, API_APP or API_ADMIN
    • query: The query of the request if the action origin is API_PUBLIC, API_APP, API_ADMIN or DF_TABLE_EXPORT_ITEMS
    • itemIds: The set of item ids that have been read
    • durationMs: The duration of the request in milliseconds
    • cacheHit: number,
    • cacheStale: number
    • cacheMiss: number
    • cacheOff: number