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

# SAP IDoc Translate

> Configuration for translating IDocs to XML and XML to IDocs using the Arc SAP IDoc connector.

## Connector Configuration

The following settings are available when you are translating IDocs into XML, and vice versa.

#### Control Record Information Options

When you are translating IDoc files into XML, or translating XML files into IDoc, you might want to change the control record information without changing the IDoc file data. See [Sending IDocs to SAP](./sap-idoc-send#sending-idocs-to-sap) for more information.

To overwrite the control headers for IDoc files, check **Overwrite**, then make your changes to the following options.

| Setting                                | Description                                                                |
| -------------------------------------- | -------------------------------------------------------------------------- |
| **SAP Release (DOCREL)**               | The SAP Release for IDOC.                                                  |
| **Test Flag (TEST)**                   | The flag which indicates whether the IDoc should be in test mode.          |
| **Sender Port (SNDPOR)**               | The sender port (SAP System or external subsystem).                        |
| **Sender Partner Number (SNDPRN)**     | The sender's partner number.                                               |
| **Sender Partner Type (SNDPRT)**       | The sender's partner type.                                                 |
| **Sender Partner Function (SNDPFC)**   | The sender's partner function.                                             |
| **Sender Address (SNDSAD)**            | The sender's address.                                                      |
| **Logical Address (SNDLAD)**           | The sender's logical address.                                              |
| **Receiver Port (RCVPOR)**             | The receiver port.                                                         |
| **Receiver Partner Number (RCVPRN)**   | The receiver's partner number.                                             |
| **Receiver Partner Type (RCFPRT)**     | The receiver's partner type.                                               |
| **Receiver Partner Function (RCVPFC)** | The receiver's partner function.                                           |
| **Recipient Address (RVCSAD)**         | The receiver's address.                                                    |
| **Receiver Logical Address (RCVLAD)**  | The receiver's logical address.                                            |
| **Use System Date/Time**               | Whether to include the system date/time in the control record information. |

#### Advanced Settings

*Settings not included in the previous categories.*

| Setting               | Description                                                                                                                                                                                                                                                                                           |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Processing Delay**  | The amount of time (in seconds) by which the processing of files placed in the **Transactions** tab is delayed. This is a legacy setting. Best practice is to [use a File connector](./Designing-a-Flow#interacting-with-the-local-file-system) to manage local file systems instead of this setting. |
| **Refresh Schema**    | When enabled, the connector attempts to update the schema it uses for parsing when a parsing error occurs. The schema is updated by reaching out to the SAP system and querying for the appropriate schema.                                                                                           |
| **Local File Scheme** | A scheme for assigning filenames to messages that are output by the connector. You can use macros in your filenames dynamically to include information such as identifiers and timestamps. For more information, see [Macros](#macros).                                                               |
| **Upload Schema**     | Use this to upload a schema and install it in the connector's Schema folder. If a schema already exists, you are asked if you want to overwrite it.                                                                                                                                                   |

#### Logging

*Settings that govern the creation and storage of logs.*

| Setting                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Log Level**            | The verbosity of logs generated by the connector. When you request support, set this to **Debug**.                                                                                                                                                                                                                                                                                                                                                                      |
| **Log Subfolder Scheme** | Instructs the connector to group files in the Logs folder according to the selected interval. The **Weekly** option (which is the default) instructs the connector to create a new subfolder each week and store all logs for the week in that folder. Leaving this setting blank tells the connector to save all logs directly in the Logs folder. For connectors that process many transactions, using subfolders helps keep logs organized and improves performance. |
| **Log Messages**         | Check this to have the log entry for a processed file include a copy of the file itself. If you disable this, you might not be able to download a copy of the file from the **Transactions** tab.                                                                                                                                                                                                                                                                       |

#### Miscellaneous

*Miscellaneous settings are for specific use cases.*

| Setting            | Description                                                                                                                                                                                                                   |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Other Settings** | Enables you to configure hidden connector settings in a semicolon-separated list (for example, `setting1=value1;setting2=value2`). Normal connector use cases and functionality should not require the use of these settings. |

## Translate without a Connection to SAP

You can translate IDocs to XML, and vice versa, without having a direct connection to SAP by uploading an additional document schema to the connector using the **Upload Schema** option in [Advanced Settings](#advanced-settings). The schema includes all elements of the base schema.

To download the schema from SAP:

* In SAP, find the documentation transaction with TCODE `WE60`.
* If your IDoc type is basic, choose the **Basic type** radio button. Otherwise, choose **Enhancement**.
* Click the **Documentation** menu and choose **XML Schema**.
* From the **XML** menu, choose **Download**.
* Save the downloaded file as `${IDocType}.xsd` (for example, `SHPMNT05.xsd`).
* Upload that file to the connector using **Upload Schema**.
