Show TOC

Creating and Embedding PanesLocate this document in the navigation structure

Use

In this step, you create the standard General Properties , Summary , What's Next panes and custom panes, and embed them in your wizard.

Procedure

Creating Panes

  1. Add a component usage for any predefined panes that you want to include in your wizard.

    For example, the following adds the General Properties pane:

    1. Right-click Used Components and select Add Used Component. The New Web Dynpro Component Usage dialog opens.

    2. In the Name field, enter IGeneralProperties .

    3. Next to the Used Web Dynpro Component field, click Browse and select IGeneralProperties , and then click OK .

    4. Click Finish .

    The following predefined panes are available (pane display name and component are shown in the Pane column):

    Pane

    Description

    General Properties

    com.sap.portal .adminstudio.igeneralpane .IGeneralProperties

    Enables an administrator to enter a name, object ID, and other basic information for a new portal object.

    Summary

    com.sap.portal .adminstudio.isummarypane .ISummary

    Displays a summary of all the basic information that was entered for a new portal object.

    What's Next

    Indicates that the wizard is finished, and displays a set of actions available on the newly created object. The actions are those that were specified in the Admin-Studio configuration for the type of the new object and classified with the whatsNext aspect. If no actions were specified for this object in the configuration, the What's Next pane displays the three default options:

    • Open the object for editing

    • Restart the wizard

    • Close tab

    Finish

    Indicates the wizard is finished, and enables the user to open the newly created object, restart the wizard, or close the wizard.

    The Finish pane is available for wizards that do not use the What's Next pane.

    This pane is added and configured by implementing the useFinishPane() method. You do not need to add a component usage.

  2. Perform the following in the IWizard window:

    1. In the window's Properties view, add the following as required controllers:

      • IWFContainer component usage and component interface controller

      • Component controller

    2. For each predefined pane, add the corresponding component usage and component interface controller as required controllers.

      For example, if you used the General Properties pane, add the IGeneralProperties component usage and component interface controller.

    3. For each predefined pane, add code to the wdDoInit() method to create an instance of the pane.

    The following code adds instances for the General Properties , Summary and What's Next panes.

    public voidwdDoInit()
    {
      //@@begin wdDoInit()
      wdThis.wdGetIGeneralPropertiesComponentUsage().createComponent(
          WizardFWAPIInfo.GENERAL_PROPERTIES_NAME,
          WizardFWAPIInfo.GENERAL_PROPERTIES_NAMESPACE);
      wdThis.wdGetIGeneralPropertiesInterface().setParamsHolderUsage(
          wdThis.wdGetMyWizardCompController().wdGetContext()
          .currentWizardFWNodeElement().getParamsHolderComponentUsage());
     
     
      wdThis.wdGetISummaryComponentUsage().createComponent(
          WizardFWAPIInfo.SUMMARY_NAME,
          WizardFWAPIInfo.SUMMARY_NAMESPACE);
      wdThis.wdGetISummaryInterface().setParamsHolderUsage(
          wdThis.wdGetMyWizardCompController().wdGetContext()
          .currentWizardFWNodeElement().getParamsHolderComponentUsage());
      wdThis.wdGetIWhatsNextUsage().createComponent(
          WizardFWAPIInfo.WHATS_NEXT_NAME,
          WizardFWAPIInfo.WHATS_NEXT_NAMESPACE);
      //@@end
    }
    
                      
  3. Create a view for each custom pane that you want to create for your wizard.

    Use any logic or UI elements that you want. You can make use of the component controller context, which contains information about the portal object that triggered the wizard and information about the user input in predefined panes.

    For more information on the component controller context, see Wizard Context .

Embedding Panes in the IWizard Window

Perform the following in the IWizard window:

  1. Embed the predefined panes as follows:

    1. Select the Navigation view.

    2. In the editor, right-click and select Embed View .

    3. Select Embed Interface View of a Component Interface , and click Next .

    4. Select the component interface view for the pane that you want to add.

    5. Click Finish .

  2. Embed your custom panes as follows:

    1. Select the Navigation view.

    2. In the editor, right-click and select Embed View .

    3. Select Embed existing View , and click Next .

    4. Select the custom pane view.

    5. Click Finish .

  3. Set the Default property for all the embedded views to false .

    To display the property editor for a view, select the window's Navigation view and select a view in the editor.

  4. Create the navigation schema for the panes as follows:

    1. Create an outbound plug in the window for each pane (view).

    2. In each custom pane (view), create an inbound plug. Each predefined pane already has an inbound plug.

    3. Create a link from each outbound plug in the window to the corresponding inbound plug in the corresponding pane.

Proceed to the next step Implementing Methods .