Home Discussions Questions & Answers Upload Status Display and Error Tracking

Upload Status Display and Error Tracking

Avatar photoCustomer January 9, 2021 at 12:28 am

After users perform a Blitz Upload, I need the final Excel report output to clearly distinguish between successfully processed records and those that resulted in errors, along with the specific error message returned by the API. How do I define the extraction logic for this status reporting?

Viewing 6 reply threads
  • Author
    Replies
    • Support January 9, 2021 at 4:28 am  

      You must define the ‘Error SQL’ and ‘Success SQL’ under the Upload SQLs tab , . These SQL snippets are dynamically appended to the main report SQL post-processing . They must query the dedicated Data View (e.g., `xxen_blitz_report_samp_12867_u`) . This view contains the original uploaded data along with the returned status (`xu.status_`) and message (`xu.message_`) for each record .

    • Avatar photoCustomer January 10, 2021 at 7:27 pm  

      What is the crucial requirement regarding the column structure of the Error SQL and Success SQL definitions?

    • Support January 12, 2021 at 11:52 am  

      It is absolutely critical that both the Error SQL and the Success SQL select the exact same number of columns and in the exact same sequence as your main report SQL extraction query . This is necessary because they are appended dynamically to format the final output correctly , . The SQLs should include human-readable status meanings by using utility functions like `xxen_upload.status_meaning` and `xxen_upload.action_meaning` , .

    • Avatar photoCustomer January 13, 2021 at 9:33 pm  

      If I choose the API method, what values are typically passed via the `action_` and `status_` parameters in my custom wrapper procedure?

    • Support January 14, 2021 at 10:13 pm  

      In an API-based upload, the input parameter `action_` receives values like `xxen_upload.action_create` or `xxen_upload.action_update` from the framework . Your custom wrapper procedure must populate the output parameter `status_` with either `xxen_upload.status_error` or `xxen_upload.status_success` based on the processing result . The output parameter `message_` is used to return the descriptive error or success message that appears in the final Excel output .

    • Avatar photoCustomer January 16, 2021 at 10:32 am  

      Is there a default retention policy for the data stored in the underlying upload data view (table `xxen_upload_data`)?

    • Support January 18, 2021 at 10:03 am  

      The retention of data in the `xxen_upload_data` table is controlled by the profile option ‘Blitz Upload Data Retention Days’ . The default value for this profile is zero . A setting of zero means that the data is deleted immediately during the upload processing . If set to a non-zero value, the data is kept for that number of days, which is useful primarily for debugging purposes .

Viewing 6 reply threads
  • You must be logged in to reply to this post.

Login with: