Add-Ons Compatibility Guide PUBLIC

SAP Business One

Document Version: 1.0 – 2013-01-30

Compatibility Guide for Add-Ons in SAP Business

One 9.0
Typographic Conventions

Type Style Description

Example Words or characters quoted from the screen. These include field names, screen titles,
pushbuttons labels, menu names, menu paths, and menu options.
Textual cross-references to other documents.

Example Emphasized words or expressions.

EXAMPLE Technical names of system objects. These include report names, program names,
transaction codes, table names, and key concepts of a programming language when they
are surrounded by body text, for example, SELECT and INCLUDE.

Example Output on the screen. This includes file and directory names and their paths, messages,
names of variables and parameters, source text, and names of installation, upgrade and
database tools.

Example Exact user entry. These are words or characters that you enter in the system exactly as they
appear in the documentation.

<Example> Variable user entry. Angle brackets indicate that you replace these words and characters
with appropriate entries to make entries in the system.

EXAMPLE Keys on the keyboard, for example, F 2 or E N T E R .

PUBLIC Compatibility Guide for Add-Ons in SAP Business One 9.0

2 © 2013 SAP AG. All rights reserved. Typographic Conventions
Table of Contents

1 Introduction ................................................................................................................................................... 4

2 Using Add-Ons in SAP Business One 9.0 .................................................................................................... 5

UI API Add-Ons ........................................................................................................................................................ 5
DI API Add-Ons.........................................................................................................................................................6
UI API and DI API Add-Ons ...................................................................................................................................... 7

Compatibility Guide for Add-Ons in SAP Business One 9.0 PUBLIC

Table of Contents © 2013 SAP AG. All rights reserved. 3
1 Introduction

SAP Business One 9.0 supports both 32-bit and 64-bit installations. This document provides an overview of the
different use cases that customers may encounter while working with SAP Business One 9.0 and running add-ons
set to either 32-bit or 64-bit.

PUBLIC Compatibility Guide for Add-Ons in SAP Business One 9.0

4 © 2013 SAP AG. All rights reserved. Introduction
2 Using Add-Ons in SAP Business One 9.0

UI API Add-Ons

 If you have UI API add-ons configured as Any CPU, x86 (32-bit), or x64 (64-bit), and only one SAP Business
One client is installed on the workstation (either 32-bit or 64-bit, not both), the add-ons can be run on either
the 32-bit client or 64-bit client.
 If you have UI API add-ons that are configured as Any CPU, and both 32-bit and 64-bit SAP Business One
clients are installed on the workstation, the add-ons can be run on the 64-bit client (not the 32-bit client).
 If you have UI API add-ons configured as x86 (32 bit), and both 32-bit and 64-bit SAP Business One clients are
installed on the workstation, the add-ons can be run on the 32-bit client (not the 64-bit client).
 If you have UI API add-ons that are configured as x64 (64 bit), and both 32-bit and 64-bit SAP Business One
clients are installed on the workstation, the add-ons can run on the 64-bit client (not the 32-bit client).

Note
All of the use cases described above (and summarized in the table below) also apply to multiple add-on
connections, where the GetDIcompany method is used to access the DI through the UI.
The following table summarizes the use cases described above:

Add-On Build Mode SAP Business One 9.0 Client Installed on the Workstation
32-bit client 64-bit client 32-bit and 64-bit clients Can the Add-On Run?
only only
Any CPU Add-on works Add-on works 32-bit client is activated No
properly properly
64-bit client is activated Yes
x86 (32-bit) Add-on works Add-on works 32-bit client is activated Yes
properly properly
64-bit client is activated No
x64 (64-bit) Add-on works Add-on works 32-bit client is activated No
properly properly
64-bit client is activated Yes

Note
If the Any CPU refers to add-on builds different than the client installed, the Add-on will not function
properly. If the installed client is 32- bit and the Any CPU refers to 64- bit build mode, the add-on will not
work.

Recommendation
If you create your own add-ons, set Any CPU to allow both 32-bit and 64-bit to run. These add-ons work
properly on either a 32-bit client or a 64-bit client and the chance of malfunction is reduced.

Compatibility Guide for Add-Ons in SAP Business One 9.0 PUBLIC

Using Add-Ons in SAP Business One 9.0 © 2013 SAP AG. All rights reserved. 5
DI API Add-Ons

The following use cases apply if a 32-bit DI API is installed on a 32-bit Microsoft Windows operating system:
 DI API add-ons set as Any CPU or x86 (32 bit) and created with SAP Business One 9.0 or older can work
properly.
 DI API add-ons set as x64 (64 bit) and created with SAP Business One 9.0 cannot run properly.

The following use cases apply if a 32-bit DI API is installed on a 64-bit Microsoft Windows operating system:
 DI API add-ons set as Any CPU and created in versions older than SAP Business One 9.0, or DI API add-ons
set as Any CPU or x64 (64 bit) with SAP Business One 9.0, cannot run properly.
 DI API add-ons set as x86 (32 bit) and created in SAP Business One 9.0 or older can run properly.
The following use cases apply if a 64-bit DI API is installed on a 64-bit Microsoft Windows operating system:
 DI API add-ons set as Any CPU or x86 (32 bit) and created in versions older than SAP Business One 9.0, and
DI API add-ons set as x86 (32 bit) and created with SAP Business One 9.0, cannot run properly.
 DI API add-ons set as Any CPU or x64 (64 bit) and created with SAP Business One 9.0 can work properly.
