File_And_Ftp_Adapters_Oracle_SOA_OSB.pptx

Spa file and ftp adapter details

1. FILE & FTP Adapters in SOA

2. What does the File and FTP adapter do? The Oracle File and FTP Adapters enable a BPEL process or a Mediator to exchange files on local file systems and remote file systems. File and FTP adapters are found in the Components palette in SOA application

3. To use the File / FTP adapter we need to drag the corresponding adapter from the component window to either Exposed Services or in the External References. The Oracle File and FTP Adapters can read and write the following file formats and use the adapter translator component at runtime: XML (both XSD- and DTD-based) Delimited Fixed positional Binary data COBOL Copybook data

4. Difference between File and FTP adapter

5. File Adapter:   After dragging and dropping the file adapter to partner link, it will start the wizard. Give any name to your file adapter. This name will be displayed for your File adapter in the partner link.

6.  After specifying the name for your File adapter, you are given two options Define from operation and Schema Import an existing WSDL For Define from operation and schema you can skip naming the operation as of now and giv e the name later

7.  If you select the Import an existing WSDL option, then the three options are available to fill. We need to provide a WSDL file as shown in the image from our local machine The port Type is automatically feed with respect to the wsdl file which is uploaded Select the operation name from the dropdown menu

8. JNDI: In the JNDI name field enter the JNDI name that you want to use to obtain the new connection instance Different JNDI name can be selected by clicking on the magnifying glass besides the File Server JNDI Name

9. FTP Adapter:  After dragging and dropping the ftp adapter to partner link, it will start the wizard. Give any name to your ftp adapter. This name will be displayed for your Ftp adapter in the partner link.

10.  After specifying the name for your FTP adapter, you are given two options Define from operation and Schema Import an existing WSDL For Define from operation and schema you can skip naming the operation as of now and giv e the name later

11.  If you select the Import an existing WSDL option, then the three options are available to fill. We need to provide a WSDL file as shown in the image from our local machine The port Type is automatically feed with respect to the wsdl file which is uploaded Select the operation name from the dropdown menu

12. JNDI: In the JNDI name field enter the JNDI name that you want to use to obtain the new connection instance Different JNDI name can be selected by clicking on the magnifying glass besides the FTP Server JNDI Name

13. The FTP adapter supports five operations Get File, Put File, Synchronous Get File, List Files, Chunked Get File Only one operation can be performed per adapter "ASCII" mode is appropriate when using FTP to send a single text file between two PCs. “Binary" mode is appropriate when sending anything else: TAR files, compressed files, gzip'd files, CA-Alexandria binaries, etc. Give a meaningful name to your operation.

14. If you select the Get File then you are reflected for 3 inputs: Do not read file content : Ignores the content of the file and just publishes the headers of the file. Use file streaming : used when the files are expected to be large. Read file as an attachment : file is read as an attachment and it does not undergo transformation or translation. Character set, Encoding and content type is available only if we select Read file as an attachment.

15. You can specify inbound directory names as physical or logical paths in the composite eg : C:\Weblogic  You can choose to process files recursively within directories. You can also specify multiple directories. If the process file recursively is checked then files in the specific directory will be processed recursively.

16. Archive processed files enables you to specify a directory in which to place successfully processed files. You can also specify the archive directory as a logical name. Delete Files after successful retrieval enables you to specify whether to delete files after a successful retrieval. If this check box is not selected, processed files remain in the inbound directory but are ignored

17.  Two naming conventions are available for selection. File wildcards ( po*.txt ) Retrieves all files that start with  po  and end with  .txt . This convention conforms to Windows operating system standards. Regular expressions ( po.*\.txt ) Retrieves all files that start with  po  and end with  .txt

18. If you use regular expressions, the values you specify in the Include Files and Exclude Files fields must conform to JDK regular expression (regex) constructs. For both fields, different regex patterns must be provided separately. The Include Files and Exclude Files fields correspond to the  IncludeFiles  and  ExcludeFiles  parameters, respectively, of the inbound  WSDL  file.

