20150506 Created By BaoXinjian

一、摘要

在将程序发布成SOA Integration接口时，需要在书写程序时，在描述中需通过规定的语法书写SOA接口，并发发布为WSDL

每种不同类型的程序，其对应语法稍不用

1. 语法可以参考Metalink：

Oracle E-Business Suite Integrated SOA Gateway Developer's Guide

Integration Repository Annotation Standards

2. 对应的程序类型

(1). Java Annotations

(2). PL/SQL Annotations

(3). Concurrent Program Annotations

(4). XML Gateway Annotations

(5). Business Event Annotations

(6). Business Entity Annotations

(7). Composite Service - BPEL Annotations

(8). Glossary of Annotations

3. 介绍常用的三种Java、PLSQL、Concurrent Program

二、PL/SQL Annotations标记

must begin with description sentence(s)
rep:scope
rep:product
rep:displayname
rep:category--Use BUSINESS_ENTITY at the class level only if all underlying methods have the same business entity. --In those cases, you do not need to repeat the annotation at the method level.
rep:businessevent (if an event is raised)

link
see
rep:lifecycle
rep:compatibility
rep:ihelp
rep:metalink
rep:doccd

must begin with description sentence(s)
param
--Use only when applicable and when other tags such as @see and @rep:metalink do not provide parameter explanations.
return (if applicable)
rep:displayname
rep:paraminfo
rep:businessevent (if an event is raised)

link
see
rep:scope
rep:lifecycle
rep:compatibility
rep:category
--Use BUSINESS_ENTITY at the method level only when a class methods have heterogeneous business entities.
rep:ihelp
rep:metalink
rep:doccd
rep:appscontext
rep:primaryinstance

create or replace package WF_ENGINE as
/*#* This is the public interface for the Workflow engine.  It allows* execution of various WF engine functions.* @rep:scope public* @rep:product WF* @rep:displayname Workflow Engine* @rep:lifecycle active* @rep:compatibility S* @rep:category BUSINESS_ENTITY WF_WORKFLOW_ENGINE*/
g_nid number;          -- current notification id
g_text varchar2(2000); -- text information
/*#* Adds Item Attribute* @param itemtype item type* @param itemkey item key* @param aname attribute name* @param text_value add text value to it if provided.* @param number_value add number value to it if provided.* @param date_value add date value to it if provided.* @rep:scope public* @rep:lifecycle active* @rep:displayname Add Item Attribute*/
procedure AddItemAttr(itemtype in varchar2,itemkey in varchar2,aname in varchar2,text_value   in varchar2 default null,number_value in number   default null,date_value   in date     default null);
END WF_ENGINE;
/commit;
exit;

must begin with description sentence(s)
--The annotation takes precedence over the concurrent program own definition in the LDT. One or the other must exist; otherwise, interface generation will fail.
rep:scope
rep:product
rep:displayname
--The annotation takes precedence over the concurrent program own definition in the LDT. One or the other must exist; otherwise, interface generation will fail.
rep:category
rep:businessevent (if an event is raised)

link
see
rep:lifecycle
rep:compatibility
rep:ihelp
rep:metalink
rep:doccd
rep:usestable
rep:usesmap

/*** Executes the Open Interface for Accounts Payable Invoices.  It uses the* following tables: AP_INVOICES_INTERFACE, AP_INVOICE_LINES_INTERFACE.* @rep:scope public* @rep:product AP* @rep:lifecycle active* @rep:category OPEN_INTERFACES AP_INVOICES_INTERFACE 1* @rep:usestable AP_INVOICES_INTERFACE 2 IN* @rep:usestable AP_INVOICE_LINES_INTERFACE 3 IN* @rep:category BUSINESS_ENTITY AP_INVOICE*/

must begin with description sentence(s)
rep:scope
rep:product
rep:implementation (only required for Java business service objects; not required for plain Java or SDOs)
rep:displayname
rep:service
rep:servicedoc

link
see
rep:lifecycle
rep:category
--Use BUSINESS_ENTITY at the class level only if all underlying methods have the same business entity. In those cases, you do not need to repeat the annotation at the method level.
rep:compatibility
rep:standard
rep:ihelp
rep:metalink
rep:doccd
rep:synchronicity

must begin with description sentence(s)
param
--Use only when applicable and when other tags such as @see and @rep:metalink do not provide parameter explanations.
return (if applicable)
rep:paraminfo
rep:displayname
rep:businessevent (if an event is raised)

link
see
rep:scope
rep:lifecycle
rep:compatibility
rep:category
--Use BUSINESS_ENTITY at the method level only when a class methods have heterogeneous business entities.
rep:ihelp
rep:metalink
rep:doccd
rep:appscontext
rep:synchronicity
rep:primaryinstance

/*===========================================================================+|      Copyright (c) 2004 Oracle Corporation, Redwood Shores, CA, USA       ||                         All rights reserved.                              |+===========================================================================+|  HISTORY                                                                  |+===========================================================================*/
package oracle.apps.po.tutorial;import oracle.jbo.domain.Number;import oracle.svc.data.DataObjectImpl;
import oracle.svc.data.DataList;/*** The Purchase Order Data Object holds the purchase order data including * nested data objects such as lines and shipments.* * @see oracle.apps.fnd.framework.toolbox.tutorial.PurchaseOrderLineSDO* * @rep:scope public* @rep:displayname Purchase Order Data Object* @rep:product PO* @rep:category BUSINESS_ENTITY PO_PURCHASE_ORDER* @rep:servicedoc */
public class PurchaseOrderSDO extends DataObjectImpl
{public PurchaseOrderSDO (){super();}/*** Returns the purchase order header id.*  * @return purchase order header id.*/public Number getHeaderId(){return (Number)getAttribute("HeaderId");}/*** Sets the purchase order header id.*  * @param value purchase order header id.* @rep:paraminfo {@rep:precision 5} {@rep:required}*/public void setHeaderId(Number value){setAttribute("HeaderId", value);}/*** Returns the purchase order name.*  * @return purchase order name.* @rep:paraminfo {rep:precision 80}*/public String getName(){return (String)getAttribute("Name");}/*** Sets the purchase order header name.*  * @param value purchase order header name.* @rep:paraminfo {@rep:precision 80}*/public void setName(String value){setAttribute("Name", value);}/*** Returns the purchase order description.*  * @return purchase order description.* @rep:paraminfo {rep:precision 120}*/public String getDescription(){return (String)getAttribute("Description");}/*** Sets the purchase order header description.*  * @param value purchase order header description.* @rep:paraminfo {@rep:precision 80}*/public void setDescription(String value){setAttribute("Description", value);}/*** @return the purchase order lines DataList.* @rep:paraminfo {@rep:innertype oracle.apps.fnd.framework.toolbox.tutorial.PurchaseOrderLineSDO}*/public DataList getLines(){return (DataList)getAttribute("Lines");}/*** @param list the putrchase order lines DataList.* @rep:paraminfo {@rep:innertype oracle.apps.fnd.framework.toolbox.tutorial.PurchaseOrderLineSDO}*/public void setLines(DataList list){setAttribute("Lines", list);}}