Box Endpoint

this section relies on values generated in the above section "configure app within box account" this is required for both ecm and content server 1\ open the docuflow configurator via https //localhost 82 (username docuflow, password docuflow) 2\ under "connections" in the left navigation panel click "box" 3\ click "configure" 4\ ensure your private key der file is placed into the config folder of your docuflow installation (you will do this in file explorer) typically located in c \versafile docuflow enterprise connector v657 5\ in the configure box ensure you replace the default docuflow app values with your organizations client id, client secret, public key id (this is located in the developer console in the box application you created earlier in "configure docuflow app within box account" ) 6\ enter the name of the der file in the der file input box (just the name is required not the location, as it must be in the config folder) 7\ click "save" 8\ restart your docuflow service in windows 9\ open the docuflow configurator via https //localhost 82 10\ under "connections" in the left navigation panel click "box" 11\ click "add row" 12\ at a bare minum enter a cms name and the enterprise id of your organization in box 13\ click "save" 14\ on the entry just created click "modify" and scroll down to the app users 15\ if no app users exist we must create one do so by entering in the input box "enter new app user" the name of the app user you would like to create 16\ once an app user is created in the table below enable it and click "save" 17\ on the entry just created click "modify" and click "test connection" a success dialog should appear if it does not refer to the docuflow middlware log 18\ consider enabling "search query" enabled as that is recommended when determining which search technology to use in box for the docuflow app to process content to and from sap, any app users created must be granted access (ie added as a collaborator) to the folder(s) in which it will performs actions albeit not required at this time for base configuration and connectivity, refer to the section follow up box and middleware team tasks >authorize docuflow app user ids to folders for more detailed instructions on how to perform this alternatively on the docuflow configuration ui in the app users table there is an email address for the app user to give the app user permissions to the folder we would simply invite that email as a collaborator when logged into box in a folder setting description sample value(s) enterprise id the box enterprise id number for the particular instance this is only necessary if an app user needs to be created by using the enterprise connector this can be found under the admin console business settings in box on the “account info” tab 2222222 root folder optional folder to allow all files stored in box to be relative of this parent or root folder date/time the date/time format used for processing with sap generally the default format shouldn’t need to be changed but in some custom processing situations it may be necessary to adjust the date/time format if processing requires in a particular way mm/dd/yyyy hh\ mm\ ss a z sap user prop the username property or attribute to use for logging who created the document this property is used by api processing and should not be changed when adding a document from the profile wizard it will populate this field with “docuflow profile wizard” note this property is required for all box metadata templates to be utilized docuflowusername time prop the timestamp property or attribute which is set when the document is added into the content management system this property is used by api processing and should not be changed note this property is required for all box metadata templates to be utilized docuflowtimestamp id the box app user id number to perform docuflow for the docuflow app to process content to and from sap, the app user must be granted access (ie added as a collaborator) to the folder(s) in which it will performs actions refer to the section authorize docuflow app user ids to folders for instructions on how to perform this box generated value 1111111 description an optional description can be added to the id to help identify what the number actually is by default when adding app users with the “create app user” button the name will be placed here docuflow app user 1 search query enabled use real time search if enabled, otherwise older mdfilters search with delay recommend to keep it enabled cascade policy when creating folders if this is enabled we can choose to enforce a cascade policy on that folder this would cascade down metadata to files/folders that would go in it task status task status value when the task request is under process in process sign task signed source status after a sign request is completed this value will be assigned to the original document task status property if the document signature request is successful signedoriginal sign task declined source status after a sign request is completed this value will be assigned to the original document task status property if the document signature request is declined declinedoriginal test box connection pressing this button tests if the top most id can successfully communicate with box rfc configuration once you have connection to your sap system and box, associate the two together via an sap rfc destination this in turn also enables all sap to box outbound processing at the connector level for box inbound to sap processing (configured using the inbound to sap tab), refer to the docuflow solution guide, as this is considered functional/pattern/use case configuring and not base connectivity in the configuration ui under "mappings" click "rfc destinations" click "add row" select the name of the cms and sap connection we would like to associate the rfc destination from the dropdowns enter the sap rfc destination name the sap rfc name will be provided by either your sap basis team or the docuflow configuration that created the docuflow sap api destination configuration this value must match the rfc created and specified in sap click enabled and set to "true" provide a server count (recommended value is 10) and also what prefer docuflow to do in the case of duplicate filenames in box (error vs replace) the working directory should be a sub folder of the docuflow connector installation directly typically c \\\versafile docuflow enterprise connector v657\\\tmp (for encoding reasons ensure there are two backslashes when entered in the input box) click save restart the docuflow service in windows service note sourcetriggerproperty is used while sending a box sign request this field provides the property name which contains original document id value sent for sign request the windows service must be restarted for changed to take effect