19. The frequency with which to poll the inbound directory for new files to retrieve is called Polling Frequency The minimum file age of files to retrieve is determined here. The age is determined by the last modified time stamp. Polling in inbound starts as soon as the endpoint is activated. To gain more control over polling we use trigger file

20. File System enables you to obtain the date/time format of the file modification time with the file system listing command. INCOMPETE

21. This page enables you to select the XSD schema file for translation If native format translation is not required (for example, a JPG or GIF image is being processed), then select the  Native format translation is not required  check box. The file is passed through in base-64 encoding.

22. Successfully completed the Read File/ Get File operation. Click finish to create the Read File FTP adapter

23. When you select the PUT_FILE operation you have to give a meaningful name for the operation. When you select this check box, the adapter WSDL has an output message pointing to a header schema, shown by the bold highlight.

24. Select a output directory for your file. It can be either Physical path or Logical path Provide a file name (%SEQ% provides a sequential numbering for your output file) By clicking the append to existing file appends the same file continuously after every test successfully completed. Number of Messages Equals Specify a value which, when equalled, causes a new outgoing file to be created. Time elapsed and size exceeds causes a new outgoing after a particular amount of time or size of file

25. This page enables you to select the XSD schema file for translation If native format translation is not required (for example, a JPG or GIF image is being processed), then select the  Native format translation is not required  check box. The file is passed through in base-64 encoding.

26. Successfully completed the Write File/ Put File operation. Click finish to create the Write File FTP adapter

27. When you select the Synchronous Get FILE operation you have to give a meaningful name for the operation. Read file as an attachment : file is read as an attachment and it does not undergo transformation or translation. Character set, Encoding and content type is available only if we select Read file as an attachment.

28. You can specify inbound directory names as physical or logical paths in the composite eg : C:\Weblogic  You can choose to process files recursively within directories. You can also specify multiple directories. Archive processed files enables you to specify a directory in which to place successfully processed files. You can also specify the archive directory as a logical name.

29. Enter the name of the File that you want to read in File Name Section

30. This page enables you to select the XSD schema file for translation If native format translation is not required (for example, a JPG or GIF image is being processed), then select the  Native format translation is not required  check box. The file is passed through in base-64 encoding.

31. Successfully completed the Synchronous Get File operation. Click finish to create the Synchronous Get FTP adapter

32. List files operations lists all the files from a specified ftp Location. Specify meaningful Operation Name for Listing the files Click on Next

33. You can specify inbound directory names as physical or logical paths in the composite eg : C:\Weblogic  You can choose to process files recursively within directories. You can also specify multiple directories. If the process file recursively is checked then files in the specific directory will be processed recursively. Click on Next

34. Two naming conventions are available for selection. File wildcards ( po*.txt ) Retrieves all files that start with  po  and end with  .txt . This convention conforms to Windows operating system standards. Regular expressions ( po.*\.txt ) Retrieves all files that start with  po  and end with  .txt

35. If you use regular expressions, the values you specify in the Include Files and Exclude Files fields must conform to JDK regular expression (regex) constructs. For both fields, different regex patterns must be provided separately. The Include Files and Exclude Files fields correspond to the  IncludeFiles  and  ExcludeFiles  parameters, respectively, of the inbound  WSDL  file.

36. Successfully completed the Listing Files from the specified Location operation. Click finish to create the Listing Files FTP adapter

37. Chunked Get Files is used when a Large sized file is to be read so it is divided into chunks of data. Chunked Read is an Oracle File Adapter feature that uses an invoke activity within a while loop to process the target file. The division of the large file into equal small chunks is decided by the Chunk Size.

38. You can specify inbound directory names as physical or logical paths in the composite eg : C:\Weblogic  You can choose to process files recursively within directories. You can also specify multiple directories. Archive processed files enables you to specify a directory in which to place successfully processed files. You can also specify the archive directory as a logical name.

39. Enter the name of the File that you want to read in File Name Section

40. This page enables you to select the XSD schema file for translation If native format translation is not required (for example, a JPG or GIF image is being processed), then select the  Native format translation is not required  check box. The file is passed through in base-64 encoding.

41. Successfully completed the Chunked Get File operation. Click finish to create the Chunked Get FTP adapter