5Using Siebel REST API For Siebel Clinical

Using Siebel REST API For Siebel Clinical

This chapter describes Siebel Representational State Transfer (REST) Services for Siebel Clinical users and how to use them. It includes the following topics:

Configuring Siebel Clinical Users

You can use Siebel Tools to configure Siebel Clinical users to pass default position and responsibility information in the Siebel REST response. For more information about Siebel Clinical, see Siebel Clinical Trial Management System Guide.

To configure Siebel Clinical Users

  1. Log into Siebel Tools as an administrator.

  2. Navigate to the Administration - Application screen and then the Business Service view.

  3. In the Business Service list, select the Clinical User Provisioning Service Business Service.

  4. In the Business Service Method list, select the CreateUser method.

    The selected Business Service method appears in the Business Service Method list view.

  5. In the Business Service Method Arguments list, select Default Position.

    Note: The Default Position must belong to the Default Organization.
  6. In the Business Service Method Arguments list, select Default Responsibility.

  7. Step off the record to save changes.

Using the Siebel REST API with Siebel Clinical

You can use the Siebel REST API to create, synchronize, and delete Siebel Clinical users. For more information about Siebel Clinical, see Siebel Clinical Trial Management System Guide.

You can also use the Siebel REST API to invoke Business Services using Siebel server script techniques. For more information, see Using Siebel Tools.

When you create or synchronize Siebel Clinical users, you can pass default position and responsibility information in the Siebel REST API response by configuring the LS Clinical User Provisioning Service Business method. For more information, see Configuring Siebel Clinical Users.

Creating a Siebel Clinical User

The following request creates a Siebel clinical user on the Siebel CRM Server:

  • URI:http://ServerName:port/siebel/v1.0/service/LS Clinical User Provisioning Service/CreateUser

  • HTTP Method: POST

  • Content-Type: application/json

  • Authorization: Basic

  • Request body:
    {
      "body":
      {
        "Employee":
        {
          "First Name": "Cathy",
          "Last Name": "Rogers",
          "Login Name":"Cathy.Rogers",
          "Email Address":"Cathy.Rogers@oracle.com"
        }
        "ListOfPosition":
        {
          "Position":
          {
            "Name":"Cathy.Rogers",
            "Division":"Default Organization"
          }
        },
        "ListOfEmployee_Responsibility":
        {
          "Employee_Responsibility":
          {
            "Responsibility":"Clinical Research Associate
          }
        }
      }
    }

Here are the response details for a successful request:

  • HTTP Code: 200

  • Content-Type: application/json

  • Response body: None.

Synchronizing a Siebel Clinical User

The following request synchronizes a Siebel clinical user on the Siebel CRM Server:

  • URI: http:/ServerName:port//siebel/v1.0/service/LS Clinical User Provisioning Service/SynchronizeUser

  • HTTP Method: POST

  • Content-Type: application/json

  • Authorization: Basic

  • Request body:

{
  "body": 
    {
      "Employee": 
       {
         "Login Name": "Cathy.Rogers",
         "Field 1": "Value 1",
         "Field 2": "Value 2",
         ………..
       }
    }
}

Here are the response details for a successful request:

  • HTTP Code: 200

  • Content-Type: application/json

  • Response body: None.

Deleting a Siebel Clinical User

When you use the Siebel REST API to delete a Siebel clinical user, the Siebel Clinical application performs a soft delete of the clinical user by stamping the Termination Date field with the Current Date value and removing the user’s responsibilities.

The following request deletes a Siebel clinical user on the Siebel CRM Server:

  • URI: http://ServerName:port/siebel/v1.0/service/LS Clinical User Provisioning Service/TerminateUser

  • HTTP Method: POST

  • Content-Type: application/json

  • Authorization: Basic

  • Request body:
    {
     "body":
      {
        "Employee":
        {
          "First Name": "Cathy",
          "Last Name": "Rogers",
          "Login Name":"Cathy.Rogers",
          "EMail Addr":"Cathy.Rogers@oracle.com"
        }
        "ListOfPosition":
        {
          "Position":
          {
             "Name":"Cathy.Rogers",
             "Division":"Default Organization"
           }
        },
         "ListOfEmployee_Responsibility":
         {
            "Employee_Responsibility":
            {
               "Responsibility":"Clinical Research Associate
            }
         }
      }
    }

Here are the response details for a successful request:

  • HTTP Code: 200

  • Content-Type: application/json

  • Response body: None.