Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

A ribbon group's Group Button is the handle that appears in the lower right corner of a ribbon group.

Sample Group Button
Follow these steps to define the group button:

  1. Open the Applications Ribbons record for which you want to define a Group Button, if not already opened.
  2. Click the Application Ribbon Groups tab and open the group whose group button you want to define, if not already opened.
  3. Select the Enable Group Button option, if not already selected.
  4. Click the Group Button tab.
  5. Enter a Name for the button.
  6. Enter a Display Name for the button. Note that this name does not appear on the ribbon since a Group Button is not labelled.
  7. If localizing the system for other cultures, enter the Culture String that you want to use for this button's Display Name in the Display Name Culture String field. See Working with Culture Strings in the Admin Guide for more information. Note that this name does not appear on the ribbon since a Group Button is not labeled.
  8. Select the Action Type for the button. See Defining the Ribbon Button Action Types for  for information on the available options.

    Note

    The Preferred Size On Ribbon, Minimum Size On Ribbon, First In Group, and Priority fields are not applicable for Group Buttons.


    Configure Group Button

  9. Click the Appearance tab.
  10. Specify tool tip text in the Tool Tip Text field. This text appears when a user hovers over the button (if a Tool Tip with Culture String is not specified).
  11. If localizing the system for other cultures, enter the Culture String that you want to use for this button's tool tip in the Tool Tip with Culture field. See Working with Culture Strings in the Admin Guide for more information.

    Note

    Leave the Small Image and Large Image fields blank. These fields are not applicable for Group Buttons.

    Group Button Appearance

  12. Click the Action Properties tab and enter the appropriate information to define the action that occurs when this button is clicked. See Defining the Ribbon Button Action Types for  for more information.

  13. Click OK to save and close the Application Ribbon Groups record.
  14. Save and close the Applications Ribbons record.

Button Action Types

A button can use one of the following Action Types:

This section describes each action type and each type's configuration parameters.

...

The Generic Data Wizard action type launches a specified metadata wizard. See Metadata Wizards on for information on metadata wizards. Follow these steps to link a wizard to a ribbon button:

  1. From the General tab on the Button form, select Generic Data Wizard from the Action Type drop-down field.
  2. Select the Action Properties tab.
  3. Enter the Target Entity for the wizard in the field provided. (Each wizard is linked to a Target Entity.)
  4. Select an available wizard from the drop-down list based on the Target Entity you selected.
  5. Note that only wizards with a scope of Global or Application are available for selection. Application-scoped wizards are only available if you are working with a dashboard linked to the wizard's specified application.
  6. Click OK to save the button.

...

  1. record

...

  • To specify default parameters for new records opened by the button, use this -syntax:

...

The Preview Report action type launches an Aptify report in a new window.

  1. From the General Tab on the Button form, select Preview Report in the Action Type field.
  2. Select the Action Properties tab.
  3. In the Service field, enter the service associated with the report to display.
  4. In the View field, enter the view that contains the records to display in the report. Only views owned by the current user can be added to this field.
  5. Select the report to display from the Report drop-down list, which contains those reports associated with the selected service.
  6. Click OK to save the button.

...

The Print Report action type prints an Aptify report to the default printer. A window displays confirming the printing of the report.

  1. From the General tab on the Button form, select Print Report in the Action Type field.
  2. Select the Action Properties tab.
  3. In the Service field, enter the service associated with the report to print.
  4. In the View field, enter the view that contains the records to display in the report. Only views owned by the current user can be added to this field.
  5. Select the report to print from the Report drop-down list, which contains those reports associated with the selected service.
  6. Click OK to save the button.

...

The Run Entity Bulk Operation action type runs a specified entity bulk operation. See Entity Bulk Operations for information on how to create entity bulk operations.

  1. From the General tab on the Button form, select Run Entity Bulk Operation in the Action Type field.
  2. Select the Action Properties tab.
  3. Enter a bulk operation in the Bulk Operation field.
  4. In the View field, enter the view that contains the records on which to run the selected bulk operation.
  5. Click OK to save the button.

...

The Run Find Dialog action type launches a Find Items dialog box in a new window for the service specified on the Action Properties tab.

  1. From the General tab on the Button form, select Run Find Dialog in the Action Type field.
  2. Select the Action Properties tab.
  3. In the Services field, enter the service in which to perform the search.
  4. Click OK to save the button.

...

The Run Process Flow action type executes a process flow using the input values you specify. See the Aptify Process Pipeline Functionality Guide for information on configuring and using Process Flows.

...

The Run Wizard action type launches a specified wizard.

  1. From the General tab on the Button form, select Run Wizard in the Action Type field.
  2. Select the Action Properties tab.
  3. In the Service field, enter the service associated with the wizard you want to run.
  4. In the View field, enter the view that contains the records that the wizard can use during its execution. This field is not required.
  5. Select an available wizard (associated with the selected service) from the Wizard drop-down list.
  6. Click OK to save the button.

...

The Switch Dashboard action type switches to the global Home tab or a specified application level tab.

  1. From the General tab on the Button form, select Switch Dashboard in the Action Type field.
  2. Select the Action Properties tab.
  3. Select Global Dashboard or Application Dashboard from the Dashboard Type drop-down menu.If you selected the Application Dashboard, then enter the application in the Application field.
    Click OK to save the button.