Help required in File Adapter Module Development

Hi All,
I am working out a File to File scenario where my source file is in some different format. Please find the below sample:
<Root>
<ID>100</ID>
<NAME>SAP</NAME>
<END-Root>
Before taking this into IS, I need to change the file to a proper XML format. I need to replace "END-" with "/".
<?xml version="1.0" encoding="UTF-8" >
<Root>
<ID>100</ID>
<NAME>SAP</NAME>
</Root>
I think I can achive this by developing Adapter Modules. I am new to Adapter Module development.
Can you please tell me if there are any inbuilt Adapter Modules for this. If not please suggest me some relevant blogs to solve this issue. Thanks in Advance.

Hi Phani Kumar
There are more than one ways to do this. As per your timelines and skill set you can decide
1. You can use the XMLAnonymizerBean this is an inbuilt module
Check Stefen's blog
Remove namespace prefix or change XML encoding with the XMLAnonymizerBean
2. You can read this complete file in a single field and then you can create XSLT or Java mapping to parse it in a target XML you desire.
Check these
https://www.sdn.sap.com/irj/sdn/weblogs?blog=/pub/wlg/3823 [original link is broken] [original link is broken] [original link is broken](XSLT mapping)
Java Mapping (Part I) (Java Mapping)
The specified item was not found. (Java Mapping helper DOM)
The specified item was not found. (XML Node into string)
3. You can develop Adapter modules for this
Refer
Check Guides
XI 3.0
https://www.sdn.sap.com/irj/sdn/go/portal/prtroot/docs/library/uuid/3bdc14e1-0901-0010-b5a9-a01e29d75a6a
PI 7.0
https://www.sdn.sap.com/irj/sdn/go/portal/prtroot/docs/library/uuid/f013e82c-e56e-2910-c3ae-c602a67b918e
PI 7.1
https://www.sdn.sap.com/irj/sdn/go/portal/prtroot/docs/library/uuid/00838345-708c-2a10-1199-9514c0b0a91c

Similar Messages

ModuleData.getPrincipalData returns null in the adapter module development

