In SystemWeaver, every object, e.g., items, parts, users, libraries, etc., is identified by a 64-bit number, unique within the specific SystemWeaver database.


Normally you don't have to care about these identifiers, since SystemWeaver manages all its data automatically. What can be useful to know, though, is that references in SystemWeaver are never done by name, but by using these IDs. So you can safely change any name you want and the information in SystemWeaver will still remain intact.


A SystemWeaver ID is usually presented as a hexadecimal number, like: x040000000003A67C, and you can see these IDs for example in the Properties view.


Sharing IDs Outside of the Server

If you want to share a reference to an object outside of the SystemWeaver server, e.g., in an email, you need to include the address of the specific SystemWeaver server as well. For practical reasons, IDs include a prefix that tells that the ID is in the form of a URL (a "Uniform Resource Locator"), and also specifically a SystemWeaver identifier, for example:


url:swap://209.systemite.net:443/x040000000003A67C


If you "copy" an item in SystemWeaver, a string like the above ends up in the Clipboard, and you can paste it into a document or email.



Usually the software used for reading the document or email will recognize the small "url:" prefix, and treat the ID as a hyperlink:



If the reader of a document or email has SystemWeaver installed, and has access to the server, he or she can click on the link and the swExplorer will automatically open the referenced item. Note that this requires the installation of the swExplorerLauncher


The ID can also be entered as a string in some special views in SystemWeaver, like the Open item page.

For such views, the ID can be entered in any of the following forms:


url:swap://209.systemite.net:443/x040000000003A67C

swap://209.systemite.net:443/x040000000003A67C

x040000000003A67C


The SystemWeaver Field code that corresponds to the identifier is "handle". (Field codes can be used in reports and when displaying more columns in a grid view. For complete lists of field codes, see the application Help.)


Exercise

Try copying an item and pasting it in an email.