PT Sync Install 1.1 - Revision history

Mcarroll: /* Version 1.0 Installation Guide */

2011-12-21T18:53:24Z

‎Version 1.0 Installation Guide

Mcarroll: Replaced content with '== Version 1.0 Installation Guide == Please follow the Version 1.0 Install Guide to install the PT Sync v1.1 application. No installation steps ha…'

2011-12-21T18:53:17Z

Replaced content with '== Version 1.0 Installation Guide == Please follow the Version 1.0 Install Guide to install the PT Sync v1.1 application. No installation steps ha…'

Mcarroll: Created page with '== Overview == The following guide will install the PT Sync Application for the source and destination sites. Follow the instructions closely because some steps need to be compl…'

2011-12-21T18:51:23Z

Created page with '== Overview == The following guide will install the PT Sync Application for the source and destination sites. Follow the instructions closely because some steps need to be compl…'

New page

== Overview ==
The following guide will install the PT Sync Application for the source and destination sites.

Follow the instructions closely because some steps need to be completed on both the source and destination sites.

The PT Sync Application is built within the ADF. The ADF must be installed in the site to run the PT Sync, follow the ADF [[Installation]] instructions.

== Download ==
Download the PT Sync Application from the Community Site or from the SVN Repository.

Extract the zip files into the following directory:
'''/ADF/apps/pt_sync/'''

