> For the complete documentation index, see [llms.txt](https://docs.pagopa.it/centrostella-1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagopa.it/centrostella-1/centro-stella/instructions-for-agenzia-delle-entrate-mandate/appendixes/appendix-6-configuration-properties.md). # Appendix 6 - Configuration properties ### **1. Logging** | Key | Description | Default | Mandatory | Values | | ---------------------- | -------------------------------------------- | --------------------------------------------- | --------- | ------------------------------------------- | | **logging.file.name** | Location where the log files will be written | ${ACQ\_BATCH\_APP\_LOG\_FILE:application.log} | NO | | | **logging.level.root** | Log level | ${LOG\_LEVEL\_RTD\_TRANSACTION\_FILTER:INFO} | NO | TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF | | **logging.pattern** | Log pattern | ${ACQ\_BATCH\_APP\_LOG\_PATTERN:} | NO | | Many other customizable variables are found [here](https://docs.spring.io/spring-boot/docs/2.7.4/reference/htmlsingle/#features.logging.custom-log-configuration). ### **2. General** | Key | Description | Default | Mandatory | Values | | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | --------- | ---------- | | **spring.batch.job.enabled** | To avoid unmanaged executions, must be at false | FALSE | YES | FALSE | | **spring.batch.job.scheduled** | To define if the process will remain active with scheduled executions | FALSE | YES | TRUE/FALSE | | **batchConfiguration.TransactionFilterBatch.successArchivePath** | Move initial csv to success path | file:/${ACQ\_BATCH\_SUCCESS\_PATH:${ACQ\_BATCH\_TRX\_INPUT\_PATH:}/success} | YES | | | **batchConfiguration.TransactionFilterBatch.errorArchivePath** | Path where the files whose processing goes wrong are moved | file:/${ACQ\_BATCH\_ERROR\_PATH:${ACQ\_BATCH\_TRX\_INPUT\_PATH:}/error} | YES | | | **batchConfiguration.TransactionFilterBatch.pendingArchivePath** | Path where the files whose upload goes wrong are moved | file:${ACQ\_BATCH\_PENDING\_PATH:${ACQ\_BATCH\_OUTPUT\_PATH:}/pending} | NO | | | **batchConfiguration.TransactionFilterBatch.cron** | Batch scheduling | ${ACQ\_BATCH\_INPUT\_CRON:0 0/1 \* 1/1 \* ?} | YES | | | **batchConfiguration.TransactionFilterBatch.partitionerMaxPoolSize** | Batch max partitioner setting | ${ACQ\_BATCH\_INPUT\_PART\_MAX\_POOL\_SIZE:5} | NO | | | **batchConfiguration.TransactionFilterBatch.partitionerCorePoolSize** | Batch partitioner pool setup | ${ACQ\_BATCH\_INPUT\_PART\_CORE\_POOL\_SIZE:5} | NO | | | **batchConfiguration.TransactionFilterBatch.readerMaxPoolSize** | Maximum number of transaction csv file readers | ${ACQ\_BATCH\_INPUT\_PART\_READ\_MAX\_POOL\_SIZE:5} | NO | | | **batchConfiguration.TransactionFilterBatch.readerCorePoolSize** | Maximum number of transaction csv file readers | ${ACQ\_BATCH\_INPUT\_PART\_READ\_CORE\_POOL\_SIZE:5} | NO | | | **batchConfiguration.TransactionFilterBatch.tablePrefix** | Table prefix containing the metadata related to the execution of the batch, if active | ${ACQ\_BATCH\_INPUT\_TABLE\_PREFIX:BATCH\_} | NO | | | **batchConfiguration.TransactionFilterBatch.isolationForCreate** | Define the isolation level used by the jobRepository on the batch tables | ${ACQ\_BATCH\_TRX\_ISOLATION\_FOR\_CREATE:ISOLATION\_SERIALIZABLE} | NO | | | **rest-client.file-report.url** |

From version 2.2.0 is able to manage either new v2 with data summary or the old report version.
if you want to use the old version you must to set ACQ\_BATCH\_FILE\_REPORT\_URL="/file-report"

| ${ACQ\_BATCH\_FILE\_REPORT\_URL:v2/file-report} | NO | | ### **3. PAN list reading** | Key | Description | Default | Mandatory | Values | | ----------------------------------------------------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | --------- | ---------- | | **batchConfiguration.TransactionFilterBatch.panList.hpanDirectoryPath** | The path where the file containing HPANs is located | file:/${ACQ\_BATCH\_HPAN\_INPUT\_PATH:}/${ACQ\_BATCH\_INPUT\_FILE\_PATTERN:\*.csv} | YES | | | **batchConfiguration.TransactionFilterBatch.panList.secretKeyPath** | Path where the private key is saved | file:/${ACQ\_BATCH\_INPUT\_SECRET\_KEYPATH:} | YES | | | **batchConfiguration.TransactionFilterBatch.panList.passphrase** | Passphrase for the private key | ${ACQ\_BATCH\_INPUT\_SECRET\_PASSPHRASE:} | YES | | | **batchConfiguration.TransactionFilterBatch.panList.partitionerSize** | Size of the partitioner used to read the file | ${ACQ\_BATCH\_HPAN\_PARTITIONER\_SIZE:10} | NO | | | **batchConfiguration.TransactionFilterBatch.panList.chunkSize** | Size of the chunks used for reading the file | ${ACQ\_BATCH\_HPAN\_CHUNK\_SIZE:1000} | NO | | | **batchConfiguration.TransactionFilterBatch.panList.skipLimit** | Maximum number of records discarded before execution is blocked | ${ACQ\_BATCH\_HPAN\_SKIP\_LIMIT:0} | NO | | | **batchConfiguration.TransactionFilterBatch.panList.applyDecrypt** | Flag indicating whether or not to apply the decrypt at the hpan file | ${ACQ\_BATCH\_PAN\_LIST\_APPLY\_DECRYPT:true} | YES | TRUE FALSE | ### **4. Transaction list reading** | Key | Description | Default | Mandatory | Values | | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | --------- | ---------- | | **batchConfiguration.TransactionFilterBatch.transactionFilter.transactionDirectoryPath** | Path where the transaction file to be processed is read | file:/${ACQ\_BATCH\_TRX\_INPUT\_PATH:}/ | YES | | | **batchConfiguration.TransactionFilterBatch.transactionFilter.outputDirectoryPath** | Path where the final file is writtene | file:/${ACQ\_BATCH\_OUTPUT\_PATH:${ACQ\_BATCH\_TRX\_INPUT\_PATH:}/output} | YES | | | **batchConfiguration.TransactionFilterBatch.transactionFilter.partitionerSize** | Partitiner size for transaction files | ${ACQ\_BATCH\_INPUT\_PARTITIONER\_SIZE:10} | NO | | | **batchConfiguration.TransactionFilterBatch.transactionFilter.chunkSize** | Chunck size for reading transaction files | ${ACQ\_BATCH\_INPUT\_CHUNK\_SIZE:1000} | NO | | | **batchConfiguration.TransactionFilterBatch.transactionFilter.skipLimit** | Maximum number of records discarded before execution is blocked | ${ACQ\_BATCH\_INPUT\_SKIP\_LIMIT:0} | NO | | | **batchConfiguration.TransactionFilterBatch.transactionFilter.timestampPattern** | Pattern relating to the transaction date | ${ACQ\_BATCH\_INPUT\_TIMESTAMP\_PATTERN:MM/dd/yyyy HH:mm:ss} | NO | | | **batchConfiguration.TransactionFilterBatch.transactionFilter.applyHashing** | Flag that drives the hashing to the pan present in the transaction file | ${ACQ\_BATCH\_TRX\_LIST\_APPLY\_HASHING:false} | YES | TRUE FALSE | | **batchConfiguration.TransactionFilterBatch.transactionFilter.applyEncrypt** | Flag to define whether to encrypt the result file | ${ACQ\_BATCH\_TRX\_LIST\_APPLY\_ENCRYPT:true} | YES | TRUE FALSE | | **batchConfiguration.TransactionFilterBatch.transactionFilter.linesToSkip** | Number of lines to skip from the beginning of the file (e.g. to avoid the header ) | ${ACQ\_BATCH\_INPUT\_LINES\_TO\_SKIP:0} | NO | | | **batchConfiguration.TransactionFilterBatch.transactionFilter.transactionLogsPath** | Path where the processed transaction records resulting in either an error, or getting filtered, are traced in .csv format | file:/${ACQ\_BATCH\_TRX\_LOGS\_PATH:} | YES | | | **batchConfiguration.TransactionFilterBatch.transactionFilter.readers.listener.enableAfterReadLogging** | Property to enable logging for the read records | ${ACQ\_BATCH\_TRX\_AFTER\_READ\_LOGGING\_ENABLED:false} | YES | TRUE FALSE | | **batchConfiguration.TransactionFilterBatch.transactionFilter.readers.listener.enableOnReadErrorLogging** | Property to enable logging for the records that had errors on the reading phase | ${ACQ\_BATCH\_TRX\_READ\_ERROR\_LOGGING\_ENABLED:true} | YES | TRUE FALSE | | **batchConfiguration.TransactionFilterBatch.transactionFilter.readers.listener.enableOnReadErrorFileLogging** | Property to enable writing the records that had errors on the reading phase | ${ACQ\_BATCH\_TRX\_READ\_ERROR\_FILE\_LOGGING\_ENABLED:true} | YES | TRUE FALSE | | **batchConfiguration.TransactionFilterBatch.transactionFilter.readers.listener.enableAfterProcessLogging** | Property to enable logging for the processed records | ${ACQ\_BATCH\_TRX\_AFTER\_PROCESS\_LOGGING\_ENABLED:false} | YES | TRUE FALSE | | **batchConfiguration.TransactionFilterBatch.transactionFilter.readers.listener.enableAfterProcessFileLogging** | Property to enable writing the records that had been filtered | ${ACQ\_BATCH\_TRX\_AFTER\_PROCESS\_FILE\_LOGGING\_ENABLED:true} | YES | TRUE FALSE | | **batchConfiguration.TransactionFilterBatch.transactionFilter.readers.listener.enableOnProcessErrorLogging** | Property to enable logging for the records that had errors on the processing phase | ${ACQ\_BATCH\_TRX\_PROCESS\_ERROR\_LOGGING\_ENABLED:true} | YES | TRUE FALSE | | **batchConfiguration.TransactionFilterBatch.transactionFilter.readers.listener.enableOnProcessErrorFileLogging** | Property to enable writing the records that had errors on the processing phase | ${ACQ\_BATCH\_TRX\_PROCESS\_ERROR\_FILE\_LOGGING\_ENABLED:true} | YES | TRUE FALSE | | **batchConfiguration.TransactionFilterBatch.transactionFilter.readers.listener.enableAfterWriteLogging** | Property to enable logging for the written records | ${ACQ\_BATCH\_TRX\_AFTER\_WRITE\_LOGGING\_ENABLED:false} | YES | TRUE FALSE | | **batchConfiguration.TransactionFilterBatch.transactionFilter.readers.listener.enableOnWriteErrorLogging** | Property to enable logging for the records that had errors on the writing phase | ${ACQ\_BATCH\_TRX\_WRITE\_ERROR\_LOGGING\_ENABLED:true} | YES | TRUE FALSE | | **batchConfiguration.TransactionFilterBatch.transactionFilter.readers.listener.enableOnWriteErrorFileLogging** | Property to enable writing the records that had errors on the writing phase | ${ACQ\_BATCH\_TRX\_WRITE\_ERROR\_FILE\_LOGGING\_ENABLED:true} | YES | TRUE FALSE | | **batchConfiguration.TransactionFilterBatch.transactionFilter.readers.listener.loggingFrequency** | Logging frequency for transaction records | ${ACQ\_BATCH\_TRX\_READ\_LOGGING\_FREQUENCY:10000} | YES | | ### **5. REST services** | Key | Description | Default | Mandatory | Values | | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | --------- | ---------- | | **batchConfiguration.TransactionFilterBatch.transactionSenderAde.enabled** | Indicates whether the sending of AdE filtered transactions to the rest channel is active or not | ${ACQ\_BATCH\_TRX\_SENDER\_ADE\_ENABLED:true} | YES | TRUE FALSE | | **batchConfiguration.TransactionFilterBatch.transactionSenderRtd.enabled** | Indicates whether the sending of filtered transactions to the rest channel is active or not | ${ACQ\_BATCH\_TRX\_SENDER\_RTD\_ENABLED:true} | YES | TRUE FALSE | | **batchConfiguration.TransactionFilterBatch.transactionSenderPending.enabled** | Indicates whether the sending of pending files is active or not | ${ACQ\_BATCH\_TRX\_SENDER\_ADE\_ENABLED:true} | NO | | | **batchConfiguration.TransactionFilterBatch.saltRecovery.enabled** | Enable the recovery service for the salt | ${ACQ\_BATCH\_SALT\_RECOVERY\_ENABLED:false} | NO | | | **batchConfiguration.TransactionFilterBatch.hpanListRecovery.enabled** | Enable the recovery service for the hpan list | ${ACQ\_BATCH\_HPAN\_RECOVERY\_ENABLED:true} | NO | | | **batchConfiguration.TransactionFilterBatch.hpanListRecovery.directoryPath** | Location where the file containing the list of files will be saved | ${ACQ\_BATCH\_HPAN\_INPUT\_PATH:} | NO | | | **batchConfiguration.TransactionFilterBatch.hpanListRecovery.filename** | Name assigned to the recovered file | ${CSV\_TRX\_BATCH\_HPAN\_LIST\_FILENAME:} | NO | | | **batchConfiguration.TransactionFilterBatch.hpanListRecovery.dailyRemoval.enabled** | Enable daily removal of retrieved hpan files | ${ACQ\_BATCH\_HPAN\_RECOVERY\_DAILY\_REM\_ENABLED:false} | NO | TRUE FALSE | | **batchConfiguration.TransactionFilterBatch.abiToFiscalCodeMapRecovery.enabled** | Enable the recovery service for the abi to fiscal code map | ${ACQ\_BATCH\_ABI\_TO\_FISCALCODE\_RECOVERY\_ENABLED:true} | NO | | | **batchConfiguration.TransactionFilterBatch.senderAdeAckFilesRecovery.enabled** | Enable the recovery service for the sender ade ack files | ${ACQ\_BATCH\_SENDER\_ADEACK\_RECOVERY\_ENABLED:true} | NO | | | **batchConfiguration.TransactionFilterBatch.senderAdeAckFilesRecovery.directoryPath** | Location where the files containing the ade acks will be saved | ${ACQ\_BATCH\_SENDER\_ADEACK\_OUTPUT\_PATH:senderAdeAck} | YES | | | **batchConfiguration.TransactionFilterBatch.transactionWriterAde.splitThreshold** | ADE file output threshold in number of rows. Beyond the threshold a new output file is generated. | ${ACQ\_BATCH\_WRITER\_ADE\_SPLIT\_THRESHOLD:2000000} | NO | | | **batchConfiguration.TransactionFilterBatch.transactionWriterRtd.splitThreshold** | RTD file output threshold in number of rows. Beyond the threshold a new output file is generated. | ${ACQ\_BATCH\_WRITER\_RTD\_SPLIT\_THRESHOLD:1000000} | NO | | | **batchConfiguration.TransactionFilterBatch.fileReportRecovery.enabled** | Enable the file report recovery step | ${ACQ\_BATCH\_FILE\_REPORT\_RECOVERY\_ENABLED:true} | NO | | | **batchConfiguration.TransactionFilterBatch.fileReportRecovery.directoryPath** | Location where the file reports will be saved | ${ACQ\_BATCH\_FILE\_REPORT\_PATH:resources/reports} | YES | | | **batchConfiguration.TransactionFilterBatch.fileReportRecovery.fileNamePrefix** | Customizable file name prefix for file reports | ${ACQ\_BATCH\_FILE\_REPORTS\_PREFIX:report-tae} | NO | | | **rest-client.hpan.base-url** | Base url for REST services | ${HPAN\_SERVICE\_URL} | NO | | | **rest-client.hpan.api.key** | Subscription key to be used if calling Azure-hosted API methods | ${HPAN\_API\_KEY} | NO | | | **rest-client.hpan.list.url** | URL to download the hpan file | ${ACQ\_BATCH\_HPAN\_LIST\_URL:v2/hashed-pans} | NO | | | **rest-client.hpan.salt.url** | URL to download the salt | ${ACQ\_BATCH\_HPAN\_SALT\_URL:v2/salt} | NO | | | **rest-client.hpan.list.attemptExtraction** | Considers the downloaded file as compressed, and attempts an estraction | TRUE | NO | TRUE FALSE | | **rest-client.hpan.list.checksumValidation** | Attempts to validate the downloaded file using a checksum | FALSE | NO | TRUE FALSE | | **rest-client.hpan.list.checksumHeaderName** | Response header containing the file's checksum | x-ms-meta-sha256 | NO | | | **rest-client.hpan.list.listFilePattern** | Pattern to be used for extracting the correct file from the compressed resource | \*\\.csv | NO | | | **rest-client.hpan.list.dateValidation** | Enables date validation for the recovered resource | FALSE | NO | TRUE FALSE | | **rest-client.hpan.list.dateValidationHeaderName** | Response header containing the file's creation/update date | last-modified | NO | | | **rest-client.hpan.list.dateValidationPattern** | Response header date timestamp pattern (defaults to RFC-1123) | | NO | | | **rest-client.hpan.list.dateValidationZone** | Zone to consider when validating the creation date for the downloaded file | Europe/Rome | NO | | | **rest-client.hpan.proxy.enabled** | Use a Proxied Client | ${HPAN\_SERVICE\_PROXY\_ENABLED:false} | NO | | | **rest-client.hpan.proxy.host** | Proxy host | ${HPAN\_SERVICE\_PROXY\_HOST:} | NO | | | **rest-client.hpan.proxy.port** | Proxy port | ${HPAN\_SERVICE\_PROXY\_PORT:} | NO | | | **rest-client.hpan.proxy.username** | Proxy username | ${HPAN\_SERVICE\_PROXY\_USERNAME:} | NO | | | **rest-client.hpan.proxy.password** | Proxy password | ${HPAN\_SERVICE\_PROXY\_PASSWORD:} | NO | | | **rest-client.hpan.mtls.enabled** | Enable MTLS for salt and pan list services | ${HPAN\_SERVICE\_MTLS\_ENABLED:true} | NO | | | **rest-client.hpan.key-store.file** | Path to key-store | file:/${HPAN\_SERVICE\_KEY\_STORE\_FILE:} | NO | | | **rest-client.hpan.key-store.type** | Key-store type | ${HPAN\_SERVICE\_KEY\_STORE\_TYPE:#{null}} | NO | | | **rest-client.hpan.key-store.algorithm** | Key-store algorithm | ${HPAN\_SERVICE\_KEY\_STORE\_ALGORITHM:#{null}} | NO | | | **rest-client.hpan.key-store.password** | Key-store password | ${HPAN\_SERVICE\_KEY\_STORE\_PASSWORD:} | NO | | | **rest-client.hpan.trust-store.file** | Path to trust-store | file:/${HPAN\_SERVICE\_TRUST\_STORE\_FILE:} | NO | | | **rest-client.hpan.trust-store.type** | Trust-store type | ${HPAN\_SERVICE\_TRUST\_STORE\_TYPE:#{null}} | NO | | | **rest-client.hpan.trust-store.password** | Trust-store password | ${HPAN\_SERVICE\_TRUST\_STORE\_PASSWORD:} | NO | | | **feign.client.config.hpan-service.connectTimeout** | Rest client connection timeout, defined in milliseconds | ${REST\_CLIENT\_CONNECT\_TIMEOUT:${HPAN\_REST\_CLIENT\_CONNECT\_TIMEOUT:5000}} | NO | | | **feign.client.config.hpan-service.readTimeout** | Rest client read timeout, defined in milliseconds | ${REST\_CLIENT\_READ\_TIMEOUT:${HPAN\_REST\_CLIENT\_READ\_TIMEOUT:5000}} | NO | | ### **6. File handling** | Key | Description | Default | Mandatory | Values | | ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------- | ----------------------------------------- | --------- | ------------------- | | **batchConfiguration.TransactionFilterBatch.transactionFilter.deleteProcessedFiles** | Enable deletion of any processed file (all files related to a batch computation) | ${ACQ\_BATCH\_DELETE\_LOCAL\_FILE:true} | YES | TRUE FALSE | | **batchConfiguration.TransactionFilterBatch.transactionFilter.deleteOutputFiles** | Define output files management rule | ${ACQ\_BATCH\_DELETE\_OUTPUT\_FILE:ERROR} | YES | ALWAYS ERROR KEEP | | **batchConfiguration.TransactionFilterBatch.transactionFilter.manageHpanOnSuccess** | Define HPAN files management rule on success | ${ACQ\_BATCH\_HPAN\_ON\_SUCCESS:DELETE} | YES | DELETE ARCHIVE KEEP | ### **7. Repository** | Key | Description | Default | Mandatory | Values | | ----------------------------------- | -------------------------------- | ----------------------------- | --------- | ------ | | **spring.datasource.url** | Database connection url | ${ACQ\_BATCH\_DB\_CONN\_URL:} | YES | | | **spring.datasource.username** | Database username for login | ${ACQ\_BATCH\_DB\_USERNAME:} | YES | | | **spring.datasource.password** | Database password for user login | ${ACQ\_BATCH\_DB\_PASSWORD:} | YES | | | **spring.datasource.hikari.schema** | Database schema | ${ACQ\_BATCH\_DB\_SCHEMA:} | YES | | | **spring.jpa.database-platform** | Database dialect | ${ACQ\_BATCH\_DB\_DIALECT:} | YES | |