Nebol's Wiki

User Tools

Site Tools

Trace:
nebolintegration

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
nebolintegration [2021/09/27 01:05] – nebolnebolintegration [2022/06/16 19:43] (current) – nebol
Line 2: Line 2:
  
 ==== DOCUMENTATION NOT DONE! WORK IN PROGRESS! ==== ==== DOCUMENTATION NOT DONE! WORK IN PROGRESS! ====
 +NebolIntegration is an active project with on-going development, and the documentation is currently lacking. Chunks of it still needs to be written. I will however answer questions to the best of my abilities.
  
 NebolIntegration is a light-weight C# library that manages integrations between systems. NebolIntegration is a light-weight C# library that manages integrations between systems.
Line 13: Line 14:
   * Handles incoming and outgoing integrations   * Handles incoming and outgoing integrations
   * Synchronous and asynchronous integrations   * Synchronous and asynchronous integrations
-  * Extensive logging and error-handling+  * Extensive tracking, logging and error-handling
   * Failed tasks are tried again according to specified schedule   * Failed tasks are tried again according to specified schedule
-  * Tasks can easily be re-sent, re-processed, and responses can be reprocessed +  * Tasks can easily be re-sent, re-processed, and responses can be re-processed 
-  * Multiple healthchecks per integration, built-in or custom coded, with configurable intervals and thresholds+  * Healthchecks, built-in or custom coded, with configurable intervals and thresholds
   * Statistics   * Statistics
 +  * Optional triggers using crontab-format to process integrations
 +  * Scheduling for special handling during maintenance windows etc
   * Reports and notifications   * Reports and notifications
 +  * Automated maintenance (log cleaning)
 +  * Grouping of integration processes simplifies administration
 +  * Optional throttling for demanding processes
  
 NebolIntegrationNotifier (windows application, downloaded separately) provides NebolIntegrationNotifier (windows application, downloaded separately) provides
Line 24: Line 30:
   * Notification when a healthcheck fails (or when it is returned to healthy state)   * Notification when a healthcheck fails (or when it is returned to healthy state)
   * Daily reports of all integrations with statistics per day, week, month, year   * Daily reports of all integrations with statistics per day, week, month, year
 +
 +=== What it will not do ===
 +
 +  * Data translation
  
 === Requirements === === Requirements ===
  
 Storage for the integration data such as an Entity Framework supported database or any other storage supported by SharpRepository (MongoDb, RavenDb, Db4o, XML etc) Storage for the integration data such as an Entity Framework supported database or any other storage supported by SharpRepository (MongoDb, RavenDb, Db4o, XML etc)
- 
  
 ==== Tutorial ==== ==== Tutorial ====
Line 48: Line 57:
 [[NebolIntegration_Incoming_Integration]] - Creating an incoming integration [[NebolIntegration_Incoming_Integration]] - Creating an incoming integration
  
-[[NebolIntegration_Reference_and_Message]] - Managing data+[[NebolIntegration_Reference_and_Message]] - Managing user data (also static vs dynamic tasks)
  
 [[NebolIntegration_More_Integration_Variations]] - Synchronous integrations, overrides, various trickery [[NebolIntegration_More_Integration_Variations]] - Synchronous integrations, overrides, various trickery
Line 82: Line 91:
 Additional topics: Additional topics:
 The database (manual configuration, troubleshooting integration tasks) The database (manual configuration, troubleshooting integration tasks)
 +
 +==== Migration ====
 +
 +Some breaking changes have been made since the early versions:
 +
 +SystemIntegration renamed to Integration
 +
 +Instead of a ISharpRepositoryConfiguration instance the Engine, Integrations etc are now accepting a NebolRepositoryConfiguration instance which has a ISharpRepositoryConfiguration instance plus an optional repository name
  
 ==== Roadmap ==== ==== Roadmap ====
  
-Version 1.1.x.x will support Tasks that are automatically repeated (like in Windows Task Scheduler) thus no Submit will need to be made in the ValidatePolling() method (which was one way to go about it).+Version 1.1.x.x will support "Triggers", that will trigger processing automatically according to a set cron-schedule thus no Submit will need to be made in the ValidatePolling() method (which was one way to go about it). Also full support for the built-in integrations "Updating" and "Cleaning"
  
-Version 1.2.x.x will support running multiple engines & multiple threads per integration.+Version 1.2.x.x will support running multiple engines (clients) & multiple threads per integration.
  
 Version 1.3.x.x will support Schedules that you can setup to plan ahead for maintenance windows, or if you only want the integration to be run on business hours etc. Version 1.3.x.x will support Schedules that you can setup to plan ahead for maintenance windows, or if you only want the integration to be run on business hours etc.
  
  
 +Still not fully planned: 
 +
 +Built-in integrations "Statistics" and "Reports"
 +
 +The additional tables Machine & Application needed for multiple client support
 +
 +Notifying clients (via built-in method or RabbitMQ) instead of client polling
 +
 +Improved built-in UI for command console using NebolConsole and multiple console areas
 +
 +Console command for listing & viewing queue & result items
 +
 +Web UI for administration + links in report-mail for errors etc
 +
 +fixing the issue of direction not being read properly from the db
  
nebolintegration.1632697535.txt.gz · Last modified: 2021/09/27 01:05 by nebol

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki