Troubleshooting
If you encounter difficulties with printing, refer to the following settings for resolution.
General Issues
Important
Before concluding that there is an issue with messages appearing during printing, consider the following:
- A loading screen will always be displayed when the label print button is pressed.
- A dialog box will appear in the event of an error or if the printing process, whether for labels or reports, cannot be completed.
- A confirmation message is always shown when the printing process is successful.
The settings to check for general printing issues are described in the following table.
| Setting | Description |
|---|---|
| User Settings | Ensure that printing permissions are enabled for the user on the Users page (see User Setup) in COSMO Mobile Solution. |
| Printer Assignment | Confirm that the user has at least one default printer assigned in the User Printers page (see Assign Printers to Users). |
| Default Printer Configuration | Check that the default printer for the desired printer type is properly set in the User Printers page (see Assign Printers to Users). |
| Printer Availability | Verify that at least one printer is added and available for printing (see Printer Setup). |
| Check Debug Log | Ensure that the Enable Debugging toggle is turned on in the Mobile Solution Settings page. |
The debug log can help in identifying why certain reports showed/printed unexpected results. For report related data look for [CalculateReport] tag when having single record report printing issues, or [CalculateBatchReport] when the issues are related to multiple record printing. |
PDF Printing Issues
The settings to check for issues related to PDF printing are described in the following table.
| Setting | Description |
|---|---|
| Custom Report Configuration | Ensure that a custom report is defined for the page, and there is a default report specified (see Custom Report Configuration). |
| If printing from a list, ensure that batch reports are present in the custom report settings. | |
| PDF Printer Configuration | Verify that a printer is designated as a Generic/Label printer (see Printer Setup). |
| Ensure that the Generic/Label printer is correctly configured, with the address set to the IP address/MAC address of the printer (see Printer Setup). | |
| Page Setup | Confirm that the page includes a PDF function set up for customization. |
For more information, see the Configure PDF Report Printing example.
BC Printing Issues
The settings to check for issues related to BC printing are described in the following table.
| Setting | Description |
|---|---|
| Custom Report Configuration | Ensure that a custom report is defined for the page, and there is a default report specified (see Custom Report Configuration). |
| If printing from a list, ensure that batch reports are present in the custom report settings. | |
| Service Installation | Ensure that the required service (e.g., Microsoft Universal Print, PrintNode) is installed and configured. |
| BC Printer Configuration | Verify that a printer is designated as a BC printer (see Printer Setup). |
| Ensure that the BC printer is correctly configured, with the address set to CCSMSServiceFunctionsWS_UniversalPrint (see Printer Setup). | |
| Ensure that the desired report is correctly set up for the users in the printer settings page in Business Central. | |
| Page Setup | Confirm that the page contains the unbound function CCSMSServiceFunctionsWS_UniversalPrint and set as BC printer. |
For more information, see the Configure BC Report Printing example.
Label Printing Issues
The areas/settings to check for issues related to label printing are described in the following table.
| Setting | Description |
|---|---|
| Label Layout | Verify that at least one label layout is added to the page (see Label Print Setup). |
| Page Condition | Ensure that the page condition can be fulfilled to enable the print action on card and single select lists. TIP: If there is only one layout for Item page set up with the condition: No. = 1000 , the Print Label button will not appear on other items unless multiple records are selected. |
| PDF Printer Configuration | Verify that a printer is designated as a Label printer (see Printer Setup). |
| Ensure that the Label printer is correctly configured, with the address set to the IP address/MAC address of the printer (see Printer Setup). |
For more information, see the Configure Label Printing example.
Feedback
Submit feedback for this page .