This section explains changes that have occurred in the Corda® Embedder between the major release versions of Corda. It includes the following topics:
Corda 7 includes several significant changes:
The Javascript* Embedder has been removed in Corda 7.
The Corda 7 XML structure has been completely revised, including a change in name (and extension) from PCXML (.pcxml) to ITXML (.itxml).
All API references that included PCXML now use ITXML. For example, addPCXML is now addITXML.
Appearance Files are now referred to as Image Template files. All API references that referred to Appearance Files, or apfiles, now use Image Template. For example, myImage.appearanceFile is now myImage.imageTemplate.
The Embedder API includes 3 new APIs that make it easier to work with typed datasets: setTypedData, setTypedDBQuery, and setTypedResultSet.
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() |
|
|
imageType |
|
|
loadServerSideImage |
|
|
saveImageToAppServer |
|
|
saveImageToCordaServer |
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.
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 |
|
|
getPCEmbedderVersion() |
|
|
saveImageToPopChartServer() |
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.
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.
.NET users should note that the Corda Embedder is the namespace Corda, not PCNetEmbedder.
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 Method |
6.0 Equivalent |
|
retrieveImageServerSide |
|
|
saveImageAsLocally |
|
|
saveImageAsServerSide |
|
|
serverInfoAppendSlash |
|
|
setAppearanceFile |
|
|
setBGColorStr |
|
|
setCacheImage |
|
|
setExtraHTMLAttributes |
|
|
setExtraPCISCommands |
|
|
setHeight |
|
|
setHTMLHeight |
|
|
setHTMLWidth |
|
|
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 |
|
|
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 |
|
|
setUseSVGTemplate |
|
|
setWidth |
|