View or cancel retail data distribution sessions
Important
This content is archived and is not being updated. For the latest documentation, see Microsoft Dynamics 365 product documentation. For the latest release plans, see Dynamics 365 and Microsoft Power Platform release plans.
Applies To: Microsoft Dynamics AX 2012 R3
The Download sessions form and the Upload sessions form show information about data distribution jobs that are in progress or have been completed. A run of a job is referred to as a session. Use the information in these forms for troubleshooting. You can also run a session again or cancel a session from these forms.
To display complete status information in these forms, you must run the batch job that processes status messages for Commerce Data Exchange. For more information, see Process status messages for data exchange.
This topic includes the following information:
View information about download sessions
View information about upload sessions
View information about download sessions
Use the Download sessions form to view information about jobs that transfer data from Microsoft Dynamics AX to channels.
Click Retail > Inquiries > Commerce Data Exchange > Download sessions.
Select a date range for which to view data. By default, records that have a status of No data are not shown in the list. Select Show all records to view an unfiltered list.
You can view the following information about download sessions.
Field
Description
Job name
The identifier for the scheduler job that was run in the session.
Channel data group
The data group that the session was run against. A channel data group can contain multiple channel databases.
Channel database
The channel database that was affected by the session.
Status
The status of the session. The following statuses are used:
Started – The data package was created in the working folder.
Available – The data package is available for download.
Requested – The data package has been requested by Async Client.
Downloaded – The data package has been downloaded by Async Client.
Applied – The data package has been applied to the channel database.
Canceled – The session was canceled by the user.
Create failed – The data package could not be created. Review the detailed error message for more information.
After you have resolved the error, run the distribution schedule again. If the distribution schedule runs as part of a batch job, it is run again the next time that the batch job runs.
Download failed – The data package could not be downloaded. Review the detailed error message for more information.
After you have resolved the error, Async Client tries the download again according to the retry interval.
Apply failed – The data package could not be applied to the channel database. Review the detailed error message for more information.
If there is a configuration issue, fix the issue, and wait for the next retry by Async Client. If there is a data issue that you can’t resolve by modifying the database schema, cancel the session.
Message
If there was an error, the detailed error message text.
Date requested
The date and time when Async Client requested the data package.
Date downloaded
The date and time when the data package was successfully downloaded by Async Client.
Date applied
The date and time when the data package was successfully applied to the channel database.
Created date and time
The date and time when the data package was created.
Session number
The identifier for the session.
Download path
The working folder where data packages are created.
Rows affected
The number of rows in the database that are read from Microsoft Dynamics AX and sent to the channel.
Modified date and time
The date and time when the data package was last modified.
To run a session again, select the session, and then click Rerun.
To cancel a session, select the session, and then click Cancel.
View information about upload sessions
Use the Upload sessions form to view information about jobs that transfer data from channels to Microsoft Dynamics AX.
Click Retail > Inquiries > Commerce Data Exchange > Upload sessions.
You can view the following information about upload sessions.
Field
Description
Job name
The identifier for the scheduler job that was run in the session.
Channel database
The channel database where the data originated.
Session number
The identifier for the session.
Upload session status
The status of the session. The following statuses are used:
Started – The data package was created in the working folder.
Available – The data package is available for upload.
Uploaded – The data package has been uploaded.
Applied – The data package has been applied to the Microsoft Dynamics AX database.
Canceled – The session was canceled by the user.
Upload failed – The data package could not be uploaded. Review the detailed error message for more information.
After you have resolved the error, Async Client tries the upload again according to the retry interval.
Apply failed – The data package could not be applied to the Microsoft Dynamics AX database. Review the detailed error message for more information.
If there is a configuration issue, fix the issue, and wait for the next retry by Async Client. If there is a data issue that you can’t resolve by modifying the database schema, cancel the session.
Rows affected
The number of rows in the database that are read from the channel database and sent to Microsoft Dynamics AX.
Temporary files path
The working folder where data packages are created.
File size
The size of the data package file.
Date and time created
The date and time when the data package was created.
Date and time modified
The date and time when the data package was last modified.
To run a session again, select the session, and then click Rerun.
To cancel a session, select the session, and then click Cancel.