IDoc step by step

创建IDOC:

第一步:WE31 创建IDOC所包含的字段.

第二步:WE30 创建IDOC 把Segment分配给IDOC

第三步:WE81 创建信息类型

第四步:WE82 把IDOC类型与信息类型对应.

第五步:WE57 Assign Message & Idoc Type to a Function Module for Data Process

第六步:SM59 Define a RFC connection for Idoc transfer

第七步：WE21 Define a Port ( Assign a RFC destination which created in SM59 )

第八步：WE41/42 Creat Process Code

第九步：WE20 Define a Partner Profiles( Also creat a Outbound parameters with Port, or Inbound parameters with Process code )

管理IDOC: WE02 显示IDOC,可以根据时间，IDOC类型查找IDOC，查看成功，出错信息。

                    WE46 IDOC管理(出/入)

                    WE60 IDOC类型文档 (可以查看IDOC结构,和每个字段的描述.

                   WE19 根据IDOC号进行IDOC处理，可以修改IDOC值进行补发动作，处理分为内向和外向。

消息配置： WE20 配置伙伴消息进和出IDOC类型

                      WE21 配置伙伴。

 

 

----------------------实例 ------------------------------------------------

Outbound Idoc-

简而言之，IDOC是类似XML的一种SAP系统与其他系统的一种集成工具。假设I04和I02是同一个集团下两个不同子公司的SAP系统，I04需要将其采购订单信息及时发送给I02。下面简单介绍IDOC的设置步骤，为了避免混淆，我的命名都比较特别。

 1，设置IDOC Type.

   (1) WE31，创建segment，类似于创建XML的结点及结点属性。这里先输入YPOHEAD，点击创建，在接下来的屏幕中，录入EBELN, BUKRS, BEDAT等字段及他们对应的data element；接着创建YPOITEM，输入EBELN, EBELP, MATNR, MENGE, MEINS等字段及他们对应的data element。保存后用SE12查看你将发现，系统自动添加了YPOHEAD和YPOITEM两个结构，每个字段都成了CHAR类型，长度就是WE31中的 EXPORT LENG。

   (2) WE30, 创建IDOC Type，定义结点间的相互逻辑关系. 先输入YPOIDOC，然后点击创建，紧跟着点击create new进入。在主界面中，先点击创建按钮，将YPOHEAD添加，设置Mandatory seg打勾，min ＝ 1， max ＝ 1，代表我们每个IDOC仅包含一张采购订单。然后在YPOHEAD下添加YPOITEM，同样的Mandatory seg打勾，min ＝ 1， max ＝ 99999.

 2，创建Message Type.

   (1) WE81，创建Message Type. 先切换到编辑状态，然后点击New Entries，输入YPO即可。

   (2) WE82,，关联Message Type和IDOC Type.

 3，创建到I02的端口. 首先确保系统内已经有到I02的R/3 Connection（SM59）,如果没有则先创建一个名为I02001。接着WE21创建Port，类型TRANSACTIONAL RFC，名为I02PORT，RFC destination则填写I02001。

4，SALE，创建Logical System. Define logical systems，新增一个logical system，名为I02LS，这将作为下一步的Partner。再定义一个本系统(I04)的一个logical system I04LS，在Define logical systems下方，有Assign Client to logical system，我对Client 001的定义是I04LS.

5，WE20，定义我们的Partner profile. 在PARTNER TYPE为logical system下，创建一个patner no为I02LS的partner，type填写LS。下面的Permitted agent，填写US(User)，Agent为你自己的用户名或某basis人员用户名。然后，点击outbound下方的加号，创建一个outbound parameter。Message Type为YPO，receiver port为I02PORT，output mode选择transfer idoc immed.，Basic Type填写YPOIDOC，保存即可。

6，编程发送IDOC 设置了这么多，真累啊，总算可以写程序了，是不是很开心呢？程序的思路就是，把每个IDOC结点按字符串形式逐个添加，而字符串的添加次序自然也体现了IDOC结点间的逻辑关系。代码如下：

DATA: ls_pohead TYPE ypohead,

 ls_poitem TYPE ypoitem,
 ls_edidc TYPE edidc,
 lt_edidc TYPE TABLE OF edidc,
 lt_edidd TYPE TABLE OF edidd WITH HEADER LINE.
CLEAR ls_edidc.
*系统根据下面4行即可与WE20设置关联起来
ls_edidc-mestyp = 'YPO'. "Message Type
ls_edidc-idoctp = 'YPOIDOC'. "IDOC Type
ls_edidc-rcvprn = 'I02LS'. "Partner Number of Recipient
ls_edidc-rcvprt = 'LS'. "Partner Type of Receiver
*添加IDOC结点
CLEAR lt_edidd.
lt_edidd-segnam = 'YPOHEAD'."结点名称
lt_edidd-dtint2 = 0.
CLEAR ls_pohead.
ls_pohead-ebeln = '4001122334'.
ls_pohead-bukrs = '0400'.
ls_pohead-bedat = '20090630'.
lt_edidd-sdata = ls_pohead. "结点内容
APPEND lt_edidd.
CLEAR lt_edidd.
lt_edidd-segnam = 'YPOITEM'.
lt_edidd-dtint2 = 0.
CLEAR ls_poitem.
ls_poitem-ebeln = '4001122334'.
ls_poitem-ebelp = '0001'.
ls_poitem-matnr = '000000000000004527'.
ls_poitem-menge = '3'.
ls_poitem-meins = 'ST'.
lt_edidd-sdata = ls_poitem.
APPEND lt_edidd.
CLEAR lt_edidd.
lt_edidd-segnam = 'YPOITEM'.
lt_edidd-dtint2 = 0.
CLEAR ls_poitem.
ls_poitem-ebeln = '4001122334'.
ls_poitem-ebelp = '0002'.
ls_poitem-matnr = '000000000000009289'.
ls_poitem-menge = '5'.
ls_poitem-meins = 'M'.
lt_edidd-sdata = ls_poitem.
APPEND lt_edidd.
CALL FUNCTION 'MASTER_IDOC_DISTRIBUTE'
  EXPORTING
    master_idoc_control            = ls_edidc "Export
  TABLES
    communication_idoc_control     = lt_edidc "Import
    master_idoc_data               = lt_edidd "Export
  EXCEPTIONS
    error_in_idoc_control          = 1
    error_writing_idoc_status      = 2
    error_in_idoc_data             = 3
    sending_logical_system_unknown = 4
    OTHERS                         = 5.
IF sy-subrc <> 0.
  MESSAGE ID sy-msgid TYPE sy-msgty NUMBER sy-msgno
    WITH sy-msgv1 sy-msgv2 sy-msgv3 sy-msgv4.
ELSE.
  COMMIT WORK.
  WRITE: 'Idoc sent:'.
  LOOP AT lt_edidc INTO ls_edidc.
    NEW-LINE.
    WRITE: 'Idoc number is', ls_edidc-docnum,
           '; receiver partner is', ls_edidc-rcvprn,
           '; sender partner',ls_edidc-sndprn.
  ENDLOOP.
ENDIF.

  7，查看IDOC. WE05可以查看我们刚刚发送的IDOC， BD87还可对IDOC进行一些处理。

 

 

----------------------实例 ------------------------------------------------

Inbound Idoc

1，创建IDOC Type和Message Type. 与上篇Outbound Idoc中的前两个步骤完全一样。

2，创建一个function：Y_IDOC_PO_PROCESS. 当IDOC设置完毕之后，SAP可以自动调用该Funtion Module处理IDOC。所以这个函数的接口都是规范的。

下面步骤中将介绍的tcode：BD51中可以查询到很多Inbound Function，比如IDOC_INPUT_BBP_IV，可参照创建我们的接口。接下来就可以写入我们的代码，根据IDOC内容，创建相应的销售订单。

为了简化，这里我们仅仅将其存到数据库表里面，请先创建两个表Y02_POHEAD和 Y02_POITEM，字段参考WE31中的YPOHEAD和YPOITEM。

然后写入下面代码：

DATA: lv_subrc LIKE sy-subrc,
      ls_chead TYPE ypohead,
      ls_citem TYPE ypoitem,
      ls_pohead TYPE y02_pohead,
      lt_poitem TYPE TABLE OF y02_poitem WITH HEADER LINE.
CLEAR idoc_contrl.
READ TABLE idoc_contrl INDEX 1.
IF idoc_contrl-mestyp <> 'YPO'.
  RAISE wrong_function_called.
ENDIF.
LOOP AT idoc_contrl.
  CLEAR: ls_pohead, lt_poitem[].
  LOOP AT idoc_data WHERE docnum = idoc_contrl-docnum.
    CASE idoc_data-segnam.
      WHEN 'YPOHEAD'.
        CLEAR: ls_chead, ls_pohead.
        ls_chead = idoc_data-sdata.
        MOVE-CORRESPONDING ls_chead TO ls_pohead.
      WHEN 'YPOITEM'.
        CLEAR: ls_citem, lt_poitem.
        ls_citem = idoc_data-sdata.
        MOVE-CORRESPONDING ls_citem TO lt_poitem.
        APPEND lt_poitem.
      WHEN OTHERS.
    ENDCASE.
  ENDLOOP.
  lv_subrc = 0.
  INSERT y02_pohead FROM ls_pohead.
  IF sy-subrc = 0.
    INSERT y02_poitem FROM TABLE lt_poitem.
    lv_subrc = sy-subrc.
  ELSE. "订单号已经存在
    lv_subrc = sy-subrc.
  ENDIF.
  IF lv_subrc = 0.
    COMMIT WORK.
    CLEAR idoc_status.
    idoc_status-docnum = idoc_contrl-docnum.
    idoc_status-status = '53'. "IDOC处理成功
    APPEND idoc_status.
  ELSE.
    ROLLBACK WORK.
    CLEAR idoc_status.
    idoc_status-docnum = idoc_contrl-docnum.
    idoc_status-status = '51'. "IDOC不成功
    idoc_status-msgty = 'E'. "错误信息
    idoc_status-msgid = 'YMSG'.
    idoc_status-msgno = '001'.
    APPEND idoc_status.
  ENDIF.
ENDLOOP.

3，在BD51中注册我们的Function Module. 在编辑状态下，点击New Entries，填入函数名Y_IDOC_PO_PROCESS，Input Type＝1即可。

4，在WE57中将Function Module与IDOC Type/Message Type关联点击New Entries，Function Module输入Y_IDOC_PO_PROCESS，其下的Type填写F；IDOC Type下的Basic Type填写YPOIDOC；Message Type填写YPO；Direction填写2(Inbound)。

5，WE42，创建Inbound Process Code. 注意该步骤必须在 BD51和WE57之后，否则将出现错误提示。创建新条目，Process Code输入YPC_PO，在Option ALE下选择Processing with ALE service，在Processing Type下选择function module。保存后，在随后的窗口中，输入Inbound Module为Y_IDOC_PO_PROCESS。

6，WE20，维护Partner Profiles. 首先确保SALE中已经维护好了对应于发送方的 Logical System，假设名称为I04LS。（WE05查看您的Inbound IDOC, 均可看到其Partner名称，这就是我们所需要的。）本步骤与上篇的WE20类似，不同的是，这里是维护从I04LS过来的 Inbound Parameters。 Message Type输入YPO，Process Type输入YPC_PO，然后选中"Trigger immediately"即可。

7，至此，我们的设置已经完毕。系统接收到从I04传来的IDOC后即会立刻处理。同时，各位针对上篇做过练习的朋友，系统中应该会遗留几个处于出错状态的IDOC吧？可以用BD87，在主界面上选中结点YPO后，点击Process按钮，一次性处理。处理前，顺便在SE37中打开 Y_IDOC_PO_PROCESS并设置几个断点即可调试。

补充：（1）如果状态码为56，则应该是您的WE20没设置好；

            （2）由于上面代码中控制了不能插入同样的采购单号，所以只有一个 Inbound IDOC将处理成功（状态码53），其余将失败（状态码51）。只要新发送的IDOC赋于不同的采购单号即可避免。

            （3）Outbound 的状态码是0－50，03代表OK；Inbound的状态码则是50－99，53代表OK。