Versions Compared

Key

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

The Black List defines a set of rules for data which should not be collected or analyzied in the analyzed from monitored environments. For example, page views and interactions by you or other site administrators. All Black List rules are applied from the moment the rule is created and are not retroactive. The Black List can be found in the navigation pane under Administration.

Contents

Anchor
create new rule
create new rule
How to Create a New Rule

  1. In the Navigation pane, under Administration, click Black List. 
  2. In the Central Area, in the bottom left corner, click Add.
  3. In the Add Rule dialog, enter the Name and Description fields.
  4. In the Add Rule dialog, under Define more criteria, select values for the Field Condition and Value fields (see the next sections in this guide for details on these fields).
     
    Create Rule dialogwhich may be Date Range, Website Item, User Name, Authentication Group, URL, Web Server IP Address, User Agent, or Client IP Address. These are all described below.
  5. Choose the Condition you would like to define your field by.
  6. Enter a Value in the text box or use the "..." button to open a search window that depending on the Field.

     Image Added
    Add Rule Dialog
     
  7. Click Add.
  8. Choose a second set of criteria if you would like to combine rule. For example, you may want to black list a Website Item that is only accessed from a specific User Agent.
  9. Click Save.
  10. The new rule is added to the Black List. The Valid From Column in the Central Area displays the date from which and time the rule is appliedwas activated.

    Note: The  Separate rules in the Black List have an OR (1) relationship, while the criteria for a which means they do not influence or rely on each other. Multiple criteria within a single rule have an AND (2) relationship.
    relationship, which means that all criteria within the rule must be met.

    Image Added
    Black List dialog

  11. To edit a rule, simply click on it and edit the parameters as you would when adding a rule.
  12. To delete a rule, select it using the inline check box and click Remove from the bottom left hand corner.

    Image Added

    Edit Rule dialog

     

Anchor
set date
set date
How to Set a Date Range Criterion for a Black List Rule

  1. In the Add Add or Edit Rule dialog , in select Date Range from the Field drop down list, select Date Range.
  2. Click on Browse (...) and select a date range. 

    Setting a date range criterion for a Black List rule

  3. Click OK to confirm your selection.

    Image Added
    Customized Date Range Dialog

Anchor
set

...

website item
set

...

website item
How to Set a

...

Website Item for a Black List Rule

  1. In the Add Add or Edit Rule dialog , in select Website Item from the Field drop down list, select Portal Item.
  2. In the Condition drop Select the desired Condition from the drop-down list, select Choose is (specific) to select a specific item or select is (aggregated) to also include also child items.

...

  1. Click on Browse (...) and select an item using the Object Explorer
  2. Click OK to confirm your selection.

Image Added
Website Item Object Explorer Dialog

 

Anchor
set user
set user
How to Set a User Criterion for a Black List Rule

  1. In the Add or Edit Rule dialog , in the Field drop down list, select User Name or Authentication Group.In  from the ConditionField drop down list, select the desired condition.
  2. Select the desired Condition from the drop-down list.
  3. Click on Browse (...) and search for and select the desired user/group.
  4. Click OK to confirm your selection.

     
    Setting a user criterion for a Black List ruleImage Added
    Select User Name Dialog 

Anchor
set url
set url
How to Set a URL Criterion for a Black List Rule

  1. In the Add or Edit Rule dialog , in select URL from the Field drop down list, select URL .In the Condition drop down list, select the desired condition
  2. Select the desired Condition from the drop-down list.
  3. Enter a URL address in the Value text box.
  4. Click Save to confirm your selection.

     Image Added
    Setting a URL criterion Criterion for a Black List ruleRule
 

Anchor
set webserver ip

...

set webserver ip

...

How to Set a Web Server IP Address Criterion for a Black List Rule

  1. In the Add or Edit Rule dialog select Web Server IP Address from the Field drop down list.
  2. Select the desired Condition from the drop-down list.
  3. Enter an IP address in the Value text box.
  4. Click Save to confirm your selection.

    Image Added
    Setting a Web Server IP Address Criterion for a Black List Rule

Anchor
set user agent
set user agent
How to Set a User Agent Criterion for a Black List Rule

  1. In the Add or Edit Rule dialog
, in
  1. select User Agent from the Field drop-down list,
select IP Address.In the Condition drop down list, select the desired condition
  1. .
  2. Select the desired Condition from the drop-down list.
  3. Enter a User Agent string in the Value text box.
  4. Click Save to confirm your selection.

     Image Added
    Setting a User Agent Criterion for a Black List Rule


Anchor
set client ip
set client ip
How to Set a Client IP Address Criterion for a Black List Rule

  1. In the Add or Edit Rule dialog select Client IP Address from the Field drop down list.
  2. Select the desired Condition from the drop-down list.
  3. Enter an IP address in the Value text box.
  4. Click Save to confirm your selection.

     Image Added
    Setting
an
  1. a Client IP Address
criterion
  1. Criterion for a Black List
rule
  1. Rule