What are D3M Icons and how are they unique?
D3M Icons are elements that represent a device or some type of equipment that will appear in your diagram. Each icon in D3M has three components to it:
A picture or graphic to represent the device
A technical view showcasing its physical and wireless ports, and
Properties that can be used to store important information, quote parts & settings
Creating a new D3M Icon
You'll need to start by clicking on the New Icon button
If you do not see the New Icon button, make sure you are looking at the library represented by the leftmost of these icons at the top of the left sidebar:
Step 1 - Name the Icon & Select an Image
First, you'll have to start by giving your new icon a name and selecting an image or graphic for your icon. You can select one of our hundreds of pre-designed vector graphics or click the Upload Custom Image button to import your own image.
Note about images: We currently support jpg, gif, and png images and require that they be less than 5MB in size. Under 1MB is recommended. For best results, dimensions should be in increments of 25px. 100px by 50px is great. 90px by 45px, not so much.
Step 2 - Creating the Technical View & Assigning Ports
The next step consists of determining the size of your icon and adding the appropriate ports to best represent your device. You'll want to include both physical and wireless ports to the best of your knowledge.
To set the size of your icon, simply click on the + and - buttons and adjust as needed. Each unit of width/height is 25px so if you have an image that is 100px by 50px you will want a width of 4 ( 100/25 = 4 ) and a height of 2 ( 50/25 = 2).
To add a port to your icon, notice the grey squares around the perimeter of the icon. Click on one of those squares to add/edit a port. You will then see a form like this:
Using this form you can give some information about the port.
Type: Select a port type that best represents the type of port you are trying to represent. The port will only be able to connect to other ports of the same type.
Label: Give the port a label that will be used to identify the port.
Side: Choose which side(s) of the port connections should connect to. Auto allows for D3M to choose what it thinks is the best side for the connection, which is typically one of the sides that is touching the perimeter of the icon.
Limit: Limit the number of connections that can be made to the port. A value of 0 means that unlimited connections can be made.
Once a port is created you can click and drag to relocate it within your icon as needed. When you're done click on Next Step.
Step 3 - Adding Properties to your Icon
Finally, you can setup some properties for your icons.
You can add some keywords that will help with finding the icon when you are searching for it.
If you have quoting enabled for your D3M Organization, you will see a Quote Parts input. Type in a quote part number and hit enter to add it to the icon. You can add multiple parts and provide a quantity if you want to quote multiple of a given part on an icon. If there are quote parts with matching part numbers in your price book at the time you drag the icon into a project, it will automatically be quoted for you based on your settings here. Remember you can also come back and edit this in the future.
Use the form at the bottom to add properties to your icon. Adding properties will allow you to store product & configuration data (Model Number, IP Address, Serial Number, etc.). These properties will also represent the columns in the D3M Inventory view. It's important to include any data your company will want to track about these devices. Consistency is key!
Finally, click Save to... to choose the library that you can save it to. If you do not have administrative privileges in your organization you may only see your personal library here. In that case, if you think this icon would be useful for others in your organization request the icon be promoted to one of the organization libraries.
You're Done!
Suggested Articles