Event Logging

Important:                           See Additional Logging Setup, above, for information on additional required setup that controls the level of detail in the logs and whether to log activity.

Probability Rules

Controls the logging to take place when applying probability rules to locate items requests and other activities that require evaluation of availability in a product location. Possible settings:

•         Errors only: log an error if probability rule evaluation results in an error. Default setting.

•         Nothing: do not log probability rule activity.

Detailed logging is not supported for probability rules.

See Probability Rule Overview for background.

Location Product Import

Controls the logging to take place when importing product and inventory information from an external system, including the incremental import program. Possible settings are:

•         Detailed: log errors and write other updates when importing information.

•         Errors only: log activity only when an error occurs during imports.Default setting.

•         Nothing: do not log activity based on product or product location imports or the incremental import.

See Schedule Jobs and the Incremental Inventory Import for background.

User Interface

Controls the logging to take place for activity in the Order Broker user interface. If this field is set to:

•         Detailed: Creation, update, and deletion of records are logged.

•         Deletions: Deletions only are logged.

•         Errors Only: Errors only are logged. Default setting.

•         Nothing: No screen activity is logged.

Trace Shopping Logic

Controls whether to track why individual locations are filtered when the Routing Engine selects a location to source an order. If this field is set to:

•         Detailed: The reasons why the Routing Engine filters individual locations from sourcing an order are tracked, and available for review at the Trace Shopping Log screen.

•         Nothing: Shopping logic is not traced.

Oracle recommends that shopping logic tracing be enabled only when needed to research shopping logic questions, and otherwise tracing is turned off in order to avoid impairing performance.

For more information: See the Trace Shopping Log screen.

Integrated Message Logging

All personally identifiable information for customers, vendors, or locations is removed from logs. Personally identifiable information includes names, address, email addresses, phone numbers, customer numbers, and tender accounts.

The personally identifiable information is replaced in the log with the text *** Removed by Logger ***. For example, the email address might appear in the log as <email>*** Removed by Logger ***</email>.

Order Broker Request/Response

Controls the logging that is related to the Routing Engine request and response messages, including geocode requests and responses if you use the Oracle Maps Cloud Service (see Proximity Locator Searching for background). Set this option to:

•         Everything: 

•         log XML messages and JSON messages, including the ProductUpdate, LocationUpdate, and LocationDetail messages and interactive inventory request messages. The availability service request messages are generated only when the Connection Type at the System screen is set to URL.

•         log incorrectly formed XML messages.

•         Errors Only: log incorrectly formed XML messages and incorrect JSON messages. Default setting.

•         Nothing: do not log any activity based on Routing Engine requests and responses.

Drop Ship Request/Response

Controls the logging that is related to the Supplier Direct Fulfillment request and response XML messages. Set this option to:

•         Everything: log all messages, including log incorrectly formed XML messages.

•         Errors Only: log formed XML messages. Default setting.

•         Nothing: do not log activity.

Vendor Portal Request/Response

Controls the logging that is related to communication between Order Broker and an integrated vendor that use JSON messages. Set this option to:

