7Scheduling Using Oracle Real-Time Scheduler Version 2.x

About Using Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x

Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x is available as an alternative to Siebel Scheduler. Siebel Scheduler is available only to new customers in controlled availability. For more information, contact your Oracle sales representative. For more information about Siebel Scheduler, see Scheduling Using Siebel Scheduler.

You can specify the scheduling method to use for each service region. For more information about migrating service regions, see Administering Service Regions.

About Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x

Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x extends or replaces the existing Siebel Scheduler capabilities to provide Siebel Field Service customers with support for real-time scheduling, street-level routing, and other features available through Oracle Real-Time Scheduler 2.x. For more information about the technical aspects of this integration, see Siebel Field Service Integration to Oracle Real-Time Scheduler Implementation Guide.

Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x supports languages that both Siebel Business Applications and Oracle Real-Time Scheduler 2.x support. Supported languages include, for example, French but not Hebrew.

You can implement language deployments for this integration in one language or in multiple languages. Siebel Field Service sends the logged in user's language to Oracle Real-Time Scheduler 2.x. For more information, see About Service Regions. For language support for Oracle Real-Time Scheduler 2.x, see the documentation for Oracle-Real-Time Scheduler in About Documentation for Oracle Real-Time Scheduler 2.x. For language support for Siebel Business Applications, see Siebel Global Deployment Guide and Siebel System Requirements and Supported Platforms on Oracle Technology Network.

Note: For Siebel CRM product releases 8.1.1.9 and later and for 8.2.2.2 and later, the system requirements and supported platform certifications are available from the Certification tab on My Oracle Support. For information about the Certification application, see article 1492194.1 (Article ID) on My Oracle Support.

Oracle Real-Time Scheduler 2.x error messages appear only in the language of the logged in Siebel Field Service user.

You can programmatically access some of the functionality for Siebel Field Service Integration to Oracle Real-Time Scheduler 2.1 through Siebel business services. For example, business service methods can be invoked from a workflow process. For more information about these business services and methods, see Business Service Methods for Siebel Field Service Integration to Oracle Real-Time Scheduler.

For more information about method arguments, review the business services and associated data in Siebel Tools. For more information, see Using Siebel Tools, Configuring Siebel Business Applications, and related documentation.

About Documentation for Oracle Real-Time Scheduler 2.x

For more information about tasks that you perform in Oracle Real-Time Scheduler 2.3, see the documentation for Oracle Real-Time Scheduler 2.3. Go to Oracle Software Delivery Cloud, and click the Oracle Utilities Applications product pack.

Related Books

  • Oracle Real-Time Scheduler V2.3.0 Release Notes

  • Oracle Real-Time Scheduler V2.3.0 Quick Install Guide

  • Oracle Real-Time Scheduler V2.3.0 Install Documentation

  • Oracle Real-Time Scheduler V2.3.0 User Documentation

  • See also the readme files and release notes for Oracle Real-Time Scheduler 2.3 products.

About User Profiles for Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x

User profiles apply to the business functions of the integration that do not include technical functions, such as installation or system administration. For more information about the integration flows for these activities, see Siebel Field Service Integration to Oracle Real-Time Scheduler Implementation Guide. For more information about field service tasks that you perform using Siebel Business Applications, see other chapters of this guide.

The major user profiles for this integration follow:

  • Business administrator. Responsible for performing business administration tasks in the Siebel Business Applications (Siebel Service, with Siebel Field Service) and in Oracle Real-Time Scheduler 2.x.

    Tasks for the Siebel application include employee administration, schedule administration, and address administration. Tasks for Oracle Real-Time Scheduler 2.x include shift template administration, speed time window settings, enhancement of employee data, and so on.

    Most deployments have from one to ten business administrators.

  • Dispatcher. Responsible for dispatch management, shift management, and user map management. The dispatcher performs tasks in Oracle Real-Time Scheduler 2.x application.

    Typically, each service region has one or two dispatchers.

  • Call center agent or customer service representative. Responsible for handling calls in the call center or other customer communications. Agents determine whether they must deploy a field service engineer to the customer location, and can book a suitable appointment for a field service engineer to visit the customer.

    The number of agents varies widely by deployment and commonly includes from ten to ten thousand agents. A typical number of agents is several hundred.

  • Field service engineer. Responsible for performing assigned service activities at customer sites or other locations. These people create and manage data on remote devices, using Siebel Mobile or Siebel Mobile Application for Siebel Service.

    The number of field service engineers varies widely by deployment and commonly includes from a few hundred to a few thousand engineers.

About Service Regions

Service regions in the Siebel Business Applications map to service areas in Oracle Real-Time Scheduler 2.x. For information about defining and mapping service regions, see Administering Service Regions.

About Employee Administration