The following use cases apply when both a 32-bit DI API and 64-bit DI API are installed on a 64-bit Microsoft
Windows operating system:
 DI API add-ons set as x86 (32 bit) and created with versions older than SAP Business One 9.0, and DI API add-
ons set as Any CPU, x86 (32 bit), or x64 (64 bit) and created with SAP Business One 9.0, can work properly.
 DI API add-ons set as Any CPU and created with versions older than SAP Business One 9.0 cannot run
properly.
The following table summarizes the use cases described above:

32-Bit Windows OS 64-Bit Windows OS

32-bit DI API 32-bit DI API 64-bit DI API 32-bit and 64-bit

installed installed installed DI API installed

Add-ons Add-on set to Add-on works Add-on cannot Add-on cannot Add-on cannot
created Any CPU properly run run run
prior to
Add-on set to Add-on works Add-on works Add-on cannot Add-on works
SAP
x86 (32-bit) properly properly run properly
Business
One 9.0

Add-ons Add-on set to Add-on works Add-on cannot Add-on works Add-on works
created Any CPU properly run properly properly
with SAP
Add-on set to Add-on works Add-on works Add-on cannot Add-on works
Business
x86 (32-bit) properly properly run properly
One 9.0
Add-on set to Add-on cannot run Add-on cannot Add-on works Add-on works
x64 (32-bit) run properly properly

PUBLIC Compatibility Guide for Add-Ons in SAP Business One 9.0

6 © 2013 SAP AG. All rights reserved. Using Add-Ons in SAP Business One 9.0
UI API and DI API Add-Ons

When working with add-ons that involve both UI API and DI API, you can predict whether a certain add-on will work
by combining the relevant use cases of DI API and UI API described above and using the logic operator "AND".

Example
You are using a 32-bit version of SAP Business One 9.0 and a 64-bit Microsoft Windows operating
system. An add-on that uses both DI API and UI API is set as Any CPU.
o Checking the UI API add-ons table , can a UI API add-on set as Any CPU work properly on SAP
Business One 9.0 32-bit client?  Yes.
o Checking the DI API add-ons table, can a DI API add-on set to Any CPU using a 32-bit DI API run on a
64-bit Microsoft Windows operating system?  No.
Conclusion
Since (Yes)AND(No) = No, the add-on in this example cannot run in the described SAP Business One
environment.

Compatibility Guide for Add-Ons in SAP Business One 9.0 PUBLIC

Using Add-Ons in SAP Business One 9.0 © 2013 SAP AG. All rights reserved. 7
www.sap.com/contactsap

Material Number

© 2013 SAP AG. All rights reserved.

No part of this publication may be reproduced or transmitted in any
form or for any purpose without the express permission of SAP AG.
The information contained herein may be changed without prior
notice.
Some software products marketed by SAP AG and its distributors
contain proprietary software components of other software
vendors.
Microsoft, Windows, Excel, Outlook, and PowerPoint are registered
trademarks of Microsoft Corporation.
IBM, DB2, DB2 Universal Database, System ads, System i5, System
p, System p5, System x, System z, System z10, System z9, z10, z9,
iSeries, pSeries, xSeries, zSeries, eServer, z/VM, z/OS, i5/OS,
S/390, OS/390, OS/400, AS/400, S/390 Parallel Enterprise
Server, PowerVM, Power Architecture, POWER6+, POWER6,
POWER5+, POWER5, POWER, OpenPower, PowerPC, BatchPipes,
BladeCenter, System Storage, GPFS, HACMP, RETAIN, DB2
Connect, RACF, Redbooks, OS/2, Parallel Sysplex, MVS/ESA, AIX,
Intelligent Miner, WebSphere, Netfinity, Tivoli and Informix are
trademarks or registered trademarks of IBM Corporation.
Linux is the registered trademark of Linus Torvalds in the U.S. and
other countries.
Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either
trademarks or registered trademarks of Adobe Systems
Incorporated in the United States and/or other countries.
Oracle is a registered trademark of Oracle Corporation.
UNIX, X/Open, OSF/1, and Motif are registered trademarks of the
Open Group.
Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame,
VideoFrame, and MultiWin are trademarks or registered trademarks
of Citrix Systems, Inc.
HTML, XML, XHTML and W3C are trademarks or registered
trademarks of W3C®, World Wide Web Consortium, Massachusetts
Institute of Technology.
Java is a registered trademark of Sun Microsystems, Inc.
JavaScript is a registered trademark of Sun Microsystems, Inc.,
used under license for technology invented and implemented by
Netscape.
SAP, R/3, xApps, xApp, SAP NetWeaver, Duet, PartnerEdge,
ByDesign, SAP Business ByDesign, and other SAP products and
services mentioned herein as well as their respective logos are
trademarks or registered trademarks of SAP AG in Germany and in
several other countries all over the world. All other product and
service names mentioned are the trademarks of their respective
companies. Data contained in this document serves informational
purposes only. National product specifications may vary.
These materials are subject to change without notice. These
materials are provided by SAP AG and its affiliated companies ("SAP
Group") for informational purposes only, without representation or
warranty of any kind, and SAP Group shall not be liable for errors or
omissions with respect to the materials. The only warranties for SAP
Group products and services are those that are set forth in the
express warranty statements accompanying such products and
services, if any. Nothing herein should be construed as constituting
an additional warranty.