Hi gurus,
i am doing a test on the adapter module development following an article written by William Li:
http://www.sdn.sap.com/irj/scn/go/portal/prtroot/docs/library/uuid/f0ac06cf-6ee2-2c10-df98-e17430ca5949?QuickLink=index&overridelayout=true
my problem is after the EJB has been deployed, it seems that the return of inputModuleData.getPrincipalData() is always null which makes the program can not get the xml payload from the framework.
the main process of the example has been simplified like this:
     public ModuleData process(ModuleContext moduleContext, ModuleData inputModuleData) throws ModuleException {
          Object           obj = null;
          try {
          obj = inputModuleData.getPrincipalData();
          Message     msg1 = (Message) obj;
                XMLPayload xmlpayload = msg1.getDocument();}
          catch (Exception e) {
               ModuleException me = new ModuleException(e);
               throw me;
          return inputModuleData;
after deployed, i get the following error in the adapter monitor of RWB: (my JNDI is testtest)
17.02.2012 17:13:44.643 Information Send binary file "test8.xml" from FTP server "10.18.48.150:/encrypt_test/", size 206 bytes with QoS EO
17.02.2012 17:13:44.644 Information MP: processing local module localejbs/CallSapAdapter
17.02.2012 17:13:44.644 Information Application attempting to send an XI message asynchronously using connection File_http://sap.com/xi/XI/System
17.02.2012 17:13:44.645 Information Trying to put the message into the send queue
17.02.2012 17:13:44.648 Information MP: processing local module localejbs/testtest
17.02.2012 17:13:44.648 Error MP: exception caught with cause java.lang.NullPointerException: while trying to invoke the method com.sap.engine.interfaces.messaging.api.Message.getDocument() of an object loaded from local variable 'msg1'
whereas if the code has been changed like this:
     public ModuleData process(ModuleContext moduleContext, ModuleData inputModuleData) throws ModuleException {
          Object           obj = null;
          try {
               obj = inputModuleData.getPrincipalData();
               Message     msg1 = (Message) obj;
               if (obj != null )
                    XMLPayload xmlpayload = msg1.getDocument();
          catch (Exception e) {
               ModuleException me = new ModuleException(e);
               throw me;
          return inputModuleData;
the file can be read by the file adapter.
i just quite confused that why the return of the getPrincipalData() is null? where is the problem? thanks
Edited by: Stephen Xue on Feb 17, 2012 5:22 AM

I'm gonna reply to myself here. I changed the processing sequence of the adapter modules in the in the FileSender channel so that my module comes first then CallSapAdapter. Then getPrincipalData() contains the message.
Hope this helps someone else.

PI 7.1 Adapter Module Development - Identify SOAP Fault Message

Hi Experts,
here's a PI 7.1 Adapter Module Development issue I hope you can help me to resolve. It's about identifying SOAP fault messages.

Scenario at a glance:
Adapter Modules placed in the modules chain at request and response time in a synchronous Scenario:
- Request: SOAP Axis to RFC 
- Response and Fault Response: RFC to SOAP Axis

The issue is how to identify SOAP fault message in SOAP Axis Adapter Module in the response message:
The client gets SOAP fault messages like the follwong one:
 <SOAP:Body>
 <SOAP:Fault>
 <faultcode>SOAP:Server</faultcode>
 <faultstring>Server Error</faultstring>
 <detail>
 <ns1:exception xmlns:ns1="http://typen.geschaeftsstelle.pab.barmer.de">
 <ns1:errortext>bla bla bla ...</ns1:errortext>
 </ns1:exception>
 </detail>
 </SOAP:Fault>
 </SOAP:Body>


But when trying to access the tags faultcode and/or faultstring in the adapter module via xPath expressions I do not get them. Obviously the SOAP Fault tags are built AFTER the adapter module has been passed. So my question is:
How can I clearly/uniquely detect a SOAP fault response message (and distinguish it from a "normal" response message) in my SOAP Axis Adapter Module?

I tried it the following way:


// Check Message Payload for SOAP Fault Message via xPath expressions
...
// SOAP Fault Code
zv_xPression = zc_constXPattern.replaceFirst("&", "faultcode");
zv_soapFaultCode = XPathAPI.eval(zv_doc, (String) zv_xPression).toString();
// SOAP Fault String
zv_xPression = zc_constXPattern.replaceFirst("&", "faultstring");
zv_soapFaultString = XPathAPI.eval(zv_doc, (String) zv_xPression).toString();
// check for SOAP Fault Message
if (zv_soapFaultCode.equals("") && zv_soapFaultString.equals("")) {
 // Create Audit Log entry - NOT a SOAP Fault Message
 zv_msgText = zc_constModuleName + " 0190: xPath - OK! This message is NOT a SOAP Fault Message";
 zv_audit.addAuditLogEntry(zv_msgKey, AuditLogStatus.SUCCESS, zv_msgText);
 zv_faultCheck = false;
}
else {
 ...
 // Create Audit Log entry - SOAP Fault Message
 zv_msgText = zc_constModuleName 
 + " 0200: xPath - this message is a SOAP Fault Message. " 
 + " - Faultcode is: " + zv_soapFaultCode 
 + " - Faultstring is: " + zv_soapFaultString; 
 zv_audit.addAuditLogEntry(zv_msgKey, AuditLogStatus.ERROR, zv_msgText);
 ...
}
...

But zv_soapFaultCode and zv_soapFaultString are always empty (with other payload tags this coding works fine).

Any ideas? 
Thanx very much in advance!
Regards,
Volker

Hi Alex!
Like already mentioned I solved my problem by identifying the SOAP exception with the messageClass attribute of the PI message header. Acess code:
try {
String zv_msgClass = zv_piMsg.getMessageClass().toString();
} catch (Exception e) {
zv_msgText = zc_constModuleName
+ " E0110: Message processing terminated."
+ " Reason: Error while getting MessageClass "
+ zv_dataSource
+ e;
// create trace and audit log entry (severity ERROR) for exception
zv_location.errorT(ZV_SIGNATURE, zv_msgText);
zv_audit.addAuditLogEntry(zv_msgKey, AuditLogStatus.ERROR, zv_msgText);
ModuleException me = new ModuleException(e);
zv_location.throwing(ZV_SIGNATURE, me);
e.printStackTrace();
throw me;
} // end of try-catch-block
But I do not think this will solve your problem. I am almost sure, that something in your Axis configuration is wrong/missing. If a handler cannot be instatiated then it really may be missing. Have a look at defaultTrace.trc. Maybe you will find more suitable information about the root cause of your problem. Also have a look at NWA under software components and/or application modules if you can find/see your modules.
But there is a general issue when trying to catch PI fault messages. If e.g. the requestor tries to login with wrong userid/pasword, then you will have no chance to catch this kind of error - at least as far as I know. Because in this very early stage of PI message processing no module is called.
One last question: Did you develop your own Adapter or just an adapter module? In the first case: Is your adapter started and healthy? Have a look at RWB -> communication channel monitoring.
Regards,
Volker

Dynamic configuration required in sender file - Adapter Module

Hi Everybody,
I am developing an Adapter Module in the file adapter (sender) using Adapter Specific Message Attributes.
I am using Dynamic configuration inside the Module Process method in the adapter module.
We are getting an error saying Dynamic Configuration cannot be resolved.
Can anybody tell me the package to be used.
Thanks,
Zabiulla

You can access the dynamic configuration in adapter module like this:
Message msg = (Message) inputModuleData.getPrincipalData();
String fileName = msg.getMessageProperty("http://sap.com/xi/XI/System/File", "FileName");
You do not need any addition library besides the adapter module API.
Hope that helps
Stefan

File Adapter Module - Help

Hi
For a file adapter I had enabled the option Archieve File in my communication channel. So the system will put the file in the archieve folder after it is read. My requirement is to check if the file already exits in the archieve folder or not. Any means of checking it? or shud i make use of adapter modules? If yes kindly point some helpful tips on the same.
Kindly fwd any useful doc to [email protected]
regds
prabhu

Prabhu,
The os command in the file adapter should exists in the XI server only.
Whatever command you provide in the Adapter will result in the SID+"ADM" user id exectuing this command at the oS level of your XI server.
So this script should exist on the XI server.
Now, if the archive directory is on the FTP server you will have to connect to the FTP server from the script and check if the file exists and then do the needful.
Check this blog out for executing Scripts on file adapters,
/people/sameer.shadab/blog/2005/09/21/executing-unix-shell-script-using-operating-system-command-in-xi
Regards
Bhavesh

My client requirements in File Adapter

Can any one guide me for the following requirements.
Case Studies - 1
Assume that you are in a class room and there are 10 students in it. The instructor then asks each student to prepare his/her the following personal details and save them in an XML file. The details are as follows:
Student ID
Name
Mobile
Email
Gender
There will be 10 files and the files are named as cv_1,2,3….10. The files are saved into the source directory. For test purposes following directories are created:
Source directory: c:\ibm\sap\training\input
Archive directory: c:\ibm\sap\training\archive
Error directory: c:\ibm\sap\training\error
Target directory: c:\ibm\sap\training\target
You are asked to develop scenarios in SAP PI which will read the source files from the source directory and write them to the target directory. Once a file is successfully read from the source directory, it should be moved to the archive directory and if the file cannot be read for some error i.e. xml format not maintained, it should be moved to the error directory. The files moved to archive, error or target directory should have a time-stamp append to the file-name.
i.e. filename+<time-stamp>.
Lesson-1
Prepare a scenario to read one single file i.e. file cv_1.xml from the source directory and write it to the target directory. The target file name should also be cv_1.xml with the time-stamp append to the name.
Lesson-2
Prepare a scenario to read all the files from the source directory and write them to the target directory. Similarly the target files should also be named as cv_1, 2 ..xml with the time-stamp append to each of them.
Lesson-3
The instructor then asks you all to add the following validation to the data.
The mobile-number should have 10 numeric digits – if the mobile number is not of 10 digit then replace it with ‘error’
The email should have one ‘@’ character and one ‘.’ character – if the email is not having the ‘@’ or ‘.’ character, then replace it with ‘error’
Before you run the scenario, in some of the source files, modify the mobile and the email so that they are in error as per the logic given above.
Lesson-4
Prepare a scenario to read all the source files and classify them according to their gender. The files for the men will be written in one directory and for the ladies to another directory. Two directories are created for the above purpose:
Target directory for men: c:\ibm\sap\training\target\men
Target directory for women: c:\ibm\sap\training\target\women
Suppose there are 6 men and 4 women in the class, then if all the source files are read successfully then the target directory for men should have 6 files and the target directory for women should have 4 files.
Case Studies - 2
The instructor then asks you all to prepare one single file with the personal details of each student in separate segments.
Lesson-5
Write a scenario which will read this file and produces 10 target files where each file should correspond to the personal data of each employee. The target files should be named as cv_<emp_ID>_<timestamp>
Lesson-6
Modify the above scenario so that it produces 2 target files instead of 10 where one target file for men and another target file for the ladies. The target file for men should have 6 segments for 6 men and the target file for ladies should have 4 segments for 4 women.
The target files should be named as
For men – men_<time-stamp>
For Ladies – women_<time_stamp>
Case Study -3
Same as case study – 1, the instructor ask each student to prepare his/her the personal details and save them in an XML file. There will be 10 files. The files are saved in the source directory.
Lesson-7
Prepare a scenario to read all the source files from the source directory and to create one single file in the target directory. The name of the target file will be output.xml with the time stamp append to the file-name. The target file will have all the details of each source file as sub-segment.
Lesson-8
Prepare a scenario to read the entire source files from the source directory and create two files in the target directory – one for the men and the other for the ladies. For 6 men, the men file should have six segments having each man’s details and for 4 women, similarly there should be 4 segments with each lady’s details.
Case Study - 4
The instructor now asks each of the students to prepare another set of details which will consist of his/her the following academic details:
Student ID
School Name
College Name
Department Name
Admission Year
There will be 10 files and the files are named as ad_1, 2, 3….10. The files are saved into the source directory. So each student will now have a pair of files – one for the personal details and the other for the academic details. Two files are co-related with the Student ID. The input directory now consists of 10 personal files and 10 academic files.
Lesson - 9
You are asked to develop a scenario which will pick the source files and will process them in pair. The scenario will generate 10 target files. Each target file will consist of the personal and academic details of a student in separate segments. The target files will be named as res_1, 2, 10.
The target files will look like:
Lesson – 10
You are then asked to change the student ID in some of the files so that they do not have a matching academic or personal files and vice-versa. The scenario should run and if it found any files who does not have a matching corresponding file then the process should end after some period of time i.e. 2 min and those files will be moved to the error directory and there will be no corresponding target files for them.

Hi
These are the exercise mentioned in the blog
http://scn.sap.com/docs/DOC-41766
In SCN , you will find many blogs on file adapter. Go through them, you will be able to do it by yourself.
If you stuck somewhere, then post the problem, we will be happy to help you.

How to send input parameters to a file adapter module

Hi all,
i have a requirement like , i need to pick a file from a file server based on a condition. that condition we write in adapter module (in file sender channel).
the condition needs some input , so how can we send input parameters to adapter module.
please suggest me some way,
thanks in advance
jhansi

hi jhansi,
u define the parameters to send to a module in 'module configuration' (in module tab) by giving the key to identify the module for which u r giving giving the parameters.
for details refer this:
Adapter module
https://www.sdn.sap.com/irj/servlet/prt/portal/prtroot/docs/library/uuid/02706f11-0d01-0010-e5ae-ac25e74c4c81
This is all u have to do
http://help.sap.com/saphelp_nw04/helpdata/en/8b/895e407aa4c44ce10000000a1550b0/content.htm
[reward if helpful]
regards,
latika.

File adapter module

Hello experts,
1.
I want to retrieve the value of Target directory for a file reciever communication channel inside module. Is it possible? Any code samples?
2. My audit logs are not getting printed inspite of having a log-configuration.xml in place and proper audit log statements in the code? anybody face similar situations before? These statements are inside a reciever file adapter module.
Amol

Hi Kapil,
file.targetFileName
In General put the following piece of code in sender or receiver adapter and u can get all the parameters specific to that Adapter Type in channel(Configuration) for outbound and inbound channel depending on direction of channel in which module is configured.
String[] chattr=ch.getAttributeNames();// ch is channel object
If u put this in receiver module of file adapter, the string array will hold the names of all the parameters pertaining to Receiver File Adapter(file.targetFileName,file.targetDir,etc). Same procedure holds good for sender channel.
Once u get the parameter name, u can get the value as given by my earlier post in this thread.
Hope this helps.
Regards,
Sudharshan

File Adapter-Module configuration

Hi All,
I have the following requiremnt.
"Duplicate files should not process"
Following are the File Access Parameters.
Source Directory: ABC (ex: contains aa1,aa2,aa3,aa4 files)
Filename: *
File name mask: aa*
My doubt is if they place aa1 file again in ftp , i should not process.
For this I'm thinking to write module configuration.
Can any one suggests , whether this is the correct approach? If it is could u explain how to write this module and where to write this module and how to import in xI, do i need to pass any parameter name in module configuration.
Regards,
venu.

Hi Venu,
You can go with Module in the Sender File Adapter.
First you need to check the file name and you need to store this file name in the Database.( you can use Java Database).
If there is an entry in the database for that file, then reject the whole file as per the business requirement. So that you can avoid , overhead of Mapping. Because if there is an error set the flag in the message and check this flag in your Receiver Determination, if it is an error send into error directory.
Another way is outside the XI, i.e using shell scripts.
Regards,
Moorthy

File adapter module enhancement error

Hello All,
We have a EDI scenario where data for 110 is to be transfered to SAP. Here customer is not able to ahead with seeburger hence decided to develope a adapter module. We have done that and started testing . While testing we are getting a error, in which ":" is field separator which is getting converted to "[]" . This we found when we debugged module process method. Pl can you suggest why this conversion is happening and how to resolve.
If you see , When I use only standared sap module file is getting read as it is. There is no such conversion happening.
Pl can you suggest at the earliest possible.
thanks,
Sharada

Hi,
I think you have done a typo error. is it not
localejbs/SeeClassifier classifier*
To find the correct JNDI lookup name, log in to Visual Administrator of the J2EE Engine and in server node look for the JNDI Registry Service.Spot your desired bean and fetch the whole JNDI name form there.
Regards,
Sudharshan N A

File adapter modules : Access to file data before content conversion

I have a file sender channel for which content conversion in applied. The incoming file has data in comma separated values format.
e.g.
102366,Amol Joshi,DEPT1
107752,XYZ PQR,DEPT2
I want to access the the actual data in the file before content conversion takes place. Is it possible to access this data inside the adaper module? I tried creating an adapter module and put it before CallSAPAdapter,it still gets the XML after content conversion as the input data to the module.
Any pointers?

Hi Amol,
I dont know if it is the right approach.
But if u r not able to meet ur requirement u can do one work around.
Use Message Transformation Bean to convert it once again in to CSV (flat file structure) and then proceed with ur module.
There should be a better way than this.
Hope we could find a better solution in the forum.
Regards,
Sudharshan

Adapter Module Development Hashtable entries

Hi I am developing an adapter module, I need to capture the SourceDirectory and Source file Timestamp, I am not able to capture the directory and file time stamp. Is there any way we can Print out the Hashtable entries into the audit log ???
I am using the below code
String fileName = (String) mp.get("FileName");
String Directory = (String) mp.get("SourceDirectory");
String SourceFileTimestamp = (String) mp.get("SourceFileTimestamp");

Hi,
>>>String fileName = (String) mp.get("FileName");
>>>String Directory = (String) mp.get("SourceDirectory");
>>>String SourceFileTimestamp = (String) mp.get("SourceFileTimestamp");
this approach works only for filename where did you read that it will work
for SourceDirectory or anything else?
you need to use adapter specific message arrtibutes to get that inside
an adapter module
that's the only way and it works for sure
Regards,
Michal Krawczyk

Typical Requirement in File Adapter

Hi All,
My scenario is File to Proxy.
Now scenario to pick up the File (at sender) is like this:
There is a file pick up from FTP Server daily. We will have two files on FTP server.First file is a blank file , which we call a FLAG File. Second file is DATA File containing required data to update in SAP.
Its a conditional File pick up:
1. If FLAG File (Blank) is present on FTP Server then pick up the data file and delete Flag File.
else
2.If FLAG File is not present on FTP server, dont pick up the DATA File and stop Processing.
Please suggest some good solution to achieve the same using File Adapter.
Also suggest, if same can be customised through Run Operating System before\after message processing.
Please help.Its Urgent..
Thanks,
Anurag

Suggestion 1: You need a BPM for this. Poll for the flag file and if present it gets into BPM. Inside the BPM check the content of the file. Remember only with latest SP you get the option to generate a message for an empty file. Use a conditional branch and proceed with the rest of the processing. You can use a dummy correlation.
Suggestion 2: Use scripts and schedule this at OS level (independent of XI). In the script file do the vaildation of checking the flag file and if the validation is ucess move the data file to the foolder FIle adapter keeps polling.
Regards,
Jaishankar

FileName in Sender File Adapter Module

Hi Folks,
In my sender file adapter have written a module to read the picked file name. The protocol used is NFS.
Notice that the file name read in the module has the absolute path, including the directory path. E.g The file name xyz has to be picked from source directory
XIServer\Outbound. In the module when I retrieve the file name, it comes up as
XIServer\Outbound\xyz. Is this expected behaviour?
I was expecting just the file name<xyz> to be retrieved.
Thanks,
Anand

HI,
Create an UDF and write this code.
DynamicConfiguration conf = (DynamicConfiguration) container.getTransformationParameters().get(StreamTransformationConstants.DYNAMIC_CONFIGURATION);
DynamicConfigurationKey key =
DynamicConfigurationKey.create("http://sap.com/xi/XI/System/File","FileName");
String ourSourceFileName = conf.get(key);
return ourSourceFileName;
in Adapter u will have Adapter specific parameters check the file name check box.
Using this UDF u will get the file name at target side.
Regards,
Phani.

Need Help-SOA 11g File Adapter unable to delete input file and its crashing

Hi All
Please find the details below:
1. We have created a simple SOA composite to Read file from an input directory, archive the file in an archive directory using Inbound File Adapter Read
and then use Outbound File Adapter Write to move the file to a output directory.
2. File Adapter needs to delete the file after successful read/retrieval.
3. We are using the "Use Trigger File" for invoking the file adapter. This is a new feature in SOA 11g
4. Also we are using the option of reading the file as an attachment as we are not doing any transformation in the composite
Issue Details_
1. When the trigger file is put in the input directory for the first time, the File Adapter reads the file, archives it and moves it to the output directory
2. However it does not delete the input file from the input directory and raises Fatal Exception mentioned below:
[*2011-01-12T16:55:48.639+05:30] [soa_server1] [WARNING] [] [oracle.soa.adapter] [tid: weblogic.work.j2ee.J2EEWorkManager$WorkWithListener@19c243d]*
[userId: <anonymous>] [ecid: 0000IptyLrL9_aY5TrL6ic1DBOS_000009,0] [APP: soa-infra] File Adapter FileAdapterTriggerFilePOC PostProcessor::
Delete failed, the operation will be retried for max of [0] times
[2011-01-12T16:55:48.639+05:30] [soa_server1] [WARNING] [] [oracle.soa.adapter] [tid: weblogic.work.j2ee.J2EEWorkManager$WorkWithListener@19c243d]
[userId: <anonymous>] [ecid: 0000IptyLrL9_aY5TrL6ic1DBOS_000009,0] [APP: soa-infra] File Adapter FileAdapterTriggerFilePOC [[
BINDING.JCA-11042
File deletion failed.
File deletion failed.
File : C:\Dibya\AttachmentTest\InputDir\TestFile3.txt could not be deleted.
Delete the file and restart server. Contact oracle support if error is not fixable.
If any one has faced similar issues, kindly provide pointers on how to resolve it.
Regards,
Dibya

Hi,
Using the file adapter, you can poll from multilple locations...
Keep the following property in your .jca file
<property name="DirectorySeparator" value="," />
While giving the path in File Adapter configuration, keep comma and give the next location....then the file will be picked up from the locations you gave....
Hope this helps...
Thanks,
N

Help required in File Adapter Module Development

Similar Messages

Maybe you are looking for