> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fentufsm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connector

> Create and manage individual integration connectors in Fentu Connect

## Overview

Connectors are the core integration units in Fentu Connect. Each connector defines a complete integration including the connection name, inbound/outbound settings, field mappings, and sync conditions.

<img src="https://mintcdn.com/fentu/VaII27VqRBHw2baV/images/fentu-connect/connector/connector-list.png?fit=max&auto=format&n=VaII27VqRBHw2baV&q=85&s=5a2a1b5426577fd660a06407bfa5f3a4" alt="Connector List" width="1280" height="720" data-path="images/fentu-connect/connector/connector-list.png" />

## Connector List

The Connector list displays all configured connectors with search and pagination features:

* **Search** - Filter connectors by name
* **New Button** - Create a new connector using the wizard interface
* **Pagination** - Navigate through multiple pages
* **Items per Page** - Choose 5, 10, 25, 50, or 100 items per page

***

## Creating a Connector

<img src="https://mintcdn.com/fentu/VaII27VqRBHw2baV/images/fentu-connect/connector/connector-new.png?fit=max&auto=format&n=VaII27VqRBHw2baV&q=85&s=a74932889ca75161371355c0d20503be" alt="New Connector Form" width="1280" height="720" data-path="images/fentu-connect/connector/connector-new.png" />

Creating a new connector uses the same 6-step wizard interface as the Connect Wizard:

<Steps>
  <Step title="Information">
    Enter the connection name and description
  </Step>

  <Step title="Inbound Setting">
    Configure inbound data connection settings
  </Step>

  <Step title="Outbound Setting">
    Configure outbound data connection settings
  </Step>

  <Step title="Mapping Field">
    Define field mappings between systems
  </Step>

  <Step title="Conditions">
    Set up data filtering and sync conditions
  </Step>

  <Step title="Completed">
    Review and save the connector
  </Step>
</Steps>

### Step 1: Information

| Field               | Description                            | Required |
| ------------------- | -------------------------------------- | -------- |
| **Connection Name** | A unique identifier for this connector | Yes      |
| **Description**     | Notes about the connector's purpose    | No       |

<Tip>
  Use a naming convention that indicates the direction and data type, such as "SAP-to-FSM Customer Sync" or "FSM-to-Salesforce Work Order Export".
</Tip>

### Step 2: Inbound Setting

| Field      | Description                               |
| ---------- | ----------------------------------------- |
| **Type**   | The external system type for inbound data |
| **Active** | Enable/disable inbound synchronization    |

See [Inbound Connections](/fentu-connect/inbound) for detailed configuration options.

### Step 3: Outbound Setting

| Field      | Description                                |
| ---------- | ------------------------------------------ |
| **Type**   | The external system type for outbound data |
| **Active** | Enable/disable outbound synchronization    |

See [Outbound Connections](/fentu-connect/outbound) for detailed configuration options.

### Step 4: Mapping Field

Configure how data maps between the source and destination systems. For each field, you can choose:

* **Field** - Direct field-to-field mapping
* **Raw Data** - Static value
* **Formula** - Calculated value using formula syntax

See [Formula Reference](/fentu-connect/formula-reference) for formula syntax.

### Step 5: Conditions

Set conditions that determine when data should be synchronized. Conditions act as filters to control which records are included in the sync.

### Step 6: Completed

Review your configuration and click **Finish** to create the connector.

***

## Editing a Connector

To edit an existing connector:

1. Navigate to the specific connector from the list (if link available)
2. Or edit through the related Inbound/Outbound connection pages

<Note>
  Changes to a connector may affect live integrations. Consider deactivating the connection before making significant changes.
</Note>

***

## Connector vs Connect Wizard

The Connector page and Connect Wizard use the same interface, but serve different entry points:

| Feature      | Connector                       | Connect Wizard                  |
| ------------ | ------------------------------- | ------------------------------- |
| Access Point | From Connector menu             | From Connect Wizard menu        |
| Purpose      | Full connector management       | Quick new setup                 |
| Interface    | Same 6-step wizard              | Same 6-step wizard              |
| Result       | Creates connector + connections | Creates connector + connections |

<Info>
  Both methods create the same artifacts. Use whichever entry point is most convenient for your workflow.
</Info>

***

## Best Practices

<AccordionGroup>
  <Accordion title="One Connector Per Data Flow" icon="diagram-project">
    Create separate connectors for each logical data flow rather than combining multiple data types in one connector. This makes troubleshooting easier and allows independent activation/deactivation.
  </Accordion>

  <Accordion title="Test Before Activating" icon="flask">
    Leave both inbound and outbound connections inactive while configuring field mappings. Test with sample data before enabling live synchronization.
  </Accordion>

  <Accordion title="Document Thoroughly" icon="book">
    Use the description field to document:

    * Business purpose of the integration
    * Data transformation rules
    * Dependencies on other connectors
    * Contact person for questions
  </Accordion>

  <Accordion title="Version Control Important Changes" icon="code-branch">
    Before making changes to production connectors, export or document the current configuration so you can revert if needed.
  </Accordion>
</AccordionGroup>

***

## Common Patterns

<AccordionGroup>
  <Accordion title="One-Way Inbound Sync" icon="arrow-down">
    **Use case:** Pull master data from ERP into Fentu FSM

    **Configuration:**

    * Inbound: Configured and Active
    * Outbound: Not configured

    **Example:** Customer records from SAP B1 to Fentu FSM
  </Accordion>

  <Accordion title="One-Way Outbound Sync" icon="arrow-up">
    **Use case:** Push completed work data to external systems

    **Configuration:**

    * Inbound: Not configured
    * Outbound: Configured and Active

    **Example:** Work order completion data from Fentu FSM to SAP B1
  </Accordion>

  <Accordion title="Bidirectional Sync" icon="arrows-left-right">
    **Use case:** Keep data synchronized in both directions

    **Configuration:**

    * Inbound: Configured and Active
    * Outbound: Configured and Active

    **Example:** Customer updates synced both ways between Salesforce and Fentu FSM

    <Warning>
      Bidirectional sync requires careful planning to avoid infinite loops and data conflicts.
    </Warning>
  </Accordion>
</AccordionGroup>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Connect Wizard" icon="wand-magic-sparkles" href="/fentu-connect/connect-wizard">
    Alternative entry point for creating connectors
  </Card>

  <Card title="Connector Set" icon="folder" href="/fentu-connect/connector-set">
    Group related connectors together
  </Card>

  <Card title="Inbound Connections" icon="arrow-down" href="/fentu-connect/inbound">
    Detailed inbound configuration guide
  </Card>

  <Card title="Outbound Connections" icon="arrow-up" href="/fentu-connect/outbound">
    Detailed outbound configuration guide
  </Card>
</CardGroup>