How to change symbology or add a new layer to your GO! Sync project

Changing symbology to a pre-existing layer:

For your GO! Sync project if you are changing the symbology to a pre-existing layer, you will need to make the symbology change in ArcMap and then save your changes. The MXD’s being used by your project can be found in the $serverdata\MobileDownloads\Default\MXD folder location, where $serverdata is the server root directory and “Default” is the particular device group. If you have no device groups configured you will automatically be using the Default device group. The next time you run a sync from one of your client machine’s with GO! Sync installed you will see those changes you made.

How do I know which MXD to use?

If you only have 1 MXD you will be using the default MXD which can be found in this location: $ServerData\MobileDownloads\Default\MXD folder

I have multiple MXD’s for my project.  How do I know which one is my default?

If your GO! Sync project is configured to use multiple MXD’s and you want to identify the default MXD being used, navigate to the $serverdata\MobileDownloads\Default\MobileConfiguration and open the file called GoSyncMobileConfiguration.xml. Once open, search for the following tag:

<StartUpMXD></StartUpMXD>

Please note: If multiple MXD’s are being used, Mapbook automatically remembers the last MXD used in the application.

We created a new feature class – how can I add this to my GO! Sync project?

If your new layer was added to ArcSDE:

You will need to first navigate to your GO! Sync server and open the GO! Sync Extractor. This can be located by navigating to the Start menu and finding the GO! Sync folder.

Once open, click the Open Extract Configuration button

and navigate to your extractor configuration file (.xconf file) which is usually found in this location: $serverdata\ServerConfiguration\Extractor folder. If there is no .xconf file visible you can run a search in Windows explorer for $serverdata for “.xconf”.

What is the purpose of the .xconf file?

The .xconf file is used to store configuration information for extractor. This file, once opened with the extractor populates any existing destination or source geodatabases; its specific feature classes, auxiliary processes, and any additional output options applicable to destination geodatabases.

If your .xconf file(s) have already been created for you the best approach would be to utilize an existing .xconf file. Doing so avoids having to create a new .xconf file, and a corresponding scheduled task to run the extractor that uses the .xconf file.

Adding your new layer to the .xconf file:

In the extractor, if your new layer is visible but unchecked then this means you need to update your .xconf file by placing a check beside the layer and then saving your changes.

If this is a new layer then most likely there won’t be a check by the layer. If you cannot see your new layer among your other feature classes then your feature class does not exist in the source geodatabase specified.


*Please note that .xconf files can store multiple destination geodatabases and different corresponding source connection files in their respective drop down menus. It is recommended to verify you are using the proper connection information when location your new layer.


How do I change the symbology if my layer was added to a personal or file geodatabase?

If your new layer was added in a separate geodatabase:

1) Locate the Destination Geodatabase drop down in your .xconf file and add a new destination geodatabase. Ensure this geodatabase is different from the previous destination geodatabase.

2) Select the corresponding location of the Source Geodatabase for the new layer

3) Save the .xconf file 

Adding the layer to the .xconf file only has to be done once as these setting are saved in your .xconf file.  By adding the new layer in the .xconf file you are adding a layer to your other existing feature classes that are part of the FTP syncing process that occurs daily to each of your client machine’s. As long as the information is saved in the .xconf file the layer is permanently added to your GO! Sync project (permanent until you delete or remove).

Checking your project for your new layer:

To check for the new layer run a sync on the client machine and open Mapbook. If a client machine is not available, there is an option in the extractor to create an unzipped geodatabase which helps confirm if your feature class was added to your .xconf file successfully.

and navigate to your extractor configuration file (.xconf file) which is usually found in this location: $serverdata\ServerConfiguration\Extractor folder. If there is no .xconf file visible you can run a search in Windows explorer for $serverdata for “.xconf”.
Posted in ESRI, GIS, GO! Sync, Uncategorized | Tagged , , , , , | Leave a comment

License error after installing GO! Sync Client.msi on Windows 7 OS

If you receive the error below after installing GO! Sync Client.msi on Windows 7 OS then most likely UAC was turned on at the time of installation and needs to be turned off.

To get around this error:

  • Turn UAC off:

  • Restart your machine
  • Regenerate license file with UAC still turned off using the “Create Client Details File” from the Start Menu\All Programs\GO! Sync location
  • Send the .clf license file you just generated to support@tctechnology.com
  • Navigate to the Start Menu\All Programs\GO! Sync location and choose “Load License Registration File” with UAC still turned off
  • If your license loaded correctly you should see the screen below:

Posted in GO! Sync | Tagged , , , | Leave a comment

What options do I have for synchronizing data using GO! Sync?

There are several options available to control when and how data are synchronized using GO! Sync.  At a high level, the options include:

1.       Managing when data are available for sync

