Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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.

Anchor
trans_luw
trans_luw
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 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.

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

Status
title(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 ).

Info

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

BP used

This field indicates whether BP transaction is in use.

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

DMS active (obsolete)

Note

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.

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]

Info

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

  • Status
    title(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]

Info

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

Status
title(s4)pacg 200 sp11
Idoc Express Queue

When enabled then , the Connector can use utilize a so-called express queue. This queue works in such a way that if any operates as follows: when an object is added to it, all the other Connector-related queues are stopped paused to make a space for this one to process. When room for processing. Once the express queue is emptied then , the FSM Connector restarts resumes previously blocked queuequeues. Objects can be added to the express queue with using the BAdI /PACG/ECM_IDOC_EXP_QUEUE. The BAdI has features only one method, SET_EXP_QUEUEwhich, based on received data, decides if , which determines whether a message should be added to the express queue or notbased on received data.

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]

Info

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

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

Expand
titleExamples

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

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

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

Info

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

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

Info

If used, field RFC Connection is not considered.

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

Status
title(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).

Info

Prerequisite - the setting https://proaxia-prod-doc.atlassian.net/wiki/spaces/PFCC/pages/37138277/PACG+ECM+USERG+User+General+Settings#Only-users must be disabled.

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.

Status
title(S4) PACG 200 SP12
ExclBrkSplitDur

When this feature is enabled, time breaks will not be included in time effort’s/work time’s duration 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.

Expand
titleExample

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

...