Functionality
This function module creates a new physical document using an existingdocument as a template. This has the effect that when the document ischecked out or when a copy of the document is copied to the front-endcomputer, the content of the document used as a template is copied tothe front-end computer.
The document class can be different from the document class of thetemplate document. If no other document class is specified, thedocument class of the template document is used. You have the option tospecify a DCE-compatible GUID. Otherwise, KPro automatically assignsthe document ID.
By default, the new document takes on the attributes of the templatedocument. However, you can use the optional flagX_IGNORE_MODEL_PROPERTIES to reject all the template documentattributes. You can also use the optional table PROPERTIES_TO_DELETE toreject individual attributes of the template document. The optionaltable PROPERTIES_TO_CHANGE is used to modify or create single-valueattributes and to create multiple-value attributes. If the documentclass contains mandatory attributes, the document can be created onlywhen all mandatory attributes are specified, or have been inheritedfrom the document class attributes.
It is also possible to create relationships from and to otherdocuments. In particular, the relationship with the associated logicaldocument should be set at this point. The GUID of a relationship canalso be pre-set to be DCE-compatible. If the relevant structure fieldis not filled when the function module is created, KPro assigns theGUID. The GUID is then returned. If a relationship cannot be createdfor some reason (see SDOK_RELA_CREATE), the exception BAD_RELATIONoccurs.
After SDOK_PHIO_CREATE_WITH_MODEL has executed successfully, the newdocument version has the status "initial". As long as the document hasthis status, the content of the original is copied to the front-endcomputer when the new version is checked out or downloaded to the filesystem of the front-end computer.