Agnostic Guides
...
Solution Guide
DocManager

SAPLink / Inbound to SAP Processing (Not supported S3)

7min
saplink is the inbound processing from your content repository to sap this can be leveraged to execute a number of link enterprise delivered functions in sap or your own custom logic thus why we call saplink the "do anything pipe" into sap there are three components involved in saplink processing ensure the cms document class/object type/metadata template has the required fields for saplink processing configuration a "rule" in the enterprise connector middleware this determines what content is to be processed, when, and what (if any) metadata is to be transferred what is processing is dependent on the cms system being used (outline more below) configuration of a corresponding docmanager rule in sap that matches the document type configured in step 2 this determines what action is to be performed in sap (link a document, trigger custom code, start accounts payable workflow, etc ) note the link enterprise sap system account specified in the middleware must have access to the transaction /dflow/gtw in its security profile to execute inbound to sap jco calls please refers to the section "create sap system account" in the base installation and configuration guide the inbound processing rule determines what is to be processed what metadata is to be sent to sap how to configure a saplink rule in enterprise connector load up in the browser the enterprise connector https //localhost 82/ https //localhost 82/box under "mappings" click inbound to sap hover over each of the input boxes in the ui to look at sample values for each input box click save restart the link enterprise windows service notes the docmanager rule in sap determines what action is to be performed in sap for each item "found" from a saplink rule in the connector each request is processing and calls a link enterprise bapi within the sap, which then reads the docmanager rule configuration found for that doctype there can only be one archivelink document type and sap business object combination ever configured in the docmanager configuration, thus avoid sharing document types across sap object (to avoid an inbound collision) gimmal link enterprise will then execute the configured action and pass back a return, either an error or success in the case of a success, the trigger property is set to false to prevent a re processing of that item found in the case of an error, the error property, if relevant to your cms system, will be updated in both scenarios, the doucflow user name and time stamp fields are updated upon a success saplink, metadata can also be enable to be transferred back to your cms system rule config what is to be processed inbound to sap entries search for documents that meet a specific criteria and send the information to sap for processing if processing completes successfully the trigger property is adjusted so that the document is not processed again if the processing were to fail by default the processing is tried again in order to not retry failed documents adjustments can be made to the filter string to omit documents that were in error setting description sample value(s) enable inbound to sap if checked configuration for inbound to sap is enabled and can be configured for inbound to sap processing sap the sap system to send document metadata too sap dev ed1 cms the cms system to get document metadata from trigger data type data type by which the saplink rule is triggered task and sign task type only applicable for box workflow tasks boolean, timestamp, task and signtask sap repo the sap archivelink repository that should be associated with this metadata being passed zc sap type the sap archivelink document type associated with this metadata being passed zcontract cms repo the content management system object store or repository cms type the content management system document class, object type or metadata template to look for the requested metadata in scmcontracts interval the inbound to sap process searches for documents matching the configured criteria and then sends the information to sap this interval determines how often the underlying content management system is searched 10 trigger prop the content management system property or attribute associated with when to trigger sending information to sap by default, link enterprise sets this property to true or false based on the result of a saplink call to sap these values can be manipulated via the config properties file with the below entries saplinkfalse value=\<value> (for success) saplinkerror value=\<value) (for error) linkenterprisesaplinktrigger saplinkfalse value=donotprocesssuccess saplinkerror value=donotprocesserror type currently m365 implementations only support boolean trigger types boolean error prop if an error happens while trying to process a particular file you can optionally store the error information in the content management system linkenterprisesaplinkerror type currently m365 implementations only support string (single line of text) error property types string max an optional setting to limit the number of entries returned when searching for documents a setting of 0 has no limit 0 filter for sharepoint this is not applicable location for sharepoint this is not applicable order by for sharepoint this is not applicable sub for sharepoint this is not applicable lineitemcolumn the line item column name which is referred to the csv files containing the line item information rule config what metadata is to be sent to sap what metadata is sent from your repository to sap is determined by the metadata column setting description sample value(s) metadata the comma separated list of metadata to send to sap in the specified order these must match the sharepoint column names with exact casing title,contract,name rule config sign task sign task config setting description sample value(s) sourcetriggerproperty the content management system property or attribute associated to trigger when the sign task is completed middlewareoriginaldocid