•         Everything: log JSON messages (getDSOrders, getDSShipConfirm, and setDSAcknowledge request and response messages, including incorrectly formed JSON messages.

•         Errors Only: log incorrectly formed JSON messages. Default setting.

•         Nothing: do not log activity for integrated vendor messages.

Integrated Shipping Request/Response

Controls the logging that is related to the integrated shipping option in the Vendor Portal and Store Connect. Set this option to:

•         Everything: log messages between Order Broker and the integrated shipping provider.

•         Errors Only: log incorrectly formed messages. Default setting.

•         Nothing: do not log messages between Order Broker and the integrated shipping provider.

Inventory Request/Response

Controls the logging that is related to the availability update request and response, and the inventory request and response between Order Broker and SIM or EICS. Set this option to:

•         Everything: log availability update request and response messages, and any errors such as an invalid request message.

•         Errors Only: log incorrectly formed messages. Default setting.

•         Nothing: do not log availability update request and response messages.

Email Notifications

Language

Controls the language to use for proximity uploads notifications.

Supported languages: Only the following languages are currently available:

•         Brazil-Portuguese

•         China-Chinese (simplified)

•         France-French

•         Germany-German

•         Italy-Italian

•         Japan-Japanese (Gregorian calendar)

•         Netherlands-Dutch

•         Russia-Russian

•         Spain-Spanish

•         Sweden-Swedish

•         United States-English (default)

Note:             

•         The selected language applies only to the Proximity Upload Status Email generated through the Proximity Uploads screen. The Incremental Inventory Import Status Email, Product Import Status Email, and Order Broker Polling Status Email use the language specified for the organization; see the Edit Organization screen. Emails generated to customers or vendors are in English.

•         Your selection applies immediately after you select Save.

Proximity Data Load

Controls the generation of email notifications when you upload proximity data through the Proximity Uploads screen. Possible settings:

•         Administrator: generate an email notification to the Administrative email.

•         User only: generate an email notification to the email specified at the User Profiles screen for the user who submitted the upload.

•         Admin and User: generate email notifications to the email specified at the for the user who submitted the upload and to the Administrative email.

•         Nothing: do not generate an email. Default setting.

See Proximity Upload Status Email for more information.

Location Product Import

Controls the generation of email notifications when importing product, system product, product barcode, location, and product location information from an external system. Possible settings:

•         Administrator: generate an email notification to the Administrative email. Default setting.

•         Nothing: do not generate an email.

See the Product Import Status Email for more information.

User Interface

Controls the email generation of email notifications for activity that takes place using the Order Broker user interface. Additional information will be provided by Oracle at a later date.

Incremental Inventory Import

Controls the generation of email notifications when the Incremental Inventory Import does not run successfully. Possible settings:

•         Administrator: generate an email notification to the Administrative email if Order Broker cannot retrieve updated inventory information.

•         Nothing: do not generate an email if Order Broker cannot retrieve inventory updates. Default setting.

For more information: See the Incremental Inventory Import.

Email Settings

Administrative email

The email address to receive system-wide email notifications, including the Proximity Upload Status Email, Incremental Inventory Import Status Email, and Product Import Status Email. You can enter multiple email addresses, separating each with a semicolon (;).

Note:             

•         Order Broker uses this email address, rather than the email address specified for the admin user at the User Profiles screen.

•         If you do not specify an internal email address, contact your email systems administrator to reset your mail server configuration to enable Order Broker to generate emails to addresses outside your company domain.

From Email

The “from” email address to appear on generated emails; depending on your mail server configuration, this might need to be an existing email address.

Note:  You need to change the delivered email address to one that is approved by Oracle in order to be used as a return address on an email generated by Order Broker. Please contact your Oracle Representative to have this email address added.

Event Notifications

Use these fields to configure Order Broker to generate a job notification web service message to an external system each time one of the following job completes:

•         Auto Cancel Unclaimed Pickup Orders

•         Completed Order Private Data Purge

•         Daily Clean Up

•         Email Notifications

•         Fulfilled Inventory Export

•         Incremental Inventory Import

•         Inventory Quantity Export

•         Product Import

•         Incremental Inventory Import

For more information: See the Job Notification Messages appendix in the Operations Guide for details on the message contents and troubleshooting information.

Job Notification URL

The URL to receive the job notifications. Up to 255 positions.

Note:  When the Authentication Type is set to OAuth, the URL must implement getAuthToken to obtain the token.

Note:  Oracle staff need to make sure that this URL is added to the allow list.

Wait Time

The number of seconds to wait for a response. Defaults to 30. Required.

Note:  A response is not required.

Authentication Type

Indicates whether to use Basic or OAuth authentication.

When the authentication type is Basic, you need to enter:

•         User ID

•         Password

When the authentication type is OAuth, you need to enter:

•         Client ID

•         Client Secret

See Manage External Application Access for background.

User ID

The user ID to use for authenticating the message in the system receiving the notification.This field is available only when the Authentication Type for a URL connection is set to Basic; otherwise, the Client ID field is available.

Up to 50 positions. Required when a Job URL is specified and Basic authentication is selected.

Password

The password to use for authenticating the message in the system receiving the notification. Available only when a URL is specified and when the Authentication Type is set to Basic; otherwise, the Client Secret field is available. Required when Basic authentication is selected.

Your entry is masked on the screen and encrypted in the database.

Client ID

Identifies Order Broker as a client application for authentication using OAuth. Available only when the Authentication Type is OAuth. Required when OAuth authentication is selected.

For more information: See Manage External Application Access for background on OAuth authentication.

Client Secret

The client secret to authenticate Order Broker as a client application in order to obtain a token. Available only when the Authentication Type is OAuth. Required when OAuth authentication is selected.

For more information: See Manage External Application Access for background on OAuth authentication.

Retry Attempts

Determines the number of times to attempt to retry sending a notification if there are communication issues. If this field is set to:

•         0, Order Broker does not attempt to resend a notification.

•         1-100, Order Broker retries sending the notification the specified number of times, using the Retry Attempt Wait Time as the interval to pause between retry attempts.

Defaults to 0. A value from 0 to 100 is required.

Retry Attempt Wait Time

The number of minutes to wait between retry attempts. Must be set to a number from 1 to 60 if the Retry Attempts is not set to 0. Defaults to 0.

# of Current Retry Attempts

The total number of job notifications that Order Broker will attempt to retry after the next Retry Attempt Wait Time has elapsed. Display-only.

# of Held Failed Notifications

The total number of notification attempts that have failed. This total can include multiple attempts for the same notification. Held attempts are retained so they can be retried periodically, based on the Retry Attempt Wait Time. Display-only.

A number of failed notifications often indicates that the URL is incorrect or not available, the port number is incorrect, or that the authentication credentials are incorrect.

Maximum retry attempts: After 50,000 failed attempts, Order Broker stops retrying to send the job notifications.