{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"ce2b8042-7d22-4d8b-ac91-e3b1b6c3873d"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"a6fa9410-1ae8-40b1-955f-d63c7e16183e"}},{"type":"rule"},{"type":"paragraph","content":[{"text":"Connect file processing follows a specific flow that can handle user interaction and error handling at certain points.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":847,"id":"cbcb6afe-e795-4304-94b2-03e988f83fb7","collection":"contentId-61409099","type":"file","height":1138}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"1. Call","type":"text"}]},{"type":"paragraph","content":[{"text":"Here it is distinguished whether the call is made with complete connect (Normal or ","type":"text"},{"text":"Type Data","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDTEN/pages/61409042"}}]},{"text":"), or via unstructured XML. In the second case, the correct XML transformer is searched for and applied to the XML. If this operation fails, the processing is aborted immediately. No ConnectorResult is created, but the server-side call returns an HTTP error code 500 (Server Error). This is because the processing has not even been started at this point, only the formatting.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"2. Preparation","type":"text"}]},{"type":"paragraph","content":[{"text":"In this second step, the connect is read in and the sequence is established. If the read-in fails, this is processed regularly via the OnError commands. By default, the Connect XML is not subjected to a schema check, unless this was requested via the attribute ","type":"text"},{"text":"Validate=\"true\"","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"3. Template selection","type":"text"}]},{"type":"paragraph","content":[{"text":"There are three different ways to select the template:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The templateId is explicitly specified → selection unique, no user interaction needed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The template is filtered by tags. Then there are two possible consequences: a) Only one template matches the filter criteria → selection unique, no user interaction needed. b) More than one template matches the filter criteria → template picker is displayed to the user. This works only on a client call, not on the server. If the template picker is displayed, the user also has the option to cancel the action, which in turn ends in an OnCancel event.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"4. Generation","type":"text"}]},{"type":"paragraph","content":[{"text":"The document creation itself is considered as a black box. In it, the various document functions attached to the selected template are applied and, if necessary, enriched with the data from the Connect call.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"5. Execution of the document commands","type":"text"}]},{"type":"paragraph","content":[{"text":"After the actual document creation, commands (e.g. ","type":"text"},{"text":"conversion to a PDF document","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDTEN/pages/61409463"}}]},{"text":") can be applied to the individual result. At the same time, the error and abort commands are executed at the document level.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"6. Execution of the batch commands","type":"text"}]},{"type":"paragraph","content":[{"text":"After all individual document creations have been completed, commands can be applied to the entire batch again – e.g. the ","type":"text"},{"text":"Merge command","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDTEN/pages/61409463"}}]},{"text":". At this point, error and abort commands are also executed from the cumulative results of the document commands. At the very end, if so requested by the Connect call, the ConnectorResult file is created. In case of a web call to the server, the created document is now returned as a stream.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"ConnectResult","type":"text"}]},{"type":"paragraph","content":[{"text":"The ConnectResult can take the following values:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Success","type":"text","marks":[{"type":"strong"}]},{"text":" No errors occurred.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cancel","type":"text","marks":[{"type":"strong"}]},{"text":" The user has canceled the process (or the previous one).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Error","type":"text","marks":[{"type":"strong"}]},{"text":" At least one error has occurred.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unknown","type":"text","marks":[{"type":"strong"}]},{"text":" The status at this time is unknown. This occurs when the template picker was started (which is executed asynchronously).","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Order/Prioritization","type":"text","marks":[{"type":"strong"}]},{"text":": Unknown, Error, Cancel, Success If a process relevant to the result returns ","type":"text"},{"text":"Unknown","type":"text","marks":[{"type":"em"}]},{"text":", then the result is also ","type":"text"},{"text":"Unknown","type":"text","marks":[{"type":"em"}]},{"text":", regardless of whether another process was aborted or failed. The same applies to ","type":"text"},{"text":"Error","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"Cancel","type":"text","marks":[{"type":"em"}]},{"text":". ","type":"text"},{"text":"Success","type":"text","marks":[{"type":"em"}]},{"text":" is only returned if everything was successful.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example: Document generation: ","type":"text"},{"text":"Success","type":"text","marks":[{"type":"em"}]},{"text":" and: Commands ","type":"text"},{"text":"Error","type":"text","marks":[{"type":"em"}]},{"text":" gives an overall result of ","type":"text"},{"text":"Error","type":"text","marks":[{"type":"em"}]},{"text":", even though the document generation itself was successful.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ConnectResult has the following format:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"text":"\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 0\n","type":"text"}]},{"type":"paragraph"}],"version":1}

Browser not supported