Opaque URI (opaqueuri)

[ 1 Description ] [ 2 How does it work in the search window? ] [ 3 How does it work in LINQ? ]

Description

You can apply this operation either as a Filter or Create field operation:

Filter	Retrieves only opaque URIs from a specified field.
Create field	Creates a Boolean field that shows true if a given URI is opaque.

Opaque URIs differ from absolute URIs in that they don't describe a path to a resource. A typical example of opaque URI is a mailto URI (mailto:a@b.com)

How does it work in the search window?

Select Filter / Create field in the search window toolbar, then select the Opaque URI operation. You need to specify one argument:

Argument	Data type

Argument	Data type
URI ^mandatory	string

If you use the Create field operation, the data type of the values in the new field is boolean (true or false).

Example

In the demo.ecommerce.data table, we want to get only the events where the URIs in the referralUri field are opaque. To do it, we will apply a Filter using the Opaque URI operation.

The arguments needed for the filter are:

URI - referralUri field

Click Filter data. Since there are no opaque URIs in the referralUri field, you will see the following result:

To add a new Boolean field that shows true when the URIs in the referralUri field are opaque, click Create field and follow the same steps.

How does it work in LINQ?

Use the operator where... to apply the Filter operation and select... as... to apply the Create field operation. This is the syntax for the Opaque URI operation:

opaqueuri(string)

Examples

You can copy the following LINQ script and try the above example on the demo.ecommerce.data table:

from demo.ecommerce.data
  where opaqueuri(referralUri)

And this is the same example using the Create field operation:

from demo.ecommerce.data
  select opaqueuri(referralUri) as opaque_uris