Changes From Previous Versions

This section explains changes that have occurred in the Corda® Embedder between the major release versions of Corda. It includes the following topics:

7.0 Changes

Corda 7 includes several significant changes:

6.0 Changes

The Java* Tag Library version of the Corda Embedder has changed radically. The changes are too numerous to list. For more information about the new syntax, see Java Tag Library.

The JavaBean and C++ versions of the Corda Embedder are no longer supported. Use the Java Tag Library Corda Embedder instead.

The following methods and attributes are renamed in all versions of the Corda Embedder to account for the widened scope of Corda Embedder functionality: imageType, getImageData, loadServerSideImage, saveImageToCordaServer, and saveImageToAppServer. The table below indicates the new names for these attributes and methods which behave exactly the same as their predecessors.

Deprecated Method

6.0 Equivalent

getImageData()

getBytes

imageType

outputType

loadServerSideImage

loadFromCordaServer

saveImageToAppServer

saveToAppServer

saveImageToCordaServer

saveToCordaServer

 

For backwards compatibility, the Corda Embedder continues to recognize the 5.x names of these attributes and methods. However, this backwards compatibility can be discontinued at any time, so Corda strongly suggest changing Corda Embedder code to reflect the new names as quickly as possible.

5.0 Changes

Corda Embedder library files are named differently that older PopChart® Embedder library files. To determine the correct file to use, see Using Corda Embedder.

Furthermore, in versions of the PopChart Server 4.0, the Corda Embedder was called the PopChart Embedder. To maintain backwards compatibility, the Corda Embedder still retains the old PopChartEmbedder class (PopChart.Embedder in ASP). However, this class has been deprecated, along with a few minor methods and attributes. Code written for the PopChart Embedder in PopChart 4.0 still works in Corda 7, but the PopChartEmbedder class and its deprecated methods may be discontinued at any time.

To avoid potential problems with deprecated methods and attributes, Corda strongly recommends switching to the CordaEmbedder class (Corda.Embedder in ASP) in all Web pages as soon as possible.

The following table lists the deprecated PopChart Embedder methods and attributes and their Corda Embedder equivalents.

Note: Deprecated methods are not included in the CordaEmbedder class.

Deprecated Method

5.0 Equivalent

extraPCSCommands

extraCTSCommands

getPCEmbedderVersion()

getCordaEmbedderVersion

saveImageToPopChartServer()

saveToCordaServer

 

Extra Notes For ASP USERS

ASP users (VBScript only) should note that both loadData and loadCommandFile now have an additional parameter for the encoding type. This means that when you switch over to the Corda.Embedder object, append an empty string to any of these method calls since these extra parameters are not optional in VBScript.

Extra Notes for Java Users

Java users should note that the package for the Java version of the Corda Embedder has changed. Instead of com.corda.pcis.PopChartEmbedder, it is now com.corda.CordaEmbedder. This affects the includes section at the top of the Java files.

Extra Notes for.NET Users

.NET users should note that the Corda Embedder is the namespace Corda, not PCNetEmbedder.

4.0 Changes

In versions of the PopChart Image Server prior to the 4.0 release, the Corda Embedder was called the PCISEmbedder. The PCISEmbedder interface has been discontinued and is no longer supported.

This section contains two tables, one for each of the 3.x versions of the PCISEmbedder. These tables list the deprecated methods and show their 7.0 equivalent. Click on the 6.0 methods to jump to a description of the method.

Deprecated Java Methods

Deprecated Method

6.0 Equivalent

retrieveImageServerSide

loadFromCordaServer

saveImageAsLocally

saveToAppServer

saveImageAsServerSide

saveToCordaServer

serverInfoAppendSlash

appendServerInfoSlash

setAppearanceFile

imageTemplate

setBGColorStr

bgColor

setCacheImage

useCache

setExtraHTMLAttributes

extraHTMLAttributes

setExtraPCISCommands

extraCTSCommands

setHeight

height

setHTMLHeight

htmlHeight

setHTMLWidth

htmlWidth

setReturnTextDescription

returnDescriptiveLink = true;

language = CordaEmbedder.EN;1

setOutputToGIF

outputType = "JPEG";

setOutputToFLASH

outputType = "FLASH"

setOutputToFLASHWithFallback

outputType = "FLASH";

fallback = { "LOOSE" | "STRICT" };2

setOutputToPNG

outputType = "PNG";

setOutputToSVG

outputType = "SVG*";

setOutputToSVGWithFallback

outputType = "SVG";

fallback = { "LOOSE" | "STRICT" };3

setPCScript

pcScript

setReturningGraphicalLog

useLogData = true;

password = "password";

setServerInfo

externalServerAddress = "www.myserver.com:2001";

internalCommPortAddress = "10.0.0.1:2002";4

setUseCommPortAlways

Obsolete (Comm Port always used)

setUseCommPortIfOverLength

makeFullRequest = true;5

maxRequestLength = int;

setUseCommPortNever

makeFullRequest = true;6

setUseLoadBalancing

Obsolete (use Clustering instead)

setUserAgent

userAgent

setUseSVGTemplate

svgTemplate

setWidth

width

  1. You may not need to set the language attribute if you have already specified a default language. Corda Embedder assumes a default language of EN (English).

  2. Whether you use "STRICT" or "LOOSE" depends on the fallback type.

  3. Whether you use "STRICT" or "LOOSE" depends on the fallback type.

  4. For a better understanding of how this method translates, examine the description of the new attributes.

  5. The Corda Embedder must still use the COM port to generate the embedding HTML, however it embeds a full URL request instead of an embedder session ID.

  6. The Corda Embedder must still use the COM port to generate the embedding HTML, however it embeds a full URL request instead of an embedder session ID.