/PACG/ECM_CPROP - General Properties of FSM Cloud Connector

Customize general, company-independent properties of FSM Cloud Connector.

Customizing options

Channel active

BAL Channel is active (cloud interface active/inactive). The field is set to true by default and should not be deactivated.

Stop comm.

Stop channel communication. Activating this field will stop channel processing with message ‘The Channel is not active - raising the error’ (idocs will not be transferred to SAP FSM).

Unconf.IdocsAge

Take unconfirmed Idoc for the last XX (Days) into account. The default value is ‘30’ days.

Trans/LUW

This parameter is used in the two scenarios.

  • first one - it controls the number of processes of iDocs generation in the single commit (for example, when sending equipment to the FSM this parameter says for how many of them iDoc will be created and to the port in the single commit)

  • second one - it controls number of messages read at once in the queue and eventually number of messages sent in a single call to the Message Broker reducing the overhead caused by executing web services separately for the single messages

Don't save Logs

No Log will be saved if check box is marked (Logs to be found in transaction SLG1)

No Log Fullsync

When the Fullsync operation is performed, no persistent logs are generated.

Reduce E4C Log

Reduce E4C log.

No "U/"

When the users are sent from SAP to the Cloud and the users correspond to the SAP Users, the default implementation of E4C adds a prefix "U/". This makes sense, the usernames (sometimes generated from the SAP Users, sometimes from Personal Numbers) to be unique. However, it can be inconvenient to use. The username can be renamed when granting the authorizations. But if they are not renamed, then the usernames including this prefix must be entered while logging in. If you check this switch on, the usernames based on the SAP users sent from SAP to the cloud will not contain this prefix.

Use cloud user

If switched on the SAP user of the cloud user is used to post changes in SAP whenever technical possible. Otherwise the technical user executing the IDOCs is used for postings and will appear in change documents.

Please note that in case where the users are created just with Personal number without ERPUSER marking this option will lead to an error in processing idocs such as "No user found".

Check event queue

E4C creates during saving of different relevant objects events. These events are either directly updated in dialogue mode or stored in the event queue. In the case of selecting event queue following settings are verified: Directly at the beginning of the updating it is checked if further events belonging to the same object exist, if so creation of the event is stopped.

Hash algorithm

Definition of HASH algorithm to be used for HASH-comparison.

Wait time lock (obsolete)

Wait time for E4C lock in seconds.

EQ.Hist.act

The checklists, which are bound to the equipment via the GOS Link, will be also presented as the documents in the Serial Number History.

VKPB active

When the price calculation is performed using the transaction VKPB (Run new price calculation), then the materials involved in this calculation will be sent to the Cloud as a side effect. Once the material data is sent to the Cloud, the price of the material is sent as well. So, if the execution of the VKPB changes the material price, the updated price will be sent to the Cloud as well.
Additional notes: Could cause a performance overhead if VKPB not scheduled to run on a lull time.

Field name in ConfNo

A field in COBL Structure (an append field or a standard field) which can be used when the service order confirmation is created. It allows the costs analysis to be related to the operations of the service orders. It is used also by the Confirmation Cockpit – the link between the CO document and the operation of the service order.

ImageConversion

How to convert pictures when printing them as part of a Checklist. This is because SAP can only work with 256 colours in a Smartform.

  • S – Server Conversion, requires a conversion tool in SAP

  • G – GUI Conversion, requires a conversion tool on the client

  • N – No Conversion, pictures remain unchanged when printed

Image Magic folder

Path to find the conversion tool for pictures

FSM Activity (obsolete)

This is to set so that custom activity from the connector is used (also known as E4C activity) instead of the standard sales activity (CAS). From (s4)pacg 200 sp07 this setting is used by default and no longer visible in transaction. Such solution helps avoid misconfiguration.

HR travel expense

