Recovering from Business Event Faults

33-10 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite Table 33–5 Oracle File Adapter Properties Service, Reference, or Endpoint Property Name Description Service PhysicalDirectory Specifies the physical directory for the fileFTP adapter. Service UseHeaders Set to true if the fileFTP adapter must publish metadata for example, the file name, directory name, last modified data, file size, and to exclude the payload. This is typically used in large payload scenarios where you want to use the inbound adapter as a notifier. Service Recursive If set to true, the fileFTP adapter processes files recursively in subdirectories. Service PhysicalArchiveDirectory Directory in which the inbound fileFTP adapter archives files after they have been processed successfully. Service PhysicalErrorArchiveDirecto ry Indicates the directory where the inbound fileFTP adapter archives files in case of failures, such as translation errors, and errors during publishing. Service DeleteFile If set to true, the fileFTP adapter deletes the file after it has been processed. Service IncludeFiles Indicates the regex pattern against which the file names are matched. If the name of a certain file matches this pattern, it is processed by the fileFTP adapter. Service ExcludeFiles Indicates the regex pattern against which the file names are matched. If the name of a certain file matches this pattern, it is excluded and not processed by the fileFTP adapter. Service PollingFrequency This parameter specifies how often does the fileFTP adapter looks for files in the inbound directory. It is specified in seconds. Service MinimumAge This parameter specifies the time interval after which to pick up a file for processing. For example, this enables a large file to be completely copied into the directory before it is retrieved for processing. The age is determined by the last modified time stamp. For example, if you know that it takes three to four minutes for a file to be written, set the minimum age of pollable files to five minutes. If a file is detected in the input directory and its modification time is less than 5 minutes older than the current time, the file is not retrieved because it is still potentially being written to. Service PublishSize This parameter indicates that a file contains multiple messages and specifies how many messages to process simultaneously. For example, if a certain file has 11 records and this parameter is set to 2, then the file is processed 2 records at a time and the final record is processed in the sixth iteration. Configuring Service and Reference Binding Components 33-11 Service Lenient If set to true, then the file adapter does not complain if it does not have enough permission to readwrite to the inbound directory. By default, this is set to false. Service TriggerFilePhysicalDirector y The directory path where the fileFTP adapter looks for the trigger files. Service TriggerFile The name of the trigger file that causes the inbound fileFTP adapter to be activated. Service TriggerFileStrategy This parameter defines the strategy that the fileFTP adapter uses to look for the specified trigger file in the trigger file directory. The acceptable values are EndpointActivation, EveryTime, or OnceOnly. Service MaxRaiseSize This parameter specifies the maximum number of files that the fileFTP adapter submits for processing in each polling cycle. For example, if the inbound directory has 1000 files and this parameter is set to 100 and the polling frequency is one minute, then the fileFTP adapter submits 100 files every minute. Service DirectorySeparator When you choose multiple directories, the generated JCA files use \;\ as the separator for these directories. If you want, you can change the separator. If you do change it, manually add DirectorySeparator=\chosen separator\ in the generated JCA file. For example, to use a comma , as the separator, you must first change the separator to \,\ in the physical directory and then add DirectorySeparator=\,\ in the JCA file. Service AsAttachment If set to true, it causes the inbound file to be published as an attachment. Service CharacterSet Set it to the character set for the attachment. This parameter is not used internally by the fileFTP adapter and is meant for third party applications that process the attachments published by the fileFTP adapter. Service Encoding Set it to the encoding for the attachment. This parameter is not used internally by the fileFTP adapter and is meant for third party applications that process the attachments published by the fileFTP adapter. Service ContentType Set it to the Mime-Type for the attachment. This parameter is not used internally by the fileFTP adapter and is meant for third party applications that process the attachments published by the fileFTP adapter. Table 33–5 Cont. Oracle File Adapter Properties Service, Reference, or Endpoint Property Name Description 33-12 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite Service ListSorter Specifies the sorter that the fileFTP adapter uses to sort files in the inbound direction. You can set this parameter to \oracle.tip.adapter.file.inbound.lis ting.TimestampSorterAscending\ or \oracle.tip.adapter.file.inbound.lis ting.TimestampSorterDescending\. You can also plug in your own sorter by writing a class that implements \java.util.Comparator\. Service SingleThreadModel If the value is true, the fileFTP adapter poller processes files in the same thread; it does not use the global in-memory queue for processing. Service ThreadCount If this parameter is available, the adapter creates its own processor threads rather than depending on the global thread pool processor threads by default, four of them. This parameter partitions the in-memory queue and each composite application gets its own in-memory queue. If the ThreadCount is set to \0\, then it behaves in the same manner as the single thread model. If ThreadCount is set to \-1\, then it starts using the global thread pool. The maximum value for this property is 40. Service recoveryInterval Used by the inbound adapter to configure the recovery interval in case of errors. For example, if the physical directory is nonexistent, then the adapter uses this value to perform periodic sleepwake ups to check if the physical directory has been created and is accessible. Reference PhysicalDirectory Specifies the physical directory for the fileFTP adapter. Reference NumberMessages Specifies the outbound file naming convention used. Reference ElapsedTime This parameter is used for outbound batching. When the time specified elapses, the outgoing file is created. The parameter is of type String and is not mandatory. The default value is 1. Reference FileSize Indicates if an opaque schema is being used. Reference FileNamingConvention This parameter is for the naming convention for the outbound write operation file. Reference FileName Use this parameter to specify a static single file name during the write operation. Reference Append Setting this parameter to \true\ causes the fileFTP adapter to append to a file in the outbound direction. If the file does not exist, a new file is created. Reference UseStaging If \true\, then the outbound fileFTP adapter writes translated data to a staging file and afterward streams the staging file to the target file. If \false\, then the outbound fileFTP adapter does not use an intermediate staging file. Table 33–5 Cont. Oracle File Adapter Properties Service, Reference, or Endpoint Property Name Description Configuring Service and Reference Binding Components 33-13 Reference ConcurrentThreshold The maximum number of translation activities that can be allowed to execute in parallel for a particular outbound scenario. The translation step during the outbound operation is CPU intensive and hence must to be guarded as it may cause starvation in other applicationsthreads. The maximum is 100 same as the maximum for dspMaxThreads in BPEL. Reference SequenceName Specifies the Oracle database sequence name to be used if you have already configured the outbound fileFTP adapter for high availability. Reference oracle.tip.adapter.file.mut ex Set it to the class name that specifies the mutex you want to use for the outbound write operation. This class must extend the oracle.tip.adapter.file.Mutex abstraction. Reference serializeTranslation If set to \true\, then the translation step is serialized using a semaphore. The number of permits for semaphore guarding the translation step comes from the ConcurrentThreshold parameter. If \false\, then the translation step occurs outside the semaphore. Reference inMemoryTranslation This parameter is applicable only if UseStaging is \false\. If set to \true\, then the translation step occurs in-memory that is, an in-memory byte array is created. If set to \false\, then the adapter creates an output stream to the target file FTP, FTPS, and SFTP included and allows the translator to translate and write directly to the stream. Reference DeleteFile If set to \true\, the fileFTP adapter deletes the file after it has been processed. Reference IgnoreZeroByteFile Set it to true if you do not want the fileFTP adapter to throw an exception during the outbound read operation if the file was not found. This parameter is ignored if the schema for the inbound file is anything other than opaque. Reference IncludeFiles Indicates the regex pattern against which the file names are matched. If the name of a certain file matches this pattern, it is processed by the fileFTP adapter. Reference ExcludeFiles Includes the regex pattern against which the file names are matched. If the name of a certain file matches this pattern, it is excluded and not processed by the fileFTP adapter. Reference Recursive If set to true, the fileFTP adapter processes files recursively in subdirectories. Reference MaxRaiseSize This parameter specifies the maximum number of files that the fileFTP adapter submits for processing in each polling cycle. For example, if the inbound directory has 1000 files and this parameter is set to 100 and the polling frequency is one minute, then the fileFTP adapter submits 100 files every minute. Table 33–5 Cont. Oracle File Adapter Properties Service, Reference, or Endpoint Property Name Description 33-14 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite

