> ## 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.

# Connect Wizard

> Step-by-step wizard for quickly setting up new integrations in Fentu Connect

## Overview

The Connect Wizard provides a guided, step-by-step process for creating new integrations between Fentu FSM and external systems. Instead of configuring each component separately, the wizard walks you through all the necessary steps in one flow.

<img src="https://mintcdn.com/fentu/VaII27VqRBHw2baV/images/fentu-connect/connect-wizard/connect-wizard-step1.png?fit=max&auto=format&n=VaII27VqRBHw2baV&q=85&s=03c47454e25df5422057a9ec39ffc106" alt="Connect Wizard - Step 1 Information" width="1280" height="720" data-path="images/fentu-connect/connect-wizard/connect-wizard-step1.png" />

## The 6-Step Process

<Steps>
  <Step title="Information">
    Enter basic details about the connection including name and description
  </Step>

  <Step title="Inbound Setting">
    Configure the inbound connection type and activation status
  </Step>

  <Step title="Outbound Setting">
    Configure the outbound connection type and activation status
  </Step>

  <Step title="Mapping Field">
    Define how fields map between systems
  </Step>

  <Step title="Conditions">
    Set up any conditions or filters for data synchronization
  </Step>

  <Step title="Completed">
    Review and finish the wizard
  </Step>
</Steps>

***

## Step 1: Information

<img src="https://mintcdn.com/fentu/VaII27VqRBHw2baV/images/fentu-connect/connect-wizard/connect-wizard-step1.png?fit=max&auto=format&n=VaII27VqRBHw2baV&q=85&s=03c47454e25df5422057a9ec39ffc106" alt="Connect Wizard - Information Step" width="1280" height="720" data-path="images/fentu-connect/connect-wizard/connect-wizard-step1.png" />

The first step captures the basic identification information for your new connection.

| Field               | Description                                                                                           |
| ------------------- | ----------------------------------------------------------------------------------------------------- |
| **Connection Name** | A unique, descriptive name for this integration (e.g., "SAP Customer Sync", "Salesforce Lead Import") |
| **Description**     | Optional notes explaining the purpose of this connection or any special configuration details         |

<Tip>
  Use clear, descriptive names that indicate both the system and data type being synchronized. This makes it easier to identify connections later.
</Tip>

***

## Step 2: Inbound Setting

<img src="https://mintcdn.com/fentu/VaII27VqRBHw2baV/images/fentu-connect/connect-wizard/connect-wizard-step2.png?fit=max&auto=format&n=VaII27VqRBHw2baV&q=85&s=6ca5c1ff879538a0feabc685348eaa41" alt="Connect Wizard - Inbound Setting" width="1280" height="720" data-path="images/fentu-connect/connect-wizard/connect-wizard-step2.png" />

Configure the inbound connection which pulls data from an external system INTO Fentu FSM.

| Field      | Description                                        |
| ---------- | -------------------------------------------------- |
| **Type**   | Select the integration type from the dropdown      |
| **Active** | Checkbox to enable/disable this inbound connection |

### Available Integration Types

<CardGroup cols={2}>
  <Card title="SAP B1" icon="database">
    SAP Business One ERP system
  </Card>

  <Card title="Fentu-FSM" icon="network-wired">
    Another Fentu FSM instance
  </Card>

  <Card title="Salesforce" icon="cloud">
    Salesforce CRM
  </Card>

  <Card title="Acumatica" icon="building">
    Acumatica Cloud ERP
  </Card>

  <Card title="Shopware" icon="cart-shopping">
    Shopware e-commerce
  </Card>

  <Card title="ABAS-ERP" icon="industry">
    ABAS ERP system
  </Card>

  <Card title="HRlab" icon="users">
    HR management system
  </Card>

  <Card title="Window Maker" icon="window-maximize">
    Window manufacturing software
  </Card>

  <Card title="Internal Connect" icon="arrows-turn-to-dots">
    Internal system connections
  </Card>

  <Card title="Jsonblob Shopware" icon="code">
    Shopware via JSON blob
  </Card>
</CardGroup>

<Warning>
  Do not activate a connection until you have verified all configuration settings. Activating an incorrectly configured connection may result in data errors.
</Warning>

***

## Step 3: Outbound Setting

<img src="https://mintcdn.com/fentu/VaII27VqRBHw2baV/images/fentu-connect/connect-wizard/connect-wizard-step3.png?fit=max&auto=format&n=VaII27VqRBHw2baV&q=85&s=a34a3a8555b8a31987c99dea0ba188b9" alt="Connect Wizard - Outbound Setting" width="1280" height="720" data-path="images/fentu-connect/connect-wizard/connect-wizard-step3.png" />