Necessary for expenses to be properly posted to travels when using E4C activities (based on customizing in https://proaxia-prod-doc.atlassian.net/wiki/spaces/PFCC/pages/31953879 ).

BP used

This field indicates whether BP transaction is in use.

If the field is not checked, then inbound Contact objects (e.g. generated during customer creation in the Self-service module) will be stored as ‘Contact Person’ of the related Customer. This setting (BP used = false) is recommended for SAP ECC systems.

 If this field is checked, then inbound Contact objects will be stored in SAP as new Business Partners with partner role ‘Contact Person'.

Please note that this setting (BP used = true) is recommended and automatically defaulted for SAP S4 systems

DMS active (obsolete)

Starting from FSM Cloud Connector Add-On version 200, the entire attachment configuration should be maintained with transaction https://proaxia-prod-doc.atlassian.net/wiki/spaces/PFCC/pages/842661889. Attachment-related fields in company configuration transactions (, ) should no longer be used. All three storage types (GOS, BDS, DMS) can be used in parallel.

DMS Active flag.

Check queue

Check for queue gap and resend

Stop low at / Rel. low at

If the standard queue is in processing (queue has no stop entry) the system checks the amount of entries in the queue. If the amount is equal or bigger than the ‘Stop low at’ value, the low priority queue should be stopped (only if the queue is not already stopped). If the amount of entries is equal or smaller than the ‘Rel. low at’ value, the low priority queue will be released (only if the queue is stopped). If one of the values is empty the new functionality is deactivated. The second value needs to be smaller than the first one.

Incoming confirmation

Specify which queue will be used for processing of inbound confirmations.

Technical note

Such confirmations are generated after transferring an object to SAP FSM and are handled by function /PACG/ECM_X_IDOCCONF. They are necessary for an outbound idoc to be set to status 41.

Inbound confirmations used to be processed by queue /PACG/ECM_STD_IN. The current options include:

  • Standard queue - /PACG/ECM_STD_WS

  • Confirmation queue - /PACG/ECM_CNF_WS

  • Confirmation queue for each company - /PACG/ECM_CNF_WS_xxxx [where ‘xxxx’ is the company number]

  • (S4)PACG 200 SP10 bgRFC processing - to improve performance of inbound documents processing, use bgRFC instead of tRFC mechanism. When selected, after clicking enter, an input option bgRFC destination is displayed at the bottom of the screen:

This additional field is ‘bgRFC destination name’ as defined with SBGRFCCONF transaction. ‘bgRFC destination‘ is a mandatory parameter required for processing to start. 

Outbound confirmation

Specify which queue will be used for processing of outbound confirmations. The options include:

  • Standard queue - /PACG/ECM_STD_OUT_xxxx [where ‘xxxx’ is the company number]

  • Confirmation queue - /PACG/ECM_CNF_OUT_xxxx [where ‘xxxx’ is the company number]

(s4)pacg 200 sp11Idoc Express Queue

When enabled then Connector can use so called express queue. This queue works in such a way that if any object is added to it all the other Connector related queues are stopped to make a space for this one to process. When express queue is emptied then FSM Connector restarts previously blocked queue. Objects can be added to the express queue with the BAdI /PACG/ECM_IDOC_EXP_QUEUE. The BAdI has only one method SET_EXP_QUEUE which, based on received data, decides if message should be added to express queue or not.

Incoming message

Specify which queue will be used for processing of inbound messages. Inbound messages used to be processed by queue /PACG/ECM_STD_IN. The current options include:

  • Standard queue - /PACG/ECM_STD_WS

  • Standard queue for each company - /PACG/ECM_STD_WS_xxxx [where ‘xxxx’ is the company number]

  • (S4)PACG 200 SP10 bgRFC processing - to improve performance of inbound documents processing, use bgRFC instead of tRFC mechanism. When selected, after clicking enter, an input option bgRFC destination is displayed at the bottom of the screen:

    This additional field is ‘bgRFC destination name’ as defined with SBGRFCCONF transaction. ‘bgRFC destination‘ is a mandatory parameter required for processing to start. 

Inbound queue

If checked, inbound idocs will be created and processed using the inbound queue (SMQ2), instead of the outbound queue (SMQ1). Inbound confirmations will also be processed using the inbound queue.

Example of an inbound message processed by the Inbound Queue (SMQ2):

Example of an inbound confirmation processed by the Inbound Queue (SMQ2):

BAdI for parallelization of inbound processing

Implement BAdI /PACG/ECM_IN_QUEUE to create more than one queue for inbound idoc processing. The BAdI can change queue name based on company ID and idoc content.

Bulk processing

When this function is enabled XML objects created based on the outbound IDocs are combined together and sent to Message Broker in a single call. The number of XML packed together is controlled by the value of Trans/LUW parameter

(s4)pacg 200 sp05 Failover MB

Enable use of the failover mechanism with the message broker

No lock event

Do not use lock in service order event.

During processing of the service order event, a lock with the order number can be set in a subsidiary table. If the lock is set and the next event for the same order is triggered, then the second one waits until the first one is processed.

(s4)pacg 200 sp09 RFC Connection

During inbound processing, FM /PACG/ECM_S_INPUT responsible for initial FSM message handling, is called by default without destination specified. This means that tRFC with destination NONE is used, which can cause performance issues (destination NONE can be used by various other processes, it can cause delay of even 15 minutes and cause transporter to resend a message to SAP). To limit negative impact on inbound processing performance, enter in the hereby described field the name of an internal or logical RFC Connection (Destination) dedicated to FSM Cloud Connector processes. The RFC Connection should be created and adjusted performance-wise beforehand in transaction SM59.

(s4)pacg 200 sp09 SynchrIDocProc

During inbound processing, web service function module /PACG/ECM_S_INPUT is called by default in background task. This is because FSM Cloud Connector tries to minimize the synchronous part of the call. On certain landscapes synchronous processing of IDocs however may prove to be more efficient. Enable this field to activate synchronous processing of inbound messages.

(s4)pacg 200 sp11 Per w/o FSMUser

Allow transfer of employees (personnel numbers) who are not supposed to be FSM users (i.e. are not added in ). Such employees are sent only as employee records, visible in FSM master data. No account-level user is created for them (therefore licence is not consumed).

Automatic transfer of non-FSM-user employees when added as responsible person of service calls

This option triggers automatic transfer of the employee (personnel number) used as responsible of a service call - if it hasn’t been sent before.

Example use case: a service order has a responsible person assigned to it (a personnel number). This person has nothing to do with FSM and should not be able to log in/consume licence. However their name/surname must still be visible in FSM on service call level. They cannot be added to because this would create an account-level user and consume another licence. If this checkbox is activated, personnel numbers used by service orders (and not added to the user maintainance transaction) will be automatically transferred to FSM and exist as employee master data (with no corresponding FSM user).

Manual transfer of non-FSM-user employee

If the hereby described option is enabled, transaction displays an additional checkbox - ‘Per w/o FSMUser’. When activated, employees not added as FSM-relevant users will also be transferred to FSM. This double-check is necessary to avoid transfer of too many objects.

(S4) PACG 200 SP12 ExclBrkSplitDur

When enabled, breaks will not be included in time effort’s/work time’s duration during split calculation.

By default, breaks are included in work duration during split calculation. This may result in ‘extra' hours being reported not because a technician worked more but because they took a break in the meantime. This settings allows to reduce impact of breaks on calculated labour costs.

Time entry recorded for 9 hours (10:00-19:00) with 1 hour break. In the split customizing, activity type 101 is used for the first 8h of duration, 102 for 8-12h of duration.  

The following time entries will be created, depending on the value of ExclBrkSplitDur setting:

 

Queue management

Use the fields Incoming confirmation, Outbound confirmation and Incoming message to specify which queues will be used for processing.

 

Incoming confirmations

Queue type

Description

Queue name

Standard queue

Standard processing

 

The new name of the standard queue is /PACG/ECM_STD_WS (‘WS’ refers to web service).

Confirmation queue

Processing with a new queue, dedicated for inbound confirmations

 

/PACG/ECM_CNF_WS

Confirmation queue for each company

Processing with new queues, dedicated for inbound confirmations and separate for each company

 

/PACG/ECM_CNF_WS_xxxx [where ‘xxxx’ is the company number].

 

Outbound confirmations

Queue type

Description

Queue name

Standard queue

Standard processing

/PACG/ECM_STD_OUT_xxxx [where ‘xxxx’ is the company number]

Confirmation queue

Processing with new queues, dedicated for outbound confirmations and separate for each company

/PACG/ECM_CNF_OUT_xxxx [where ‘xxxx’ is the company number]

 

Incoming messages

Queue type

Description

Queue name

Standard queue

Standard processing

The new name of the standard queue is /PACG/ECM_STD_WS (‘WS’ refers to web service).

Standard queue for each company

Processing with new queues, separate for each company

/PACG/ECM_STD_WS_xxxx [where ‘xxxx’ is the company number]

 

If you'd like to help us improve the documentation, please provide your feedback using the communication channels listed /wiki/spaces/PFCC/pages/1561427969. Learn about support possibilities here.