HOW TO
Instructions provided describe how to enable ArcMap to create documentation for custom geoprocessing tools that are not models or scripts. When custom geoprocessing tools are created using programming languages such as C#, VB .Net and C++, the Windows registry must be updated to allow help documentation to be created with the Documentation Editor.
Custom tools created through the geoprocessing environment in the form of models or scripts, allow use of the Documentation Editor to produce documentation by default. Tools created in other formats, such as C#, VB .Net and C++, work within the geoprocessing environment. However, the Documentation Editor is not accessible unless a registry update is performed.
Note: Verify that the Metadata_File() property in the custom tool is set before compiling. Make the value equal to a unique file name with an '.xml' extension. This property is read from the tool by the application. The first time documentation of a file is created with the specified name, it is generated in the path returned by the MetadataFile property. This sample shows an example where the metadata file is created at the location of the program executable. However, if only the name of an XML file is returned, then the metadata file is created under <install directory>\Help\gp folder. Each time changes made in the Documentation Editor are saved, they are written to the XML file. The content of this file is displayed in the custom tool help, on the side panel of its dialog box, and in the metadata window of ArcCatalog.
Warning: The instructions below include making changes to essential parts of your operating system. It is recommended that you backup your operating system and files, including the registry, before proceeding. Consult with a qualified computer systems professional, if necessary. Esri cannot guarantee results from incorrect modifications while following these instructions; therefore, use caution and proceed at your own risk.
For Version 10.1:
[HKEY_CURRENT_USER\Software\esri\Desktop10.1\ArcToolbox]
"CanEditMetadata"=dword:00000001
For Version 10:
[HKEY_CURRENT_USER\Software\esri\Desktop10.0\ArcToolbox]
"CanEditMetadata"=dword:00000001
For 9.3.1 and earlier versions:
[HKEY_CURRENT_USER\Software\esri\ArcToolbox]
"CanEditMetadata"=dword:00000001
▪ Setting the value to 1 means documentation for the tools can be edited.
▪ Setting the value to 0 removes this ability and the Documentation Editor becomes inaccessible.
Alternatively, registry changes can be made manually.
For Version 10.1:
HKEY_CURRENT_USER\Software\ESRI\Desktop10.1\ArcToolbox
For Version 10:
HKEY_CURRENT_USER\Software\ESRI\Desktop10.0\ArcToolbox
• For 9.3.1 and earlier versions:
HKEY_CURRENT_USER\Software\ESRI\ArcToolbox
Get help from ArcGIS experts
Download the Esri Support App