DocumentationAEMBrand Portal Guide

Use custom search facets use-custom-search-facets

Last update: Mon Sep 25 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Admin

Administrators can add search predicates to the Filters panel to customize search and make the search functionality versatile.

Brand Portal supports faceted search for granular searches of approved brand assets, which is possible due to Filters panel. Search facets are made available on Filters panel through Search Form in the admin tools. A default search form named Asset Admin Search Rail exists in Search Forms page in admin tools. However, Administrators can customize the default Filters panel by editing the default Search Form (Asset Admin Search Rail) by adding, modifying, or removing search predicates, thereby making the search functionality versatile.

You can use various search predicates to customize the Filters panel. For example, add the property predicate to search for assets that match a single property that you specify in this predicate. Add the options predicate to search for assets that match one or more values that you specify for a particular property. Add the date range predicate to search for assets created within a specified date range.

NOTE
Experience Manager Assets allows organizations to publish the customized search forms from AEM Author to Brand Portal, instead of re-creating the same form on Brand Portal.

Add a search predicate add-a-search-predicate

To add a search predicate to the Filters panel:

  1. To access administrative tools, click the Experience Manager logo from the toolbar at the top.

  2. From the administrative tools panel, click Search Forms.

  3. In the Search Forms page, select Assets Admin Search Rail.

  4. On toolbar that appears at the top, click Edit to open the edit search form.

  5. In the Edit Search Form page, drag a predicate from the Select Predicate tab to the main pane. For example, drag Property Predicate.

    The Property field appears in the main pane and the Settings tab on the right displays property predicates.

    note note
    NOTE
    The header label in the Settings tab identifies the type of predicate you select.

  6. In the Settings tab, enter a label, placeholder text, and description for the property predicate.

    • Select Partial Search, if you want to allow partial phrase search (and wildcard search) of assets-based on the specified property value. By default, the predicate supports the full-text search.
    • Select Ignore Case, if you want the asset search based on property value to be non-case sensitive. By default, the search for property values in search Filter is case-sensitive.
    note note
    NOTE
    On selecting Partial Search checkbox, Ignore Case is selected by default.

  7. In the Property Name field, open property picker and select the property based on which the search is performed. Alternatively, enter a name for the property. For example, enter jcr :content/metadata/dc:title or ./jcr:content/metadata/dc:title.

    note note
    NOTE
    In Brand Portal, all the String properties (except the ones starting with xmp) in jcrcontent/metadata of dam:asset are indexed by default. Rest all other custom properties of any type are not indexed, by default.
    Any property which is indexed can be used while creating a property predicate. If any non-indexed property is configured, the search query on an un-indexed property may not give any search result.

  8. Click Done to save the settings.

  9. From the Assets user interface, click the overlay icon and choose Filter to navigate to the Filters panel. The Property predicate is added to the panel.

  10. Enter a title for the asset to be searched in the Property text box. For example, “Adobe”. When you perform a search, assets with the title matching “Adobe” are displayed in the search results.

List of search predicates list-of-search-predicates

Similar to the way you add a Property predicate, you can add the following predicates to the Filters panel:

Predicate Name
Description
Properties
Path Browser
Search predicate to search assets at a particular location. Note: For a logged-in user, path browser on Filter shows only the content structure of the folders (and their ancestors) shared with the user.
Admin users can search assets in any folder by navigating to that folder using Path Browser.
Whereas, non-admin users can search assets in a folder (accessible to them) by navigating to that folder in Path Browser.
  • Field Label
  • Path
  • Description
Property
Search assets based on a particular metadata property. Note: On selecting Partial Search, Ignore Case is selected by default.
  • Field Label
  • Placeholder
  • Property Name
  • Partial Search
  • Ignore Case
  • Description
Multi-Value Property
Similar to property predicate but allows multiple input values, separated by a delimiter (default is COMMA[,]) assets matching any of the input values are returned in results.
  • Field Label
  • Placeholder
  • Property name
  • Delimiter Support
  • Ignore Case
  • Description
Tags
Search predicate to search assets based on tags. You can configure the Path property to populate various tags in the Tags list. *Note: Administrators might need to change the path value, for example, /etc/tags/mac/<tenant_id>/<custom_tag_namespace>, if they publish the search form from AEM, where the path does not include tenant information, for example, /etc/tags/<custom_tag_namespace>.
  • Field Label
  • Property name
  • Path
  • Description
Path
Search predicate to search assets at a particular location.
  • Field Label
  • Path
  • Description
Relative Date
Search predicate to search assets based on the relative date of their creation.
  • Field Label
  • Property name
  • Relative date
Range
Search predicate to search assets that lie within a specified range of property values. In the Filters panel, you can specify minimum and maximum property values for the range.
  • Field Label
  • Property name
  • Description
Date Range
Search predicate to search assets created within a specified range for a date property. In the Filters panel, you can specify Start and End dates.
  • Field Label
  • Placeholder
  • Property name
  • Range text (From)
  • Range text (To)
  • Description
Date
Search predicate for a slider-based search of assets based on a date property.
  • Field Label
  • Property name
  • Description
File Size
Search predicate to search assets based on their size.
  • Field Label
  • Property name
  • Path
  • Description
Asset Last Modified
Search predicate to search assets based on the last modified date.
  • Field Label
  • Property name
  • Description
Approval Status
Search predicate to search assets based on approval metadata property. The default property name is dam:status.
  • Field Label
  • Property name
  • Description
Checkout Status
Search predicate to search assets based on the check-out status of an asset when it was published from AEM Assets.
  • Field Label
  • Property name
  • Description
Checked Out By
Search predicate to search assets based on the user who has checked out the asset.
  • Field Label
  • Property name
  • Description
Expiry Status
Search predicate to search assets based on the expiration status.
  • Field Label
  • Property name
  • Description
Member of collection
Search predicate to search assets based on whether an asset is a part of a collection.
Description
Hidden
This predicate is not explicitly visible to the end users and is used for any hidden constraints typically for restricting search results type to dam:Asset.
  • Field Label
  • Property name
  • Description
NOTE
  • Do not use Options Predicate, Publish Status Predicate, and Rating Predicate as these predicates are not functional in Brand Portal.
  • Folder type predicate (nt:folder type) is not supported on Brand Portal and may cause performance issues. If it is present in published custom search form then it can be deleted by editing search form.

Delete a search predicate delete-a-search-predicate

To delete a search predicate, follow these steps:

  1. Click the Adobe logo to access administrative tools.

  2. From the administrative tools panel, click Search Forms.

  3. In the Search Forms page, select Assets Admin Search Rail.

  4. On toolbar that appears at the top, click Edit to open the edit search form.

  5. In the Edit Search Form page, from the main pane, select the predicate you want to delete. For example, select Property Predicate.

    The Settings tab on the right displays property predicate fields.

  6. To delete the property predicate, click the bin icon. On the Delete Field dialog box, click Delete to confirm the delete action.

    The Property Predicate field is removed from the main pane, and the Settings tab becomes empty.

  7. To save the changes, click Done in the toolbar.

  8. From the Assets user interface, click the overlay icon and choose Filter to navigate to the Filters panel. The Property predicate is removed from the panel.

recommendation-more-help
4a60ca76-1c10-45cf-87aa-95ab647d0ca3