Enabling round-trip editing for files

Enable round-trip editing for files so that users can check out a file and edit it locally with one click.

Before you begin

Round-trip editing is not available by default. Being able to perform round-trip editing is dependent on the desktop plug-ins being installed on users' clients.

Note: Round-trip editing should be configured before the desktop clients are configured. If round-trip editing is configured after the desktop client plug-ins, users will have to refresh their server configuration manually.

About this task

To ensure that round-trip editing is enabled, perform the following steps:

Procedure

Locate the restrictions section in the files-config.xml file, and add the following code after </restrictions>:

<roundTripEditing>
		<extensions>
       <extension>.ppt</extension>
       <extension>.doc</extension>
       <extension>.xls</extension>
       <extension>.docx</extension>
       <extension>.pptx</extension>
       <extension>.xlsx</extension>
       <extension>.odt</extension>
       <extension>.odp</extension>
       <extension>.ods</extension>
   </extensions>
</roundTripEditing>

Locate the files-config.xsd file, and add the following code to the <xsd:element name="file"> section after xsd:element name="renditions" type="tns:renditions" minOccurs="1" maxOccurs="1"/>:
```
<xsd:element ref="tns:roundTripEditing" minOccurs="1" maxOccurs="1"/>
```

Add the following code after the autoVersioning definition:

<xsd:element name="roundTripEditing">
        <xsd:complexType>
            <xsd:all>
                <xsd:element name="extensions" type="tns:extensions" minOccurs="1" maxOccurs="1" />
            </xsd:all>
        </xsd:complexType>
 </xsd:element>

Restart Files.ear.

Identify the WebSphere® variable CONNECTIONS_CONFIGURATION_PATH.
Navigate to the directory found in the value of CONNECTIONS_CONFIGURATION_PATH and then navigate to the update subdirectory.
In the update subdirectory, create a file named 00000000-0000-0000-0000-000000000000.json.

Paste the following contents into 00000000-0000-0000-0000-000000000000.json:

{
   			 "organisation": "00000000-0000-0000-0000-000000000000",
  			  "settings": [
       				 {
           				 	"id": "5a019ee0-eb0a-47b9-b812-6d09c2fd7611",
           					"name": "files.roundTripEditingEnabled",
            				"title": "Enable or disable round trip editing",
            				"category": "general",
           				 	"description": "If this policy is enabled, user can see 'Edit On Desktop' button on web UI. Clicking the button, a file can be opened by local application. This function requires desktop plugin to be installed.",
            				"canModify": true,
           					"allowRoles": true,
            				"validation": {
                					"type": "boolean",
                					"details": ""
           					 },
           					 "values": {
                					"___default_role___": {
                    						"isFile": false,
                   						 "content": true
                					}
            				}
       	 			}
   			 ]
		}

Ensure that the Connections server is started. Use wsadmin commands to update the settings in the database to match the filesystem. For more information, see Updating Settings in Highway through the Filesystem.
```
./wsadmin.sh -lang jython -username wasadmin -password wasadmin
execfile("highwayAdmin.py")
HighwayService.updateSettingsFromFile()
```
A new file is in the configuration directory /opt/IBM/Connections/data/configuration/update with the following naming structure: <orgId>._[UPDATED]_.<dateTimeStamp>. You can also view the updated settings in the HOMEPAGE.MT_CFG_SETTINGS table in the database or by using the Highway Application.
Restart the application servers and clear the browser cache in order to see the updated settings.