Configure the outbound connection which pushes data FROM Fentu FSM to an external system.

| Field      | Description                                                             |
| ---------- | ----------------------------------------------------------------------- |
| **Type**   | Select the integration type from the dropdown (same options as Inbound) |
| **Active** | Checkbox to enable/disable this outbound connection                     |

<Note>
  You can configure just an inbound connection, just an outbound connection, or both depending on your integration requirements.
</Note>

***

## Step 4: Mapping Field

<img src="https://mintcdn.com/fentu/VaII27VqRBHw2baV/images/fentu-connect/connect-wizard/connect-wizard-step4.png?fit=max&auto=format&n=VaII27VqRBHw2baV&q=85&s=be54f9558c3636659817ebcda127c377" alt="Connect Wizard - Mapping Field" width="1280" height="720" data-path="images/fentu-connect/connect-wizard/connect-wizard-step4.png" />

Define how fields from the source system map to fields in the destination system. This step allows you to specify which data goes where.

<Info>
  For detailed information about field mapping including formula syntax, see the [Field Mapping Guide](/fentu-connect/connection-config) and [Formula Reference](/fentu-connect/formula-reference).
</Info>

***

## Step 5: Conditions

<img src="https://mintcdn.com/fentu/VaII27VqRBHw2baV/images/fentu-connect/connect-wizard/connect-wizard-step5.png?fit=max&auto=format&n=VaII27VqRBHw2baV&q=85&s=6bea13a4c5074a687e37bb61e584b865" alt="Connect Wizard - Conditions" width="1280" height="720" data-path="images/fentu-connect/connect-wizard/connect-wizard-step5.png" />

Set up any conditions that control when data should be synchronized. Conditions act as filters to ensure only the right data is transferred.

***

## Step 6: Completed

<img src="https://mintcdn.com/fentu/VaII27VqRBHw2baV/images/fentu-connect/connect-wizard/connect-wizard-step6.png?fit=max&auto=format&n=VaII27VqRBHw2baV&q=85&s=6eb52c41feba3285442bb624127aff59" alt="Connect Wizard - Completed" width="1280" height="720" data-path="images/fentu-connect/connect-wizard/connect-wizard-step6.png" />

Review your configuration and click **Finish** to create the connection. The wizard will create:

* A new Connector with your specified settings
* Inbound connection (if configured)
* Outbound connection (if configured)
* Field mappings

***

## Tips and Best Practices

<AccordionGroup>
  <Accordion title="Start with Inbound First" icon="arrow-down">
    When setting up bidirectional sync, it's often best to configure and test the inbound connection first. This allows you to verify data is being received correctly before configuring outbound data push.
  </Accordion>

  <Accordion title="Test Before Activating" icon="flask">
    Leave connections inactive initially. Use the test features to verify your configuration before enabling live data synchronization.
  </Accordion>

  <Accordion title="Use Descriptive Names" icon="tag">
    Name your connections clearly to indicate the system, direction, and data type. For example: "SAP B1 - Inbound - Customers" or "SFDC - Outbound - Work Orders"
  </Accordion>

  <Accordion title="Document Your Mappings" icon="file-lines">
    Use the description field to document any special mapping logic or business rules applied to this connection.
  </Accordion>
</AccordionGroup>

***

## Common Questions

<AccordionGroup>
  <Accordion title="Can I create a connection with only inbound or only outbound?" icon="question">
    Yes, you can configure just one direction. Simply leave the other direction's type as "Select an Option" and don't activate it.
  </Accordion>

  <Accordion title="What happens if I click Finish without filling everything?" icon="question">
    The wizard will create a connection with whatever settings you've provided. You can edit the connection later to complete the configuration.
  </Accordion>

  <Accordion title="Can I edit a wizard-created connection later?" icon="question">
    Yes, all connections created through the wizard can be edited individually through the Connector, Inbound, or Outbound menu items.
  </Accordion>

  <Accordion title="How do I delete a wizard-created connection?" icon="question">
    Navigate to the Connector page, find your connection, and use the Delete button. Note that this may also affect related inbound/outbound configurations.
  </Accordion>
</AccordionGroup>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Connection Config" icon="gear" href="/fentu-connect/connection-config">
    Configure connection credentials before using the wizard
  </Card>

  <Card title="Connect Objects" icon="cube" href="/fentu-connect/connect-objects">
    Define the data structures for your integrations
  </Card>

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

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