Overview:
This Knowledge Base article describes how to change the IDs of a site and its HTML5 viewer. While Display Names can be easily changed in Geocortex Essentials Manager, changing IDs requires editing configuration files.
Solution:
This Knowledge Base article describes how to change the IDs of a site and its HTML5 viewer. While Display Names can be easily changed in Geocortex Essentials Manager, changing IDs requires editing configuration files.
Solution:
Changing the Site ID
Note: before editing your folders or configuration files, it is important to back up your site. Right click the site's folder, and select Send to > Compressed (zipped) folder to create a zipped backup of the site.
- Open the Sites folder. By default, this is located at C:\Program Files (x86)\Latitude Geographics\Geocortex Essentials\Default\REST Elements\Sites
- Find the folder for the site you want to change. Back it up if you have not already done so.
- Rename the folder using the name that will be used as the new site ID. Make sure to pick a valid ID that is not shared by any other sites, and has no spaces or special characters.
- Open the folder.
- Open the Site.xml file in a text editor such as Notepad.
- Line 2 should look something like:
<Site xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" DisplayName="OldSiteID" ID="OldSiteID" Version="4.6.3">
Change the ID to match the name of the folder. For example:<Site xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" DisplayName="OldSiteID" ID="NewSiteID" Version="4.6.3">
- Save the Site.xml file.
Changing the Viewer ID
Note: before editing your folders or configuration files, it is important to back up your site. Right click the site's folder, and select Send to > Compressed (zipped) folder to create a zipped backup of the site.
- Open your site's folder. By default, this is located at C:\Program Files (x86)\Latitude Geographics\Geocortex Essentials\Default\REST Elements\Sites\MySiteName
- Open the Site.xml file in a text editor such as Notepad.
- Find the Viewers section in the xml, and the viewer that will be changed. You may have more than one viewer configured, but it should look something like:
<Viewers> <Viewer DisplayName="OldViewerID" Hidden="false" ID="OldViewerID" Path="{SitePath}\Viewers\OldViewerID" Tags="gvh gvh2.7 gvh2.7.2" TemplateID="Html5Viewer_2_7" /> </Viewers>
- Change both the ID and the Path to reflect your new viewer ID. Make sure to pick a valid ID that is not shared by any other viewers on this site, and has no spaces or special characters. For example:
<Viewers> <Viewer DisplayName="OldViewerID" Hidden="false" ID="NewViewerID" Path="{SitePath}\Viewers\NewViewerID" Tags="gvh gvh2.7 gvh2.7.2" TemplateID="Html5Viewer_2_7" /> </Viewers>
- Save the SIte.xml, and navigate to the Viewers folder within the site's folder.
- Find the folder within that is named after the old viewer ID and rename it to match the new viewer ID.
- Open the folder and navigate to VirtualDirectory\Resources\Config\Default
- Open Desktop.json.js in a text editor such as Notepad.
- Find the viewerId configuration. Normally it will be located at the very bottom of the file. For example:
"viewerId": "OldViewerID"
- Change the viewerId value to match the new viewer ID. For example:
"viewerId": "NewViewerID"
- Save the json.js file.
- Repeat steps 8-11 for Handheld.json.js and Tablet.json.js.
Comments
0 comments
Article is closed for comments.