How to set up the Eclipse Faces Config Visual Editor


Summary
By default, the ArcGIS Web Project template that comes with the ArcGIS for Server for Java Web ADF plug-in for Eclipse IDE extends the Eclipse Dynamic Web Project template. This provides the base for a Web Mapping Application that is a Java Server Faces (JSF) application. To take advantage of Eclipse Web Tools Platform (WTP) JSF tools, you need to associate your Web project as a JavaServer Faces Facet in Eclipse.
This topic shows the steps required to set up this association so that you can take advantage of the Faces Config Visual Editor.

Setting up the Eclipse Faces Config Visual Editor

The Eclipse Web Tools Platform (WTP) JSF tools have been provided with Eclipse Java EE bundles since the Ganymede release. To take advantage of the Faces Config Visual Editor in your ArcGIS Web project, you need to perform the following steps in your Eclipse Developer Environment:
  1. Create a Web ADF project using the Eclipse Esri Web ADF templates, or use an existing Web ADF Project. 
  2. Rename your project's web.xml (for example, web_orig.xml), as this process will create a new web.xml file and overwrite the project's web.xml. The Web ADF project depends on the web.xml file that the Web ADF plug-in creates, so you don't want to overwrite it.
  3. Right-click the project and select Properties.
  4. In the Properties dialog box, select Project Facets from the list on the left, and check the JavaServer Faces project facet. See the following screen shot:

  5. Click the Further configuration required link near the bottom of the dialog box. The Modify Faceted Project dialog box appears.
  6. Accept the Server Supplied JSF Implementation option on the JSF Capabilities page of the Modify Faceted Project dialog box and click OK. See the following screen shot:

  7. Click OK on the Project Properties dialog box. 
  8. Delete the web.xml file that was generated by the JSF Facets dialog box and rename the original file you changed in step 1 back to web.xml.
  9. Double-click the faces-config.xml file. The Faces Configuration Introduction page appears, and you can now use the visual editor capabilities to edit your faces-config file. See the following screen shot:



    If the Faces Configuration Introduction page did not appear, right-click the faces-config.xml file and select Open With to ensure that the Faces Config Editor is the default editor.
  10. Once your faces-config file is opened in the visual editor, you'll see the various tab options at the bottom of the editor that allow you to visually edit different aspects of the file. For example, to edit the Managed Beans in your application, click the ManagedBean tab to open the editor, then add or remove beans, or select a bean to edit. See the following screen shot:







Development licensingDeployment licensing
ServerServer