Contents

 
Preface
Introducing Software AG MashZone NextGen
MashZone NextGen welcome page
Open a dashboard in MashZone NextGen
Use the dashboard editor
Use dashboards in view mode
Display a dashboard in view mode
Use interactive filters in dashboards
Use the filter panel of Process Mining context-based widgets
Refresh data of widgets
Pause automatic data refreshing
Change column width and sort order
Use lists for multiple selection
Save widget data as a CSV file
Manage dashboards
Open a dashboard in the dashboard editor
Create a dashboard in the dashboard editor
Use smart dashboard edit mode
Insert new row
Delete a row
Resize a row
Lock row height
Change a row order
Place a widget
Resize widgets
Avoid line break in dashboard view mode
Group widgets
Set row style
Set layout group style
Set dashboard tab style
Switch to fixed-grid workspace
Edit a dashboard
Delete a dashboard
Edit dashboard properties
Manage dashboard permissions
Change dashboard style template
Use the Process Mining context
Create a Process Mining context
Edit a Process Mining context
Delete a Process Mining context
Assign data columns to Process Mining context-based widgets
Configure filters for Process Mining context-based widgets
Configure a date filter for a Process Mining context
Exclude a widget from a Process Mining context filter
Enable the filter panel
Configure the filter panel
Migrate a dashboard context
Use Multi-lingual dashboards
Configure languages for translation
Translate the widget content
Select the language for your dashboard
Translate the tab title
Configure widgets
Set up widgets
Insert widgets in a dashboard
Copy and paste widgets in dashboards
Assign data sources to widgets
Assign data columns to line, column or bar charts
Set properties of widget elements
Configure KPI thresholds
Configure KPI rating
Assign data columns to pie charts
Set properties of widget elements
Assign data columns to bubble charts
Set properties of widget elements
Configure KPI thresholds
Assign data columns to grids
Set properties of widget elements
Configure thresholds
Assign data columns to lists
Set properties of widget elements
Assign data columns to circular gauge charts
Set properties of widget elements
Configure thresholds
Assign data columns to horizontal and vertical gauge charts
Set properties of widget elements
Configure thresholds
Assign data columns to traffic lights
Set properties of widget elements
Configure thresholds
Assign data columns to a drop-down box
Set properties of widget elements
Assign data columns to labels
Set properties of widget elements
Assign data columns to a rich text area
Set properties of widget elements
Assign data columns to sliders
Set properties of widget elements
Assign data columns to date filters
Assign data columns to vector map
Set properties of widget elements
Configure KPI thresholds
Assign data columns to map with markers
Set properties of widget elements
Configure KPI thresholds
Create input parameters
Display legend
Remove widgets from dashboard
Define filters for widgets
Specify actions for widgets
Change tab
Set selection
Call URL
Specify an image source URL
Post data
Send events
Hide or display widget header and border
Resize widgets
Move widgets to the foreground or background
Display widgets on multiple dashboard tabs
Change widget style template
Configure dashboard tabs
Add dashboard tabs
Delete dashboard tabs
Set dashboard tab properties
Set dashboard tab style
Set dashboard tab as default
Other
Use dynamic URL selection
Hide tab bar in view mode
Set display size
Set grid lines
Allow anonymous access to dashboards
PPM data source operator
File resources
Customize the MashZone NextGen welcome page
Display dashboards without application header
Export dashboards
Import dashboards
Create widget style template
Use the data feed editor
Create a data feed
Open a new data feed
Select data sources
Calculate the feed data
Add further operators
Connect the operators
Save the data feed
Edit a data feed
Delete data feeds
Edit data feed properties
Manage data feed permissions
Change the feed editor style
Data feed operators
Use Materialized Feeds
Use datasets storing data feed results
Administrate Materialized Feeds in Terracotta DB
Use datasets from external application
Which privileges are required?
Other
Import data feeds
Export data feeds
Display data feed without application header
Valuable information
What are dashboards?
What are data feeds?
What is the view-only license?
Administration
Open the Admin Console
MashZone NextGen Security
Manage your MashZone NextGen profile
Manage your locale and account information
Change your password
MashZone NextGen server
MashZone NextGen repository
Change technical user password
Authentication and Guest Access
User Authentication
Valid Credentials
Sessions and Timeouts
Default User Accounts
Authentication with Single Sign-On Solutions
Configuration for Agent-Based SSO Solutions
Implementing a Custom SSO Filter
SSO integration in My webMethods
Authorization Policies and Permissions
Grant User Access to MashZone NextGen with Built-in Groups
Built-In MashZone NextGen User Groups and Permissions
Access Policies Using MashZone NextGen Built-In Groups
Protect MashZone NextGen Event Service access
Anti-Clickjacking prevention when using iFrame
MashZone NextGen HTTP header security filter
Example
MashZone NextGen Content Security Policy
Add a trusted site to allow iFrame
Add multiple trusted sites to allow iFrame
Content-Security-Policy using wildcards
Handle personal data in log files
Getting Started with the MashZone NextGen Server
Additional MashZone NextGen System and Software Requirements
Additional Recommendations for MashZone NextGen
What is Installed with MashZone NextGen
Start and Stop the MashZone NextGen Server
Start the MashZone NextGen Event Service
Start the MashZone NextGen Server
Stop the MashZone NextGen Event Service
Stop the MashZone NextGen Server
Startup Considerations
Manage Licenses for MashZone NextGen and BigMemory
Move the MashZone NextGen repository to a robust database solution
Troubleshooting Connections to the MashZone NextGen Repository
Move the MashZone NextGen repository to Microsoft SQL Server
Move the MashZone NextGen repository to MySQL
Move the MashZone NextGen repository to Oracle
Move the MashZone NextGen repository to PostGres
Integrate Your LDAP Directory with MashZone NextGen
Defining LDAP Connection Configuration
Defining the Authentication Scheme
Defining the Authorization Scheme
Enabling MashZone NextGen Application Queries for All LDAP Users or Groups for Permissions
Use the Default MashZone NextGen User Repository
Manage Users
Create Users
Edit, Grant Permissions and other User Management Tasks
Manage User Groups
Automatically Assign New Users to Groups
Grant dashboard and data feed permissions via API console
Enable dashboard and data feed creation
Install MashZone NextGen and MashZone NextGen Event Service as Windows services
Command Central
MashZone NextGen plug-in
Required installer modules
Instance Overview
Instance Configuration
Instance Logs
Enable remote JMX connection
MashZone NextGen Event Service plug-in
Instance overview
Instance configuration
Instance Logs
Configure MashZone NextGen Digital Event Service (DES)
Configure ports
Configure keystores
Configure truststores
Configure SSL certifcates
Manage licenses
MashZone NextGen Server Configuration
Memory Configuration for the MashZone NextGen Server
Configuration When MashZone NextGen Uses Only Heap Memory
Configuration When MashZone NextGen Uses Heap and Off-Heap Memory
Support International Character Sets and Locales
Set the Repository Character Encoding
Set the Repository Timezone or Offset
Date, Time and Numeric Display Options
Message Log and Default Locales
Edit style templates
Configure the MashZone NextGen server with custom ports
Change MashZone NextGen Server Ports
Change MashZone NextGen Repository Ports
Tomcat Application Server Port
Configure the MashZone NextGen server to work with a proxy server
Embedding MashZone NextGen in external system environments
Configure MashZone NextGen server to work with iFrame
Post data
URL selection
Define a Proxy Server Whitelist for MashZone NextGen
Using Regular Expressions in a Whitelist
Specifying Literal Dot Separators
Specifying Domains
Specifying Host Names
Configure MashZone NextGen for SSL and Digital Certificates
The Certificate Store and Certificates
Key Certificate Pairs
Trusted Peer Cerficates
The Certificate Store
Configure Mutual SSL Between Users and MashZone NextGen
One-Way SSL to MashZone NextGen
One-Way SSL to Information Sources
Configure HTTPS and Certficate Stores in the Application Server
Update SSL Configuration for Java
MashZone NextGen Logging
Configure Logging for the MashZone NextGen Server
Audit logging for dashboards, data feeds, aliases, and permissions
MashZone NextGen Notifications
Configuring a Mail Server for MashZone NextGen
Update the User Email Attribute from LDAP
BigMemory for Caching, Connections and In-Memory Stores
Caching for the MashZone NextGen Server
Artifact Caching
Response Caching
Distributed Caching for MashZone NextGen Clusters
Configure BigMemory Servers for MashZone NextGen Caching
Working with BigMemory Stores for RAQL
Declared In-Memory Stores
Declare a new In-Memory Store
Modify a Declared In-Memory Store
View Details for Declared In-Memory Stores
Dynamic In-Memory Stores
Manage Dynamic BigMemory Stores for MashZone NextGen Analytics
Add an External Dynamic In-Memory Store Connection
Delete External Dynamic In-Memory Store Connections
Manage Terracotta DB connections
Register Terracotta DB connections
Edit Terracotta DB connections
Test Terracotta DB connections
Share Terracotta DB connections
Delete Terracotta DB connections
Manage data sources and drivers
Add a data source
Edit, test or remove data sources
Share data sources
Add or manage JDBC drivers
Migrate JDBC connections
Migrate JDBC configuration of Presto to MashZone NextGen
Migrate JDBC connections of Presto to MashZone NextGen
Migrate JDBC configuration of MashZone NextGen 9.10
Migrate JDBC connections of MashZone legacy to MashZone NextGen
Manage map files
Manage geoJSON files
Manage tile server configuration files
Tune memory/caching for MashZone NextGen
Tune MashZone Memory and Cache Configuration Manually
Update Cache Memory Settings
Update MashZone ThreadSize Properties
Manage Materialized Feeds
Configure Materialized Feeds
Edit Materialized Feeds
Delete Materialized Feeds
Share Materialized Feeds
Materialize data feed results in Terracotta DB
Use the Admin Console
Use the API Console
Use the server administration tool
Use server web services
MashZone NextGen Server Administration
Manage Files for MashZone NextGen Features or Artifacts
Add External Resources as MashZone NextGen Files
Find MashZone NextGen Files
Update or Delete MashZone NextGen Files
Manage resource directories
Create resource directory
Change resource directory
Delete resource directory
Share resource directory
Manage URL aliases
Create URL alias
Change URL alias
Delete URL alias
Share URL alias
Deploying MashZone NextGen Instances, Clusters or Artifacts
Deploying the Core Widgets
Deploying MashZone NextGen Artifacts and Other Metadata
Export users, user metadata and groups
Export dashboards
Export data feeds
Import users, user metadata and groups
Import dashboards
Import data feeds
Deploying multiple MashZone NextGen servers in one host
Clustering MashZone NextGen Servers
Setting Up a New Cluster
Adding New Members to an Existing Cluster
Sharing the MashZone NextGen Repository in Clustered Environments
Create and Share a New MashZone NextGen Repository
Share an Existing MashZone NextGen Repository
Setting Up an External MashZone NextGen Configuration Folder
MashZone NextGen File-Based Configuration and Extensions
MashZone NextGen Configuration Files That Can Be External
MashZone NextGen Configuration Files That Must Be Internal
MashZone NextGen Extensions
MashZone NextGen dashboards in a clustered scenario
Preliminary
Configuration
MashZone NextGen Event Service
rtbs.properties
zookeeper.properties
server.properties
MashZone NextGen nodes
Customizing dashboards
Custom styles
Custom widgets
Using JDBC drivers
Local file resources
Event Service Configuration and Administration
About the Event Service and Event Data
Use Events as Information Sources
Manage EDA Event Sources
Create EDA Event Sources
Edit EDA Event Sources
Simple and Hybrid Throttling Strategies
Duplicate EDA Event Sources
Delete EDA Event Sources
Share EDA Event Sources
Manage Apama Event Sources
Create Apama Event Sources
Duplicate Apama Event Sources
Delete Apama Event Sources
Edit Apama Event Sources
Share Apama Event Sources
Manage DES Event Sources
Create DES Event Source
Edit DES Event Sources
Simple and Hybrid Throttling Strategies
Duplicate DES Event Sources
Delete DES Event Sources
Share DES Event Sources
Activate DES in MashZone NextGen
Start or Stop an Event Source
Restart all Event Sources
Manage Apama Instances
Create Apama Instances
Edit Apama Instances
Delete Apama Instances
Manage Apama Event Targets
Create Apama Event Targets
Edit Apama Event Targets
Delete Apama Event Targets
Share Apama Event Target
Process Performance Manager Integration
Manage PPM Connections
Create PPM Connections
Edit PPM Connections
Delete PPM Connections
Share PPM connections
webMethods Business Console Integration
Example
Authentication
Example URL
Configuration
Outbound API
Inbound API
MashZone NextGen Repositories
Maintenance Suggestions
Tuning the MashZone NextGen Repository Connection Pool
Connection Pool Size Properties
Idle Pool Connection Properties
Synchronize the MashZone NextGen Repository and MashZone NextGen Server Time Zones
Appendix
Widgets
Action button
Bar chart
Bubble chart
Circular gauge chart
Column chart
Date filter
Drop-down box
Grid
Horizontal and vertical gauge chart
Image
Input field
Label
Line chart
List
Map with markers
Pie chart
Rich text area
Slider
Jump to PPM client
Traffic lights
Vector map
Operators
Data source operators
ARIS table
BigMemory
CSV
Data feed
Events
JDBC
JSON
Excel
PPM
Add filter
Terracotta DB
XML
URL parameter syntax
RAQL and SQL statement parameters
JDBC parameters
RAQL parameters
Data transformation operators
Aggregate
Parameters
Aggregation type
Examples
Arithmetic
Parameters
Example
Average
Parameters
Change data type
Parameters
Examples
Change data type - single value
Parameters
Examples
Column to value
Parameters
Combine data feeds
Parameters
Concatenate data feeds
Parameters
Concatenate texts
Parameters
Conditional replace
Parameters
Comparison operators
Convert text
Parameters
Copy data feeds
Parameters
Copy single value
Parameters
Delete column
Parameters
Duplicate column
Parameter
Extract text
Parameters
Filter by date
Parameters
Filter rows
Parameters
Find text index
Parameters
Goal accomplishment
Parameters
Insert column
Parameter
Merge single texts
Parameters
Move date
Parameter
Example
RAQL Inline
Parameters
Example
Rename column
Parameter
Replace text
Parameters
Round up/down
Parameter
Round up/down date
Parameter
Examples
Runtime info
Parameters
Value to column
Parameters
User input operators
Date user input
Parameters
Date user input (List)
Parameters
Number user input
Parameters
Number user input (List)
Parameters
Text user input
Parameters
Text user input (List)
Parameters
Analytics with RAQL
About the Real-Time Analytical Query Language
Scope of RAQL
RAQL in MashZone NextGen
Working with RAQL queries
Query Syntax of RAQL
Data types in RAQL
Creating dynamic RAQL queries
Language reference
Reserved keywords
Syntax Reference
ExplainOrSelectStatement
CharacterConstant
SelectStatement
SelectWithOrder
QueryExpressionBody
QueryTerm
QueryPrimary
SelectWithoutOrder
SelectList
SelectItem
SelectStar
ObjectName
SqlSimpleExpression
SqlMultiplicativeExpression
SqlExponentExpression
SqlUnaryExpression
SqlPrimaryExpression
SqlExpression
SqlAndExpression
SqlUnaryLogicalExpression
SqlRelationalExpression
SqlExpressionList
SqlRelationalOperatorExpression
Relop
SqlInClause
SqlBetweenClause
SqlLikeClause
IsNullClause
Constant
FunctionCall
CastableDataTypeDeclaration
UserDefinedType
SimpleCaseCall
BooleanCaseCall
AggregateFunctionCall
SourceField
GenericFunctionCall
ConstantList
WindowSpecification
OrderByClause
WindowFrameClause
WindowFrameStart
FrameBound
WindowFrameBound
GroupingOperation
WindowFunctionCall
LongConstant
IntegerConstant
ArrayElementReference
ArrayValueConstructor
Alias
FromClause
FromItem
SourceReferenceOrSubquery
SourceReference
JoinedTable
SourceFieldList
WhereClause
GroupByClause
GroupingElementList
GroupingElement
EmptyGroupingSet
OrdinaryGroupingSet
GroupingExpressionReferenceList
GroupingExpressionReference
RollupList
OrdinaryGroupingSetList
CubeList
GroupingSetsSpecification
GroupingSetList
GroupingSet
HavingClause
LimitClause
S_NUMBER
FLOAT
INTEGER
DIGIT
S_PARAMETER
S_IDENTIFIER
NAMESTARTCHAR
NAMECHAR
S_QUOTED_IDENTIFIER
S_CHAR_LITERAL
IgnorableWhitespace
LINE_COMMENT
MULTI_LINE_COMMENT
RAQL extensions
RAQL function extensions
Plain functions
Analytic functions
Window functions over RANGEs
Migrate RAQL queries from Version 3.7 to 3.8
Update plain functions for 3.8
Update analytic functions for 3.8
Creating new user-defined functions
Set Up Your Development Environment
Write Plain Functions for RAQL
Configure, Compile, Deploy and Test User-Defined Functions
UDF Library Configuration
External UDF Library Deployment Folder
Write Window Analytic Functions for RAQL
Construct and Initialize the Window Analytic Function Class
Implement the call Method for the Window Analytic Function
Complete WindowSum Example
Work with Specific Records in Window Calculations
Write Aggregate Analytic Functions for RAQL
My Average Aggregate Example
Kurtosis Using a Third Party Library
Use a Factory for Function Overloading
MashZone NextGen Platform API Console
Open the MashZone NextGen API Console
MashZone NextGen Platform Services
Input Parameters for JUMP Requests
Parameter Values
Root Cause Miner
Symptoms and root causes
Limitations
Score
Scaled system
Permissions
How to use the Root Cause Miner widget
Additional Information and Support
Samples, Help and Other Documentation
Version and License Information
Legal information
Documentation scope
Data protection
Legal notices
Index