Difference between revisions of "Building an ADF Application"

From ADF Docs
Jump to: navigation, search
(Created page with '== Overview == == Guide to Creating a New ADF Application == The following steps are instructions for creating a new application in the ADF. # A 'Starter App' is provided in t…')
 
(Core folders and files)
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
== Overview ==
 
== Overview ==
 +
ADF Applications are a combination of custom coding, CommonSpot API calls, and CommonSpot Custom Elements.  Applications can do many things but on a whole they are used to allow content contributors to easily manage structured data within the CommonSpot site.
  
 +
== Prerequisites ==
 +
To build Applications using the ADF it is essential that you become familiar with some of the common interfaces available to you as a developer.  Since the ADF is an extension of CommonSpot, the more you know about how CommonSpot works in general the better.  Some places to get started:
 +
* CommonSpot Documentation: browse to /commonspot/help/ on your CommonSpot Authoring server to gain access to all of the documentation available in your installation
 +
* Browse the Articles on the [http://community.paperthin.com/articles/browse.cfm CommonSpot Community Site] to learn what others are doing with the API's
 +
* Contact your Account Manager for upcoming training dates
  
== Guide to Creating a New ADF Application ==
+
== Core folders and files ==
 
The following steps are instructions for creating a new application in the ADF.
 
The following steps are instructions for creating a new application in the ADF.
  
# A 'Starter App' is provided in the '/ADF/apps/' directory.  See the [[Starter_Application|Starter Application]] wiki page for more details.
+
Note: A 'Starter App' is available for download on the [http://community.paperthin.com/projects/pt_starter_app/ CommonSpot Community Site].
# Copy this 'Starter App' directory into the apps directory and rename the folder to the name of your application.
+
  See the [[Starter_Application|Starter Application]] wiki page for more details.
 +
 
 +
# Pick a name for your application <!-- (See [[Best Practices for ADF Applications]] for more on naming your application) -->
 +
# Create a new directory for your application (application names and application directories do NOT have to match) within the /ADF/apps/ directory
 +
# Copy the contents of the 'Starter App' into your new application directory
 
# Open the 'AppBeanConfig.cfm' file in your applications directory.  See the [[App Bean Config|App Bean Config]] wiki page for more details.
 
# Open the 'AppBeanConfig.cfm' file in your applications directory.  See the [[App Bean Config|App Bean Config]] wiki page for more details.
 
# Update the 'appBeanName' variable with the name for your application and the comment header at the top of the file with your application name.
 
# Update the 'appBeanName' variable with the name for your application and the comment header at the top of the file with your application name.
<source lang="java">
+
 
 +
<pre>
 
// App specific variables
 
// App specific variables
appBeanName = "STARTER_APP";
+
appBeanName = "myAppName";
</source>
+
</pre>
 +
 
 
# Save the updated 'AppBeanConfig.cfm' file.
 
# Save the updated 'AppBeanConfig.cfm' file.
 
# [[Reset_ADF|Reset the ADF]] for the server and site.  
 
# [[Reset_ADF|Reset the ADF]] for the server and site.  
 
# If no error messages appear, then your application is configured within the ADF.
 
# If no error messages appear, then your application is configured within the ADF.
 +
 +
== Adding functionality ==
 +
Where you go from here is very much up to you.  Some things that you might do are:
 +
* Build a CommonSpot Custom Element(s) to house your content
 +
* Build a [[Custom Field Type]] to enhance the management of data
 +
* Construct some [[Application Components]] to help control the entry and display of data from your Custom Element(s)
 +
 +
[[ADF Applications|Back to ADF Applications]]
 +
 +
[[Category: How-to Guide]]

Latest revision as of 14:25, 9 October 2014

Overview

ADF Applications are a combination of custom coding, CommonSpot API calls, and CommonSpot Custom Elements. Applications can do many things but on a whole they are used to allow content contributors to easily manage structured data within the CommonSpot site.

Prerequisites

To build Applications using the ADF it is essential that you become familiar with some of the common interfaces available to you as a developer. Since the ADF is an extension of CommonSpot, the more you know about how CommonSpot works in general the better. Some places to get started:

  • CommonSpot Documentation: browse to /commonspot/help/ on your CommonSpot Authoring server to gain access to all of the documentation available in your installation
  • Browse the Articles on the CommonSpot Community Site to learn what others are doing with the API's
  • Contact your Account Manager for upcoming training dates

Core folders and files

The following steps are instructions for creating a new application in the ADF.

Note: A 'Starter App' is available for download on the CommonSpot Community Site.
See the Starter Application wiki page for more details.
  1. Pick a name for your application
  2. Create a new directory for your application (application names and application directories do NOT have to match) within the /ADF/apps/ directory
  3. Copy the contents of the 'Starter App' into your new application directory
  4. Open the 'AppBeanConfig.cfm' file in your applications directory. See the App Bean Config wiki page for more details.
  5. Update the 'appBeanName' variable with the name for your application and the comment header at the top of the file with your application name.
// App specific variables
appBeanName = "myAppName";
  1. Save the updated 'AppBeanConfig.cfm' file.
  2. Reset the ADF for the server and site.
  3. If no error messages appear, then your application is configured within the ADF.

Adding functionality

Where you go from here is very much up to you. Some things that you might do are:

  • Build a CommonSpot Custom Element(s) to house your content
  • Build a Custom Field Type to enhance the management of data
  • Construct some Application Components to help control the entry and display of data from your Custom Element(s)

Back to ADF Applications