Siebel documentation provides information about creating and administering employees in the Siebel application. However, some fields apply to Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x, and some requirements related to how such data is used in Oracle Real-Time Scheduler 2.x apply. For more information about creating and administering employees in the Siebel application, see Siebel Security Guide and Siebel Applications Administration Guide.

    Integration Changes for Employee Administration

    For this integration, some of the changes and requirements for administering employees are as follows:

    • Select appropriate values in the Start Shift From and End Shift At fields to reflect the employee logon and logoff points of the shift for the employee. LOVs- Home (Travel Incl.) and Home (Travel Not Incl.) both point to Home address with no difference for this integration.

    • Populate Start Home Address or Start Depot Address and End Home Address or End Depot Address data for employees with corresponding latitude and longitude values. Use GeoCode Start Address and GeoCode End Address buttons to geocode start and end address. For more information about associating geocodes with addresses, see Administering Addresses.

    • Start Home Address or Start Depot Address and End Home Address or End Depot Address data in the Siebel application correspond to employee logon and logoff addresses in Oracle Real-Time Scheduler 2.x. This Oracle Real-Time Scheduler 2.x data is mandatory.

    • Start Date and End Date fields are included for each employee. (For a terminated employee, set the End Date field to the last date of employment, and Siebel Field Service updates Oracle Real-Time Scheduler 2.x accordingly.)

    • Select Service Region and Schedule for the employee.

    • The following fields do not apply to this integration and are not synchronized with Oracle Real-Time Scheduler 2.x:

      • Service Role

      • Cost Per Hour

      • Overtime

      Sending Employee Data to Oracle Real-Time Scheduler 2.x

      Employee data is sent to Oracle Real-Time Scheduler 2.x when the employee is associated with a service region configured for scheduling by Oracle Real-Time Scheduler 2.x.

        Maintaining Employee Skills

        A business administrator maintains employee skills and skill items in the Assignment Skills view in the Employee view of the Administration - User screen. If an employee is associated with a service region configured for scheduling by Oracle Real-Time Scheduler 2.x, then any updates to employee skills are automatically synchronized with Oracle Real-Time Scheduler 2.x. These changes are picked up for scheduling through the shift generation process. For more information, see About Documentation for Oracle Real-Time Scheduler 2.x.

          Maintaining Employee Schedules and Exceptions

          A business administrator associates a schedule (available and unavailable hours) with an employee in the Service Details view in the Employees view of the Administration - User screen.

          A business administrator also maintains employee exception hours for the employee in the Employee Exception Hours view in the Employees view of the Administration - User screen. Employee Exception Hours with a Working flag unchecked and associated with an address are considered a Period Of Unavailability (PoUs) in Oracle Real-Time Scheduler 2.x. Employee Exception Hours with a Working flag unchecked and without an associated address are considered Leaves in Oracle Real-Time Scheduler 2.x. Employee Exception Hours with a Working flag checked are mapped as a new shift in Oracle Real-Time Scheduler 2.x.

          Note: For more information, refer to How the Connector Updates Employee Data in Real Time in the Siebel Field Service Integration to Oracle Real-Time Scheduler Implementation Guide.

          In the Schedules view of the Administration - Service screen, you can define the schedules that appear in the Schedule field.

          Any updates to schedules that are associated with an employee or to employee exceptions are updated in Oracle Real-Time Scheduler 2.x.

            About Performing Schedule-Related Tasks in Oracle Real-Time Scheduler 2.x

            Some tasks related to scheduling are specific to Oracle Real-Time Scheduler 2.x. Such tasks include defining and administering slots and slot groups, cost profiles, and other entities. Observe all applicable dependencies. For more information about the tasks that you perform in Oracle Real-Time Scheduler 2.x, see the documentation for Oracle Real-Time Scheduler 2.x in About Documentation for Oracle Real-Time Scheduler 2.x.

            The following task is specific to Oracle Real-Time Scheduler 2.x:

            • You define slots and slot groups in Oracle Real-Time Scheduler 2.x. However, the display value of the Slot Group LOV (LOV type SLOT_GROUP_CD) in the Siebel application must be the same as the slot group name in Oracle Real-Time Scheduler 2.x.

            For details on configuring Oracle Real-Time Scheduler 2.x for integration with Siebel Field Service, see the Siebel Integration Starter Pack documentation included in the Integration Patch.

            About Appointment Booking for Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x

            Schedules are maintained in Siebel Field Service and are synched to Oracle Real-Time Scheduler 2.x along with employees associated to Service Regions that are scheduled in Oracle Real-Time Scheduler 2.x. For more information about schedule administration in Siebel, see Process of Administering Schedules Using Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x.

            In a typical scenario for appointment booking, a customer contacts your company and requests service of some kind. Commonly, the customer contacts your company on the telephone. Alternatively, the customer might send email, use chat, or visit a sales or service counter in a store.

            A customer service representative uses the Siebel application to create a service request to capture information about the customer issue. If the representative cannot resolve the issue by consulting a knowledge base or a product specialist, then a customer visit (on-site service call) from a field service engineer might be necessary.

            The customer service representative enters additional information in an activity for the service request, then books a specific appointment time or appointment window (slot) for the customer, and confirms the appointment with the customer. For more information, see Booking Appointments Using Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x.

            You book appointments for the particular service region that matches the zip code or equivalent postal code for the customer. Appointment booking uses the scheduling product associated with the service region. This scheduling product is Oracle Real-Time Scheduler 2.x or Siebel Scheduler. For more information about appointment booking using Siebel Scheduler, see About Appointment Booking for Siebel Scheduler.

            Using Oracle Real-Time Scheduler 2.x, a customer service representative can book an appointment for a service region if the service region was successfully migrated to Oracle Real-Time Scheduler 2.x, and if the Engine field on the service region is ORS.

            The Engine field value determines whether the slot request is routed to Oracle Real-Time Scheduler 2.x or Siebel Scheduler as follows:

            • If the Engine value is ORS, then the request is routed to Oracle Real-Time Scheduler 2.x.

            • If the Engine value is iLog, then the request is routed to Siebel Scheduler.

            You book appointments for activities from the Service screen or the Activities screen. For more information about working with service regions, see Administering Service Regions.

              Manually Updating Booked Activities

              You can click Update Activity to synchronize manual updates for a booked activity with Oracle Real-Time Scheduler 2.x. However, updating the activity status automatically triggers an update in Oracle Real-Time Scheduler 2.x. For information about updating the activity status, see Service Activities. For information about working with activities in Siebel Mobile applications, see Siebel Mobile Guides on Siebel Bookshelf.

              You maintain status mapping between the activity status in the Siebel application and the activity status in Oracle Real-Time Scheduler 2.x in Oracle Fusion Middleware as a domain value mapping. For more information about this mapping, see Siebel Field Service Integration to Oracle Real-Time Scheduler Implementation Guide.

              Note: You cannot delete an activity after it is scheduled in Oracle Real-Time Scheduler 2.x.

              A customer service representative can also update assignment skills and related attributes for an activity.

              When assignment attributes change for any entity related to the job, such as a service request, activity, order, order line item, and so on, a representative must send the update to Oracle Real-Time Scheduler 2.x so it can consider the changes for reassignment. For example, a repair job has an incorrect value of Installation for the activity type. The customer service representative updates the activity type to a value of Repair. Also for example, a product is obsolete, and all customers who ordered the product automatically receive a new upgraded product.

              To send these updates, the representative can click Update Activity for the activity. Choosing this command triggers an update for the stop in Oracle Real-Time Scheduler 2.x. If no resource is available for the appropriate slot, then Oracle Real-Time Scheduler 2.x might not schedule the activity.

                User Interface Elements for Activity Schedule Detail View

                Some fields and other user interface features for this integration are included in the Activity Schedule Detail view, or developers can add these interface elements to this view and other views. Some of these fields are available only in business components. When these fields apply to your company’s requirements, developers can display the fields in the application user interface and populate field values.

                The user interface elements for this integration include the following items:

                • Time Zone. The time zone of the service region. This time zone must also be the time zone of the specified account address. Values sent to Oracle Real-Time Scheduler 2.x must represent UTC (Universal Time Coordinated) offsets, adjusted accordingly to the daylight saving time, such as UTC - 8 for Pacific Standard Time and UTC - 7 during Daylight Saving Time). (This field is only available in the business component.)

                • Slot Group. The group of slots. For more information about slots, see the documentation for Oracle Real-Time Scheduler 2.x in About Documentation for Oracle Real-Time Scheduler 2.x.

                • Account Address Pick Applet. A MVG applet that includes the Latitude and Longitude fields. Oracle Real-Time Scheduler 2.x has geocode requirements. For more information about addresses, see Administering Addresses.

                • Error Reason. The reason for the error. If a job is disabled in Oracle Real-Time Scheduler 2.x, then the error reason is populated in this field. This field maps to the Warn Text field for a stop in Oracle Real-Time Scheduler 2.x.

                • Latitude and Longitude. The geocode coordinates. Oracle Real-Time Scheduler 2.x has geocode requirements. For more information about addresses, see Administering Addresses.

                • Min Offset. The minimum offset in minutes required from start of the parent activity to start the child activity for bound jobs. For more information about bound jobs, see Scheduling Appointments with Bound Jobs.

                • Max Offset. The maximum offset in minutes required from start of the parent activity to start the child activity for bound jobs. For more information about bound jobs, see Scheduling Appointments with Bound Jobs.

                • Parent Activity Id. The row ID of the Parent activity for bound jobs. For more information about bound jobs, see Scheduling Appointments with Bound Jobs.

                  Booking Emergency and Contract-Based Appointments

                  Sometimes you might want to request and fulfill immediate or urgent appointments. For example, you might schedule some appointments because of an emergency or because of contractual obligations involving service-level agreements.

                  Oracle Real-Time Scheduler 2.x can evaluate such considerations and book an appointment for the customer. The customer service representative requests the appointment by clicking the Insert Activity button for the activity. (This button is available in the Schedule view in the Activity List view of the Activities screen.)

                  In this type of scheduling, no slots are returned to the customer service representative. The appointment is booked automatically by using the activity settings that the representative designates. An activity is inserted into the Oracle Real-Time Scheduler 2.x database. After clicking the Insert Activity button, the representative clicks Refresh Activity to get the latest details about the inserted activity.

                  For example, a service-level agreement for a customer stipulates that a booked appointment start within an hour after calling. The customer service representative can use the contract scheduling functionality to create an appointment that might not otherwise be easily fulfilled. Contract scheduling might affect other existing appointments, but Oracle Real-Time Scheduler 2.x attempts to minimize schedule disruption.

                    Refreshing Activities

                    The Refresh Activity menu option is available in the lower applet of the Activity Schedule view.

                    When you book an appointment in the Siebel application, a corresponding activity is created in Oracle Real-Time Scheduler 2.x. This activity maps one-to-one to the activity in the Siebel application. The activity is continually optimized, and the planned start, planned end, owner, and status values of the activity keep changing until the stop is dispatched to a field service engineer.

                    The Refresh Activity menu option allows the customer service representative to get the latest activity details from Oracle Real-Time Scheduler 2.x because the Siebel activity and the Oracle Real-Time Scheduler 2.x activity are not synchronized at all times. Oracle Real-Time Scheduler 2.x activity data is automatically synchronized with Siebel CRM only when the activity status in Oracle Real-Time Scheduler 2.x is Dispatched or Cancelled.

                      Canceling Appointments for Activities

                      To comply with customer requests, you can cancel scheduled appointments. The customer service representative can display the relevant activity, then click Refresh Activity to view the latest activity data from Oracle Real-Time Scheduler 2.x. As appropriate, the representative then clicks Cancel Appointment. Oracle Real-Time Scheduler 2.x frees up the appointment slot, and changes the job status to Cancel.

                      Note: The Cancel Appointment button is not available for an activity with the status of Completed.

                        Rescheduling Appointments

                        To comply with customer requests, you can reschedule scheduled appointments. The customer service representative can display the relevant activity, then click Refresh Activity to view the latest activity data from Oracle Real-Time Scheduler 2.x. As appropriate, the representative then updates the earliest and latest start times, and clicks Book Appointment. Oracle Real-Time Scheduler 2.x returns new appointment slots that the representative can select.

                          Scheduling Appointments with Bound Jobs

                          To comply with customer requests, you can book multiple appointments that have interdependent activities in Oracle Real-Time Scheduler 2.x.

                          The customer service representative must first create a parent activity and click Book Appointment. Oracle Real-Time Scheduler 2.x returns appointment slots that the representative can select. Oracle recommends selecting one of the earliest appointments to ensure that all child activities are scheduled. Next, the customer service representative creates child activities and assigns the parent activity id to the child activities. The customer service representative must also define the minimum and maximum offset times in the activity. These fields define the minimum and maximum time between the start of the predecessor and start of this activity. Oracle Real-Time Scheduler 2.x optimally schedules the child activities by using parent-child relationship and minimum and maximum offset time.

                          Finally, the customer service representative clicks Book Appointment. No time slots are returned for child activities. To get the latest status of appointments from Oracle Real-Time Scheduler 2.x, the customer service representative can Refresh the activity.

                          Note: To reschedule, update, or cancel appointments with bound jobs, all activities must be rescheduled, updated, or canceled.

                            About Activity Skills

                            In a typical Siebel Field Service scenario, a field service engineer arrives at a customer location to perform a job such as installation, upgrade, or repair. For Oracle Real-Time Scheduler 2.x to schedule the correct person to perform a job, it must determine the necessary skills to perform the job, and it must schedule a person with the required skill set to complete the work. To facilitate this outcome, the Siebel application passes the required skills to Oracle Real-Time Scheduler 2.x. For more information, see Managing Activity Skills for Skills-Based Assignments.

                            For example, a customer needs a plumber to fix a leak in a kitchen sink between 10:00 A.M. and 2:00 P.M. on November 15, 2011. Oracle Real-Time Scheduler 2.x must schedule a field service engineer with a skill value of Plumbing to visit the customer location during this time. As part of appointment booking, the request to Oracle Real-Time Scheduler 2.x includes the time and date range as well as the skill value of Plumbing. Consequently, a person with the required skill is scheduled at the appropriate time.

                              Evaluation of Activity Skill Rules

                              As part of the appointment booking process, activity skill rules are evaluated as follows:

                              1. The customer service representative navigates to the Activities screen, then the Schedule view.

                              2. The customer service representative creates an activity record, populates the necessary fields, and then clicks the Book Appointment, Insert Activity, or Update Activity button.

                              3. All active skill rules are evaluated.

                              4. For the rules with met criteria, the skills and category are sent to Oracle Real-Time Scheduler 2.x.

                                Categories include Must Have, Must Not Have, Pref Have, and Pref Not Have. For more information about these categories, see the documentation for Oracle Real-Time Scheduler 2.x in About Documentation for Oracle Real-Time Scheduler 2.x.

                              5. The lowest-ranked rules are evaluated before evaluating the next higher-ranked rule. If the criteria for the lower-ranked rule is met, then the higher-ranked rule is not evaluated.

                              6. Any skills that you manually enter in the Activity Assignment Skills view are appended to the skills obtained from the rules evaluation and sent to Oracle Real-Time Scheduler 2.x.

                                About Dispatch Management

                                Dispatch management includes tasks for viewing and managing shifts and associated entities, such as activities and breaks. The dispatcher might also view and manage maps showing locations of activities and field service engineers. You perform dispatch management tasks in Oracle Real-Time Scheduler 2.x. For more information about tasks that you perform in Oracle Real-Time Scheduler 2.x, see the documentation for Oracle Real-Time Scheduler 2.x in About Documentation for Oracle Real-Time Scheduler 2.x.

                                About Mobile Data Management

                                Field service engineers receive and send activity updates from mobile devices. Siebel administrators manage status data for field service engineers, who access functionality for Siebel Business Applications on mobile devices. After communicating offline with a field service engineer, a dispatcher might also make updates from Oracle Real-Time Scheduler 2.x. For more information about using and administering Sielbel Mobile applications, see Siebel Mobile Guides on Siebel Bookshelf.

                                  Status Data Sent to Field Service Engineers

                                  Status data that is sent to field service engineers includes the following data:

                                  • Dispatched activities

                                    Note: The Siebel Mobile application and Siebel Mobile connected application show all activities assigned to the field service engineer irrespective of the status value. Customers must set the appropriate filters to display only activities with the required status values.

                                  In addition to the dispatched data, Queued For Dispatch status activities in Oracle Real-Time Scheduler 2.x are also sent to Siebel Mobile applications and Siebel Mobile connected applications with status as Queued. Queued For Dispatch status in Oracle Real-Time Scheduler 2.x is mapped to Queued status in Siebel Field Service.

                                    Status Data Sent from Field Service Engineers

                                    Status data that is sent from field service engineers (or that dispatchers who communicate with field service engineers manually update) includes the following data:

                                    • Status for dispatched activities

                                      For example, the status is updated when the field service engineer accepts or declines a job, starts a job, or completes the job.

                                      You map activity statuses in the Siebel application to activity statuses in Oracle Real-Time Scheduler using domain value mapping in Oracle Fusion Middleware. For more information, see Siebel Field Service Integration to Oracle Real-Time Scheduler Implementation Guide.

                                      About Fault Handling

                                      The following situations for fault handling apply to Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x:

                                      • Oracle Real-Time Scheduler 2.x is unavailable, and the Siebel application sends messages to it.

                                        An issue is passed back to the Siebel application and presented to the user as an error message. An administrator can access a monitoring screen to track errors.

                                        For synchronous processes, changes in the Siebel application are not recognized until the changes are synchronized with Oracle Real-Time Scheduler 2.x. For example, if Oracle Real-Time Scheduler 2.x or Oracle Fusion Middleware is unavailable when a user updates the status of an activity, then the Siebel application displays an error message and does not recognize the update.

                                        For asynchronous processes, a table in the Siebel database contains Sync status flags. If an error occurs, then the table is updated with a value of N for the Sync status flag and an error description for the Sync Failure Description.

                                      • The Siebel application is unavailable, and Oracle Real-Time Scheduler 2.x sends messages to it through Oracle Fusion Middleware.

                                        Oracle Real-Time Scheduler 2.x attempts multiple times to access the Siebel application through Oracle Fusion Middleware to make sure that the information is delivered when the Siebel application is available.

                                      Process of Configuring Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x

                                      The following list shows the tasks that Siebel administrators typically perform to configure Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x. Your company might follow a different process according to its business requirements.

                                      To configure Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x, Siebel administrators perform the following tasks:

                                        Enabling Oracle Real-Time Scheduler 2.x in the Siebel Application

                                        Siebel administrators use the procedure in this topic to enable Oracle Real-Time Scheduler 2.x in the Siebel application. Oracle Real-Time Scheduler 2.x is an alternative to Siebel Scheduler.

                                        This task is a step in Process of Configuring Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x.

                                        To enable Oracle Real-Time Scheduler 2.x in the Siebel application

                                        1. Log in to Siebel Tools or Web Tools as Administrator (see Using Siebel Tools).

                                        2. Create a workspace.

                                        3. In the Object Explorer, navigate to Business Component, query for the Action business component, and then complete the following steps:

                                          1. Lock the object.

                                          2. Navigate to Business Component, then Business Component User Prop, and query for the Advanced Scheduler Enabled user property.

                                          3. Change the Value field to TRUE.

                                        4. In the Object Explorer, navigate to Business Component, query for the Service Region business component, and then complete the following steps:

                                          1. Lock the object.

                                          2. Navigate to Business Component, then Business Component User Prop, and query for the Advanced Scheduler Enabled user property.

                                          3. Change the Value field to TRUE.

                                        5. Deliver the changes to the Integration Branch.

                                          Configuring the Endpoint URLs for Web Services

                                          Siebel administrators configure the endpoint URLs for Web services to allow the Siebel application to communicate with Oracle Real-Time Scheduler 2.x. An endpoint URL defines the address for or connection point to a Web service.

                                          Later, they specify these endpoint URLs when configuring Oracle Fusion Middleware components to support this integration. For more information about endpoint URLs, see Siebel Field Service Integration to Oracle Real-Time Scheduler Implementation Guide and Integration Platform Technologies: Siebel Enterprise Application Integration.

                                          This task is a step in Process of Configuring Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x.

                                            Configuring the Endpoint URL for Outbound Web Services

                                            Siebel administrators use the following procedure to configure the endpoint URL for outbound Web services.

                                            To configure the endpoint URL for outbound Web services
                                            1. Navigate to the Administration - Web Services screen, then the Outbound Web Services view.

                                            2. Query for the following Web services for Oracle Real-Time Scheduler 2.x:

                                              • ABSWebService

                                              • ActivityStateRetrievalService

                                              • adminDataMgmtWebService

                                              • BatchGeoService

                                              • RealTimeService

                                              • serviceregionmigrationorchestrator_client_ep

                                              • ServiceRegionRollback_ep

                                              • ServiceRegionSystemRegionMappingWebServiceSoap

                                              • StatusUpdatesWebServiceSoap

                                              • transferschedulessblors_client_ep

                                              • transferexceptionssblors_client_ep

                                            3. For each of these Web services, navigate to the Service Ports applet, and update the Address field with a value such as hostname:portnumber, where:

                                              • hostname is the name of the computer on which Oracle Fusion Middleware is installed

                                              • portnumber is the SOA port number for this Oracle Fusion Middleware installation

                                            4. Save the record.

                                              Configuring the Endpoint URL for Inbound Web Services

                                              Siebel administrators use the following procedure to configure the endpoint URL for inbound Web services.

                                              To configure the endpoint URL for inbound Web services
                                              1. Navigate to the Administration - Web Services screen, then the Inbound Web Services view.

                                              2. Query for Web Services with a name of *ORS*.

                                              3. For each of these Web services, navigate to the Service Ports applet, and update the Address field with a value such as hostname:portnumber, where:

                                                • hostname is the name of the computer for the Siebel Application Interface that the Siebel Business Applications use.

                                                • portnumber is the listening port number for this Siebel Application Interface.

                                              4. Save the record.

                                              5. Activate all of the Web services.

                                              6. Click Generate WSDL to confirm that you can use the Web services.

                                                Assigning Responsibilities to Siebel Views

                                                Siebel administrators use the procedure in this topic to assign suitable responsibilities to the Siebel views for Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x. For more information about setting up Siebel responsibilities and associating views with responsibilities, see Siebel Security Guide.

                                                The following Siebel views are included in this integration:

                                                • Administration Scheduling Rule Objects View

                                                • Administration Skill Matching Rules - Skills View

                                                • Administration Skill Matching Rules View

                                                • Administration Skill Rule Criteria

                                                • Monitoring Scheduler Admin View

                                                • Service Region Activities Admin View - Monitoring

                                                • Service Region Employees Admin View Monitoring

                                                • Service Region Mapping View

                                                This task is a step in Process of Configuring Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x.

                                                To assign responsibilities to Siebel views

                                                1. Log in to the Siebel application using one of the following clients:

                                                  • Siebel Web Client

                                                  • Siebel Developer Web Client, with the /editseeddata command-line option

                                                2. In the Responsibilities applet, query for the Siebel Administrator responsibility you want to assign to the administration views for this integration. (For all other views, query for the appropriate responsibility as required for your deployment.)

                                                3. In the Views applet, click Add, select the first administration view you want to associate with the responsibility, and then click OK.

                                                4. Repeat Step 3 for all other views for this integration.

                                                5. After associating the views with the responsibilities, restart the component definition or the Siebel Server.

                                                  Enabling Component Groups

                                                  Siebel administrators use the procedure in this topic to enable component groups on the Siebel Server.

                                                  The following table describes the component groups that you must enable for Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x. These component groups supplement any other component groups that you need for your applications. For more information about enabling component groups, see Siebel System Administration Guide.

                                                  Table Component Groups Required for This Integration

                                                  Component Group Purpose

                                                  Workflow Management

                                                  Provides the workflow processes to run some of the asynchronous workflows.

                                                  EAI

                                                  Provides inbound Web services into the Siebel Business Applications.

                                                  This task is a step in Process of Configuring Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x.

                                                  To enable a component group

                                                  1. Navigate to the Administration - Server Configuration screen, Enterprises, and then the Component Groups view.

                                                  2. In the Component Groups view, query for Workflow Management, and then click Enable.

                                                  3. Navigate to the Administration - Server Configuration screen, Enterprises, and then the Component Definitions view.

                                                  4. In the Component Groups field, query for Workflow Management.

                                                  5. Select all of the records, and then click Synchronize.

                                                  6. Restart the Siebel Server.

                                                    Setting Up and Configuring Workflow Processes and Policies

                                                    You must perform the procedures in this topic to be able to use real-time synchronization of address and employee data from the Siebel application to Oracle Real-Time Scheduler 2.x.

                                                    This topic contains the following related information:

                                                    This task is a step in Process of Configuring Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x.

                                                      Activating Workflow Processes

                                                      Siebel administrators use the following procedure to activate workflow processes.

                                                      To activate workflow processes
                                                      1. Navigate to the Administration - Business Processes screen, then the Workflow Deployment view.

                                                      2. Query for *ORS*.

                                                      3. Click Activate.

                                                      4. Query for the Advanced Scheduler Skill Persistence Process, and click Activate for this workflow process.

                                                        Enabling Workflow Policies

                                                        Siebel administrators use the following procedure to enable workflow policies.

                                                        To enable workflow policies
                                                        1. Navigate to the Administration - Business Processes screen, then the Workflow Policies view.

                                                        2. Make sure that Expiration Date is properly set for all the workflow policies that are not in use.

                                                        3. Query for *ORS*.

                                                        4. Verify that the Expiration Date is not set for these workflow policies.

                                                          Shutting Down Workflow Monitor Agent

                                                          Siebel administrators use the following procedure to shut down Workflow Monitor Agent.

                                                          To shut down Workflow Monitor Agent
                                                          1. Navigate to the Administration - Server Management screen, Servers, then Component Groups view.

                                                          2. Query for Workflow Management.

                                                          3. In the lower Components applet, query for Workflow Monitor Agent.

                                                          4. Click Shut Down.

                                                            Dropping Database Triggers

                                                            Siebel administrators use the following procedure to drop database triggers.

                                                            To drop database triggers
                                                            1. Navigate to the Administration - Server Management screen, then the Jobs view.

                                                            2. Create a job for the Generate Triggers component.

                                                            3. In the Job Parameters list, define the job parameter with the values in the following table.

                                                              Name Value

                                                              EXEC

                                                              True

                                                              Privileged User

                                                              MS22116

                                                              Privileged User Password

                                                              (No example)

                                                              Remove

                                                              True

                                                              Trigger File Name

                                                              Droptrigger.sql

                                                              Note: The values for Privileged User and Privileged User Password must be the database user name and password that have the privileges to drop and generate triggers. The user name value in this table is an example.
                                                            4. Start the job.

                                                              Generating Database Triggers

                                                              Siebel administrators use the following procedure to generate database triggers.

                                                              To generate database triggers
                                                              1. Navigate to the Administration - Server Management screen, then the Jobs view.

                                                              2. Create a job for the Generate Triggers component.

                                                              3. In the Job Parameters list, define a job with the values in the following table.

                                                                Name Value

                                                                EXEC

                                                                True

                                                                Privileged User

                                                                MS22116

                                                                Privileged User Password

                                                                (no example)

                                                                Trigger File Name

                                                                Gentrigger.sql

                                                                Note: The values for Privileged User and Privileged User Password must be the database user name and password that have the privileges to drop and generate triggers. The user name value in this table is an example.
                                                              4. Start the job.

                                                                Configuring Workflow Monitor Agent

                                                                Siebel administrators use the following procedure to configure Workflow Monitor Agent.

                                                                To configure Workflow Monitor Agent
                                                                1. Navigate to the Administration - Server Configuration screen, Enterprises, and then the Component Definitions view.

                                                                2. Query for Workflow Monitor Agent, and perform the following steps:

                                                                  1. Change the Group Name to ORS Group.

                                                                  2. Change the Action Interval to 5.

                                                                3. Click Advanced, and perform the following steps:

                                                                  1. Change the Sleep Time value to 5.

                                                                  2. Change the Default Task value to 1.

                                                                4. Click Enable to change the status of the new component to Active.

                                                                5. Restart the Siebel Server.

                                                                  Process of Administering Schedules Using Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x

                                                                  The following list shows the tasks that business administrators typically perform to administer Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x. Your company might follow a different process according to its business requirements.

                                                                  Business administration tasks for this integration are divided between the Siebel application and Oracle Real-Time Scheduler 2.x. You manage all business administration processes that are specific to Oracle Real-Time Scheduler 2.x from Oracle Real-Time Scheduler 2.x application. Other information like employee, address, schedule, exceptions, etc. are entered and managed in the Siebel application.

                                                                  To administer Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x, business administrators perform the following tasks:

                                                                    Administering Service Regions

                                                                      Defining Service Regions Using Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x

                                                                      Business administrators define service regions in the Siebel application using the Service Regions List view of the Administration - Scheduling screen. For more information about defining service regions, see Defining Service Regions.

                                                                      The following fields for service region administration apply to scheduling using Siebel Scheduler, but do not apply to the integration to Oracle Real-Time Scheduler 2.x:

                                                                      • Cost Variables (Cost List, Currency, Travel Cost, and Cost Function)

                                                                      • Configuration Parameters (Parameter Set, Constraint Set, Time Windows, Min Travel Time, Avg Travel Time, Avg Travel Speed, and Unit Of Measure)

                                                                        Migrating Service Regions to Oracle Real-Time Scheduler 2.x

                                                                        When it is appropriate to do so according to business requirements, business administrators migrate existing service regions to Oracle Real-Time Scheduler 2.x. They migrate service regions one at a time.

                                                                        Before migrating a service region, note the following requirements:

                                                                        • Associating geocodes with address in bulk was performed in the Addresses view of the Administration - Data screen on all addresses for the service region that you migrate. For more information, see Administering Addresses.

                                                                        • Skills transfer rules were defined in the Skills Transfer - Rules Administration view of the Administration - Scheduling screen. For more information, see Managing Activity Skills for Skills-Based Assignments.

                                                                        As part of the migration, the following events occur:

                                                                        • Employees, associated Schedules, Exception Hours, addresses, and skills are transferred to Oracle Real-Time Scheduler 2.x.

                                                                        • Applicable activities that are based on defined criteria are transferred along with the associated skills. The associated skills are obtained when you click the Persist Activity Skills button.

                                                                        To migrate a service region to Oracle Real-Time Scheduler 2.x
                                                                        1. Navigate to the Administration - Scheduling screen, then the Service Region List view.

                                                                        2. Select the record for the service region that you want to migrate.

                                                                        3. Click Persist Activity Skills if activities have to be populated with assignment skills by using skill transfer rules.

                                                                          If Persist Activity Skills are not populated, then the activities being transferred to Oracle Real-Time Scheduler do not have skills associated with them.

                                                                          The applicable activities are associated with skills by using the skills transfer rules in the Skills Transfer Rules - Administration view of the Administration - Scheduling screen.

                                                                          Activity filtration for the current service region is based on the following criteria:

                                                                          • The value of the Status field for the activity must not be Done, Completed or Cancelled.

                                                                          • The value of the Latest Start field for the activity must be NULL or later than today, or the value of the Planned End field must be NULL or later than today.

                                                                        4. Click Transfer to ORS.

                                                                          When the transfer is complete, the Sync Success Description field for the service region indicates a status of Successfully Migrated to ORS, and the Engine field value changes from iLog (for Siebel Scheduler) to ORS (for Oracle Real-Time Scheduler 2.x). Also, the Transfer Complete field (if it appears) is checked.

                                                                          The service region is now ready for scheduling using Oracle Real-Time Scheduler 2.x. All subsequent appointments for this service region are scheduled using Oracle Real-Time Scheduler 2.x.

                                                                          Checking for Failed Migration of Employee and Activity Data to Oracle Real-Time Scheduler 2.x

                                                                          After business administrators migrate a service region to Oracle Real-Time Scheduler 2.x, they can check whether all applicable employees and activities migrated successfully.

                                                                          To check for failed migration of employee or activity data to Oracle Real-Time Scheduler 2.x
                                                                          1. Navigate to the Administration - Scheduling screen, then the Cutover Monitoring view.

                                                                          2. Select the record for the service region that you migrated.

                                                                          3. Click the Employees view tab to see all employees that were not migrated.

                                                                            The reason for the failure appears in the Sync Success Description field.

                                                                          4. Click the Activities view tab to see all activities that were not migrated.

                                                                            The reason for the failure appears in the Sync Success Description field.

                                                                            Associating Service Area in Oracle Real-Time Scheduler 2.x with Scheduler Area

                                                                            Before booking appointments using Oracle Real-Time Scheduler 2.x, the Service Area created in Oracle Real-Time Scheduler 2.x for the Service Region in Siebel Field Service needs to be linked to a Scheduler Area. For more information about associating service areas in Oracle Real-Time Scheduler 2.x, see About Documentation for Oracle Real-Time Scheduler 2.x.

                                                                              Rolling Back Service Regions from Oracle Real-Time Scheduler 2.x

                                                                              When it is necessary for a deployment, business administrators can roll back a migrated service region so that it again uses Siebel Scheduler instead of Oracle Real-Time Scheduler 2.x. They roll back service regions one at a time.

                                                                              After the rollback is complete, the business administrator must make sure that the requirements for scheduling the service region using Siebel Scheduler are satisfied. For information about scheduling appointments using Siebel Scheduler, see Scheduling Using Siebel Scheduler.

                                                                              Note: The schedule that is generated using Siebel Scheduler is different from the schedule that is generated using the Oracle Real-Time Scheduler 2.x engine because the optimization algorithms for the two engines are different.
                                                                              To roll back a service region from Oracle Real-Time Scheduler 2.x
                                                                              1. Navigate to the Administration - Scheduling screen, then the Service Region List view.

                                                                              2. Select the record for the service region that you want to roll back.

                                                                                The value of the Engine field must be ORS (for Oracle Real-Time Scheduler 2.x).

                                                                              3. Click Menu, and select Rollback Service Region.

                                                                                When the rollback is complete, the Sync Success Description field for the service region indicates a status of Rollback Complete, and the Engine field value changes from ORS (for Oracle Real-Time Scheduler 2.x) to iLog (for Siebel Scheduler). Also, the Transfer Complete field (if it appears) is unchecked.

                                                                                The mapping between the service region and system region is removed. In Oracle Real-Time Scheduler 2.x, the applicable employees are inactivated, and the appointments in Oracle Real-Time Scheduler 2.x are cancelled. These appointments continue to exist in the Siebel application, and can be loaded into Siebel Scheduler for scheduling.

                                                                                All subsequent activities for this service region are sent to Siebel Scheduler for scheduling.

                                                                                Administering Addresses

                                                                                Business administrators can administer addresses and related data for Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x.

                                                                                You can populate the Latitude and Longitude fields for addresses that are synchronized with Oracle Real-Time Scheduler 2.x. Oracle Real-Time Scheduler 2.x must have addresses that are associated with geocodes to successfully schedule and optimize appointments. Although you create and maintain address data in the Siebel application, you associate geocodes with addresses by using Oracle Real-Time Scheduler 2.x.

                                                                                This topic contains the following related information:

                                                                                This task is a step in Process of Administering Schedules Using Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x.

                                                                                  Associating Geocodes with Addresses in Bulk

                                                                                  Business administrators use the following procedure to associate geocodes with a large number of address records.

                                                                                  To associate geocodes with a large number of addresses
                                                                                  1. Navigate to the Administration - Data screen, then the Addresses view.

                                                                                  2. Specify criteria to query for the appropriate addresses.

                                                                                    For example, you can query for addresses in a particular zip code or equivalent postal code.

                                                                                    Note: All addresses resulting from the query are sent for bulk geocodes.
                                                                                  3. Click Bulk GeoCode.

                                                                                    A message window appears specifying the number of addresses that are sent for geocodes.

                                                                                  4. Click OK.

                                                                                    A batch operation is performed to obtain the latitude and longitude data for these addresses. The following message appears: Batch Geocode Request is submitted successfully.

                                                                                    The value in the Geocoding Fail Description field changes to Geocoding InProgress for selected records in which the Geocode Valid field is set to N.

                                                                                    Successful responses update the Latitude and Longitude fields for applicable addresses. In these cases, the Geocoding Fail Description field is cleared and the Geocode Valid field is set to Y. When multiple geocodes or no geocodes are returned for an address, the Geocoding Fail Description field is updated with the appropriate error message.

                                                                                    Associating Geocodes with Addresses for Service Regions

                                                                                    Business administrators use the following procedure to associate geocodes with addresses for a service region that they migrate to Oracle Real-Time Scheduler 2.x.

                                                                                    To associate geocodes with addresses for a service region
                                                                                    1. Navigate to the Administration - Scheduling screen, then the Service Regions List view.

                                                                                    2. Select the service region for which you want to associate geocodes.

                                                                                    3. Click the Zip Codes view tab.

                                                                                    4. Click Bulk GeoCode.

                                                                                      A batch operation is performed to update the Latitude and Longitude fields for all addresses with a zip code or equivalent postal code value that corresponds to a zip code or equivalent postal code value for the service region in the Zip Codes view.

                                                                                      Associating Geocodes with New Addresses

                                                                                      Business administrators use the following procedure to associate geocodes with new address records.

                                                                                      To associate geocodes with a new address
                                                                                      1. Navigate to the Administration - Data screen, then the Addresses view.

                                                                                      2. Create a new address record.

                                                                                      3. When the Latitude and Longitude fields for a new (or existing) address record are not populated with valid data, click Get GeoCode.

                                                                                        The Get GeoCode button also appears in the following Siebel views that display address data:

                                                                                        • Service Details view in the Employees view of the Administration - User screen

                                                                                        • Schedules view in the Activity List view of the Activities screen

                                                                                      4. Select the appropriate latitude and longitude from the GeoCode dialog box.

                                                                                        • Select Update Geocode to update only the latitude and longitude data

                                                                                        • Select Update Geocode and Address to update the latitude and longitude data and the address data

                                                                                      Note: Any manual updates to the address record update the Geocode Valid field to N, and show that the address was edited. Associate geocodes with this address record again. Both the Bulk Geocode and Real Time Geocode functions process only records in which Geocode Valid field is set to N.

                                                                                        Managing Activity Skills for Skills-Based Assignments

                                                                                        You can use Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x to manage activity skill rules during appointment booking to support skills-based assignment. For more information, see About Activity Skills.

                                                                                        This topic contains the following related information:

                                                                                        This task is a step in Process of Administering Schedules Using Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x.

                                                                                          Defining Activity Skill Rules

                                                                                          Business administrators define the required skills to work on an activity as rules in the Skills Transfer - Rules Administration view.

                                                                                          They can define a skill item as an exact value or as a selectable value, as follows:

                                                                                          • For example, the business administrator can define a skill item to include the exact value of a product or product model. The business administrator defines an activity skill rule and an associated skill item in which the value in the Product field represents a specific product or product model that the field service engineer must be skilled with, such as Model 3567.

                                                                                          • For example, the business administrator can define the skill to require that the field service engineer is skilled with the product model that is associated with the service request. The business administrator sets the Pick From Object field for the skill item to Y, and uses the Rule Object and Object Attribute fields to specify the field from which the user selects the model name.

                                                                                          To define an activity skill rule
                                                                                          1. Navigate to the Administration - Scheduling screen, then the Skills Transfer - Rules Administration view.

                                                                                          2. Create a new record to define a rule.

                                                                                          3. Drill down on the rule name to navigate to the Criteria view.

                                                                                          4. Define the criteria for the rule.

                                                                                          5. Navigate to the Skills view to define the skills and skill items for the rule.

                                                                                            Defining Rule Objects

                                                                                            A rule object defines the link between the Action entity (for activities) and any other entity, such as Service Request, Order, Order Line Item, and so on. Siebel administrators define rule objects. They must define rule objects before a business administrator can specify rule criteria.

                                                                                            If a business administrator must define a rule criteria that is based on an attribute, such as Order Type, then a Siebel administrator must establish a link between the Action business component and the Order Entry business component. When a Siebel administrator creates this link in the form of the necessary rule object, the fields of the Order Entry business component (including the Order Type field) are available in the Criteria view. A Siebel administrator establishes this link by creating a rule object between these two entities. After the rule object creation, the business administrator can pick the rule object in the Criteria field.

                                                                                            The Activity Rule Object and Activity Service Request rule objects are predefined in the seed data.

                                                                                            To define a rule object
                                                                                            1. Navigate to the Administration - Scheduling screen, then the Rule Objects Administration view.

                                                                                            2. Create a new record to define a rule object.

                                                                                              Some fields are described in the following table.

                                                                                              Field Comments

                                                                                              Rule Object

                                                                                              Type the name of the rule object. For example, if you want to establish a link between the Activity and Order Entry business components, then the name might be Activity - Order.

                                                                                              Business Object

                                                                                              Select the business object that you want to link to both the linked business components. For example, if you want to link the Action and Order Entry business components, then the Source Business Object is Order Entry.

                                                                                              Source BC

                                                                                              Select the source business component. In this example, the source is the Action business component.

                                                                                              Target BC

                                                                                              Select the target business component with fields to make available in the Criteria view. In this example, the target is the Order Entry business component.

                                                                                              Source Field

                                                                                              Select the field in the source business component that you want to join to the target field.

                                                                                              Target Field

                                                                                              Select the field in the target business component that you want join to the source field.

                                                                                              Comments

                                                                                              Type comments to describe this rule object.

                                                                                              Booking Appointments Using Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x

                                                                                              Customer service representatives can use the procedure in this topic to book appointments. For more information, see About Appointment Booking for Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x.

                                                                                              The procedure in this topic assumes that a customer service representative books the appointment from the Service screen. The representative creates the service request, and then must schedule an activity. The representative books the appointment as part of resolving the customer issue.

                                                                                              You can work with activities in many ways. Your process for working with activities depends on your company’s deployment and business requirements and on the nature of the customer communication. For more information about working with activities, see Service Activities.

                                                                                              The functionality relating to the fields in the Schedule view of the procedure in this topic works as expected only if the appropriate data for these fields was previously defined in the appropriate environment and synchronized as necessary between the Siebel application and Oracle Real-Time Scheduler 2.x.

                                                                                              To book an appointment using Siebel Field Service Integration to Oracle Real-Time Scheduler 2.x

                                                                                              1. Navigate to the Service screen, then the Service Request List view.

                                                                                              2. Create a new service request record for the customer issue, and then drill down on the value in the SR # (number) field.

                                                                                              3. In the Activities view tab, create a new activity record for the service request, and then drill down on the value in the Type field.

                                                                                              4. Click the Schedule view tab.

                                                                                              5. Complete the form fields as appropriate.

                                                                                                Some fields are described in the following table.

                                                                                                Field Comments

                                                                                                Service Region

                                                                                                Select the service region for the activity. The default service region is based on the zip code or equivalent postal code of the account address.

                                                                                                Work Time

                                                                                                Type the time needed to complete the activity. Work time data is transmitted to Oracle Real-Time Scheduler 2.x when you click the Insert Activity button or Update Activity button in this view, or when you click the Confirm button in the dialog box that appears when you click Book Appointment.

                                                                                                Duration

                                                                                                Select the time needed to complete the activity.

                                                                                                For activities scheduled using Oracle Real-Time Scheduler 2.x, Duration equals Planned End minus Planned Start, and includes only Work Time. Oracle Real-Time Scheduler 2.x does not support activity breaks. The Allow Breaks field does not apply to any activities scheduled using Oracle Real-Time Scheduler 2.x.

                                                                                                Earliest Start

                                                                                                Select the earliest time and date the activity can begin. This field usually indicates contractual commitments or deadlines. If you do not populate this field, then the current date and time are used for the appointment request.

                                                                                                Latest Start

                                                                                                Select the latest time and date the activity can begin. This field usually indicates contractual commitments or deadlines. If you do not populate this field, then the current date and time, plus seven days, are used for the appointment request.

                                                                                                Slot Group

                                                                                                Type the slot group for the customer.

                                                                                                Lock Assignment

                                                                                                Select this check box as appropriate. This field affects how appointments are returned. In general, the functionality for this field is the same as the functionality for this field in Siebel Scheduler. For more information, see Locking Assignments and Schedules for Activities (End User).

                                                                                                Lock Schedule

                                                                                                Select this check box as appropriate. This field affects how appointments are returned. In general, the functionality for this field is the same as the functionality for this field in Siebel Scheduler. Locking Assignments and Schedules for Activities (End User).

                                                                                                For Oracle Real-Time Scheduler 2.x, selecting this field locks the activity within a 20-minute window of the planned start. For example, if Planned Start is at 10:00 A.M., then the activity can start any time between 9:50 A.M. and 10:10 A.M., and is not fixed at 10:00 A.M.

                                                                                                Account

                                                                                                Select the appropriate account for the customer.

                                                                                                Account Address

                                                                                                Select the appropriate account address for the customer. If you try to book an appointment when the address does not have latitude and longitude data, then the following error message appears: The Account Address is not Geocoded. Make sure it is geocoded before proceeding.

                                                                                                You can obtain the latitude and longitude data by clicking the Get GeoCode button in this view. For more information, see Administering Addresses.

                                                                                                Min Offset

                                                                                                Select for child activities the minimum time between start of predecessor (parent) activity and start of this activity if you book related activities. This field applies only to Bound Jobs.

                                                                                                Max Offset

                                                                                                Select for child activities the maximum time between start of predecessor (parent) activity and start of this activity if you book related activities. This field applies only to Bound Jobs.

                                                                                                Parent Activity Id

                                                                                                Select the Id of the parent activity for child activities if you book related activities. This field applies only to Bound Jobs.

                                                                                              6. Click Book Appointment to request available appointment slots from Oracle Real-Time Scheduler 2.x.

                                                                                                This button is available in the Schedule view in the Activity List view of the Activities screen or in the Activities view in the Service Request List view of the Service screen.

                                                                                                The scheduling engine associated with the service region processes the request. If this integration is implemented and a service region was migrated, then the scheduling engine is set to ORS, and the request is sent to Oracle Real-Time Scheduler 2.x. For more information, see Administering Service Regions.

                                                                                                Unlike Siebel Scheduler, Oracle Real-Time Scheduler 2.x does not lock these slots. Consequently, multiple customer service representatives can see the same slot. The first representative to confirm a slot successfully completes the confirmation, and a list of available appointment slots appears. The slot confirmation fails for other representatives. Slots are confirmed on a first come, first serve basis because the Oracle Real-Time Scheduler does not block the slots that are displayed in Siebel CRM. Oracle Real-Time Scheduler 2.x might reject the selected slots if another agent booked them.

                                                                                              7. If none of the appointments are acceptable to the customer, then complete the following steps:

                                                                                                1. Click Cancel.

                                                                                                2. Adjust the appointment range as needed.

                                                                                                3. Click Book Appointment again.

                                                                                              8. Select an appointment the customer agrees to, and click Confirm.

                                                                                                Oracle Real-Time Scheduler 2.x verifies that the cost of the appointment did not change and exceed the maximum cost, and then confirms the appointment. For information about how the maximum cost is defined, see Siebel Field Service Integration to Oracle Real-Time Scheduler Implementation Guide.

                                                                                                The activity status is updated to Scheduled, and the planned start and end dates are populated.