modify_time_log

Public Function modify_time_log(ByVal time_log_objid As Long, _
                  ByVal creation_time As String, ByVal perf_by As String, _
                  ByVal notes As String, ByVal user_name As String, _
                  ByVal time_type As String, ByVal start_time As String, _
                  ByVal duration As Long, ByVal billable As Long, _
                  ByVal bill_to As String, ByVal wrk_center As String, _
                  ByVal resolution As String) As Integer

Description

This API modifies an existing time log record in the Clarify database. You must pass in a valid time log objid (which is returned by the create_time_log API). You can specify the start time and a duration. The duration is specified in seconds. 

The time type is an optional code list value that may be specified. The user performing the logging may be specified as can the creation time. If you do not specify a value for one of the arguments, the value in the existing record is not updated.

Parameters

Parameter Name	Required?	Description
time_log_objid	Yes	The OBJID of the time log to modify
creation_time	No	When is the log modified? If left blank, it will be modified at the current time
perf_by	No	The user who modified the time log. If left blank, the current user performs the modify
notes	No	The updated notes for the onsite log
user_name	No	The user who is recording the modification of the time log. If left blank, the current user records the modify
time_type	No	Value from the TIME_TYPE code list
start_time	No	When does the time log start? If you want to leave the original time, leave this field empty
duration	No	How long (in seconds) is the appointment?
billable	No	Indicates if this time is billable
bill_to	No	Indicates who this time log will be billed to, from the BILL_TO_TIME list in Policies and Customers
wrk_center	No	Value from the WORK_CENTER list where the time was spent
resolution	No	Value from the RESOLUTION_CODE list

Returns

Value	Meaning
0	No errors
-1	Could not find specified TIME_TYPE
-2	Could not find specified BILL_TO_TIME
-3	Cannot find specified user in database
-4	Cannot find employee record for specified user in database
-5	Cannot find performing user in database
-6	Could not find case or subcase for time log record
-7	Could not find specified WORK_CENTER
-8	Could not find specified RESOLUTION_CODE
-9	Could not find the specified time log record
-10	Cannot find employee record for performing user in database
-11	Cannot find the 'T & E Log' activity string with rank = 8700

Examples

Update an existing appointment. Set all the data that you can set. Change the start time and set the end time with the original end time from the appointment by using "-1".

Visual Basic:

Dim ret_int As Integer

ret_int = fcfo.modify_svc_inter(268435465, "A new description",
      "12/1/98 16:00:00", "-1", 600, _
      "Appt type", "Appt subtype", "sa", "9/9/98")

JavaScript:

var ret_int = fcfo.modify_svc_inter(268435465, "A new description",
      "12/1/98 16:00:00", "-1", 600,
      "Appt type", "Appt subtype", "sa", "9/9/98");

Simply append to the description for an appointment.

Visual Basic:

Dim ret_int As Integer

ret_int = fcfo.modify_svc_inter(268435465, "+for api", "", "", 0, _
                                 "-1", "-1", "", "")

JavaScript:

var ret_int = fcfo.modify_svc_inter(268435465, "+for api", "", "", 0,
                                 "-1", "-1", "", "");