BUILDING WITH INTERA

8 articles

Build an INTERA Integration Module: the architecture, the contract every module follows, sample code, testing and packaging.

01 Integration Architecture High-Level Architecture A typical INTERA Integration consists of: An Integration Module may expose one or more capabilities, including: The Integration Module is responsible for communicating with the external system. INTERA Core is responsible for consuming the capabilities declared by the Integration. Integration Module An Integration Module is the reusable software component that implements support for […] 8 min 02 Build Your First Integration This chapter explains how to create a basic INTERA Integration Module, define configuration parameters, expose DataSources, test the integration in a trial environment, and prepare for future publication in the INTERA Online Store. The goal of your first integration is not to cover every possible feature. The goal is to build a small, valid Integration […] 10 min 03 Integration Contract The Integration Contract defines the minimum technical and operational rules that every INTERA Integration Module must follow. An Integration Module is not just a script that connects to an external system. It is a reusable package that INTERA Core can discover, configure, execute, monitor, and eventually publish through the INTERA Online Store. A valid Integration […] 10 min 04 Integration types INTERA integrations can connect to many different categories of external systems. Each system type has its own data structure, terminology, access method, and operational logic. The purpose of an INTERA Integration Module is not to copy the external system. The purpose is to expose useful business data from that system in a clean, structured, and […] 15 min 05 Testing & Validation Testing and validation are required before an INTERA Integration Module is used in a customer environment or prepared for future publication in the INTERA Online Store. An integration should not only work when the external system is available and returns perfect data. It should also behave predictably when credentials are wrong, data is missing, responses […] 10 min 06 Packaging & Submission Packaging and submission define how an INTERA Integration Module should be prepared before it is installed, reviewed, shared, or published. A good integration package should be easy to inspect, easy to test, and safe to install. It should include not only the integration code, but also the manifest, configuration description, DataSource documentation, test notes, version […] 10 min 07 Reference This chapter provides technical reference material for INTERA Integration Modules. The reference section is intended for developers who already understand the main integration concepts and need precise information about schemas, fields, naming rules, supported structures, error handling, and API behavior. The examples in this chapter are representative and may be extended as INTERA evolves. When […] 9 min 08 Sample integration code A complete, minimal INTERA Integration Module in JavaScript: manifest, configuration schema, one read-only DataSource, error handling and how to run it. 6 min