Help Center>Foundation Help

Applies to:

Migrating Composer solutions through environments

Using SVConfigurator FormReplace and FormSearch Keys

Composer solution migration

  1. Use deployment profiles
  2. Migrate SharePoint lists
  3. Save SharePoint lists as a template
  4. Change SharePoint data connections
  5. Migrate Transaction/Query scripts
  6. Deploy solution to new environment

Winshuttle Workflow has a tool that is located on the server that Workflow was installed on called SVConfigurator. This tool allows for easy server-side changes as it provides a better interface than a configuration file.

Note: SVConfigurator.exe is usually located in C:\Program Files\ShareVis\bin.

Once the SVConfigurator is launched you can reference your Winshuttle Forms Site and make configuration changes to the entire site or a single form. To use the FormSearch and FormReplace keys in the SVConfigurator to modify data connections, follow the procedure below.

NOTE: Once you have made the appropriate modifications, you will not be able to tell on the form that the data connections have changed. It only exists on the server so you will not be able to tell by looking at the form so testing is a must.

WARNING: In order for this to work correctly, your Column Names must be identical to your old SharePoint List Columns. If the Column Names do not match up, you will encounter an error.

  1. Logon to the Winshuttle Workflow server.
  2. Navigate to the file path of C:\Program Files\ShareVis\bin
  3. The file path may be different depending on your setup.
  4. Right-click SVConfigurator.exe, and then click Run as Administrator.
  5. In the SP Server/Site field, enter the SharePoint URL to the Winshuttle Forms site that you want to change, and then click Load. Configuration settings will then load for that particular site.

  6. On the left hand side, you will see a Tree Structure showing a hierarchal view of your Winshuttle Forms Site. In the screenshot above, ShareVis.Config would be a global configuration change, http://sea-en-vsdev6/sites/central/forms would apply the change to the entire site. The items directly below it (Announcements, Calendar, Forms, etc.) represent the list or form level. In the event that you are changing data connections, this change should be made at the List level.
  7. Click the List to which you want to apply changes.

    NOTE: If you have not published your Winshuttle Solution to the Forms Site yet, you will not see your list until you do so.

  8. If you need help understanding the configuration keys do, click Help. The keys in the example below are the ones used to implement the changes for this example.

  9. In the Key field, enter FormSearch0.
  10. In the Value field, enter the SharePoint URL to look for. This SharePoint URL will be the link to the old SharePoint List.

  11. Click Add Key.
  12. Click Save.
  13. In the Key field, enter FormReplace0
  14. In the Value field, enter the new SharePoint URL where your migrated list resides.

  15. Click Save.

    Note: When you have more than one data connection, the FormReplace/FormSearch keys must start with an appended 0 and increase sequentially.

    Example:

    <add key="FormSearch0" value="http://myOldSite/lists/mySPList" />

    <add key="FormReplace0" value="http://myNewSite/lists/mySPList " />

    <add key="FormSearch1" value="http://myOldSite/lists/ManagerList " />

    <add key="FormReplace1" value="http://myNewSite/lists/ManagerList " />

    <add key="FormSearch3" value="http://myOldSite/lists/Plants " />

    <add key="FormReplace3" value="http://myNewSite/lists/Plants " />

  16. Test your data connections in your new environment to ensure everything is working properly.