Folijet - FSE tips on troubleshooting
When processing a request from customer related to Data Import, please follow next recommendations:
Validate Job Profile. There is number of things that need to be checked:
Job profile contains Actions
Update Actions always follow the Match
Actions on Inventory entities are linked in the right order (Instance, then Holdings, then Item, not in reverse order)
Each Action Profile has a link to a single Mapping Profile
Modify Action is always used either in the beginning or follow an Action on Instance
*See linked Support training.pptx for more info on Data Import Profiles
Recreate Job Profile on a relevant bugfest environment (always include the link to that profile in the RRT request):
Keep in mind probable differences in reference data. It is usually not a problem, you can select value from the accepted dropdown list for most of the fields, unless the issue specifically indicates the problem with mapping.
Make sure importing data is not sensitive and can be shared for using on reference envs
Review DI log for a particular error displayed on UI (include this information in the RRT request - status of the Job completion, content of summary page, any specific errors). Try to reproduce issue on bugfest environment, include the link to that job in the request.
Search module logs for that particular Job Execution, if you have error - search for that error as well.
Review relevant modules (besides basic DI - mod-data-import, mod-source-record-manager, mod-di-converter-storage) for the flow in question:
Inventory entities (Instance, Holdings, Items) - mod-inventory, mod-source-record-storage
Orders - mod-orders
Invoices - mod-invoice
Try searching logs filtering by Job Execution id.
*See linked Support training.pptx for more info on Data Import modules
Note:
Mapping profile and Mapping rules are different things:
Mapping Profile contains instruction on how to map incoming record into target Folio record (specifically fields that are not controlled by MARC). Required to be linked to an Action Profile to be used in a Job Profile.
Default Mapping rules – are also instructions, but for different fields (for MARC-controlled fields). There are MARC Bib-to-Instance, MARC Holdings-to-Holdings, MARC Authority-to-Authority Mapping rules. Stored in mod-source-record-manager https://github.com/folio-org/mod-source-record-manager/tree/master/mod-source-record-manager-server/src/main/resources/rules
*See linked Data Support training.ppt for more info on Mapping rules
Poppy known issues:
https://issues.folio.org/browse/MODDICONV-294
https://issues.folio.org/browse/MODDICONV-334
Review the linked presentations for additional info