Skip to main content

Introduction to OpenConnector

OpenConnector is a powerful Nextcloud application that enables seamless data synchronization between various sources and targets. It's designed to help you integrate your Nextcloud environment with external systems and the Open Register.

Key Featuresโ€‹

  • Source Integration: Connect to various data sources
  • Target Synchronization: Push data to multiple destinations
  • Open Register Support: Native integration with Open Register
  • Flexible Mapping: Configure how data should be transformed
  • Automated Sync: Schedule and automate your data flows

Main Componentsโ€‹

๐Ÿ“Š Dashboardโ€‹

Get an overview of all your synchronization activities and system status.

๐Ÿ”Œ Sourcesโ€‹

Configure and manage your data sources:

  • API endpoints
  • File systems
  • Databases
  • External services

๐ŸŽฏ Endpointsโ€‹

Define and manage API endpoints for data exchange.

๐Ÿ‘ฅ Consumersโ€‹

Set up and manage data consumers that process your synchronized data.

๐Ÿ”„ Mappingsโ€‹

Create data transformation rules to map source data to target formats.

โš™๏ธ Jobsโ€‹

Schedule and monitor automated synchronization tasks.

โ˜๏ธ Cloud Eventsโ€‹

Handle and process cloud events for real-time data synchronization.

๐Ÿ“ Eventsโ€‹

Configure event-driven data synchronization workflows.

๐Ÿ”„ Synchronizationโ€‹

Manage your synchronization processes and schedules.

๐Ÿ“‹ Rulesโ€‹

Define business rules and conditions for data synchronization.

๐Ÿ‘ค User APIโ€‹

Secure JSON-based API endpoints for user management and authentication:

  • Get current user information
  • Update user profiles
  • Secure user authentication with comprehensive protection
  • See User API Documentation for complete reference

โš™๏ธ Settingsโ€‹

Configure global settings for OpenConnector.

Getting Startedโ€‹

To get started with OpenConnector, check out our Getting Started Guide or dive into our Tutorial.

Open Register Documentation

This directory contains the documentation website for Open Register, built with Docusaurus 2.

Installationโ€‹

Install the dependencies:

npm install

Local Developmentโ€‹

Start the development server:

npm start

This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.

Buildโ€‹

Build the static files:

npm run build

This command generates static content into the build directory and can be served using any static contents hosting service.

Deploymentโ€‹

The documentation is automatically deployed to GitHub Pages when changes are pushed to the documentation branch.

Project Structureโ€‹

website/ โ”œโ”€โ”€ docs/ # Documentation markdown files โ”œโ”€โ”€ src/ # React components and pages โ”œโ”€โ”€ static/ # Static files (images, etc) โ”œโ”€โ”€ docusaurus.config.js # Site configuration โ”œโ”€โ”€ package.json # Project dependencies โ”œโ”€โ”€ README.md # This file โ””โ”€โ”€ sidebars.js # Sidebar configuration

Contributingโ€‹

  1. Create a new branch from documentation
  2. Make your changes
  3. Test locally using npm start
  4. Create a Pull Request to the documentation branch