Coresuite Designer WebExtension Configuration and Deployment Guide

Table of Contents

1. Introduction
2. Prerequisites, Requirements & Limitations
3. SSL/TLS Certificate Configuration
4. Configuration and Deployment
5. Troubleshooting
6. Download Resources
7. Related Documentation

1. Introduction [Back to Top]

The Coresuite Designer WebExtension is an add-on specifically designed for the SAP Business One WebClient. It combines the proven background technology from the standard SAP Business One client with the modern front-end framework of the WebClient.

Our solution for generating PDF layouts created in Coresuite Designer is based on the Coresuite Service. This service acts as a REST API server that processes requests from the SAP Business One WebClient, allowing the same layouts known from the standard fat client to be used for PDF output in the browser environment.

Important Note: WebClient extensions function differently from standard SAP Business One client add-ons. This guide provides the necessary instructions for correct configuration and deployment.

2. Prerequisites, Requirements & Limitations [Back to Top]

Before proceeding with the installation, ensure all the following components are available:

Required Components:

• SAP Business One 10.0 FP 2508 or later with WebClient installed (SP 2502 is not supported by us and not tested)
• Coresuite Designer and Customize version 8.45
• Coresuite Service version 8.45
• SSL/TLS Certificate: Valid certificate for secure communication

Configuration Requirements:

• The Coresuite Service configuration file must include the database used by WebClient
• A valid license must be assigned to Coresuite Service
• Users accessing the WebClient Designer extension must have Coresuite Designer and Customize licenses assigned
• The SSL/TLS certificate must be properly configured during SAP Business One component installation

Limitations:

• Extensibility in SAP Business One Web Client currently requires modifications to be applied individually for each web page (i.e., each document type). At this stage, PDF generation button is supported only for Sales A/R invoice.
• In this first release, only PDF generation is available. In a future iteration, we plan to evaluate the addition of “Email” and “Print” actions.
• Because of existing Web Client extensibility constraints, the placement of custom buttons is limited. We expect broader positioning options to become available in upcoming SAP Business One Web Client updates.

Reference Documentation:

• For SAP Business One WebClient installation: SAP Business One Admin Guide
• For certificate configuration with SAP Business One: SAP Note 3537539

3. SSL/TLS Certificate Configuration [Back to Top]

Secure communication between SAP Business One WebClient and Coresuite Service API requires proper SSL/TLS certificate configuration. Without a valid certificate, WebClient will block connections to external applications.

Certificate Options:

1. Production Environment: Purchase a certificate from a trusted Certificate Authority (CA)
2. Testing Environment: Generate a self-signed certificate following the instructions below

Generating a Self-Signed Certificate (Testing Only)

Prerequisites:

• Install Git for Windows (latest version recommended for built-in OpenSSL support)

Generation Steps

1. Open Git Bash terminal
2. Execute the commands from SAP Note 3537539
3. Important: Use the corrected third command:

   openssl req -new -x509 -sha256 -days 365 -key b1CA.key -subj //CN=b1CA -outform pem -out b1CA.cer -config b1openssl.cfg

   Note: The double slash (//) is required to prevent escape character issues
4. Distribute and install the certificate according to SAP Note instructions

Binding Certificate to Service Port

Follow these steps to bind your certificate to the Service API URL port:

1. Obtain Certificate Thumbprint:
   • Open Certificate Manager (certmgr.msc) on the Coresuite Service server
   • Navigate to: Personal → Certificates
   • Locate and double-click your b1server.crt certificate (You will find it based on the Common Name used in b1openssl.cfg)
   • Go to the Details tab
   • Copy the Thumbprint value
2. Bind Certificate to Port:
   • Open Command Prompt as Administrator
   • Execute the following command (replace placeholders):

     netsh http add sslcert ipport=<0.0.0.0>:<port> certhash=<thumbprint> appid={FEF10CE0-47F1-4488-A8F2-4F8552C565E3}

     Example (used on our HANA deployment):

     netsh http add sslcert ipport=15.401.36.215:8899 certhash=1234567890abcdef appid={FEF10CE0-47F1-4488-A8F2-4F8552C565E3}

HANA Deployment Note: For SAP HANA deployments, the keystore.p12 certificate must be installed on the Windows machine where the Coresuite Service is running. After installation, bind the IP address of that machine to the certificate’s thumbprint instead of using the default 0.0.0.0.

Testing the Configuration

After completing the configuration:

1. Navigate to Sales A/R invoices → Select a Print Definition in WebClient
2. Click the "Generate PDF" button
3. Expected results:
   • Single Layout Definition: Downloads a PDF file
   • Multiple Layout Definitions: Downloads a ZIP file containing multiple PDFs

4. Configuration and Deployment [Back to Top]

Step 1: Configure Service API URL

After installing all required Coresuite components and certificate generation, configure the Service API URL to establish communication between WebClient and Coresuite Service:

1. Open Coresuite Designer configuration in SAP Business One.
2. Navigate to the "WebClient" tab.
3. Configure the Service API URL using the following format:

   https://<HostOrIP>:<Port>/api/

   Where:
   • <HostOrIP>: The Common Name (CN) used during certificate generation or the hostname where Coresuite Service is installed
   • <Port>: The port number bound to your SSL/TLS certificate

Step 2: Deploy Designer WebExtension

1. Download the Coresuite Designer WebExtension (mtar file) from the Download section.
2. Deploy the extension through the SAP Business One Extension Manager, installing it as a lightweight add-on.
3. After successful deployment, verify the following elements appear in marketing documents:
   • A new "Print definition" dropdown menu
   • A "Generate PDF" button

5. Troubleshooting [Back to Top]

If you have configured everything as described in the previous sections and the Coresuite Service is running, but you encounter issues in the SAP Business One WebClient when clicking the “Generate PDF” button, follow the steps below to identify the cause:

1. Open the Developer Tools in your browser (usually by pressing F12).
2. Go to the "Console" tab.
3. Clear existing messages (click the trash bin or clear icon).
4. Click the “Generate PDF” button to reproduce the issue and trace events and messages.
5. Review the messages displayed to determine if you can identify and resolve the issue.
6. Repeat the same steps, but this time switch to the "Network" tab in Developer Tools.
6. If the root cause remains unclear, please provide us the messages from both the Console and Network tabs after reproducing the issue and a screenshot of the error shown when clicking “Generate PDF”.

6. Download Resources [Back to Top]

7. Related Documentation [Back to Top]

• WebClient Extension Deployment Guide
• SAP Business One Administration Guide
• SAP Note 3537539 - Certificate Configuration

Back to Top