Base SAP Link Enterprise Configuration

ecm ecm requires base configuration regardless of what integration patterns, use cases, or functionality you would like to utilize content server content server requires no more sap link enterprise specific configuration unless you are going to use the below functionality with content server outbound document storage (gos/sfo or message output) with outbound metadata transfer url/web viewing (instead of archivelink standard viewing) docmover folder creation it is recommended to use ecm unless you must use content server if you must use content server, this must be a separate (set of) oac0 repository id(s) reasons you may need to use content server sap message output without ecm plug in adk data archiving fiori apps using document service (ie without sfo/gos functionality) outbound dms any other application or 3rd party that relies on archivelink directly if you are not implementing outbound metadata transfer you do not need to perform the below configuration you will most likely require standard sap archivelink oac2 and oac3 configuration overview the base configuration consists of the following components one or more cms profiles one or more cms use tags one or more api destinations environment variables (optional) one or more repository id’s all above configuration is navigated via the content api system dashboard (transaction /dflow/sys) utilizing the top left menu path “configure” configuration must be done in sequence, and requires the repository id(s) to be created as a pre requisite all configuration must be saved in a transport for migration to qual and production (among other) environments cms profiles setting description sample value(s) cms profile cms profiles equate to top level site collections in sharepoint typically, there is only one cms profile per repository type of an organization m365 1 repository type version of sharepoint that you are connecting to sharepoint m365 description an english description given to the describe the cms profile main site acme cms use tags setting description sample value(s) cms use tag cms use tags, in combination with cms profiles, will together determine an api destination (below) to be utilized api destinations in turn determine the sap rfc to be leveraged, and thus load on that rfc and in turn a group of sap jco server threads in short, this combination allows you to load balance processing across multiple rfc/sap jco connections a very common approach to at a minimum to break out viewing from the rest of your processing as let’s face it, end users hate when they can’t view their documents and if you are hammering an rfc with other processing, well, insert hourglass icon also, have one or more use tags for custom usage this way if you mess up you don’t affect everyone else ; ) the load balancing features of use tags is not relevant to content server usage doc storage fi doc storage scm doc storage hr custom api usage 1 migration 1 migration 2 auditlink 1 etc … description an english description given to the describe the cms tag outbound document storage for fi api destinations api designations are a unique combination of cms use tags and cms profiles that determines the sap rfc to be leveraged, and thus load on that rfc and in turn a group of sap jco server threads, allowing you to manually control the load balance processing across multiple rfc/sap jco connections this is not relevant to content server integration note that for extreme load, you can also have multiple enterprise connectors configure for an sap system, allowing you to spread api destinations (i e rfc destination) across multiple connector instances and possibly physical/virtual servers important this rfc destination chosen must match the api destination configured in enterprise connector in step base enterprise connector configuration – enterprise ecm only setting description sample value(s) cms profile cms profile that will use this api/rfc destination m365 1 cms tag cms use tag that will use this api/rfc destination • outbound document storage for fi or • viewing disable used to temporary disable processing on this api destination on/off cms rfc destination sap rfc to be used to communicate with a specific instance of a enterprise connector this rfc destination chosen must match the api destination configured in enterprise connector in step base enterprise connector configuration – ecm only z cmsapi 01 environment variables environment variables are used for two reasons the primary/most common reason is when a enterprise configuration element requires a value that might change depending on which sap environment (i e sap system id) you are in an example of this would be a development server vs a production server for saving auditlink bundles viewing url’s are often different for development vs production as well this is leveraged extensively for on prem content repositories when there are more server and host names involved this is not relevant to content server integration the second reason and less common, is if the enterprise configuration field is too small in length to hold a crazy long value you may have yes, we have seen it note when used in configuration, the environment variable must be specified within brackets, i e \<hostname>, or \<reallylongsubsitestring> setting description sample value(s) sap system id sap system id that should use the value specified dev qa1 prd variable name variable name that will be specified in any relevant enterprise ecm configuration • sponpremhost or • reallylongsubsitestring variable value 1 the value to be substituted in the ecm configuration per sap environment/system id http //devsp2013srv1/ http //qualsp2013srv1/ http //prodsp2013srv1/ or mycompany sharepoint com/sites/sapdemo repository id’s setting description sample value(s) cont rep id the content repository id matching oac0 z1 disable the ability to temporarily turn off all usage of the repository id for ecm usage off use cmsid relevant to ecm only this uses cmsid (instead of sapdocid) for all archivelink entries for all implementations it is highly recommended this be kept off and shoud only be turned on in link enterprise legacy installations if dictated by your link enterprise sme off is archivelink if this repository id is a content server (ie not ecm), this must be enabled you cannot share an “is archivelink” repository id with an ecm repository id on/off use direct api future use n/a req location determines whether the repository requires location as part of the ecm processing currently all sharepoint versions require a location on/off cms profile cms profile that is relevant to this repository id m365 1 cms rep/store for sharepoint, this is your top level construct that uniquely determines your online repository this is typically your top level site collection http //mysharepoint com/ or environment variable \<reallylongsubsitestring> viewer medium the method of viewing you would like to utilized cms portal url typically used for specifying viewing url and future use not needed for sharepoint as the enterprise connector compiles the viewing url at request time n/a en embedded url use this to prevent user logon to the repository when viewing by using short lived expiring unauthenticated urls currently not available in m365 but expected soon from microsoft off cms use tag v the use tag to be utilized for viewing requests as api calls are required to compile information in order to view content this is typically a separate use tag so that either from the start or in the future you can split viewing off to its own api/rfc destination viewing repository id’s are the final element to the base configuration and tie in the top level cms profile with the repository store name (top level site name in sharepoint) along with which viewing mechanism and elements to use and a few other options at this point if you are viewing the system dashboard ( make sure to hit refresh to show your new changes! ) you will see your entry(ies) the api status column will be red until the enterprise connector is configured for that api/rfc destination check with your middleware installation and once completed and the windows service is turn on, see section establishing sap < > enterprise connector connectivity configuration