Overview
Overview
In OneEnterprise, a connector is a pre-built integration component that represents an external system — such as an ERP, CRM, or cloud application — within a project network. Connectors encapsulate the logic needed to communicate with a specific system, including its authentication model, supported data objects, and available flow directions. Rather than building system connections from scratch, teams add connectors from a catalog of pre-configured integrations and then configure them to match their specific environment.
The Connector module covers the full lifecycle of a connector within a project: adding it, connecting it to other entities, editing its settings, and removing it when it is no longer needed. Each of these actions has a dedicated interface in OneEnterprise, and this guide explains what each one does and when to use it.
Administrator access to a system is required to modify connector settings. Non-administrator users can view connector details and settings in read-only mode, but cannot make changes.
Add Connector to Project
Adding a connector to a project registers it as a participant in the project network and makes it available for connection to other entities. OneEnterprise guides you through this process with the Add Asset Wizard, a multi-step interface that collects all the information needed to place the connector on the network canvas and prepare it for integration.
The wizard is accessible from the Project module by selecting the Add button in the action area. The same wizard handles both connectors and automations — you declare which type you are adding in the second step, after which the wizard branches to show only the steps relevant to connectors.
Wizard Structure
The wizard is divided into a two-panel layout: an Information Area on the left provides context and guidance for each step, and a Content Area on the right is where you make selections and configure settings. A collapsible information bar lets you maximize the working area when needed. A progress bar shows your current step against the total, and a Completed drop-down lets you return to any previously finished step without restarting the wizard. A Show Every Time toggle on the Introduction screen controls whether the introduction appears on future runs of the wizard.
Selecting and Configuring the Connector
After confirming the asset type as Connector, the wizard presents the connector catalog — a list of all installed connectors available to your project. A search field and a Type filter (such as Accounting System) help you quickly locate the right connector. If the connector you need is not in the catalog, three options appear at the bottom of the screen:
- Get from the marketplace: Opens the OneEnterprise marketplace, where additional connectors can be browsed and installed.
- Create Your Own Connector: Redirects you to the Connector Designer, where you can build a custom connector for a system not available in the catalog.
- Ask the Community for Support: Opens the OneEnterprise community portal, where you can request connector development support from other users.
Publishing Objects
Once you select a connector, the wizard presents the list of objects the connector supports — data entities such as Customers, Orders, or Invoices. In this step, you select which objects to publish from the connector, making them available for other connectors in the project to subscribe to. You can select individual objects or use Select All to publish every available object. Publishing an object does not immediately start data flow — it signals that the connector will make that object’s data available when connections and flows are configured.
After confirming the object selection, OneEnterprise automatically handles all backend configuration. When complete, the connector appears on the project’s network canvas and in the project’s connector list.
Connect Connector
Adding a connector to a project places it on the network canvas as a standalone node. To participate in actual data exchange, the connector must be connected to at least one other entity. The Connect Connector wizard creates this relationship, establishing the link through which data will flow between the two systems.
The same wizard handles both connector-to-connector and connector-to-automation connections. You initiate it by bringing the entity you want to connect from to the center of the network diagram and clicking the Connect button in the action area. The centered entity becomes the first system in the connection; the second is chosen in a later wizard step.
Selecting the Target Entity
After confirming that you want to connect a Connector (rather than Automation), the wizard presents the list of entities already added to the project. The same search and Type filter tools available during Add Connector are present here, making it easy to locate the target. If the connector you need is not yet in the project, the same three options appear: Get from the marketplace, Create Your Own Connector, and Ask the Community for Support.
Configuring Flow Directions
After selecting the target connector, the wizard presents the objects shared between the two entities and asks you to define how data flows through each one. Each object appears on its own band. Expanding a band reveals the flow directions the connection supports — from Connector A to Connector B, from B to A, or both if the connection is bidirectional.
Flow direction bands are selectable and highlight when active. Selecting one band enables unidirectional flow; selecting both enables bidirectional flow. Not every object needs to be configured in this step — you can configure any combination of objects and directions and leave the rest unconfigured. The configured flow directions are displayed on the collapsed band so you can confirm your selections at a glance before proceeding.
Once flow directions are set, and you advance the wizard, OneEnterprise creates the connection in the background. The newly connected entities appear linked on the Interaction View canvas when the wizard completes.
Edit Connector
Edit Connector is the interface for administrators to update the settings of a connector already part of the project network. It is accessible from both the Interaction view and the Dataflow view: in either view, selecting a system node and clicking the Edit System band on the Network tab opens the edit screen.
The edit screen presents seven sections, each on its own collapsible band. You expand the section you want to modify and work within it independently. Non-administrator users who open this screen see all settings in read-only mode.
Section | What it controls |
Admin Users | The users who have administrator access to this connector. Admin users can modify all connector settings; non-admins have read-only access. |
Configuration | The technical parameters that govern how the connector communicates, including application settings, connector-specific settings, credentials, and user-defined fields. |
Details | The connector’s identity information — its name, description, and other metadata visible across the project. |
Logo | The visual identifier for the connector. Admins can add, change, or remove the logo displayed on the network canvas and throughout the project. |
Maintenance | Maintenance-related settings for the connector, such as scheduled downtime or operational state flags. |
Published Objects | The data objects the connector exposes for integration. Admins can view and modify which objects are published and how they are configured. |
Subscriptions | The other entities that subscribe to the connector’s published automations. This section is informational — it shows the subscription count and subscriber list. |
Each section is independent. Changes you make in one section do not affect the others, and you can navigate between sections without losing unsaved work in a different band.
Connector Settings
Connector Settings is the sub-section within the Edit Connector’s Configuration band that contains the parameters that define how a connector interacts with its external system. These settings vary by system type — the options available for a Salesforce connector differ from those for an SAP connector — because each connector surfaces the settings relevant to its own API and authentication model.
The Configuration band contains four sub-sections accessed as individual bands:
- Application Settings: General operational settings that apply to how OneEnterprise uses the application, independent of specific connector parameters.
- Connector Settings: The connector-specific parameters that control how OneEnterprise connects to and communicates with the external system.
- Credentials: Authentication details — API keys, usernames, passwords, or tokens — that OneEnterprise uses to authenticate with the external system.
- User-Defined Fields: Custom fields that your organization has added to extend the connector’s standard configuration.
Modifying Settings
Each connector setting appears on its own band with an inline control — a drop-down menu, a toggle switch, a text box, or another appropriate input depending on the setting type. You modify a setting directly on the band and save the change immediately. A Help icon in the action area opens contextual help for the currently visible settings, explaining what each parameter controls and what values are appropriate.
Resetting Settings
If you need to undo configuration changes, Connector Settings provides two reset options that restore settings to their factory defaults:
- Reset All Settings: Resets all connector settings to their default values. A confirmation pop-up appears before the reset executes. This is useful when a series of changes has produced unexpected behavior, and you want to start from a clean baseline.
- Reset Selected Settings: Lets you reset specific settings individually. Clicking Select puts the screen into selection mode; you then choose the bands you want to reset and confirm. This is the more surgical option when only certain parameters need to be reverted.
Both reset operations require confirmation before executing. Selecting No in the confirmation pop-up cancels the reset and leaves all settings unchanged.
Reset operations cannot be undone. Once you confirm a reset, the affected settings return to their default values, and any custom configuration is lost. Export or document your current settings before resetting, in case you need to restore them.
Related Articles
Overview
Overview The Business Partner section in OneEnterprise serves as the central platform for overseeing external organizations and service providers with whom you collaborate. Within OneEnterprise, a Business Partner is defined as any individual or ...Overview
Overview The Home Projects module is the central workspace in OneEnterprise where integration teams create, configure, and manage all integration projects. It brings together everything you need — project status, system connections, team access, and ...Home Overview
Overview The Home module is the central entry point in OneEnterprise. When you log in, you get a consolidated view of your entire integration environment — so you can manage entities, configure integrations, and monitor workflows from a single ...Edit Project Overview
Overview One of the great benefits of our project management is that it enables you to make changes to your existing project details as needed. If you need to make changes to your project details after it has been created, don't worry! You can easily ...Project Network Overview
Overview This section describes the Project Network — the workspace where you add, connect, and manage entities within a project. After adding entities to the network, you can establish connections between them and modify the objects those ...