create_time_log

Public Function create_time_log(ByVal onsite_objid As Long, _
        ByVal id_num As String, ByVal creation_time As String, _
      	ByVal notes As String, ByVal perf_by 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 allows creation of a time log that is related to an onsite log. The OBJID of the onsite log or a case/subcase id must be supplied (but not both), and the other parameters are all optional.

Parameters

Parameter Name	Required?	Description
onsite_objid	Yes	The OBJID of the onsite log this time log is related to
id_num	No	The Id number for the Case or Subcase if no onsite log is specified
creation_time	No	The time this time log is created. If left blank, it will be the current time
notes	No	The note text for this time log
perf_by	No	The user who is performing the actions associated to the onsite log
user_name	No	The user who is creating the onsite log. If left blank, the current user performs the create
time_type	No	Value from the TIME_TYPE list
start_time	Yes	When the process started
duration	Yes	How much time was spent, in number of seconds
billable	No	Indicates if this time is billable (1=Billable, Other Value = Not Billable)
bill_to	No	Indicates who this expense 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 value
-2	Could not find specified BILL_TO_TIME value
-3	Cannot find user in database
-4	Cannot find employee record for user in database
-5	Cannot find employee record for performing user in database
-6	Cannot find specified case/subcase
-7	Could not find specified WORK_CENTER
-8	Could not find specified RESOLUTION_CODE
-9	Cannot find the 'T & E log' activity string with rank = 1800
-10	Either Case ID or Onsite Log Objid must be specified
-11	Cannot find user record for performing user in database
-12	The supplied onsite log objid is not found
ret_objid	The objid of the new time log object is returned by this parameter.
ret_objid2	The objid of the new onsite object is returned by this parameter.

Examples

Create a new time log related to onsite log 268435522. The creation time is 10:55 am on September 11, 1998. A sample note is passed, and the resolution will be "Completed". The user will default, and the performing user will be set to "db". This default time type is billable to the customer. The process started in the default work center at 10:00 am and lasted for 10 minutes. Once created, the new objid will be passed back in the tl_objid field.

Visual Basic:

Dim ret_int As Integer
Dim tl_objid As Long

ret_int = fcfo.create_expense_log(268435522, "", "09/11/98 10:55:00", _
        "time log note", "db", "", "", _
        "09/11/98 10:00:00", 600, 1, "Customer", _
        "", "Completed")

   If ret_int = 0 Then
     tl_objid = fcfo.ret_objid
   End If

JavaScript:

var ret_int = fcfo.create_expense_log(268435522, "", "09/11/98 10:55:00",

                                   "time log note", "db", "", "",

        "09/11/98 10:00:00", 600, 1, "Customer",

        "", "Completed");

if (ret_int == 0){ var tl_objid = fcfo.ret_objid; }

Create a new time log related to onsite log 268435463. The time spent was 2 minutes, starting at noon on 9/10/1998, and was non-billable. All other parameters will default.

Visual Basic:

Dim ret_int As Integer
Dim tl_objid As Long

ret_int = fcfo.create_expense_log(268435463, "", "", "", "", "",_
                                   "", "09/09/1998 12:00", 120, 0, "", _
                                   "", "")

   If ret_int = 0 Then
     tl_objid = fcfo.ret_objid
   End If

JavaScript:

var ret_int = fcfo.create_expense_log(268435463, "", "", "", "", "",
                                   "", "09/09/1998 12:00", 120, 0, "",
                                   "", "");

if (ret_int == 0){ var tl_objid = fcfo.ret_objid; }