Documentation Center

Low

GetDoc adapter callbacks that have been determined by SDL Contenta Engineering to be low in usefulness.

pcm_should_skip_content_slice
This method (or callback) is similar to pcm_should_skip_child_slice on page 5-34 except that it is called on each content slice. It is passed a reference to the current slice object, $SliceO. Refer to Methods on the slice object.

Return Value: The callback returns true or false (1 or 0).

True indicates to SKIP export of the content, false to export it.

The CustomGetDocDefault implementation returns true if ($SliceO->Type() =~ /dtd/i) which means not to export the slice if it contains the DTD.

Dynamic Import sets the slice type to DTD if it imports the DTD into it. If you override this method, you could copy the code from the original into your implementation so that it still skips the DTD slice—but it is preferable to use the approach in the following example where first the callback in the super class is called then followed by your custom implementation:
sub pcm_should_skip_content_slice {
my $self = shift;
my $SliceO = shift;
if($self->SUPER::pcm_should_skip_content_slice($SliceO,@_ ) !=0) {
return(1); # must be DTD, skip it
}
# Your implementation starts here…
return 0; # Don't skip. Export content.
pcm_before_return
Introduced in SDL Contenta 3.1C.1, this callback is called after the concatenated file of tree object data is closed and before the API call to GetDocPerl returns.
pcm_before_session_detach

Introduced in SDL Contenta 3.1C.1, this method (or callback) is not invoked by publish adapter PcmGetDocCat.

By overriding this callback, you have the opportunity to lock any other objects long term that you want locked in the same session as the tree of objects being exported, before detaching occurs from the session.

pcm_get_cat_extension

Introduced in SDL Contenta 3.1C.1, this method is not invoked by the publish adapter PcmGetDocCat.

Return Value: This callback returns the extension that is appended to the concatenated document.