PutDoc adapter callbacks
Several callbacks are made before the PutDoc adapter starts writing data back to SDL Contenta.
- pcm_preparse_cat_file
- pcm_bust
- pcm_entity_init
With the (Arbortext) EpicEdit (cat) tool, all three are called. With the Epic Entity version, the first two callbacks are not invoked.
pcm_preparse_cat_file allows you to parse all the data in one concatenated file if you are customizing Epic Edit (cat). You can also use this callback to extract data inserted in the header during the edit session. There should be no need to override pcm_bust, a callback used by the Epic Edit (cat) version of the adapters. It splits the concatenated document file back into file entities. Only data from object-mapped elements that are new or modified is written to file entities.
pcm_preparse_modified_entities( ) provides an opportunity to examine the modified data before the import process has started.
In the updated file entities, the PutDoc import process is not a transaction that can be rolled back. If you need to abort the import of data (for example, because it doesn't parse) you must halt the process in either pcm_preparse_cat_file or pcm_entity_init. By aborting in one of these callbacks the user can correct the problem in the document and try again.