Blocks

Analysis Block Management

Manage analysis blocks within notebooks including filters, calculators, and alerts. Complete operations for working with process mining analysis blocks.

Features

Block Type Discovery

Discover all available block types (filters, calculators, enrichments) in a single API call with complete metadata.

Discover Block Types

Block Management

Get, update, and delete analysis blocks. Create blocks via the Notebook API.

Manage Blocks

Block Execution

Execute individual blocks and monitor processing status with asynchronous queuing.

Execute Blocks

Block Results

Retrieve analysis results and execution history from completed block executions.

Get Results

Block Types

Explore different block types including filters, calculators, and alert configurations.

Explore Types

Available Endpoints

Block Type Discovery

  • GET /api/tenant/{tenantId}/project/{projectId}/block/types/all - Get all block types (filters, calculators, enrichments) in a single call

Connectivity Testing

  • GET /api/{tenantId}/{projectId}/block/unauthorized-ping - Public connectivity test (no auth required)
  • GET /api/{tenantId}/{projectId}/block/ping - Authenticated connectivity test

Block Operations

  • GET /api/{tenantId}/{projectId}/block/{blockId} - Get block details
  • PUT /api/{tenantId}/{projectId}/block/{blockId} - Update block metadata
  • DELETE /api/{tenantId}/{projectId}/block/{blockId} - Delete a block

Block Execution

  • POST /api/{tenantId}/{projectId}/block/{blockId}/execute - Queue block for execution

Block Results

  • GET /api/{tenantId}/{projectId}/block/{blockId}/results - Get execution results
  • GET /api/{tenantId}/{projectId}/block/{blockId}/output-data - Get output data (via ExecutionController)

Creating Blocks

Block creation is handled through the Notebook API:

POST /api/{tenantId}/{projectId}/notebook/{notebookId}/blocks

See Notebook API for block creation details.

Block Types

mindzieStudio supports various types of analysis blocks:

Filter Blocks

Apply filters to focus analysis on specific data subsets and conditions.

  • Activity filters
  • Time period filters
  • Case attribute filters

Calculator Blocks

Perform calculations and generate metrics from process mining data.

  • Duration calculations
  • Frequency analysis
  • Performance metrics

Alert Blocks

Configure monitoring alerts and notifications for process deviations.

  • Threshold alerts
  • Pattern detection
  • Compliance monitoring

Common Use Cases

  • Dynamic Analysis: Build and modify analysis workflows programmatically
  • Automated Reporting: Execute blocks on schedule and export results
  • Custom Dashboards: Create tailored visualizations with specific block configurations
  • Data Processing Pipelines: Chain multiple blocks for complex analysis workflows
  • Real-time Monitoring: Set up alert blocks for continuous process monitoring

Authentication

All Block API endpoints (except unauthorized-ping) require valid authentication with appropriate permissions for the target tenant and project.

Getting Started

Begin with Block Management to learn how to work with blocks, then explore Block Types for specific analysis configurations.