Upload
others
View
22
Download
0
Embed Size (px)
Citation preview
IBM Marketing OperationsV 9 R 1.12014 j 11 B 26 U
/I#i
���
"b
Z9C>E"0d'VDz70,kHDAZ 313D:yw;PDE"#
Kf>JCZ IBM Marketing Operations V9.1.1 0yPsx"PfM^)f,1=ZBf>PmPyw*9#
© Copyright IBM Corporation 2002, 2014.
?<
Z 1 B 24G IBM MarketingOperations Integration Services? . . . 1Marketing Operations Integration Services D*sPD)? . . . . . . . . . . . . . . . . . 2IBM Marketing Operations Integration Services y>. . 320 Integration Services . . . . . . . . . 5m~*"K1$_|Z] . . . . . . . . . 5
P\D Javadoc. . . . . . . . . . . . . . 6Marketing Operations D5Moz . . . . . . . . 6
Z 2 B Marketing Operations /IWebservice . . . . . . . . . . . . . 9Marketing Operations Integration Services WSDL . . . 9executeProcedure . . . . . . . . . . . . . 9Marketing Operations /I Webservice }]`M . . 10
Z 3 B IBM Marketing Operations }L . . . . . . . . . . . . . . . . . 13Yh . . . . . . . . . . . . . . . . . 13dCN} . . . . . . . . . . . . . . . 14hF . . . . . . . . . . . . . . . . . 15
}Lz|\Z . . . . . . . . . . . . . . 15X| Java ` . . . . . . . . . . . . . . 17}]x( . . . . . . . . . . . . . . . 17}LBq . . . . . . . . . . . . . . . 17}L(E . . . . . . . . . . . . . . . 18}LU>G< . . . . . . . . . . . . . . 18}Le~(eD~ . . . . . . . . . . . . 18
Z 4 B IBM Marketing Operations API 21IBM Marketing Operations API DZ] . . . . . 21
API SZ . . . . . . . . . . . . . . 21#{l# . . . . . . . . . . . . . . 22dz . . . . . . . . . . . . . . . . 22tT3d . . . . . . . . . . . . . . 246Y}]`M . . . . . . . . . . . . . 25
Z*5 IBM <u'VPD.0 . . . . . 29
yw . . . . . . . . . . . . . . . . 31LjE" . . . . . . . . . . . . . . . 32~=_TM9Cun"bBn . . . . . . . . 33
© Copyright IBM Corp. 2002, 2014 iii
iv /I#i
Z 1 B 24G IBM Marketing Operations IntegrationServices?
IBM® Marketing Operations Integration Services + Marketing Operations Integration
Webservice"API }LM%"wiOZ;pT)95q&\#
IBM Marketing Operations Integration Services GTBTsDiOe#
v Marketing Operations /I Webservice
Integration Services a)K;V==,9 Marketing Operations M'M IBM Profes-
sional Services IT+ Marketing Operations k73PKPDd{&CLr/I#
v Marketing Operations }LM API
ITZ Marketing Operations P(e(F}L,T(}Nb==)9 Marketing Opera-
tions 5q_-#(e}Ls,b)}LMITw*Sd{&CLrxP Integration
Services Webservice wCD?j#9IT(e}L4+{""MAd{&CLr#
v Marketing Operations %"w
IT+%"wk Marketing Operations PDB~M}LX*#"z3vK`B~1,
+KPX*D%"w#
f>Mrsf]T
Integration Services D+4f>+k2m,;wf>EDyPN*f>M,$frsf
]#+G,TZcc (x.0) w*f>DOgf>,g{P5qmIr<umI#$,G
4 IBM +#tPOkCf>f]TD(^#
g{xPKNNTB|D,G4K API Dw*f>E+]v#
v }]bM|D
v 5q_-|D(}g,~q=(&\|D)
v =(N}M/r5X`M|D
g{xPKNNTB|D,G4K API DN*f>E+]v#b)|DJCZOMf>
(4(e)#
v mSKB=(
v mSKB}]`M"RdC>^Z3vB=(
v r6Y`MmSKB*X
v 9Cf>s:(eKSZDBf>
O$
^hO$;yPM'z<k{* PlanAPIUse DQ* IBM Marketing Operations C'X
*#53\m1+dCKXbC'D2+&\,TzcyP Webservice M'zDhs#
© Copyright IBM Corp. 2002, 2014 1
oT73
'VD(;oT73G10* IBM Marketing Operations 535}dCDoT73#Y
(yPoT73`X}](}g,{"MuR)<IC53oT73#
4,\m
API M webservice ^4,;4g API wCD~q5V;a#f?vM'zDE"#N
\a)|P'JD~q5V,"Rr/K/:'V#
}]bBq
Marketing Operations Integration Services ;arM'zT>}]bBq,+g{4PO
BDP|,K`E",G4+9Cb)E"#g{Qt/Bq,G4X(}LPyP
API wCDwC+IC-S==#;d05,'\D API wC+9}]bT&ZkS
4wC} API ;yD4,#Z}LI&jIBq.0,Marketing Operations Dd{C
';a4=|D#
C4|B}]bD API wCXkWHq!`-x(,T@9d{C'ZC API wC}
LP^DWc}]#d{C'Z API wCjI.0^(|Bx(Di~#,y,B;v
Marketing OperationsC'r API M'zXkq!}]x(,;sE\a;m;v API
wC#
B~&m
(} API Z IBM Marketing Operations i~O4PDYw+g, Marketing Opera-
tions C'4PYw;yzI`,DB~#)DX((*(}g,n?4,|D)DC'
+U=I API wCT0C'Ywx}pD4,|D(*#
Marketing Operations Integration Services D*sPD)?Marketing Operations Integration Services XkzcTB*s:
v TI"==xP53/IDnO#
v a);VzF,M'z&CLrI9CKzF(} Webservice wC40l Market-
ing Operations#
v a);VzF,I9CKzFZ Marketing Operations PrM'&CLr(*3)B
~#
v a)WZmbM9CDr%`L#M#
v _P?sDJOV4&\
v #$}]j{T#
v kyZ GUI DVP Marketing Operations M'/I,"+Tb)M'D0l5An
M#
v T Marketing Operations i~a)8E#HDCJ,,19`LK1bZS%Wc5
Vj8E"#
2 /I#i
IBM Marketing Operations Integration Services y>I9C IBM Marketing Operations Integration Services 44((F}L#1 Marketing
Operations P"zX(B~1,IT9Cb)}L4%"b?B~#IT9Cb)}L
4Sb?53rLrKP Marketing Operations &\#
API SZk IBM Marketing Operations Z`L6pOxP;%,}g GUI SZk Mar-
keting Operations ZC'6pOxP;%;y#9C API IT9(}L#IT9Cb)
}LZ Marketing Operations kb?53.d(E#Marketing Operations Webservice G
}L"API M%"wD]wTs#
TBT>K Marketing Operations Integration Services De5a9#
外部系统 外部系统
Marketing O
perations Web Service
定制过程
Marketing Operations 应用程序核心
触发器管理器
过程管理器
IBM Marketing Operations
TBG Integration Services Dw*i~#
v Marketing Operations }L\mw:(}hz API k Marketing Operations ;%,)
95q_-#
v Marketing Operations %"w\mw:+u~(}gP!*zTsD4,|D)kYw
(1zc%"wDu~1*KPD}L)X*#
=(
9C IBM Marketing Operations Integration Services Di~4*"(F}L,gB<P
y>:
Z 1 B 24G IBM Marketing Operations Integration Services? 3
Marketing Operations 安装程序
Java IDE
应用程序服务器
编程人员
取消部署 MO
弹回服务器
部署 MO
更新 MO归档
构建插件
<<包含>>
持久存储
持久存储
持久存储
Java
XML
ANT
文件系统
文件系统
编译类
安装开发人员工具箱
更新插件定义
代码程序
20*"K1$_|.s,kq-TBy>=h:
1. T(F}LxP`k#10Xk9C Java™#
2. |B XML (eD~PDe~(e#
3. 9(e~:
a. `kX*D`#
b. g{z}Z9C;Z Marketing Operations i5PDZ}=b,k+b&sZ
plan.war D~Z"XB?p#
4. XBt/ Marketing Operations#1zXBt/&CLr~qw1,a&CT}L`
yvD|D#
":g{z|D plan.war D~,G4Xk!{?p;s9CBD plan.war D~XB?p Marketing Operations#g{z9C;Z Marketing Operations i5PDZ
}=b"`- plan.war D~,k!{?p;sXB?p Marketing Operations#
4 /I#i
Z IBM Marketing Operations k API .d(EDy>>}
TBy>>}hvZ API k Marketing Operations .d("(E#|";4PNNP
CD$w;|+4P Marketing Operations k Integration Services .dDy5(E#
K>}9C Marketing Operations Integration Services *"K1$_|f=D?V>}
}L#_e45,ITZTBD~PR=K&}CDzk#
v PlanClientFacade.java
v PlanWSNOOPTestCase.java
noop =(GT Marketing Operations D Webservice wC#|Z PlanClientFacade `P
(e,"Z}iP+]U5#
public ProcedureResponse noop(String jobId)throws RemoteException, ServiceException {NameValueArrays parameters =
new NameValueArrays(null, null, null, null, null, null, null, null);return _serviceBinding.executeProcedure("uapNOOPProcedure", jobId, parameters);
}
}L testExecuteProcedure S PlanClientFacade wC noop =(,T("k Marketing
Operations &CLrDy5(E#
public void testExecuteProcedure() throws Exception {// Time out after a minuteint timeout = 60000;PlanClientFacade clientFacade = new PlanClientFacade(urlWebService, timeout);System.out.println("noop w/no parameters");long startTime = new Date().getTime();ProcedureResponse response = clientFacade.noop("junit-jobid");long duration = new Date().getTime() - startTime;
// zero or positive status => successSystem.out.println("Status: " + response.getStatus());System.out.println("Duration: " + duration + " ms");assertTrue(response.getStatus() >= 0);System.out.println("Done.");
}
PX NameValueArrays"ProcedureResponse T0d{PvD=(M}]`MDj8E",
kND6Marketing Operations /I#i7 M JavaDocs#
20 Integration ServicesIBM Marketing Operations Integration Services #iG;V@"D6Qi~#g{z:
r Integration Services #i,G4XkTdxP20#
1. BX IBM Marketing Operations Integration Services 20Lr#
2. IBM EMM 20Lr+lb Integration Services #i#
3. C20Lr+hC;Z Marketing Operations | umoConfiguration |integrationServices | enableIntegrationServices DdCtT#I(}|DdC
N}4(FzD20#PX|`E",kND Z 143D:dCN};#
m~*"K1$_|Z](#,yP Marketing Operations Integration Services i~<20Zj)*“devkits”D
~PP#
Z 1 B 24G IBM Marketing Operations Integration Services? 5
m~*"K1$_||,D5"|,yP publicapi `MSZD Javadoc T0>}zk#
>}zk20ZTBD~PP#
v build D~P|,CZ9(M?p(F}LDE>#
v Classes D~P|,QxP`kD}L`#
C'Xk?p;ZdCN} integrationProcedureClasspathURL y8(76D(F}LD`k`#;s,IBM Marketing Operations Procedure Manager +4 proce-
dure-plugins.xml dCD~Py8(D==0kb)`#
v lib D~P|,CZ*"M`k(F}LDXhb#
v src D~P|,(F}LD4D~#C'I+*w*%"wr web-service t/D(
F}LECZK&#
– src/procedure D~P|, procedure-plugins.xml dCD~#w*yZB~D
%"wr_(}b? web service KPD?v(F}L<XkZKD~P_P;v
u?#b)u?Xk|,}LDj<`76T0XhDu</N}#
– src/procedure D~P9|, IBM Marketing Operations f=D3)y>}L#
b)}LIC4KbM*"(F}L#
+(F}LECZBD~Pa9PD src ?<B,}g,com/<mycompany>/
<mypackage>#;*+(F}LECZy>}LD~PP#
– src/soap D~P|,Z Java P*"Dy> web service M'z#9Cb)y>
w*kT Integration Services *"yZ web service DM'zDp<c#KD~
P9|,CZ(}|nPt/y>M'zD~xFE>#
P\D JavadocPX+2 API =(DX(E",kND JavaDocs API D5D~PD iPlanAPI `#
(}TB==Iq!b)D~:
v (}w\ M a r k e t i n g O p e r a t i o n s D~qwOD < I B M _ E M M > /
<MarketingOperations_Home>/devkits/integration/javadocs ?<PDD~#
v G<= Marketing Operations "SNN3f!qoz> z7D5,;sBX IBM
<V>PublicAPI.zip D~#
Marketing Operations D5Mozi/PD;,K19C IBM Marketing Operations 4jI;,DNq#;5P8OPa
)KPX Marketing Operations DE",dP?V8O<<Z)_PX(?jM<\/
ODESI19C#
BmhvK?v8OPa)DE"#
6 /I#i
m 1. Marketing Operations D5/OPD8O.
BmI}PiI,Z;P|,Nq,Z~P|,8O{F,Z}P|,\Z#
g{z4PTBNq kND \Z
v F.M\mn?
v 7($wwLNq"oL.MK1
v zYn?QC
v qCPXZ]DsDMsz
v zI(f
6IBM Marketing Operations C'8O7 v n?-m
v 4bhF&
v 1SJDP!*z-m
v hF#e"m%"tTMH?
v (FC'gf
v (eC'CJ6pM2+
v 5VI!&\
v dCMwE Marketing Operations
IBM Marketing Operations\m18O v n?-m
v IT \m1
v 5VKJ
v 4(P!*zn/
v F.L7
v 5V Marketing Operations k Cam-
paign D/I
v 5V Marketing Operations k IBM
Digital Recommendations D/I
6IBM Marketing Operations k IBM /
I8O7
v n?-m
v P!*z4P(R
v 1z-m
v KbPXB53&\DE"
v P?Q*JbMd(=(
6IBM Marketing Operations "P5w7 9C Marketing Operations DNNK
v 20 Marketing Operations
v dC Marketing Operations
v }6= Marketing Operations DBf
>
6IBM Marketing Operations 208O7 v m~5VKJ
v IT \m1
v }]b\m1
4((F}LT+ Marketing Opera-
tions kd{&CLr/I
6IBM Marketing Operations /I#
i7,T01zZ Marketing Operations
P%woz > z7E""BX IBM
<version>PublicAPI.zip D~1a)D
API JavaDoc#
v IT \m1
v }]b\m1
v 5VKJ
KbPX Marketing Operations }]b
a9DE"
6IBM Marketing Operations 53#=7 }]b\m1
Z$w1h*|`E" v q!oz"Qwr/@6Marketing
Operations C'8O7"6Marketing
Operations \m18O7r6Market-
ing Operations 208O7:%woz
> K3fDoz
v CJyP Marketing Operations 8O:
%woz > z7D5
v CJyP IBM Enterprise Marketing
Management (EMM) z7D8O:%
woz > +? IBM EMM Suite D5
9C Marketing Operations DNNK
Z 1 B 24G IBM Marketing Operations Integration Services? 7
8 /I#i
Z 2 B Marketing Operations /I Webservice
Webservice a) Marketing Operations Integration Services DM'zS<,x Integra-
tion Services G IBM Marketing Operations ~qw?pD;?V#C~q) Marketing
Operations Web C'""9C#
Webservice a);v API wC,4 executeProcedure#
M'z1SxPK Webservice wC#
Marketing Operations Integration Services WSDLWeb ~q(eoT (WSDL) (}V/(e,"RGXZ Webservice (eDnUmv#
Axis
Kf>D Webservice 9C Axis2 1.5.2 4(} WSDL D~zI9I Web service 5
VD~qwK`#C'IT(}a)D WSDL,fb9CNNf>D Axis rNNd{
G Axis <u44(M'zK5V,Tk API /I#
-if>
-iDf>k WSDL T=s(,gBy>:
v w* WSDL {FD;?V,}g,PlanIntegrationService1.0.wsdl
v w* WSDL ta rge tNamespace D;?V,}g,xmlns:tns= ″http://webservices.unica.com /MktOps/services/PlanIntegrationServices1.0?wsdl″
WSDL
IBM Market ing Operat ions Integrat ion Services f=;v WSDL D~:
PlanIntegrationServices1.0.wsdl#C WSDL Z integration/examples/soap/plan
?<Pa)#>}9(E>9CKD~4zI`&DM'zKfyT,SA
Webservice#
executeProcedureo(
executeProcedure(string key, string jobid, NameValueArrays paramArray)
5X5
int: statusMessage[]: messages
hv
K=(9CI!DN}}iwC8(}L#wC+T,===4P;4,|+h9M
'z"ZjI15Xa{#
© Copyright IBM Corp. 2002, 2014 9
N}
m 2. executeProcedure N}
Name hv
key *KPD}LD(;|#g{;P* key s(NN}L,G4+5XRemoteException ms#
jobid j6kK}L4PX*Dw5DI!V{.#KV{.G+]n?,+|
ICZ+M'zNqkX(}LD4PX*Z;p#
paramArray *+]A}LDN}}i#g{;vr`vN}^'(}g,ms`Mr
;}75),G4+5Xms4,M{"#+IM'z47(N}"N}
`MT0}Lyh5D}?#
5XN}
m 3. executeProcedure 5XN}
Name hv
status {}zk:
v 0 8>}LQI&KP
v {}8>ms
}LIT9C4,48>;,6pDms#
messages cr`v{"}]a9D}i#g{ status * 0,G4K}i;|,
ERROR {",+IT|, INFORMATION M WARNING {"#
g{ status Gc,G4 messages IT|, ERROR"INFORMATION M
WARNING {"DNNiO#
Marketing Operations /I Webservice }]`MWebservice 9CD}]`MkNNX(~qs(r`L5V^X#
+9CTBm>(#
v <type>: <type definition> (er%D}]`M#}g:
Handle: string
v <type>: [ <type definition> ] (e4SD}]`Mr}]a9#
v <type>: { <type definition> } (e4SD}]`Mr}]a9#
4SD`M*XM API N}IT9Cb)`M4yw}i#}g:
Handle [] handles
`M handles G Handle `MD}i#
y>`M
y>`Mv^ZBmP(eD`M,CZr/ SOAP 1.1 s(D'V#IT+yP`M
yw*}i,}g String [ ]#5JO,~xF}]`M(g long)ITI-is((}g SOAP)m>*V{.#;x,Km>TZM'z4=D`Moe"mID5H
;PwC#
10 /I#i
m 4. y>`M
API `M hv SOAP `M Java `M
<{5 <{5:true r false xsd:Boolean <{5
dateTime UZ1d5 xsd:datetime Date
decimal Nb+H.xF5 xsd:decimal java.math.BigDecimal
double xP{ED++H.xF
5
xsd:double double
int xP{ED 32 ;{}5 xsd:int int
integer xP{EDNb+H{}
5
xsd:integer java.math.BigInteger
long xP{ED 64 ;{}5 xsd:long long
V{. Unicode V{DV{. xsd:string java.lang.String
MessageTypeEnumMessageTypeEnum: { INFORMATION, WARNING, ERROR }
MessageTypeEnum G(eyPI\{"`MD6Y`M#
v INFORMATION:N<{"
v WARNING:/f{"
v ERROR:ms{"
{"
Message: [MessageTypeEnum type, string code, string localizedText, string logDetail]
Message G(e Webservice API wCa{D}]a9#|a)G>X/zk">X/
D>MU>j8E"DI!VN#10,yP>X/D><9C* IBM Marketing
Operations ~qw5}hCDoT73#
m 5. {"N}
N} hv
`M MessageTypeEnum,hC{"D`M#
code {"DI!zk,ICV{.q=#
localizedText CZk{"X*DI!D>V{.#
logDetail I!Q;zY{"#
NameValueNameValue: [string name, int sequence]
NameValue G(e{F/5TDy>4S`M#|9(e~qCZy]h*9l5}iD
I!rP(rPyZc)#
{F`,+rE;,DyP NameValue <+*;*5D}i,"k+2{FX*#
}is!InsrE7(;48(D}i*X_PU5#}irEXk(;#5M5
D`MI)9`Ma)#
Z 2 B Marketing Operations /I Webservice 11
m 6. NameValue N}
N} hv
name (e NameValue `MD{FDV{.#
3r yZcD{},|hC NameValue 5,5DrE#
*?vy>`M(eK)9 NameValue `M,gBy>:
m 7. )9 NameValue `M
)9`M hv
BigDecimalNameValue: NameValue [ decimal
value]
5*Nb+H.xF}VD NameValue `M#
BigIntegerNameValue: NameValue [ integer value] 5*Nbs!{}D NameValue `M#
BooleanNameValue: NameValue [ Boolean value] 5*<{5D NameValue `M#
CurrencyNameValue: NameValue [ string locale,
decimal value]
JCZm>3)oT73PDuRD
NameValue `M#oT73G ISO oTzk,
4 ISO-639 (eD=v!4V8Dzk#
10,oT73Xkk IBM Marketing Opera-
tions ~qw5}PhCDoT73;B#
DateNameValue: NameValue [ datetime value] 5*UZD NameValue `M#
DecimalNameValue: NameValue [ double value] 5*++H.xF}VD NameValue `M#
IntegerNameValue: NameValue [ long value] 5* 64 ;{}D NameValue `M#
String NameValue: NameValue [ string value] 5*V{.D NameValue `M#
nU,+(e)9 NameValue `MD}i,T)ZXk(e;,`M NameValue /O
19C#
NameValueArrays: [BooleanNameValue[] booleanValues,StringNameValue[] stringValues,IntegerNameValue[] integerValues,BigIntegerNameValue[] bigIntegooleanNameValue,DecimalNameValue[] decimalValues,BigDecimalNameValue[] bigDecimalValuesDateNameValue[] dateNameValuesCurrencyNameValue[] currencyValues
]
12 /I#i
Z 3 B IBM Marketing Operations }L
“}L”G IBM Marketing Operations P\D(Frj< Java `,|4P3)$w%*#
}La)K;V==,9M'M IBM Professional Services IT(}Nb==)9 Mar-
keting Operations 5q_-#
}Lq-r%D`L#M,|9C}7(eD API 40l Marketing Operations \m
Di~#(}r%DiRzFMyZ XML D(eD~4“"V”}L#Marketing Opera-
tions y]}LD“M'z”Dhs4KPb)}L#}g,T/Iks(kV)r%"w
%"(Z?rvV)xPl&#
}LkdM'zT,===KP;a{(}VCDsFzF1Sa)xM'z#}L
D4PI\9a<BZ Marketing Operations P%"d{B~M%"w#
Xk9C Java `4}L#
Yh
}L5V
}L5V`b0Z%@D`wr JAR D~P,"(} URL 76a)x IBM Market-
ing Operations#}L4P\mw9C@"D`0kw4y]h*0kb)`#1!iv
B,Marketing Operations ZTB?<PiR:
<MarketingOperations_Home>/devkits/integration/examples/classes
*|DK1!5,kThC > dC > Marketing Operations > umoConfiguration> integrationServices BD integrationProcedureClasspathURL N}xPhC#
}L5V`{q-+OD Java |{<(,T\bk“unica”Md{)&La)D`"z
Lr|e;#XpGM';C+}LCZ“com.unica”r“com.unicacorp”Lr|wB#
Q9C&CLr~qwOD IBM Marketing Operations y9CD Java KP1f>(A
Y* JRE 1.5.10)4T}L5VxP`k#
}L5V`I IBM Marketing Operations (#9CD`0k_T((#G8`s0k)
40k#&CLr~qwI\aa)*"$_M!nTXB0kJCZ Marketing Opera-
tions }LD`,+KP*"GXh#
b
IBM Marketing Operations a);)*E=4zkMZ}=b;&CLr~qw29C
b)bD;,f>#
(#,KPmf"PfD;,x|D#TZ V9.1.0,TBZ}=b\'V#
v Ant 1.6.5 (ant.jar)
v Axis2 1.5.2 M@5X5
© Copyright IBM Corp. 2002, 2014 13
– axiom-api-1.2.9.jar
– axiom-impl-1.2.9.jar
– axis2-adb-codegen-1.5.2.jar
– axis2-codegen-1.5.2.jar
– axis2-adb-1.5.2.jar
– axis2-kernel-1.5.2.jar
– axis2-transport-http-1.5.2.jar
– axis2-transport-local-1.5.2.jar
– commons-codec.jar
– commons-httpclient-3.1.jar
– commons-logging.jar
– httpcore-4.0.jar
– neethi-2.0.4.jar
– geronimo-stax-api_1.0_spec-1.0.1.jar
– jaxrpc.jar
– xlxpScanner.jar
– xlxpScannerUtils.jar
– xlxpWASParsers.jar
– wsdl4j-1.6.2.jar
– XmlSchema-1.4.3.jar
v JavaMail 1.4.3(activation.jar M mail.jar)
v JUnit 4.4 (junit-4.4.jar)
v IBM Marketing Operations API (affinium_plan.jar)
v IBM Marketing Platform API (unica-common.jar)
g{}LrC}L<kDN6`9CK`Lr|,G4b)|D9CXkk Marketing
Operations r&CLr~qwa)D|j+;B#ZbVivB,g{ Marketing Opera-
tions D+4f>TbxP}6rEzb,G4zh*XB`4}Lzk#
}LM_L
TZ}LT:D4,,}LXkG_L2+D;4|DKP=(;\@5Z;,wC
dDZ?4,|D#}L;\T:4(_L#
dCN}
1z20 Marketing Operations /I#i1,20Lr+hC}vdCtT#I^Dd
CtTT(F/I#iDP*#
/I#iDdCtT;Z Marketing Operations | umoConfiguration |integrationServices B#
v enableIntegrationServices dCtT,CZXUM*t Integration Services #i#
v integrationProcedureDefinitionPath N},|,(F}L(e XML D~Dj{
D~76#
14 /I#i
1!5* <IBM_EMM_Home><MarketingOperations_Home>/devkits/integration/
examples/src/procedure/procedure-plugins.xml/#
v integrationProcedureClasspathURL N},|,(F}L`76D URL#
1!5* file:///<IBM_EMM_Home><MarketingOperations_Home>/devkits/ inte-
gration/examples/classes/#
":integrationProcedureClasspathURL 76)2D“/”G}70k}L`yXhD#
hF
}L5V`9C IBM Marketing Operations API 4A!M|B Marketing Operations i
~"t/~qHH#d{ Java |ICZ4Pd{Nq#
hF&EXZzIT-S==4PD%v$w%*#ZmkivB,}L4P;5P
Nq,I(}l===+b)NqwH*Z+431KP#K“;M@]”D/I#M
<B=v53O<fZn!D:X#
":Z Marketing Operations D+4"PfP,+v'VD5/D`M=(#&+ Mar-
keting Operations PDyPd{`M=(<S*{99C#
Z`4}L5V`Dzk"xP`k.s,&9|GTZ Marketing Operations IC#
f Marketing Operations Integration Services a)D9(E>+`ksD}LCZ1!
;C#nsD*"=hG|B Marketing Operations 9CD(F}Le~(eD~,T
"V(F}L#
}LXk5V com.unica.publicapi.plan.plugin.procedure.IProcedure SZ,"Xk_P^N}D9l=((#{D JavaBeans #M)#?v}LD`kM`k<ZM'
!qD Java IDE(}g Eclipse"Borland JBuilder r Idea)PjI#IBM Marketing
Operations f=Ky>zkw**"_$_|,|G;ZTB;C:
<MarketingOperations_Home>/devkits/integration/examples/src/procedure
}Lz|\Z
?v}L<Zj{z|\ZPKP#
}LDKP1z|\Z|(BP=h#
1. "VMu</
2. !q(I!)
3. 4P
4. zY
"VMu</
Xk9 IBM Marketing Operations KbICZX(205}DyPj<M(F}L#K
}LF*"V#
":j<}L(I Marketing Operations $LES(eD}L)G~=Q*D,rK^
hNNYwMIT"Vb)}L#
Z 3 B IBM Marketing Operations }L 15
(F}LZ}Le~(eD~P(e#Marketing Operations e~\mwZu</ZdA
!KD~#TZR=D?v}L,e~\mw+jIBP=h#
1. T}LxP5}/;+d4,*;* INSTANTIATED#
2. 4(}LsFG<#
3. g{QT}LxP5}/,G4+9Cde~hvD~PR=DNNu</N}4
wCd initialize() =(#g{K=(Wvl#,G4+G<4,,"RaEzC
}L#qr,C}LD4,+*;* INITIALIZED#VZC}Lf1IKP#
4. 4(}LsFG<#
5. g{QT}LxPu</,G4+wCd getKey =(47(M'zCZ}CC}LD|#a+K|k5}X*,"#fT)+4iR#
!q
P1,IBM Marketing Operations I\arC'a)IC}LDPm,}g9\m1I
ThC%"w#Z}Lu</.s,M a r k e t i n g O p e r a t i o n s a9C}LD
getDisplayName() M getDescription() =(va)KPm#
4P
ZQT}LxPu</sD3v1L,IBM Marketing Operations +U=KPC}LD
ks#bI\akd{_LOKPDd{}L(r,;}L),1"z#
ZKP1,}L4P\mw+jIBP=h#
1. t/}]bBq#
2. +}L4,hC* EXECUTING#
3. 4(}LsFG<#
4. x4POBDT0IM'za)DNNKPN}wC}LD execute() =(#=(
5V+y]h*9C Marketing Operations API,,1q!`-x("X4POBD
=r+]#g{ run =(Wvl#,G44P\mw+jGBqTxPXv#
5. y]4Pa{d5rXvBq;+}L4,hC* EXECUTED#
6. MENN4vD`-x(#
7. 4(}LsFG<#
":execute() =(;&Dd}L5}}]#
zY
1 IBM Marketing Operations XU1,}Le~\mw+izyP0kD}L#TZR
=D?v}L,|+jIBP=h#
1. wC}LD destroy() =(,T9}LIZzY5}.0xPem#
2. +}LD4,|D* FINALIZED(^(KPC}L)#
3. 4(}LsFG<#
4. zY}LD5}#
16 /I#i
X| Java `a)D/I*"K1$_||,+C IBM Marketing Operations API M'V`D;i
Javadoc#
K&PvKnX*D;) Java `#
v IProcedure (com.unica.publicapi.plan.plugin.procedure.IProcedure):yP}LXk5VD
SZ#}L-z}7(eDz|\Z,"CJ Marketing Operations API T4P$w#
v ITriggerProcedure (com.unica.publicapi.plan.plugin.procedure.ITriggerProcedure):yP%
"w}LXk5VDSZ(jGSZ)#
v IExecutionContext (com.unica.publicapi.plan.plugin.procedure.IExecutionContext):I4P
\mw+]A}LD;8wOBDTsDSZ#KTs_PCZG<M`-x(\
mD+C=(#}L9a+KTs+]AyP PlanAPI wC#
v IPlanAPI (com.unica.publicapi.plan.api.IPlanAPI):Marketing Operations API DSZ#
4POBDa) getPlanAPI() =(Tlw}7D5V#
}]x(
IBM Marketing Operations 9C#X=`-x(=8;4,?N;r;vC'Zhi~
5}D|BCJ(#TZ GUI C',Kx(ZIS!n(6pOjI#Z3)ivB,
+x(?V5}D}],}g,“n?**”!n(#Zd{ivB,+x(m`5}
ZD}],}g,“$wwL”!n(#C'q!x(.s,yPd{C'TZ`X}
]<;\xPACJ#
*7#d{C';aZ^bP2G}LTi~5}r5}ixPD|D,}LZ|B
i~}].0Xkq!`&Dx(#+9C+]A}L execute() =(D4POBDTs45Vx(}]#
Z}L|BNN}].0,|Xk*yhD?vx(wCOBDD acquireLock() =(#}g,g{}L+|Bn?MX*D$wwL,G4C}LXkq!b=_Dx
(#
g{d{C'Q5Px(,G4 acquireLock() =(+"4Wv LockInUseException#*!?uYe;,}LXkZ|BTss"4MEx(#
1 execute =(5X1,4P\mw+T/MEyP4vDx(#ZNNivB,vZ
}]bBqDzfZP#Vx(#bMG5,g{,vKX(Z}]bDBq,1
5,G4x(+=Z#
":`-x(k}]bBq;,#
}LBq
}L4P\mwT/9C}]bBqT}LD4PxPr|,y]}L4PDa{x
Pd5rXv#
|0}L4PM}]b;W+7#Zd5.0d{C';a4=T IBM Marketing
Operations }]bxPD|B#,1T-S==xP|B#
Z 3 B IBM Marketing Operations }L 17
}L4LrT;Xkq!X*D`-x(,T7#Z}L4PjI.0d{C'^(
r}]b4k|D#
}L(E
}LD execute() =(+{}4,k5X= IBM Marketing Operations }LsFmP#
}LD execute() =(5X{}4,k,a+b)E"G<"VC#fZ}LsFmP#
M'z2IT9C3)d{D==4+]4,E"#
}LU>G<
IBM Marketing Operations _PCZ}LD%@U>D~:<MarketingOperations_Home>\
logs\procedure.log
}L4P\mw+G<?v}LDz|\Z"4(sFG<#
v logInfo():+N<{"4k=}LU>#
v logWarning():+/f{"4k=}LU>#
v logError:+ms{"4k=}LU>#
v logException():+l#DQ;zY*"=}LU>#
}Le~(eD~
K}Le~(eD~(ePX*Z IBM Marketing Operations PP\D(F}LD5V
`"*}]Md{E"#
1!ivB,Y(}Le~(e;ZTB76P:
<MarketingOperations_Home>/devkits/integration/examples/src/procedures/
procedure-plugins.xml
KD~G|,TBE"D XML D5#
}L:cr`v Procedure *XDPm#
}L:(e}LD*X#?v}L|,TB*X#
v key(I!):(e}LDiR|DV{.#TZX( Marketing Operations 5}P\
DyPj<(IBM a)D)}LM(F}L,K|Xk(;#g{4(e,G4+1
!* className *XDj<f>#TV{.“uap”*7D{F#t) IBM Marketing
Operations 9C#
v className(Xh):}L`Dj<Lr|{#K`Xk5V IProcedure `
(com.unica.public.plan.plugin.procedure.IProcedure)#
v initParameters(I!):cr`v initParameter *XDPm#
initParameter(I!):*+]A}LD initialize() =(DN}#K*X|(6W
DN} name"type M value *X#
– name:(eN}{FDV{.
– type:(eN}5`MD Java |0w`DI!`{#XkGTB3v`M:
18 /I#i
- java.lang.String(1!5)
- java.lang.Integer
- java.lang.Double
- java.lang.Calendar
- java.lang.Boolean
– value:y]`Mx(DtT5DV{.q=
Z 3 B IBM Marketing Operations }L 19
20 /I#i
Z 4 B IBM Marketing Operations API
IBM Marketing Operations API G;Vb[,|a)}ZKPD Marketing Operations
5}DM'zS<#
vrC'T>?V Marketing Operations &\#C API ) Marketing Operations Web
C'k Marketing Operations Integration Services WebService SOAP ksM%"w""
9C#C API 'VTB`MDYw:
v i~4(M>}
v "V(4i~`M"tT5Md{5)
v i~li((}dtT"(C4SMd{5)
v i~^D
IBM Marketing Operations API DZ]com.unica.publicapi.plan.api m~|a)K IBM Marketing Operations API#
Km~|a)KSZMl#,"R|,TB`MD`:
v 6Y}]`M#
v CZj6TsMi~5}Ddz#
v ;V Java 3d,AttributeMap#
(}Z M a r k e t i n g O p e r a t i o n s 5}P%woz > z7D5;sBX IBM
<version>PublicAPI.zip D~IqC API Dj{D5,|(yP=(MI\D5#
API SZIBM Marketing Operations &CLr`LSZ (API) |,TBSZ:IPlanAPI MIExecutionContext#
Marketing Operations API |,TBSZ#
IPlanAPI(e Marketing Operations D+C API#a)CZ4(""VM^DTs(|
(D~P"n?"$wwLNqMESI1)D=(#
TZtCKI!Dk IBM Campaign/I!nD53,9a)CZ4(""VM
^DL7D=(#
IExecutionContext(eZ API P4P=(D%"wMx(#
API =(PX+2 API =(DX(E",kND JavaDocs API D5D~PD iPlanAPI `#
(}G<= Marketing Operations "ISNN3f!qoz> z7D5,;sBX<V>PublicAPI.zip D~4q!b)D~#
© Copyright IBM Corp. 2002, 2014 21
#{l#
A P I WvD#{l#|(TB8V:
N o t F o u n d E x c e p t i o n " A u t h o r i z a t i o n E x c e p t i o n " D a t a E x c e p t i o n "
InvalidExecutionContextException M NotLockedException#
TBPm5wI\"zb)#{l#D-r#
v <object type>NotFoundException:53^(5X8(DnrTs#
v AuthorizationException:k4POBDX*DC'^(4PksDYw#NN API =
(<ITWvKl#,rK4ywKl##
v DataException:IBM Marketing Operations PDWc}]bcP"zKl##ki4
SQL U>Tq!j8E"#
v InvalidExecutionContextException:+]A API =(D4POBD"zJb,}g,
4TC=(}7u</#NN API <ITWvKl#,rK4ywKl##
v NotLockedException:4WHq!XhDx(M"T|Bi~}]#kND
IExecutionContext SZD acquireLock() =(#
dz
dzG}C IBM Marketing Operations 5}P3vX(Ts5}DXb URL Ts#d
z|(i~`M"Z?}]j6M5}y> URL#
I API 9CrzIDdzITb?/*j{ URL#I(};,=(9CzID URL#
IT9C URL TZ Marketing Operations GUI Pr*i~S<,ZgSJ~P"Mr
Zd{}LPCwN}#
dzvTZX( Marketing Operations ~q5}r/:5}P',+TZQ?p~qD
{vzfZ<P'#rK,IT+dz#fZD~PT)+4}C,+^(+dCZ
CJd{ Marketing Operations 5}ODi~#K^F2JCZZ,;omwz~qw
OD5}#+G,Marketing Operations 75a)K;V+;,Dy> URL 3dA10
5}DzF,TJ&+5}XBECAd{~qw(}g,1h8"zJO1)#
dz@"ZM'z#}g,%"wIT+dz+]A}L,C}L+dw*N}CZ
TZ}=53D SOAP wCP#Z}=53r Marketing Operations "X SOAP ks,
Tt/|BtTD}L#
Handle `DI1_PSwV`MD URL 4(dzD$'=(#TBG>}#
sz
http://mymachine:7001/plan/affiniumplan.jsp?cat=approvaldetail&approvalid=101
Jz
http://localhost:7001/plan/affiniumplan.jsp?cat=asset&assetMode=VIEW_ASSET&assetid=101
JzD~P
http://localhost:7001/plan/affiniumplan.jsp?cat=folder&id=101
Jzb
http://localhost:7001/plan/affiniumplan.jsp?cat=library&id=101
22 /I#i
=~
http://mychane:7001/plan/affiniumplan.jsp?cat=attachmentview&attachid=101&parentObjectId=101&parentObjectType=project
FqJ'
http://localhost:7001/plan/affiniumplan.jsp?cat=accountdetails&accountid=101
D~P
http://mymachine:7001/plan/affiniumplan.jsp?cat=grouping_folder&folderid=1234
"1
http://localhost:7001/plan/affiniumplan.jsp?cat=invoicedetails&invoiceid=134
"1Pn
http://localhost:7001/plan/affiniumplan.jsp?cat=invoicedetails&invoiceid=134&line_item_id=101
*zTs
http://mymachine:7001/plan/affiniumplan.jsp?cat=componenttabs&componentid=creatives&componentinstid=1234
P!*zTsxq
http://mymachine:7001/plan/affiniumplan.jsp?cat=componenttabs&componentid=creatives&componentinstid=1234&gridid=grid
P!*zTsxqP
http://mymachine:7001/plan/affiniumplan.jsp?cat=componenttabs&componentid=creatives&componentinstid=1234&gridid=grid&gridrowid=101
F.ES
http://mychane:7001/plan/affiniumplan.jsp?cat=teamdetails&func=edit&teamid=100001
F.C'
http://mymachine:7001/plan/affiniumplan.jsp?cat=adminuserpermissions&func=edit&userId=101
n?
http://mymachine:7001/plan/affiniumplan.jsp?cat=projecttabs&projectid=1234
n?xq
http://mymachine:7001/plan/affiniumplan.jsp?cat=projecttabs&projectid=1234&gridid=grid
n?xqP
http://mymachine:7001/plan/affiniumplan.jsp?cat=projecttabs&projectid=1234&gridid=grid&gridrowid=101
n?Pn
http://localhost:7001/plan/affiniumplan.jsp?cat=projecttabs&projectid=1234&projectlineitemid=123&projectlineitemisversionfinal=false
$wwLWN
http://mymachine:7001/plan/affiniumplan.jsp?cat=projectworkflow&projectid=1234&taskid=5678
$wwLNq
http://mymachine:7001/plan/affiniumplan.jsp?cat=projectworkflow&projectid=1234&taskid=5678
Z 4 B IBM Marketing Operations API 23
tT3d
AttributeMap `Gv|,tTD Java 3d#tT <Name> G3du?|,xtT <val-
ues> }i(k"b4})G3du?5#
AttributeMap `|,BPVN#
v <Name>:tTD`L{F#K{FCwZ"z3dDi~5}PCJCtTD(;
|#
":<Name> ;;(G GUI PrC'J>DT>{#TZy]#e(gn?r$w
wLNq)4(Di~,tT{I#e*X(e8(#tT{FXkG(;D#T
Zd{i~,tT{(#T`L==S~qwKi~5}Izx4(}g,(} Java
T!)#
":4U_},(FtT|(CZ(eI`-f>Dq=D{F:
<form_name>.<attribute_name>#
v Values:Java Ts}i,||,cr`vtT5#?v5D`MXk`,"Rk Mar-
keting Operations P(eDtT`M;B#v'VTB Java |0wM Marketing Opera-
tions `M:
– AssetLibraryStateEnum:AssetLibraryStateEnum 6Y`M5#
– AssetStateEnum:AssetStateEnum 6Y`M5#
– AttachmentTypeEnum:AttachmentTypeEnum 6Y`M5#
– AttributeMap:#ftTD3d#
– BudgetPeriodEnum:BudgetPeriodEnum 6Y`M5#
– BudgetTypeEnum:BudgetTypeEnum 6Y`M5#
– Handle:Ti~5}"xqP"tTHD}C#
– InvoiceStateEnum:InvoiceStateEnum 6Y`M5#
– java.io.File:D~D5w#
– java.lang.Boolean:<{5,True r False
– java.lang.Double:++H.xF}5#
– java.lang.Float:%+H.xF}5
– java.lang.Integer:32 ;{}5
– java.lang.Long:64 ;{}5
– java.lang.Object:`t Java Ts
– java.lang.String:cr`v Unicode V{iIDV{.
– java.math.BigDecimal:xP{EDNb+H.xF}5#JCZuR;C5Db
M!vZM'zDuRoT73#
– java.math.BigInteger:Nb+H{}5#
– java.net.URL:3;J4(;w (URL) Ts#
– java.util.ArrayList:TsPm#
– java.util.Calendar:X(oT73DUZ1d5#
– java.util.Date:UZ1d5#(i;*9CK`M#kD*9C java.util.Calendar r
java.util.GregorianCalendar#
":*5VUZ,C'IT!q java.util.Calendar r java.util.GregorianCalendar#
24 /I#i
– java.util.GregorianCalendar:GregorianCalendar G java.util.Calendar D_eS`,
"a)@gOs?VXx9CDj<Uz53#
– MonthEnum:MonthEnum 6Y`M5#
– ProjectStateEnum:ProjectStateEnum 6Y`M5#
– QuarterEnum:QuarterEnum 6Y`M5#
– TaskStateEnum:TaskStateEnum 6Y`M5#
– WeekEnum:WeekEnum 6Y`M5#
tTD*}](gQ-kDT>{Mhv)IkCtT0d8Ts5}X*D#e(
e#tTa)K;Vr%xVI)9DzF,ICZT>XhMI!DTs5}t
T,gn?{F"zkM*<UZ#
6Y}]`M
ApprovalMethodEnumApprovalMethodEnum (eP'Dsz=(#I\D5P:
v SEQUENTIAL
v SIMULTANEOUS
ApprovalStateEnumApprovalStateEnum (eP'Dsz4,#I\D5P:
v CANCELLED
v COMPLETED
v IN_PROGRESS
v NOT_STATED
v ON_HOLD
AssetLibraryStateEnumAssetLibraryStateEnum (eP'DJzb4,#I\D5P:
v DISABLED
v ENABLED
AssetStateEnumAssetStateEnum (eP'DJz4,#I\D5P:
v ARCHIVE
v ]e
v FINALIZE
v LOCK
AttachmentTypeEnumAttachmentTypeEnum (eP'D=~`M#I\D5P:
v ASSET
v FILE
v URL
BudgetPeriodEnumBudgetPeriodEnum (eI\D$c\Z#I\D5P:
Z 4 B IBM Marketing Operations API 25
v ALL
v MONTHLY
v QUARTERLY
v WEEKLY
v YEARLY
BudgetTypeEnumBudgetTypeEnum (eP'D$c`M#I\D5P:
v ACTUAL
v ALLOCATED
v COMMITTED
v FORECAST
v TOTAL
ComponentTypeEnumComponentTypeEnum j6ICJD Marketing Operations i~`M#I\D5
P:
v APPROVAL
v ASSET
v ASSET_FOLDER
v ASSET_LIBRARY
v ATTACHMENT
v FINANCIAL_ACCOUNT
v GROUPING_FOLDER
v INVOICE
v MARKETING_OBJECT
v PLAN_TEAM
v PLAN_USER
v PROJECT
v PROJECT_REQUEST
v TASK
v
InvoiceStateEnumInvoiceStateEnum (eP'D"14,#I\D5P:
v CANCELLED
v ]e
v PAID
v PAYABLE
MonthEnumMonthEnum (eB]DP'5#
OfferStateEnumOfferStateEnum (eP'DL74,#I\D5P:
26 /I#i
v STATE_OFFER_DRAFT
v STATE_OFFER_PUBLISHED
v STATE_OFFER_RETIRED
ProjectCopyTypeEnumProjectCopyTypeEnum (eCZ4Fn?DP'=(#I\D5P:
v COPY_USING_PROJECT_METRICS
v COPY_USING_TEMMPLATE_METRICS
ProjectParticipantLevelEnumProjectParticipantLevelEnum j6C'Zn?PId1DG+#I\D5P:
v OWNER
v PARTICIPANT
v REQUESTER
ProjectStateEnumProjectStateEnum (eP'Dn?Mks4,#I\D5P:
v ACCEPTED
v CANCELLED
v COMPLETED
v ]e
v IN_PROGRESS
v IN_RECONCILIATION
v LATE:n?4ZdwH*<UZ.0t/#
v NOT_STARTED
v ON_HOLD
v OVERDUE:n?4ZdwHaxUZ.0jI#
v RETURNED
v SUBMITTED
PXn?MNq4,D|`E",kND6IBM Marketing Operations C'8
O7#
QuarterEnumQuarterEnum (e>HDP'5:Q1"Q2"Q3 M Q4#
TaskStateEnumTaskStateEnum (eP'D$wwLNq4,#I\D5P:
v ACTIVE
v DISABLED
v FINISHED
v PENDING
v SKIPPED
WeekEnumWeekEnum (e;jPDGZ,S WEEK_1 = WEEK_53#
Z 4 B IBM Marketing Operations API 27
28 /I#i
Z*5 IBM <u'VPD.0
g{zv=^((}iDD5bvDJb,G4s+>D8('V*5KIBg IBM <
u'VPD#kq-TB<r47#I&P'XbvzDJb#
g{z;Gs+>D8('V*5,kk IBM \m1*5TKb`XE"#
":<u'VPD;`4r4( API E>#*Z5V API z71q!oz,kk IBM
(5~qz9*5#
*U/DE"
*5 IBM <u'VPD0,kU/TBE":
v PXJbTJDrLhv#
v "zJb14=Dj8ms{"#
v XVCJbDj8=h#
v `XDU>D~"a0D~"dCD~M}]D~#
v PX z7M5373DE",I4“53E"”PyvqCKE"#
53E"
Bg IBM <u'VPD1,I\a*sza)PX5373DE"#
g{Jb;A-G<,G4IZ“XZ”3fOqCs?VK`E",C3fa)PX
y20D IBM &CLrDE"#
I(}!qoz > XZCJ“XZ”3f#g{^(CJ“XZ”3f,kli;Z&CL
rD20?<BD version.txt D~#
IBM <u'VPDD*5E"
PX*5 IBM <u'VPDD=(,kN{ IBM z7<u'VPDx>:(http://
www.ibm.com/support/entry/portal/open_service_request)#
":*dk;v'Vks,zXk9C IBM J'G<#KJ'Xk4S=zD IBM M
'E#*'0PX+zDJ'kIBM M'`EX*DE",ki4'VE'x>OD'
VJ4 > Z(Dm~'V#
© Copyright IBM Corp. 2002, 2014 29
30 /I#i
yw
>E"G*Z@za)Dz7M~qx`4D#
IBM I\Zd{zRrXx;a)>D5PV[Dz7"~qr&\XT#PXzyZ
xr10IqCDz7M~qDE",krz1XD IBM zmI/#NNT IBM z
7"Lrr~qD}C"GbZw>r5>;\9C IBM Dz7"Lrr~q#;*
;V8 IBM D*6z(,NN,H&\Dz7"Lrr~q,<ITzf IBM z7
"Lrr~q#+G,@@Mi$NNG IBM z7"Lrr~q,rIC'TP:p#
IBM I\Q5Pr}Zjkk>D5Z]PXDwn({#a)>D5";b6EZh
C'9Cb)({DNNmI#zITCifN=+mIi/Dy:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
PX+VZ (DBCS) E"DmI$i/,kkzyZzRrXxD IBM *6z(?E
*5,rCif==+i/Dy:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan
>un;JC"zrNNbyDunk1X(I;;BDzRrXx:International Busi-
ness Machines Corporation“4V4”a)>vfo,;=PNNV`D(^[Gw>D9
G5,D)#$,|(+;^Z5,DPXGV("JzMJCZ3VX(C>D#
$#3)zRrXxZ3);WP;Jmb}w>r5,D#$#rK>unI\;
JCZz#
>E"PI\|,<u=f;;<7DX=r!"ms#K&DE"+(Z|D;b
)|D+`k>JODBf>P#IBM ITf1T>vfoPhvDz7M/rLrxP
DxM/r|D,x;mP(*#
>E"PTNNG IBM Web >cD}C<;G*K=cp{Ea)D, ;TNN=
=d1TG) Web >cD#$#G) Web >cPDJO;G IBM z7JOD;?
V,9CG) Web >cx4DgU+IzTPP##
IBM IT4|O*J1DNN==9CrV"zya)DNNE"x^hTzP#NN
pN#
>LrD;mI=g{*KbPXLrDE"To=gB?D:(i) JmZ@"4(DL
rMd{Lr(|(>Lr).dxPE";;,T0 (ii) JmTQ-;;DE"xP
`%9C,kkBPX7*5:
© Copyright IBM Corp. 2002, 2014 31
IBM Corporation
170 Tracer Lane
Waltham, MA 02451
U.S.A.
;*qXJ1Du~Mun,|(3)iNBD;(}?D6Q,<IqCb=fD
E"#
>D5PhvDmILr0dyPICDmIJOyI IBM @] IBM M'-i"IBM
zJLrmI-irNN,H-iPDuna)#
K&|,DNNT\}]<GZ\X73PbCD#rK,Zd{Yw73PqCD
}]I\aPwTD;,#P)b?I\GZ*"6D53OxPD,rK;#$k
;cIC53OxPDb?a{`,#Kb,P)b?G(}Fcx@cD,5Ja
{I\aPnl#>D5DC'&1i$dX(73DJC}]#
f0G IBM z7DE"ISb)z7D)&L"dvf5wrd{I+*qCDJO
Pq!#IBM ;PTb)z7xPbT,2^(7OdT\D+7T"f]TrNNd
{XZG IBM z7Dyw#PXG IBM z7T\DJb&1rb)z7D)&La
v#
yPXZ IBM 44=rrbrDyw<If1d|rUX,x;mP(*,|Gvv
m>K?jMb8xQ#
T>DyP IBM [q<G IBM (iDnBc[[,If1|Dx;mP(*#-z
LD[qI\aPy;,#
>E"|,ZU#5qYwP9CD}]M(fD>}#*K!I\j{X5wb)
>},>}PI\a|(vK"+>"7FMz7D{F#yPb){V<Gi9
D,tV5znP5J5qs59CD{VMX7kK`F,?tIO#
f(mI:
>E"|(4oTN=Dy>&CLr,b)y>5w;,Yw=(OD`L=(#
g{G*4UZ`4y>LrDYw=(OD&CLr`LSZ(API)xP&CLr
D*""9C"-zrV"*?D,zITNNN=Tb)y>LrxP4F"^D
"V",x^hr IBM 6Q#b)>}"4ZyPu~Bw+fbT#rK,IBM ;
\##r5>b)LrDI?T"I,$Tr&\#y>Lr<G“4V4”a)D,
;=PNNV`D#$#TZr9Cy>Lrx}pDNNp&,IBM ;P#pN#
g{z}Tm=4q=i4>E",G4<,MJ+<}I\^(T>#
LjE"
IBM"IBM UjM ibm.com G International Business Machines Corp. Z+rm`\=
xrP"aDLjr"aLj#d{z7M~q{FI\G IBM rd{+>DLj#
Web O www.ibm.com/legal/copytrade.shtml &D“f(MLj”a)K IBM LjD10
Pm#
32 /I#i
~=_TM9Cun"bBn
IBM m~z7(|(w*~qbv=8Dm~,4“a)Dm~”)I\a9C cookie r
d{<u4U/z79CivE",TcDFnUC'ei"(FknUC'D;%
rCZd{C>#cookie G Web >cI"MA/@wD}],fsI+df"ZzD
FczOw*j6zDFczDjG#Zm`ivB,b) cookie ;aU/vKE"#
g{z*9CDm~z7Jmz(} cookie r`F<uU/vKE",RG+ZBff
*z_eiv#
y]Q?pDdC,Km~z7I\9Ca0MVCT cookie,|GU/wvC'DC
'{Md{vKE"TCZa0\m"v?C'ICTrd{9CzYr&\T?
D#IT{Cb) cookie,+{C|G2+9|Gy'VD&\^(9C#
;,\=xrT(} cookie M`M<uU/vKE"xP;,LHDf\#g{Km~
z7DQ?pdC*z(w*M')a)(} cookie Md{<uU/vKE"D\&,
G4z&1w/wsPXNNJCZK`}]U/(|(a)(*M,bDNN*
s,gJC)D(ID(I(i#
IBM *sM'K (1) a)w7"TxD8rM'D Web >c9Cun(dP|(8r
IBM MM'KD}]U/M9C5yD4S)D4S(g~=~_),(2) f*CJ_
IBM zmM'+ cookie M8w GIF/xgEjfEZCJ_DFczO"5wK`<u
D?D,"R (3) Z(IJmD6'Z,ZM'r IBM zmM'+ cookie M8w GIF/
xgEjfEZ Web >cCJ_Dh8O.0wC Web >cCJ_D,b#
PXgN9C|( cookie ZZDwV<u5Vb)?DD|`E",kND IBM“xO
~=yw”(http://www.ibm.com/privacy/details/us/en) PD“Cookie"Web Beacon Md{
<u”?V#
yw 33
����
Printed in China