Send notifications of a problem, suggest improvements for our modeling tools, or ask about new features directly from the modeling tool. Simply choose Help > Report an Issue from the main menu. If the modeling tool stops responding, you can use the executable tools for analyzing and submitting the status of the process. To report an issue using an executable file, start the reportissue.exe file, located in <modeling tool installation directory>\bin.
These reports help us address issues in a timely manner, as well as speeding up maintenance releases with fixes that are free of known defects.
Note
title
Automatic Report Build
When reporting an issue directly from the modeling tool, information is automatically incorporated into a report.
Warning
title
File unable to load
If the modeling tool is unable to load your file, and the file is non-confidential, please attach it to your submission. It will assist us when we analyze your issue.
Reporting issues directly from the modeling tool
We strongly recommend submitting a report for any problem, suggestion, or question about new features directly from the modeling tool. Your report will create an issue in our Online Customer Support System.
Anchor
dialog
dialog
To report an issue directly from the modeling tool
On the Help menu, click Report an Issue. The Report an Issue dialog opens.
Image RemovedReport an Issue dialog in the modeling tool
Fill in your first and last name together with your email address.
Note
title
Email
Choose the product, issue type, and component.
Describe your issue. Please provide as much information as possible.
Note
title
Registered MagicDraw Users
Please note that we provide professional support for registered users with a valid No Magic Software Assurance Contract (SA). SA provides you with technical support, together with major software updates and maintenance releases, at no cost throughout the contract period. Issues are normally handled within one or two business days during regular business hours.
In the Attachments tab, select files you would like to send together with your issue report:
Attach log file - the log file will be sent with your issue report.
Info
Each modeling tool instance (opened version) has a separate .log file. While the first opened instance has a dedicated <modeling tool>.log file in the main directory, all other opened instances create separate folders, e.g., instance_1 and instance_2 with .log files. To access the file used by the specific instance, go to Help > About > Environment > Log File.
Attach project file - the opened and last saved project file will be sent with your issue report.
Attach used projects - modules that have been used in the opened project file will be sent with your issue report.
Attach diagrams images - choose diagrams, whose images you would like to send with your issue report. Also, specify the format of the images.
If you are already registered, your personal information will be automatically filled in on the Report an Issue dialog.
Anchor
If you supply the email address you used when registering at www.magicdraw.com, you will be able to track the status of your issue in our Online Customer Support System. If you used another email address, you will only receive email notifications of status changes.
offline
offline
Report an issue when the program is unresponsive
If you encounter an issue or the modeling tool becomes unresponsive, a separately executable tool is provided for analyzing the status of the process to aid in bug submission. In these situations, manually start
the
the submit_issue.exe file (located in
the
the <modeling tool installation directory>\bin folder)
and follow directions
. After you
start
start submit_issue.exe,
the
the Report an Issue
dialog
dialog opens.
Image Removed
The Report an Issue dialog in an online mode
If the Out Of Memory error occurs when running the program, start submit_issue.exe and then click the Dump Memory Heap button in the bottom-left corner of the Report an Issue dialog to generate a memory heap file. You need to submit this file to customer support to get further assistance regarding the encountered memory issue.
Report an issue in the offline mode
If there is no Internet connection (or the version of the product you use does not allow sending data out), the Report an Issue window does not appear. Instead, a new offline mode dialog is displayed:
Image Removed
The Report an Issue dialog in the offline mode
Connect to a Proxy Server - try to reconnect to the Internet by entering the Proxy server details.
In this dialog, you can easily dump threads or memory heap into files and provide those files when reporting an issue to the support team.
Image Added
Dump Threads to Log File - threads will be dumped to a Log file.
Dump Memory Heap to File - memory heap will be dumped to a new .hprof file
.
Reporting Issues Through Email
The e-mail address for registered users to access our customer support system is support@nomagic.com.
The system allows you to include keywords in the email’s subject line. These keywords will enable us to route the issue to the proper support organization more quickly and resolve the issue in a more timely manner. They also allow the definition of many fields for the newly created issue (reporter, project, priority, affected components, affected version).
Note
title
Support Issues
Support Issues can only be reported or commented on from the email address registered in your www.nomagic.com account.
The parameters are listed below:
#PROJECT
#SECURITY_LEVEL
Tip
title
Format of the Email
For example, if you have a question about documentation in UPDM, you might submit the following email:
Image Removed
This email sent from the registered user will create a support issue in the UPDM project. The Issue’s component will be Documentation and Requirements Management and its severity will be low.
Note
title
Parameters
Parameters should be listed in the email subject line with a single space between them.
No commas should be used between parameters.
No spaces should be used in the body of the parameter.
If a parameter value contains spaces, you must replace each space with two underscore characters. For instance, #COMPONENT=Test__Component associates the issue to Test Component. If you specify an invalid component or none at all, the issue is associated to No Component by default.
Emailing support requests can be faster compared to the web interface http://knowledgebase.nomagic.com; however, when reporting issues through email, additional important information might be lost. This information loss can be mitigated by including parameters from the list above.
If an email has email addresses in either the CC: or the BCC: fields, they will be added to the support issue as External Watchers. All watchers receive email notifications about any activity on the issue
.
note
title
Support Issues
Support issues that are marked private are not viewable within the support system, even if you are listed as an external watcher. Non-registered users also will be unable to see issues within the support system.
Commenting on a Support Issue
To comment on an existing support issue, please reply to the notification email. The body of the email will become your comment on the issue. If you send attachments with your email, they will become attachments on the issue.
Note
title
Issue ID
It is important that the issue id (e.g. [MDUMLCS-2058]) exists in the subject line.
Warning
title
Not a registered user
If a commenter is not registered in www.nomagic.com, his or her comment is not recorded in the support issue.
View and Submit Internal Errors
Internal errors are displayed as notifications by default. The internal error does not necessarily mean damage to your data, but can be a reason for unexpected tool behavior. We highly recommend submitting internal errors to No Magic for further investigation.
You can submit either manually or automatically. In both cases, we
We strongly recommend attaching the log file. An internal error message appears at the bottom of the modeling tool.
Image Removed
Image Added
Example of Internal Error message in MagicDraw modeling tool
To view internal errors
To view internal errors you must open the Internal Errorsdialog, using one of the
three
two methods outlined below:
Click the View
andSubmit Internal Errors
internal errors button in the Notification Window.
From the Help main menu, choose the View andSubmit Internal Errors command.
Click the notification
icon
icon on the status
bar.
Note
title
Button Availability
The Viewand Submit Internal Errors buttons in the Help main menu and the red button at the bottom of the status bar only exist if the Submit Errors dialog actually contains errors
line.
To submit an error
Open the Internal Errors dialog.
Click
the Submit button in the Internal Errors dialog box. The Submit Error dialog appears.
Fill in Your name, Your e-mail and Bug description fields and click the Send button.
The error will be sent to the support team. Submitted internal
the Export To File button. Image Added
Specify the name and location of the error log file and click Export.
Internal errors will not be shown for 24 hours (or until you restart your modeling tool) after clicking
the Submit or
Clear And Closebuttons.
To
allow automatic internal errors submission
From Options menu, select Environment. The Environment Optionsdialog will open.
Click on the General options group Internal Errors.
To allow automatic internal errors submission: in the Internal Errors options list, change the Automatically Submit Internal Errors value to true.
Note
title
Question dialog
If you set the Automatically Submit Internal Errors value to false in the Environment Options dialog, the Question dialog shown below appears when closing the error notification or before the Internal Errors dialog opens.
Select Attach the log file check box to attach the log file for Submitting Internal Errors,
To automatically submit internal errors to No Magic, click Yes.
Image Removed
To attach the log file when automatically submitting Internal Errors to No Magic
From the Options menu, select Environment. The Environment options dialog will open. In the General options group, click Internal Errors.
To attach the log file, in the Internal Errors options list, change the Attach Log File Submitting Internal Errors option value to true.
To
Display Internal Errors
From the Options menu, select Environment. The Environment options dialog will open.
In the General options group, click Internal Errors.
In the Internal Errors options list change the Display Internal Errors option value to true to display
internal errors.
Note
title
Background Task Manager
You can see the submitted
internal errors
status in the Background Task Manager at the bottom right corner of the modeling tool window
.
Click the Background tasksImage Removedicon to see the status.During the submission process, the status will be submitting.
If the submission process was successful, the status will be submitted automatically.
If the submission process failed, the status will be automaticsubmission failed, and the automatic submission will resubmit errors a maximum of 5 times (every 10 minutes). Otherwise, you can submit internal errors manually using the dialog Report an Issue.