AP Essentials Connect for PROCESS DIRECTOR AP
Learn how to set up and use AP Essentials Connect for PROCESS DIRECTOR AP.
Tungsten AP Essentials Connect is a program you can install on a local computer and use to perform a number of tasks, such as uploading documents to AP Essentials. It is an alternative to uploading documents using the web interface in AP Essentials. Using AP Essentials Connect, you can upload documents automatically, lessening the effort of uploading documents one by one.
AP Essentials Connect runs as a service in the background, so it is not necessary to start a program each time you want to upload documents. Instead, you simply move the files you want to upload to the folders you specify during the installation setup.
AP Essentials Connect can be beneficial if you want to:
- Upload large numbers of documents.
- Automate the process of uploading documents.
- Download output data from AP Essentials.
- Automatically register supplier documents in external systems.
Note that the user interface for Tungsten AP Essentials Connect is currently only available in English.
Other flavors of AP Essentials Connect
Tungsten AP Essentials Connect can display different settings, depending on which target system you use. Before you continue reading, make sure you choose the AP Essentials Connect guide that matches your target system. If you don't find a match, read the generic guide for AP Essentials Connect.
AP Essentials Connect System requirements
Tungsten AP Essentials Connect supports the following operating systems:
- Windows 11
- Windows 10
- Windows 8.1
- Windows Server 2019 Standard
- Windows Server 2019 Datacenter
- Windows Server 2016
- Windows Server 2012 and Windows Server 2012 R2
Tungsten AP Essentials Connect requires the following:
- Microsoft .NET Framework 4.8.
- An HTTPS connection which uses port 443.
Creating a customer account
In order to use AP Essentials Connect you must make sure that your account in Tungsten AP Essentials is set up properly.
After you have created a new customer account, check the following:
- You cannot specify PROCESS DIRECTOR AP as a target system, if Workflow services are enabled.
- In order to send invoices to PROCESS DIRECTOR AP, make sure PROCESS DIRECTOR AP is specified in the target system service ( ) for the account.
- Make sure the you
add at
least one buyer. The
External ID (External reference
ID) of each buyer must match a company code in PROCESS DIRECTOR AP. You can add additional buyers if your organization
has more than one buyer.
If you add a new buyer to the system after you configure Tungsten AP Essentials Connect you must run the configuration wizard again and specify the new upload locations.
After you create a customer account with appropriate services and buyers, you are ready to install Tungsten AP Essentials Connect.
Installation
If you use a proxy connection to connect to the Internet, make sure you specify the Windows proxy settings before you install Tungsten AP Essentials Connect.
To install Tungsten AP Essentials Connect:
-
Download and run the setup file from the URL that corresponds to your location. Note that an HTTPS connection on
port 443 is required to download the installation. After the installation, the connection is required to receive program updates.
- Europe: https://production.readsoftonline.com/install/connect
- Australia: https://au.readsoftonline.com/install/connect
- US: https://us.readsoftonline.com/install/connect
-
Specify the installation folder and click
Next to continue:
-
Click
Install to confirm your settings and install
Tungsten AP Essentials Connect.
-
After the installation, click
Finish to launch
Tungsten AP Essentials Connect
and run the setup wizard.
Troubleshooting the installation
When running the installation, some computers display a message that states, "Installation directory must be on a local drive." If you receive this message, run this command as an administrator in Windows Command Prompt:
msiexec /i "C:\Program Files (x86)\Tungsten\AP Essentials Connect\Tungsten AP Essentials Connect.msi" WIXUI_DONTVALIDATEPATH="1"
AP Essentials Connect Setup for PROCESS DIRECTOR AP
Be sure to specify the target-system settings correctly before you begin.
The first time you run Tungsten AP Essentials Connect, a setup wizard appears to help you configure the initial settings. If you see the Tungsten AP Essentials Connect dialog instead of the wizard, click Configure to display the wizard.
The steps that appear in the wizard can vary, depending on the services that are enabled in AP Essentials.
1. Click Next to begin.
2. Use the information provided in your account-information email to fill in the Login address, Authorization key, User name and Password.
Login address |
|
Authorization key (API Key) | You can obtain the key from your account-information email or from an administrator, who can find the key in the Target system view in Admin Center. |
User name |
The user name you use to log in to AP Essentials. The user must be a customer admin or customer user. If only one target system is enabled on the partner level, partner admins and partner users are also supported. Group users are not supported. |
Password | The password for User name. |
3. Configure optional dialogs that can appear, depending on the services that are enabled in Tungsten AP Essentials:
- Configure settings for uploading documents.
- Upload master data. You can only choose one of these methods. Although it is possible to choose both, conflicts will
occur.
- Via local file upload.
- Via the master data service which imports master data from PROCESS DIRECTOR Accounts Payable.
- Configure settings for exporting to PROCESS DIRECTOR Accounts Payable.
4. After you complete the required procedures from step 3 above, click Save to save the settings and exit the wizard.
If you want to change the Output image format from TIF to PDF (Target system configuration settings), you must process all of the documents in the system before you change this setting. Failure to do so will result in output errors.
Windows users that run Tungsten AP Essentials Connect must have Read, Write and Modify permissions on all of the folders you specify in the setup.
When a new version of the PROCESS DIRECTOR Accounts Payable integration is released, you must run the configuration wizard again to ensure you have the latest version. Simply click the Configure button, click through the wizard until you reach the end, and click Save. It is not necessary to change any settings in the wizard.
Latest release date: April 8, 2024
Configure settings for uploading documents
If the Image upload service is enabled, you can use Tungsten AP Essentials Connect to upload documents to AP Essentials. Customers can upload their own documents for processing, and partner administrators can upload images on behalf of all of their customers.
Ideally, you specify the Root folder, and then click to automatically generate the subfolders. Subfolder are created for each buyer defined in AP Essentials. If no buyers are defined, the subfolder has the same name as the organization (customer account). These subfolders determine which buyer the documents are connected to when they are uploaded to AP Essentials. Additional subfolders are created for each document type, if the buyer has more than one document type.
In this example, the Folder containing scanned images is named “Upload."
Import master data via the Master data service
Importing master data using the master data service differs from uploading master data as described above. When you select Master data service in the setup wizard, master data is imported directly from PROCESS DIRECTOR AP. When importing the master data, CorporateGroupID elements in PROCESS DIRECTOR AP master data are mapped with the external IDs of buyers in Tungsten AP Essentials. Master data is only imported for buyers that match a CorporateGroupID.
Configure settings for exporting to PROCESS DIRECTOR Accounts Payable
If PROCESS DIRECTOR AP is specified as a target system, you can use Tungsten AP Essentials Connect to automatically export invoices to PROCESS DIRECTOR AP.
-
If prompted to do so, install the
SAP Connector
for Microsoft .NET 3.0 (NCo 3.0), and make sure you select
Install assemblies to GAC during the installation.
Microsoft Visual C++ 2010 Redistributables must be installed before installing SAP Connector for Microsoft .NET 3.0. You must install the x86 version of Microsoft Visual C++ 2010 Redistributables. The x64 version is incompatible with the integration.
You must install the latest 32-bit (x86) version of SAP Connector for Microsoft .NET 3.0 (NCo 3.0). The x64 version and the NCo 3.1 version are incompatible with the integration. These are requirements of SAP S/4 Hana 2023.
-
Select
Export to PROCESS DIRECTOR AP and optionally select
Master data service to map the
CorporateGroupID elements in PROCESS DIRECTOR AP master data with
external IDs of buyers in
Tungsten AP Essentials.
Export to PROCESS DIRECTOR Accounts Payable Enables the integration between Tungsten AP Essentials and PROCESS DIRECTOR AP. Master data service Enables master-data import from PROCESS DIRECTOR AP.
If you enable this setting, you must configure the Supplier master-data file setting. Tungsten AP Essentials Connect imports the master data by regularly importing the file you specify in the Supplier master-data file setting.
Tungsten AP Essentials matches the CorporateGroupID elements in PROCESS DIRECTOR AP master data with external IDs of buyers in Tungsten AP Essentials. Master data is only imported for buyers that match a CorporateGroupID.
Setup for multiple customers
If you log in to Tungsten AP Essentials Connect as a partner administrator, you can configure settings for each customer that uses PROCESS DIRECTOR AP as the target system. The feature saves you time because you do not have to log in to different accounts to configure multiple customers.
Using AP Essentials Connect with PROCESS DIRECTOR AP
After following the procedures above to setup AP Essentials Connect, you are ready to use it in production.
Uploading documents using AP Essentials Connect
You can upload documents to AP Essentials in these supported file formats using AP Essentials Connect.
Automatic uploading
If you selected Upload documents automatically when configuring Tungsten AP Essentials Connect for uploading documents, no interaction is required. When files are moved to the subfolder(s) of the location you specified in the configuration, they are automatically uploaded.
Tungsten AP Essentials Connect runs continuously in the background as a Windows service and periodically checks (every 15 minutes by default) for new files to upload. When new files are found, they are uploaded automatically. Even if you restart the computer, Tungsten AP Essentials Connect runs automatically in the background with no need for interaction. If a problem occurs during the upload, the upload operation will timeout after 10 minutes.
Most users use automatic uploading, and set up their scanners to save files directly in the appropriate subfolders that are created during the configuration.
If you have more than one document type, but you place files in the parent folder of the document type folders, the files are uploaded and processed using the Default document type specified in the Extraction service settings.
Manually uploading documents
If you did not select Upload documents automatically when configuring Tungsten AP Essentials Connect, you can upload files manually at your convenience:
-
Start
Tungsten AP Essentials Connect
from the Windows Start menu.
-
Move or scan document image files to an appropriate subfolder of the location you specified in the
configuration, and click
Refresh so you can see the files in the list. You can also click the
Event log tab to check for errors.
If you do not see files in the list, make sure you place the files in a subfolder that corresponds to an organization or buyer in AP Essentials.
-
Click
Upload documents. You can click
Refresh to see that the images have uploaded or use the Event log to
monitor the progress of your uploads.
Troubleshooting AP Essentials Connect for PROCESS DIRECTOR AP
Generic issues
If you have problems running Tungsten AP Essentials Connect:
- Make sure you have access to the URL that corresponds to your location:
You can click the links above to test if you have access. Click the links using the same computer that runs Tungsten AP Essentials Connect. If you receive a 404 error, you do not have access.
- Make sure you can download the files that are listed in the page that is displayed when you click one of the links above. To do this, replace "Deployment.manifest" in the URL with one of the file names in the list.
- Log in to AP Essentials using the same computer that runs Tungsten AP Essentials Connect to make sure you can connect to AP Essentials.
- If you use a proxy connection, make sure the settings are applied to the same user/account that runs Tungsten AP Essentials Connect. By default, this is a local System account. To test this, access AP Essentials using a location above, then change the Tungsten AP Essentials Connect user to the same Windows user you tested with.
Login issues
If you receive the message, "Name or password is incorrect (repeat logon)", it can be caused by using an exclamation point (!) in your password. Even if the login information works correctly using "SAP logon", the exclamation point can cause problems when using AP Essentials Connect.
To resolve this issue, try changing your password to a password that does not use exclamation points.