2.       Managing what type of data are available for sync

3.       Managing how data are packaged for sync

4.       Controlling GO! Sync program execution

5.       Limiting data updates to incremental changes

  • A refined implementation of Esri Distributed Geodatabase framework

Managing when data are available is the simplest method for dealing with data synchronization challenges. In a typical implementation of GO! Sync, data are made available for download once per day – usually in the middle of the night. This prevents the majority of data downloads from occurring during peak load hours. GO! Sync only pulls data when changes are detected. Therefore, if the data published on the server do not change, then the client will not have anything to download and will only upload data throughout the day. Upload packages are very small (typically 2-5 KB) per package.

Managing what data are available is the most commonly used method to achieve significant performance improvements.  In addition to timing your updates, data updates can also be staggered.  Separate feature datasets can be packaged into separate geodatabases, and geodatabases can be post-processed to remove extraneous information.  For example, land base layers are updated less frequently than facility data therefore they are split into different geodatabases and distributed at different times. A typical approach is to update facility data nightly and land base data weekly.  This concept can be extended to segregate frequently updated features from rarely updated features as long as there are no geodatabase relationships that link the features.  Finally, GO! Sync customers commonly make use of standard or custom Auxiliary Processors to post-process geodatabases prior to distributing them.  A custom process could for example, strip out unneeded columns from the geodatabase and make the file much smaller by virtue of removing information that is unnecessary to support a particular business process.

All data are compacted and zipped prior to distribution.  When attempting to fully replace/update all of your data and total file size may be an issue, keep in mind that partial updates of individual sync sets are much smaller and again, data will only be downloaded when the server-side files change.

In addition to controlling when data are made available, GO! Sync can be further controlled at the client level.  The sync engine runs as a local service so a user need not be logged in to receive data updates. And when the user does log in, the program can be made to shut off and suspend all sync processing.

Limiting data updates to just the database deltas has the potential to substantially decrease the size of the update packages, but certainly increases the complexity of the system.  TCT’s approach to incremental updates is to maintain a replica on the GO! Sync Server and periodically difference that replica and register changes with GO! Sync.  The change packages are distributed and database state is managed at the client level.  If there is ever a state mismatch or other database failure, then the fail-over condition is to download the full replacement package.

In all cases, the synchronization actions are automatic and transparent to the end-user. They are never required to interact with the application to synchronize data updates.

Posted in GO! Sync | Tagged , , , | Leave a comment

Enabling Toggle Layers in Mapbook

If you want to easily turn on or off 1 layer or an entire group of layers you can enable the Toggle View command.

Configuring Toggle Layer Functionality:

 

ToggleLayers.xml: location: <ServerDataRoot>\MobileDownloads\Default\MobileConfiguration\ToggleLayers.xml

1) Open the ToggleLayers.xml in the MobileConfiguration Folder.  *If you don’t have the ToggleLayers.xml file we can provide you this file or please contact your project manager to obtain this file and the ToggleLayers.xsd.

2) Update any LayerName Tag(s) to the layer(s) to be Toggled in GO! Sync Mapbook.

 

Here is what the code will look like:

 

<ToggleLayer>

<LayerName>LayerName1</LayerName>

<LayerName>LayerName2</LayerName>

<LayerName>LayerName3</LayerName>

<LayerName>LayerName4</LayerName>

<LayerName>LayerName5</LayerName>

</ToggleLayer>

</ToggleLayers>

 

3) Delete any LayerName tags that are not used.

4) Save and Close the xml document.

 

GoSyncMobileConfiguration.xml (GSMC.xml): location: <ServerDataRoot>\MobileDownloads\Default\MobileConfiguration\GoSyncMobileConfiguration.xml

5) Uncomment the Toggle Layer button in the GoSyncMobileConfiguration.xml file and save.  If you don’t have the code below you can copy and paste into your GoSyncMobileConfiguration.xml within the <Toolbar></Toolbar> section.

<Tool name=”CustomCommands_ToggleLayer”>
<caption>Toggle Layers</caption>
<category>Command</category>
<style>image</style>
<tag>CustomCommands_ToggleLayer</tag>
<image>ToggleLayers</image>
<image_large>ToggleLayers</image_large>
<Assembly>Tadpole.GoSync.Mapbook.MapEngineUI.dll</Assembly>
<TypeName>TCTechnology.GoSync.Mapbook.MapEngineUI.ToggleLayerTool</TypeName>
</Tool>

6) Open Mapbook

Posted in Uncategorized | Leave a comment

Error when installing GO! Sync Client.msi on Windows 7 OS

If after installing GO! Sync Client.msi and you run into the error below after clicking the GO! Sync Mapbook desktop shortcut, this problem is due to Microsoft’s Windows 7 UAC control being set to on.

To get around this error:

  • Uninstall GO! Sync Client.msi
  • Completely turn off UAC
  • Reboot machine and continue with the installation of GO! Sync Client.msi.
  • Run the Mapbook desktop shortcut in elevated mode which can be done by right clicking and choosing to run as administrator
Posted in GO! Sync | Tagged | Leave a comment

How do I configure my Saved Views tool?

The Open Saved View tool opens a map document in the mobile application.  This tool can be found in the toolbar in Mapbook:

Saved Views are selected in the Open Saved View dialog.

How to use Saved Views buttons:

1) Click on the ‘Open Saved View’ tool.  The Open Saved View dialog opens, displaying available maps.  The first saved view in the list is automatically selected.

2) To select a different saved view in the list, tap/click the Saved View or the ‘Move Up/Move Down’ tools to move the selection cursor in the list.

3) To open the selected Saved View in the map display, tap/click the ‘Open Document’ tool or double-tap/click the Saved View in the list.

Configuring Saved Views:

For SavedViews, verify that you have this tag enabled in the <Paths> section of your GoSyncMobileConfiguration.xml:

<SavedViewXMLPath>$data\MobileConfiguration\SavedViews.xml</SavedViewXMLPath>

For Saved Views, there are two options for configuration.  The 1st option allows you to pick from a list of predefined MXD documents, as shown in the above Saved Views UI.  This method is ideal for user’s to quickly access commonly used map views.  If this is the preferred method, the below configuration can be used in the GoSyncMobileConfiguration.xml:

<!– Saved Views tool, replaces Open File if used –>

<Tool name=”CommandNewFile_NewFile”>

<caption>Open File</caption>

<category>Command</category>

<image>Open</image>

<image_large>Open_large</image_large>

<style>image</style>

<tag>ControlsOpenDocCommand2</tag>

<Assembly>Tadpole.GoSync.Mapbook.SavedViews.dll</Assembly>

<TypeName>Tadpole.GoSync.Mapbook.SavedViews.OpenSavedView</TypeName>

</Tool>

The second option allows you to browse to a specific MXD versus using the Saved Views window.  This is done by commenting out the Saved Views tag and uncommenting out the Open File tool tags also contained in the GoSyncMobileConfiguration.xml:

<!– Open File tool, replaces Saved Views if used –>

<Tool name=”CommandNewFile_NewFile”>

<caption>Open File</caption>

<category>Command</category>

<image>Open</image>

<image_large>Open_large</image_large>

<style>image</style>

<tag>ControlsOpenDocCommand</tag>

<progID>esriControlToolsGeneric.ControlsOpenDocCommand</progID>

</Tool>

Posted in Configuration, GO! Sync, Mobile GIS | Tagged , | Leave a comment

How do I change the color of my GPS arrow?

If your field crew is requesting to change the color of your GPS arrow, this can be done by:

Locating your GoSyncMobileConfiguration.xml file – this is found in your $serverdata\MobileDownloads\Default\MobileConfiguration folder

Inserting the following tags in your <GPS> section:

<GpsColor>

<GpsColorRed>255</GpsColorRed>

<GpsColorGreen></GpsColorGreen>

<GpsColorBlue></GpsColorBlue>

</GpsColor>

The above set of tags renders a red arrow, but you can change the color to be any combination of Red, Green & Blue.

After you have color values specified in the above GPS tags, save your GoSyncMobileConfiguration.xml and run a sync from your client machines.  The next time your user’s start GPS in Mapbook, they will be able to see the new color.

Posted in Configuration, GO! Sync, Mobile GIS | Tagged , | Leave a comment

Our IT department installed GO! Sync on a client machine and licensed it but now I can’t run a sync.

  • This happens occasionally when IT logins in with Admin privileges to install a machine, then does not set them as below for all Users.
  • Verify permissions have been set for the $data folder:
  • $data – Read / Write / Modify for all Users (typically User group), not just Admins

  • Verify permissions have been set for the $app folder:
  • $app – Read / Write / Modify / Execute for all Users (typically User group), not just Admins

Posted in Uncategorized | Leave a comment

What kind of geodatabases are supported as connection files in InspectServerConfiguration.xml?

The InspectServerConfiguration.xml is the GO! Sync Server inspection configuration file used to process incoming inspections.  The key to this file are that inspection names have to match with what is being used in the InspectionClientConfiguration.xml, multiple connection files are supported.

Acceptable database types can be SDE ‘*.sde’ connection files, pGDB ‘*.mdb’ or fGDB ‘*.gdb’ databases.  SDE connection files should be located in the [ServerDataRoot]\ServerConfiguration\ConnectionFiles folder.

Posted in Configuration, GO! Sync, Inspections | Leave a comment