<?xml version="1.0" encoding="UTF-8" ?>
<!--
    Copyright (c) 2006, 2019 IBM Corporation and others.
    This program and the accompanying materials
    are made available under the terms of the Eclipse Public License 2.0
    which accompanies this distribution, and is available at
    https://www.eclipse.org/legal/epl-2.0/

    SPDX-License-Identifier: EPL-2.0

    Contributors:
        IBM Corporation - initial API and implementation
 -->

<cheatsheet title="Faces Configuration Editor">

	<intro
		href="/org.eclipse.platform.doc.user/reference/ref-cheatsheets.htm">
		<description>
			This cheat sheet will demonstrate how to edit a JSF
			configuration file with Faces Config Editor.
			<br />
			<br />
			To learn more about using cheat sheets, click the help
			button in the top right corner (?).
		</description>
	</intro>

	<!-- Item -->

	<item title="Open the J2EE perspective"
		href="/org.eclipse.jst.j2ee.doc.user/topics/cjpers.html"
		dialog="false" skip="true">
		<description>
			To open the J2EE perspective, select
			<b>Window-&gt;Open Perspective-&gt;Other...</b>
			and choose
			<b>J2EE</b>
			.
			<br />
			<br />
			Alternatively, click the following button to perform the
			task.
		</description>
		<command
			serialization="org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.jst.j2ee.J2EEPerspective)" />
	</item>

	<!-- Item -->

	<item title="Create the JSF web project"
		href="/org.eclipse.jst.jsf.doc.user/html/tasks/create_jsf_app.html"
		dialog="true" skip="false">
		<description>
			To create the JSF web application perform the following
			steps
		</description>
		<subitem
			label="Select &quot;File-&gt;New-&gt;Project...&quot; from the main menu and choose &quot;Dynamic Web Project&quot; from the resulting &quot;New Project&quot; dialog box"
			skip="false">
			<command
				serialization="org.eclipse.ui.newWizard(newWizardId=org.eclipse.jst.servlet.ui.project.facet.WebProjectWizard)" />
		</subitem>
		<subitem
			label="Input &quot;JSFApplication&quot; into the &quot;Project Name&quot; text box"
			skip="false" />
		<subitem
			label="Select &quot;JavaServer Faces v1.1 Project&quot; in the &quot;Configurations&quot; dropdown box"
			skip="false" />
		<subitem
			label="Accept the rest of the default preloaded values on the &quot;Dynamic Web Project&quot; page and click &quot;Next&quot;"
			skip="false" />
		<subitem
			label="Accept the rest of the default preloaded values on the &quot;Project Facets&quot; page and click &quot;Next&quot;"
			skip="false" />
		<subitem
			label="Accept the rest of the default preloaded values on the &quot;Web Module&quot; page and click &quot;Next&quot;"
			skip="false" />
		<subitem
			label="Specify JSF Facet Settings on the &quot;JSF Capabilities&quot; page and click &quot;Finish&quot;"
			skip="false" />
	</item>

	<item title="Open the JSF configuration file"
		href="/org.eclipse.jst.jsf.doc.user/html/tasks/use_facesconfig_editor.html"
		dialog="true" skip="false">
		<description>
			To open the JSF configuration file, Expand the
			WebContent/WEB-INF/ folder in the &quot;Project
			Explorer&quot; view; Double click on the
			&quot;faces-config.xml&quot; file to open it. Or right click
			on it then select &quot;Open With&quot; -> &quot;FacesConfig
			Editor&quot;
		</description>
		<subitem
			label="Expand the /JSFApplication/WebContent/WEB-INF/ folder in the &quot;Project Explorer&quot; view; "
			skip="true">
		</subitem>
		<subitem
			label="Double click on the &quot;faces-config.xml&quot; file to open it.
			Or right click on it then select &quot;Open With&quot; -> &quot;FacesConfig Editor&quot;"
			skip="false">
			<command
				serialization="org.eclipse.ui.navigate.openResource(filePath=JSFApplication/WebContent/WEB-INF/faces-config.xml)" />
		</subitem>
	</item>


	<item href=" " title="Get an introduction on the FacesConfig Editor"
		dialog="false" skip="true">
		<description>
			On the &quot;Introduction &quot; page, there are some
			introductions about the FacesConfig Editor, and some links
			to start work with it, or show user the tutorial and help
			documentation.
		</description>
	</item>


	<item href=" " title="Get an overview of the content" dialog="false"
		skip="true">
		<description>
			On the &quot;Overview &quot; page, there are several tables
			that list the main elements defined in the current faces
			config file. By double-clicking on an element, user could be
			guided to the corresponding page to edit it.
		</description>
	</item>

	<item
		href="/org.eclipse.jst.jsf.doc.user/html/tasks/define_navigations.html"
		title="Create a Navigation Rule">
		<description>
			To create a navigation rule perform the following steps
		</description>
		<subitem
			label="Use the JSP Page wizard to create a page called &quot; login.jsp &quot; in the Web Content folder of the new application. 
			In the Select Templates page of the wizard, select the &quot;New JSP(html) &quot; template. Click Finish."
			skip="false">
			<command
				serialization="org.eclipse.ui.newWizard(newWizardId=org.eclipse.jst.jsp.ui.internal.wizard.NewJSPWizard)" />
		</subitem>
		<subitem
			label="In the same way, create a page called &quot;welcome.jsp &quot; ."
			skip="false">
			<command
				serialization="org.eclipse.ui.newWizard(newWizardId=org.eclipse.jst.jsp.ui.internal.wizard.NewJSPWizard)" />
		</subitem>
		<subitem
			label="Select the &quot;Page&quot; control from the &quot;Palette&quot; and drop it on the &quot;Navigation&quot; tab. 
			Choose the page in the resulting &quot;Select JSP File&quot; dialog. "
			skip="false" />
		<subitem
			label="Connect the two pages. Click on the &quot;Link&quot; control in the &quot;Palette&quot;, select the &quot;login&quot; page and draw a line to the &quot;welcome&quot; page. 
			Select the line in the &quot;Navigation&quot; tab and in the property view, set the value of the &quot;from-outcome&quot; to &quot;login&quot; . "
			skip="false" />
		<subitem
			label="Swith to the &quot;Source&quot; page, will find that there is a navigation-rule element created."
			skip="false" />
	</item>

	<item
		href="/org.eclipse.jst.jsf.doc.user/html/tasks/create_managedbean.html"
		title="Create a Managed Bean">
		<description>
			To create a managed bean perform the following steps
		</description>
		<subitem
			label="Switch to the &quot;ManagedBean&quot; page; click the &quot;New&quot; button, the new managed bean wizard pops up."
			skip="false" />
		<subitem
			label="On the &quot;Java Class Selection&quot; page, choose &quot;Create a new Java class&quot;, then click &quot;Next&quot;."
			skip="false" />
		<subitem
			label="On the &quot;Java Class&quot; page, input &quot;com.tutorial&quot; into the &quot;Package&quot; field and input &quot;LoginBean&quot; into the &quot;Name&quot; field, 
			then click &quot;Next&quot; to the next page."
			skip="false" />
		<subitem
			label="On the &quot;Managed Bean Configuration&quot; page, accept the default values and click &quot;Finish&quot; to finish this wizard."
			skip="false" />
		<subitem
			label="Swith to the &quot;Source&quot; page, will find that there is a managed-bean element created."
			skip="true" />
	</item>

	<item
		href="/org.eclipse.jst.jsf.doc.user/html/tasks/facesconfig_ui/add_component.html"
		title="Create a Component">
		<description>
			To create a component perform the following steps
		</description>
		<subitem
			label="Switch to the &quot;Component&quot; page; expand the &quot;Components&quot; section; "
			skip="false" />
		<subitem
			label="Click the &quot;New&quot; button, a new empty component element is created."
			skip="false" />
		<subitem
			label="On the right part, fill in the essential fields for this component, for example &quot;Component Type&quot;, &quot;Component Class&quot;."
			skip="false" />
		<subitem
			label="Swith to the &quot;Source&quot; page, will find that there is a component element created."
			skip="false" />
	</item>


	<item
		href="/org.eclipse.jst.jsf.doc.user/html/tasks/facesconfig_ui/add_converter.html"
		title="Create a Converter">
		<description>
			To create a converter perform the following steps
		</description>
		<subitem
			label="Switch to the &quot;Component&quot; page; expand the &quot;Converters&quot; section; "
			skip="false" />
		<subitem
			label="Click the &quot;New&quot; button, a new empty converter element is created."
			skip="false" />
		<subitem
			label="On the right part, fill in the essential fields for this converter, for example &quot;Converter ID&quot;, &quot;Converter Class&quot;."
			skip="false" />
		<subitem
			label="Swith to the &quot;Source&quot; page, will find that there is a converter element created."
			skip="false" />
	</item>

	<item
		href="/org.eclipse.jst.jsf.doc.user/html/tasks/facesconfig_ui/add_renderkit.html"
		title="Create a Render Kit">
		<description>
			To create a render-kit perform the following steps
		</description>
		<subitem
			label="Switch to the &quot;Component&quot; page; expand the &quot;RenderKits&quot; section; "
			skip="false" />
		<subitem
			label="Click the &quot;New&quot; button, a new empty render-kit element is created."
			skip="false" />
		<subitem
			label="On the right part, fill in the essential fields for this converter, for example &quot;Renderkit ID&quot;, &quot;Renderkit Class&quot;."
			skip="false" />
		<subitem
			label="Swith to the &quot;Source&quot; page, will find that there is a render-kit element created."
			skip="false" />
	</item>

	<item
		href="/org.eclipse.jst.jsf.doc.user/html/tasks/facesconfig_ui/add_validator.html"
		title="Create a Validator">
		<description>
			To create a validator perform the following steps
		</description>
		<subitem
			label="Switch to the &quot;Component&quot; page; expand the &quot;Validators&quot; section; "
			skip="false" />
		<subitem
			label="Click the &quot;New&quot; button, a new empty validator element is created."
			skip="false" />
		<subitem
			label="On the right part, fill in the essential fields for this converter, for example &quot;Validator ID&quot;, &quot;Validator Class&quot;."
			skip="false" />
		<subitem
			label="Swith to the &quot;Source&quot; page, will find that there is a validator element created."
			skip="false" />
	</item>

	<item
		href="/org.eclipse.jst.jsf.doc.user/html/tasks/use_facesconfig_editor.html"
		title="Editing other elements on the Others Page">
		<description>
			On the &quot;Others&quot; page, there are several sections
			for editing the elements such as
			&quot;action-listener&quot;, &quot;locale-config&quot;, and
			so on.
		</description>
	</item>

	<item title="Source Page">
		<description>
		   The &quot;Source&quot; page is a embeded XML editor, user can edit the xml source of faces config directly here.
		</description>
	</item>

	<item title="Completion">
		<description>
			Congratulations, you should now be able to use this editor fluently.
		</description>
	</item>
</cheatsheet>