Appearance
Glossary
Definitions of key terms and concepts used throughout the Datascaphe Uplink documentation.
Administrator One of three Datascaphe user roles. Has full access to all backend features, including user management, organization settings, billing, and service principal configuration.
Analysis A named configuration within a Scanner Definition that links a Power BI table/column pair to a specific report page popup and filtering behavior. Each analysis must have a unique name within the same report.
API Key A credential for programmatic access to Datascaphe Uplink, bypassing the standard user authentication flow. Scoped to a role, which determines which API endpoints and operations the key can access. Typically used for server-to-server integrations or automated workflows, such as chaining ELT refresh with report refresh, or Service Principal renewal.
Auto Add Users An organization-level setting that automatically grants backend access (as Viewers) to users who sign up with the organization's domain, without requiring administrator approval.
Azure Active Directory (Azure AD / Entra ID) Microsoft's cloud identity and access management service. Used by Datascaphe Uplink for user authentication and Service Principal registration.
Azure Tenant A dedicated instance of Azure Active Directory associated with an organization. Contains users, groups, app registrations, and verified domain names. Required to use Datascaphe Uplink's Power BI integration features.
Azure Tenant ID A 36-character GUID that uniquely identifies an Azure tenant. Must be configured in the Datascaphe organization settings and synchronized to enable tenant-dependent features.
Backend The Datascaphe web application management interface (datascaphe.com) used by administrators and developers to manage reports, users, organizations, service principals, and scanner definitions.
Backend Access A user-level flag that controls whether a user can log in to the Datascaphe backend interface. Users without backend access can still use the browser extension if they have a license.
Cache / Cache Duration Temporary storage of scanner data to reduce repeated queries to the Power BI datasets. Scanner data is cached at two levels: on the user's device (local cache) and on Datascaphe servers (server cache). The cache duration defines how long cached data remains valid before it must be refreshed. Minimum: 1800 seconds (30 minutes). Default: 86400 seconds (24 hours).
Chrome Extension The Datascaphe browser extension installed in Google Chrome (or any CHromium base browser). It scans the content of web pages for search terms matching values in a configured Power BI semantic model, highlights matched terms, and displays contextual Power BI report popups.
Client ID The Azure Application (Client) ID of an Entra ID app registration. A 36-character GUID used to identify a Service Principal.
Client Secret A credential generated for an Entra ID app registration and used to authenticate a Service Principal. Stored encrypted in Datascaphe and never retrievable after the initial save.
Cron Expression A scheduling syntax used to define recurring scanner data cache refresh times. Schedules are interpreted in the configured timezone and stored in UTC.
Dataset The Power BI semantic model associated with a report. Contains the tables and columns queried by Datascaphe to build scanner data. Also referred to as "semantic model."
Dataset ID The 36-character GUID identifying a specific Power BI dataset. Required when linking a report in Datascaphe. Can be found in the Power BI service URL or via the Datascaphe browser extension.
Datascaphe Uplink The Datascaphe product that enables contextual Power BI report display and interaction directly in the browser, based on terms detected on the web pages a user visits.
Developer One of three Datascaphe user roles. Can configure reports and scanner definitions but cannot manage users, roles, billing, or organization-level settings.
Display Page The name of the Power BI report page shown in the smart popup when a scanner analysis is triggered by a matched term on a web page.
Domain Name An internet domain used to identify and group users belonging to an organization. Domain names registered in an organization allow automatic user association on sign-up.
Embedded Capacity A Microsoft Power BI licensing tier. A capacity (Fabric or Embedded) is required when using a Service Principal to authenticate against the Power BI API. This is a Microsoft licensing requirement.
Fabric Capacity A Microsoft Power BI licensing tier. A capacity (Fabric or Embedded) is required when using a Service Principal to authenticate against the Power BI API. This is a Microsoft licensing requirement.
GUID Globally Unique Identifier. A 36-character identifier format (e.g. 550e8400-e29b-41d4-a716-446655440000) used throughout Datascaphe and Power BI for Report IDs, Dataset IDs, Workspace IDs, and Tenant IDs.
License Type The license level assigned to a Datascaphe user. Possible values: no license (no active license), free (trial period), pro (paid license). A license is required to use the browser extension after the trial period.
Local Cache Scanner data stored on the user's device by the browser extension. The first source checked when a user opens a new web page. Avoids unnecessary network requests for recently fetched data.
Match Full String A Scanner Definition option that, when enabled, restricts term matching to full-word matches only. When disabled, the extension also highlights the term when it appears as part of a longer word.
Organization The top-level grouping entity in Datascaphe, representing a company or association. Associated with one or more internet domains. Billing is managed at the organization level.
Organization Code A unique identifier automatically generated when an organization is created in Datascaphe. Required when configuring the browser extension to associate it with the correct organization.
Personal Workspace A Power BI workspace private to a single user (called "My Workspace" in the Power BI service). Not supported by Datascaphe — reports must be published in a shared workspace.
Power BI Microsoft's business intelligence and data visualization platform. Datascaphe Uplink integrates with Power BI to embed reports and retrieve dataset values for scanning web pages.
Power BI API The Microsoft REST API used by Datascaphe to retrieve report metadata (name, workspace) and query dataset values for building scanner data.
Power BI Pro A Microsoft Power BI license required to publish and share reports in shared workspaces. A prerequisite for using Datascaphe Uplink.
Prevent User Signup An organization-level setting that blocks users with the organization's domain from self-registering on Datascaphe. When enabled, users must be added manually by an administrator.
Ref Column The column in a Power BI semantic model whose values the scanner uses to detect matches on web pages. Specified in a Scanner Definition or Scanner Synonym.
Ref Table The table in a Power BI semantic model that contains the Ref Column used as a reference for a scanner analysis.
Report The logical representation of a Power BI report in Datascaphe Uplink. Identified by its Report ID and Dataset ID. Can be configured with RLS, a Service Principal, cache settings, and a scanner data refresh schedule. Each user can be assigned one active report.
Report ID The 36-character GUID identifying a specific Power BI report. Required when linking a report in Datascaphe. Found in the Power BI report URL or via the Datascaphe browser extension.
RLS (Row Level Security) A Power BI feature that restricts which rows of data a user can see, based on their identity. When RLS is enabled on a report in Datascaphe, scanner data is cached per user instead of at the report level, ensuring each user only sees terms they have access to.
Role A permission level that defines what actions an entity can perform. For users: Administrator, Developer, or Viewer. For API Keys: the same role values apply and scope which API endpoints are accessible.
Scanner The component of the Chrome extension that scans the text content of web pages, identifies terms matching values from the Power BI dataset, and triggers highlighting and popup display.
Scanner Data The column values extracted from the Power BI dataset according to the Scanner Metadata specifications. These values become the search terms that the Chrome extension looks for when scanning web pages.
Scanner Definition Configuration that specifies how Datascaphe should scan web pages for a given report. Defines which Power BI table/column to use as a source of search terms, which report page to display in the popup, and display options such as highlight color and match behavior.
Scanner Metadata Structured information generated from Scanner Definitions and Synonyms. Configures how the Chrome extension detects terms on web pages and which report page to display. Combines the structural definition (from Scanner Definition) with the actual values (Scanner Data).
Scanner Synonym An extension of a Scanner Definition that maps additional Power BI table/column pairs to the same analysis. Allows values from multiple columns or tables to trigger the same report popup and filtering.
Search Terms The values extracted from Power BI dataset columns (as defined in Scanner Definitions) that the Chrome extension searches for when scanning a web page. When a match is found, the term is highlighted and the associated report popup is shown.
Self-Service Mode The default user management mode. The end user's own account is used to authenticate Power BI API calls when fetching scanner data. Requires the user to have build permission on the Power BI dataset.
Semantic Model See Dataset. The Power BI data model containing tables, columns, measures, and relationships. The term used by Microsoft for what was previously called a "dataset."
Server Cache Scanner data stored on Datascaphe servers. Shared across all users of a report (unless RLS is enabled, in which case it is stored per user). The second source checked by the extension after the local cache.
Service Principal An Azure AD/Entra ID app registration used by Datascaphe to authenticate against Power BI APIs without requiring an end user to be signed in. Required for scheduled scanner data refresh. Can be assigned at the report level (applies to all users of the report) or the user level (applies only to that specific user). Requires Premium or Embedded Capacity.
Shared Workspace A Power BI workspace accessible to multiple users. Required for Datascaphe — reports published in personal workspaces (My Workspace) are not supported.
Smart Popup The contextual Power BI report popup displayed by the Chrome extension when a search term is detected on a web page. Shows the configured Display Page of the associated report, filtered to the matched value.
Uplink Short name for Datascaphe Uplink. See Datascaphe Uplink.
User An individual account in Datascaphe Uplink belonging to an organization. Has two access layers: Backend access (management interface) and Extension access (browser extension and report embedding). A license is required for Extension access after the trial period.
Viewer One of three Datascaphe user roles. Can use the browser extension and view limited backend pages (own report, organization info, account). Cannot edit reports, manage users, or configure service principals.
Workspace A Power BI collaborative environment where reports and datasets are published and shared. Must be a shared workspace (not a personal workspace) for use with Datascaphe.
Workspace ID The 36-character GUID identifying a Power BI workspace. Automatically retrieved by Datascaphe from the Power BI API after a report is linked.