== ADF Configuration ==
* Make sure the ADF is setup and running on the site. If the ADF is not setup, then follow the instructions for ADF [[Installation]].
* Open the sites 'ADF.cfc' ([[Site Configuration (ADF.cfc)|See Site Configuration (ADF.cfc) for more info]]) file (located in your site's /_cs_apps/ directory) in a text editor. Locate the ''Load the ADF Application into application space'' comment in the file. Add (or uncomment) the following command under the comment section:
<source lang="java">
loadApp("ptSync");
</source>
* '''Load the PT Sync Application into the source and destination site!'''
* [[Reset ADF|Reset the ADF]] for the server and site.

== Import ==
'''Only important these elements into the Source Site'''

Create a new element category called "PT Sync Elements".
Import Custom Elements in this order:

# [[PT_Sync_Sync_Mapping_Element|Sync Mapping]]
# [[PT_Sync_Sync_Configuration_Element|ptSync Configuration]]

== Subsites ==
It is '''highly recommended''' that a PT Sync webadmin subsite is created for the administrators. This configuration allows subsite security to be used to allow only Administrators access to the webadmin subsite.

Your site may already have a ''webadmin'' subsite. The steps below will add a ''sync'' subsite under the ''webadmin'' subsite.

=== Web Admin ===
# Create a new subsite under the site root called ''webadmin''.
# Create a new subsite under ''webadmin'' called ''sync''.
# Configure the ''/webadmin/sync/'' subsite Content Security to give 'No Rights' to 'Anonymous Users' and 'Authenticated Users'.
# Configure the ''/webadmin/sync/'' subsite Content Security to give permissions to the group of administrators who will manage the sync application.

== App Configuration ==
The PT Sync Configuration Page will be used to manage the ptSync Configuration custom element.

'''Setup the App Configuration on the Source site!'''

=== Steps ===
# Create a new page called 'Configuration Manager' in the ''/webadmin/sync/'' subsite.
# In the main content of the page, add a Custom Script element.
# Enter the explicit module path for:
## ''/ADF/apps/pt_sync/customcf/sync_config_admin.cfm''
# Publish the page.

=== Create Sync Configuration Record ===

We are creating a single PT Sync Configuration element record to be used within the application.

On the page select the "Edit Configuration" button. Complete this form to select the source site, destination site, and the Sync Mapping custom element that was imported.

Once this record is saved and created, this page will render the "Show/Hide Configuration" button to see the configuration record.

[[Reset ADF|Reset the ADF]] for the server and site.

== Mapping Manager ==
The Sync Mappings are global custom elements. Managing data for these global custom elements can be configured easily through the use of Datasheets. The following sections will describe how to configure a CommonSpot page to manage the data for this element.

=== Steps ===
#Create a new page with the title 'Sync Mappings' and name 'index' in the subsite ''/webadmin/sync/''.
#In the main content of the page, add a Custom Script element.
#From the Custom Script element interface, click the "Edit" icon.
#Enter the following text into the Explicit Module path: /ADF/apps/pt_sync/customcf/sync_mapping_manager.cfm
# From the Datasheet element interface, click the "Datasheet" icon.
# From the "Datasheet Views" dialog, follow the "Click here to create a new datasheet view" link.
# Enter the following information and then click "Next":
## Name: All Sync Mappings
## Private: unchecked
## Default View: unchecked
## Description: View to manage all of the photo sizes
## Datasheet Source: Form Result/Custom Element Sheet
# From the Datasheet Source dialog, choose the "Sync Mapping" custom element and click "Next".
# From the Datasheet Columns dialog select the columns UUIDField, sourceCE, Is Active, and ID fields and move them to the Selected Columns list then click "Finish".
# You will be directed to the Datasheet View page. Click "Close" to return to your page.
# You will now see the datasheet element on this page. Click the Datasheet element interface icon again and choose "Edit Columns".
# Add Action Columns for Edit and Delete.
# Edit the "UUIDField" column.
## Change the "Render Handler" to the following path:
### /ADF/extensions/datasheet-modules/1.0/edit-delete.cfm
# Edit the "SOURCECE" column.
## Change the "Render Handler" to the following path:
### /ADF/extensions/datasheet-modules/1.0/formID-to-CEName.cfm
# Edit the "ID" column.
## Change the "Header" text to "Automate Sync".
## Change the "Render Handler" to the following path:
### /ADF/apps/pt_sync/datasheet-modules/ds-auto-sync-actions.cfm
# Save the form.
# Publish this page.

== CommonSpot Hooks ==
CommonSpot provides hooks for editing global custom element and post page approvals. The PT Sync application utilizes these hooks to call the sync processing functions when a global custom element is added/edited and a local custom element is added/edited with a page and the page is approved.

The following steps are to include the CommonSpot hook files into the '''source site''' (these files are not needed on the destination site).

=== Steps ===
# Copy the following two files from the PT Sync app:
## /pt_sync/site_files/post-approve.cfm
## /pt_sync/site_files/post-save-form-hook.cfm
# Paste these files directly within the site root.
# In the PT Sync App, open the delete form data file within the app (/pt_sync/site_files/datasheet-modules/delete-form-data.cfm). Within the file, identify the snippet code block within the comments for "PT SYNC - SNIPPET START" and "PT SYNC - SNIPPET END".
# Locate the delete form data datasheet module within the site (/datasheet-modules/delete-form-data.cfm). Insert the snippet code block within your sites delete form data. Make sure that the snippet code block is ABOVE the cfinclude to the cs-delete-form-data.cfm.
## <cfinclude template="\commonspot\controls\datasheet\cs-delete-form-data.cfm">

[[Category:PT Sync]]

← Older revision		Revision as of 18:53, 21 December 2011
Line 2:		Line 2:
	Please follow the [[PT_Sync_Install_1.0\|Version 1.0 Install Guide]] to install the PT Sync v1.1 application.		Please follow the [[PT_Sync_Install_1.0\|Version 1.0 Install Guide]] to install the PT Sync v1.1 application.

−	No installation steps have changed with ~~the~~ version 1.1.	+	No installation steps have changed with version 1.1.

@@ Line 1: / Line 1: @@
-== Overview ==
+== Version 1.0 Installation Guide ==
-The following guide will install the PT Sync Application for the source and destination sites.
+Please follow the [[PT_Sync_Install_1.0|Version 1.0 Install Guide]] to install the PT Sync v1.1 application.
-Follow the instructions closely because some steps need to be completed on both the source and destination sites.
+No installation steps have changed with the version 1.1.