33.1.2.4 Oracle FTP Adapter

Table 33–6 describes the properties available for the Oracle FTP adapter. Reference DirectorySeparator When you choose multiple directories, the generated JCA files use \;\ as the separator for these directories. If you want, you can change the separator. If you do so, manually add DirectorySeparator=\chosen separator\ in the generated JCA file. For example, to use a comma , as the separator, you must first change the separator to \,\ in the physical directory and then add DirectorySeparator=\,\ in the JCA file. Reference SourceFileName The source file for the file IO operation. Reference SourcePhysicalDirectory The source directory for the file IO operation. Reference SourceType Set this to \native\ if the source file is native and to \xml\ if the source file is XML. Reference SourceSchema Set it to the schema for the source file. Reference SourceSchemaRoot Set it to the root element name for the source file. Reference TargetFileName Indicates the target file for the file IO operation. Reference TargetPhysicalDirectory Indicates the target directory for the file IO operation. Reference TargetType Set this to \native\ if the target file is native and to \xml\ if the source file is XML. Reference TargetSchema Set it to the schema for the target file. Reference TargetSchemaRoot Set it to the root element name for the target file. Reference Xsl Set it to the XSL transformer between the source and target. Reference Type Set it to \COPY\,\MOVE\, or \DELETE\. Reference BatchSize Set it to the batch size for the batching transformation. Reference ChunkSize Specifies the number of outbound messages. Table 33–5 Cont. Oracle File Adapter Properties Service, Reference, or Endpoint Property Name Description Configuring Service and Reference Binding Components 33-15 Table 33–6 Oracle FTP Adapter Properties Service, Reference, or Endpoint Property Name Description Service timestampOffset This parameter is used by the FTP adapter to tackle time zone issues typically, to convert the time difference between the FTP server and the system on which the FTP adapter is running to milliseconds. Service PhysicalDirectory This parameter specifies the physical directory for the fileFTP adapter. Service UseHeaders Set to \true\ if the fileFTP adapter must publish metadata for example, the file name, directory name, last modified data, file size, and to exclude the payload. This is typically used in large payload scenarios where you want to use the inbound adapter as a notifier. Service FileType Set it to either \ascii\ or \binary\, depending on the requirement. Service Recursive If set to \true\, the fileFTP adapter processes files recursively in subdirectories. Service PhysicalArchiveDirectory Directory in which the inbound fileFTP adapter archives files after they have been processed successfully. Service PhysicalErrorArchiveDirectory Indicates the directory where the inbound fileFTP adapter archives files in case of failures, such as translation errors, and errors during publishing. Service UseRemoteArchive Set this parameter to \true\ to notify the FTP adapter that the archival directory is on the same FTP server. If set to \false\, the FTP adapter uses a local file system folder for archival. Service UseNlst Set this parameter to \true\ if you need the FTP adapter to use the \NLST\ FTP command instead of the \LIST\ that the adapter uses by default. Service DeleteFile If set to \true\, the fileFTP adapter deletes the file after it has been processed. Service IncludeFiles Indicates the regex pattern against which the file names are matched. If the name of a certain file matches this pattern, it is processed by the fileFTP adapter. Service ExcludeFiles Indicates the regex pattern against which the file names are matched. If the name of a certain file matches this pattern, it is excluded and not processed by the fileFTP adapter. Service PollingFrequency This parameter specifies how often the fileFTP adapter checks for files in the inbound directory. It is specified in seconds.