Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 66 Next »

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

Customizing options

Communication

1

Stop communication from SAP to FSM

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).

2

Bulk processing

When the ‘Bulk processing’ option is enabled, objects sent to FSM are removed from the SAP standard queue (processed from a system perspective) and placed into an internal, dedicated Connector’s queue. If the number of objects reaches the predefined limit or there are no more relevant objects in the standard queue to select, the Connector combines all the objects and sends them to the message broker in a single call. This optimization ensures that the related web service is invoked once instead of being called individually for each message. The maximum number of messages that can be sent together is controlled by the parameter ‘Transactions per LUW.’

Enabling this flag can improve message sending time in highly loaded systems, but it must be used cautiously. The solution relies heavily on data selection from the ARFCSDATA table, so it’s possible that obtaining data from this table may take longer than the system saves by limiting the number of web service calls.

3

Activate low-prio queue

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.

4

Stop low-prio queue

5

Select type of queue of outgoing conf.

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]

For more details, see chapter Queue management, subchapter Outbound confirmations down below.

6

(S4)PACG 200 SP11Use of express queue for outgoing Idocs

When enabled, the Connector can utilize a so-called express queue. This queue operates as follows: when an object is added to it, all other Connector-related queues are paused to make room for processing. Once the express queue is emptied, the FSM Connector resumes previously blocked queues. Objects can be added to the express queue using the BAdI /PACG/ECM_IDOC_EXP_QUEUE. The BAdI features only one method, SET_EXP_QUEUE, which determines whether a message should be added to the express queue based on received data.

7

Use 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.

 Examples

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.

8

Type of queue for incoming messages

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]

For more details, see chapter Queue management, subchapter Incoming messages down below.

  • (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. 

9

Type of queue of incoming confirmations

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:

  1. Standard queue - /PACG/ECM_STD_WS

  2. Confirmation queue - /PACG/ECM_CNF_WS

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

For more details, see chapter Queue management, subchapter Incoming confirmations down below.

  1. (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. 

10

Unconf.IdocsAge

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

11

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

12

Don't save Logs

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

13

No Log Fullsync

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

14

Reduce E4C Log

Reduce E4C log.

15

No "U/"

Due to various historical reasons, user IDs for FSM users based on SAP user names were initially always prefixed with ‘U/’—similarly to how user IDs for FSM users based on HR personal numbers are prefixed with ‘X/’. However, during a certain period, the user’s ID was also used as the FSM login name, making the ‘U/’ prefix inconvenient. As a result, a feature flag was implemented to allow disabling the ‘U/’ prefix (while IDs for FSM users based on HR records still retain the ‘X/’ prefix).

However, since the user’s ID and ‘FSM login name’ became separate properties, this flag has become essentially irrelevant—the ‘FSM login name’ is now always sent without any prefix.

16

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".

17

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.

18

Hash algorithm

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

19

Wait time lock (obsolete)

Wait time for E4C lock in seconds.

20

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.

21

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.

22

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.

23

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

24

Image Magic folder

Path to find the conversion tool for pictures

25

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.

26

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 ).

Learn more about expenses posting to trips: Expense posting to trips.

27

BP used

This field indicates whether BP transaction is in use.

 Click here to expand...

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

28

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 (https://proaxia-prod-doc.atlassian.net/wiki/spaces/PFCC/pages/31953211, https://proaxia-prod-doc.atlassian.net/wiki/pages/resumedraft.action?draftId=31952515) should no longer be used. All three storage types (GOS, BDS, DMS) can be used in parallel.

DMS Active flag.

29

Check queue

Check for queue gap and resend

30

(S4)PACG 200 SP05 Failover MB

Enable use of the failover mechanism with the message broker

31

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.

32

(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.

If used, keep field SynchrIdocProc inactive. SynchrIdocProc has higher priority.

33

(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.

If used, field RFC Connection is not considered.

On a reference system, synchronous idoc processing allowed for processing of ca. 4 messages/second.

34

(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 https://proaxia-prod-doc.atlassian.net/wiki/spaces/PFCC/pages/975601665). 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 https://proaxia-prod-doc.atlassian.net/wiki/spaces/PFCC/pages/975601665 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 https://proaxia-prod-doc.atlassian.net/wiki/spaces/PFCC/pages/37138800 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.

35

(S4) PACG 200 SP12 ExclBrkSplitDur

When this feature is enabled, time breaks will not be included in the overall duration of time effort or work time 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.

 Example

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:

image-20240130-102137.png

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]

  • No labels