Skip to main content

Export Connections - OData API

JustPerform exposes its data through a standardized OData API, enabling external systems to consume planning and consolidation data. This allows for seamless integration with BI tools, custom applications, and other enterprise systems.

v25.12:  You can expose OData snippets via OData services by referencing their Technical ID, and export the report via API. For how to create OData snippets, see OData Snippets.

Enabling OData Export

  1. Enable OData Service

    1. Navigate to System Administration

    2. Select API Configuration

    3. Enable OData Service

    4. Configure service endpoint URL

  2. Define Exposed Entities

    1. Select data models to expose

    2. Choose specific tables/views

    3. Set field-level permissions

    4. Configure relationships

  3. Set Access Permissions

    1. Define read/write permissions

    2. Configure entity-level security

    3. Set row-level security rules

    4. Enable query restrictions

API Configuration

Service Endpoints

  • Service Endpoint: https://<API-justperform-instance>/justperform/Workspace/odata/$metadata

  • Metadata URL: https://<API-justperform-instance>/odata/SheetNames

Authentication Methods

API Key Authentication

  1. Generate API keys per consumer

  2. Set expiration policies

  3. Monitor usage per key

OAuth 2.0

  1. Configure OAuth provider

  2. Set up client applications

  3. Define scopes and permissions

SSO Integration

  1. Leverage existing SSO

  2. Map user permissions

  3. Session-based access

Best Practices for Consumers

Parameter

Best Practices for Consumers

Efficient Querying

  • Use $select to limit fields

  • Apply appropriate filters

  • Implement pagination

  • Cache frequently accessed data

Error Handling

  • Handle rate limit responses

  • Implement retry logic

  • Log failed requests

  • Monitor error patterns

Performance Optimization

  • Use batch operations

  • Minimize round trips

  • Compress requests/responses

  • Implement connection pooling

Was this article helpful?

We're sorry to hear that.