Product change - New endpoint to access logs in Norce [Storm] Connect

Last changed: 2023-07-04

New functionality, optionally available for use.

Background

Import jobs in Norce [Storm] Connect are asynchronous, and until now the logs for these jobs have only been accessible through Norce [Storm] Admin. There has been no way of accessing these automatically or read and parse the logs through an integration. This change provides that possibility.

Changes

Storm Connect

A new endpoint has been created in Norce [Storm] Connect in the Job subcomponent called GetLog. You can read more about it in the API reference here.

The response is a list of log entries, where the minimum is two entries: Starting import and Import finished. Each entry has a number called SeverityId to indicate the severity of each log entry.

SeverityId	Level	Description
1	Information	Only information.
2	Warning	Some part of the record could not be handled but the remaining record have been imported.
3	Error	The record could not be imported at all.

Example:

Copy

Copied

[
    {
        "SeverityId": 1,
        "Message": "Starting import.",
        "TimeStamp": "2023-07-31T16:24:37.967",
        "ImportedRow": null
    },
    {
        "SeverityId": 2,
        "Message": "Image storm-commerce-logo-500x177.png (, https://d2b1p7ke1xn1n3.cloudfront.net/uploads/2016/02/storm-commerce-logo-500x177.png) upload failed: (404) NotFound.",
        "TimeStamp": "2023-07-31T16:24:44.463",
        "ImportedRow": null
    },
    {
        "SeverityId": 1,
        "Message": "Import finished.",
        "TimeStamp": "2023-07-31T16:24:44.48",
        "ImportedRow": null
    }
]

Sometimes the ImportedRow property contains the record that could not be imported, though it may be truncated.

The extent of these messages will be developed further.