Skip to main content

Glossary

This glossary defines the core terms used across Adeptia platform documentation, covering integration objects, data management concepts, and knowledge base categories.


Integration objects​

TermDefinition
WorkflowAn integration process managed and executed on the Adeptia platform.
TransactionAn integration entity tracked and listed within the platform.
SourceA configured entry point from which the platform reads incoming data. Sources define the protocol and location from which data is retrieved.
Layout (Schema)A structural definition that describes the fields, hierarchy, and format of a data payload. Layouts are used on both the source and target sides of a mapping.
MappingA transformation definition that specifies how fields from one or more source layouts are converted and written to a target layout.

Data enrichment and crosswalk objects​

TermDefinition
Value MapA crosswalk table that translates a single source field value to a corresponding target value. Value maps can be scoped globally or to a specific project.
Multi-valued MapA crosswalk table that translates a single source key to multiple output column values simultaneously. Like value maps, multi-valued maps support global and project scopes.
Enrichment SourceA registered external data source (such as a database, API, CSV file, or value map) that the platform can query at runtime to add supplementary fields to a record.
Use-case TemplateA reusable configuration pattern that captures the structure of a common integration scenario, allowing non-engineers to apply or update it without code changes.

Mapping concepts​

TermDefinition
IR (Intermediate Representation)A full-fidelity, lossless representation of a mapping's working state. Storing the IR allows a mapping to be reopened and edited exactly as it was last saved.
XSLThe stylesheet format that the platform compiles a mapping into for execution. XSL is the runtime form of a mapping definition.
Mapping rule typesThe categories of transformation logic that can be applied to a field in a mapping: direct field copy, transform expression, constant value, and concatenation.
Value map referenceA mapping rule that routes a source field through a named value map crosswalk to produce the target value, rather than copying or computing it directly.
Join hintA result returned by the join-detection capability indicating a potential relationship between source datasets.
Preflight checkA dry-run validation that reports which mapping rules the platform would drop during deployment, without actually deploying the mapping.

Execution and monitoring concepts​

TermDefinition
ExecutionA single run of a workflow or process flow, capturing its status, timing, and step-level results.
Execution historyThe record of past executions for a workflow, filterable by status, transaction, and partner.
Audit logAn activity-by-activity trail for a specific execution, recording each step taken during the run.
Context infoThe set of runtime variables and parameters that were active during a specific execution.
Automation overviewA dashboard view that summarizes execution trends, completed and pending runs, transaction types, and process flow activity across the tenant.
Trigger dashboardA monitoring view that shows event chart data, triggered processes, active triggers, and any process or trigger errors.

Knowledge base concepts​

TermDefinition
CollectionA named, tenant-scoped container in the knowledge base that holds indexed documents. Each collection belongs to a single organization.
DocumentA file ingested into the knowledge base and broken into searchable chunks. Supported document types include PDF, DOCX, TXT, HTML, and others.
Taxonomy pathA hierarchical label applied to a document at ingestion time that places it within a category tree, making it easier to browse and filter.
Semantic searchA retrieval method that matches a natural-language query to relevant document chunks.
Ingestion jobAn asynchronous task created when a document is submitted for indexing via the async ingestion path. The job can be monitored by its identifier until it reaches a completed or failed state.
PreferencesStored customer-specific settings associated with a knowledge base collection that guide how the platform interprets or responds to queries for that collection.
RulesStored customer-specific directives associated with a knowledge base collection that constrain or shape the platform's behavior when answering queries.

Knowledge base categories​

Documents ingested into the knowledge base are organized under the following top-level categories.

CategoryDescription
Terminology / DefinitionsGlossaries, term definitions, and concept explanations.
IntegrationsDocumentation covering integration patterns, connector behavior, and end-to-end flow design.
Data MappingMapping specifications, field-level transformation rules, and crosswalk references.
Schemas and Data ModelsLayout definitions, data model diagrams, and schema documentation.
Industry and StandardsIndustry-standard formats, compliance references, and regulatory guidance.
Transformation RulesBusiness and technical rules that govern how data is converted or enriched during processing.
Architecture and DesignSystem design documents, architectural diagrams, and platform topology references.
Messaging and EventingDocumentation for event-driven patterns, message queues, and trigger configurations.
Logs and MonitoringOperational runbooks, log interpretation guides, and monitoring dashboards.
How-To Guides and TutorialsStep-by-step instructions for common tasks and platform features.
Troubleshooting and RunbooksDiagnostic procedures, error resolution guides, and operational runbooks.
KB Process / Knowledge DoerInternal knowledge base process documentation and contributor guidelines.

Tool behavior classifications​

Every platform action is classified by the type of change it makes, which determines how the platform warns you before proceeding.

BehaviorMeaning
ReadRetrieves or computes information without changing any platform state.
WriteCreates new objects or submits new data, such as deploying a new mapping or ingesting a document.
DestructiveOverwrites or removes existing platform state.

Readiness tiers​

TierMeaning