Using Filter By Attribute in Adobe FrameMaker 8.0

In this tutorial we will explore one of the new options available in FrameMaker 8.0: the possibility to filter content in a structured FrameMaker document based on attributes. With a few easy steps you can single out desired attributes in a structured FrameMaker document by using a complex filter. When the filter is in use every element that does not match your chosen attributes will be hidden. You will also learn how to build expressions to filter your document according to your needs.


To follow along with this article, you need this software:

Prerequisite knowledge:

Using Filter by attribute

  1. In FrameMaker 8.0, choose File > Open and choose the file. Click Open.
  2. In general, content can be filtered by conditional tagging. Content of structured FrameMaker documents can also be filtered by attributes; this is not possible in an unstructured document, since they have neither elements nor attributes .In the Structure View window you will find various attributes that each are assigned to different values. For instance you will find "User Level" and "Output". These are the smallest values that can be filtered.

  3. Go to the Structure View window and select the attribute "UserLevel". Notice that the attribute has three assigned values: "Beginner", "Intermediate" and "PowerUser".
  4. Now select the attribute "Output". The Output attribute has three values: "CD", "Print" and "Web".
  5. Choose Special > Filter by Attribute....
  6. This opens up the Manage Attribute Expressions dialog box.

  7. Click the button New. This opens up the Build Expression dialog.
  8. In this dialog, you can create new expressions.

    Image 1

    Figure 1: The Build Expression dialog.

  9. To enter a new name for the expression, type in the Expression Tag input field: “PowerUser+Web”.
  10. From the list of attributes select "UserLevel", and click Add Attribute.
  11. The attribute now appears in the Expressions box. The value of the UserLevel is "PowerUser". This matches with our desired expression.

    You can define the value of an attribute by yourself:

  12. Click the Define Values button.
  13. From the list of attributes select the attribute you want to assign with a new value, in this case Output.
  14. In the New Value box, type Web and click ADD Value. (see Figure 2)
  15. Image 2

    Figure 2: Type in the new value and click ADD Value.

  16. When you are finished, click Set.
  17. The attribute Output now has a new value assigned. We can go on building our expression.

  18. In the Build Expression dialog, click the AND button, to add a Boolean operator to the expression.
  19. Select the item Output and click Add attribute.
  20. In the expression box you can see the added Attribute "Output" and its value "Web".

  21. The expression is finished. Click OK.
  22. A new expression has now been created in the Manage Attribute Expressions dialog box.

  23. Select the new expression "PowerUser+Web" and click Apply.
  24. Only the content that relates to both the attributes "PowerUser" and "Web" are now shown in the document. (See Figure 3)

    Image 3

    Figure 3: Only the content that relates to the attributes "PowerUser" and "Web" are shown in the document.

    Note: if you are a quick typist, you can also enter new expressions directly in the Build Expression dialog.

Where to go from here

For more information and additional tutorials, visit the Adobe Design Center.