Warning
WARNING: The TrackAbout MetaWiki has been deprecated and is no longer being updated.

Please visit our new TrackAbout Knowledge Base at https://supportkb.trackabout.com for the most-up-to-date documentation on TrackAbout and TrackAbout Mobile.

Difference between revisions of "Integration with Computers Unlimited 3.0"

From TrackAbout MetaWiki
Jump to navigation Jump to search
m (Initial proofread pass - docs)
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
CU 3.0 runs on MS SQL server. Our customers interact with TIMS 3.0 by logging into a remote desktop connection, and running the TIMS front end directly from their server.
+
==Overview==
 +
CU 3.0 runs on Microsoft SQL Server. TrackAbout customers interact with TIMS 3.0 by logging into a Remote Desktop connection, and running the TIMS front end directly on their server.  
  
The local admin for the TIMS server should also have the administrator login for the TIMS server, and the SQL server login for the TIMS server.
+
The local admin for the TIMS server should also have the administrator login for the TIMS server, and the SQL server login for the TIMS server.  
  
So far, at 2 clients, the sql server login has been:
+
So far, at 2 clients, the sql server login has been: user: sa Password: cusqlxxx with 'xxx' being some three letter abbreviation for the client.  
user: sa
 
Password: cusqlxxx with ‘xxx’ being some three letter abbreviation for the client.
 
  
What you’ll need on the client PC:
+
==What you'll need on the client PC==
-some version of Microsoft Access to handle pulling the information from the TIMS database, and exporting the resulting text to TrackAbout.
 
-IP address of the TIMS SQL server
 
-Login information for the TIMS server, and SQL server.
 
-Some facility for transferring the file to TrackAbout.  Typically we've used Novell's free utility, NetDrive, which maps an FTP site to a network drive on the PC.  You could certainly do the same with Windows XP/NT/2000/Vista's mapped network drive functionality.
 
-ftp login information for the particular client
 
  
 +
#Some version of Microsoft Access or other SQL query tool to handle pulling the information from the TIMS database, and exporting the resulting text to TrackAbout.
 +
#IP address of the TIMS SQL server Login information for the TIMS server, and SQL server.
 +
#Some facility for transferring the file to TrackAbout. Typically we've used Novell's free utility, NetDrive, which maps an FTP site to a network drive on the PC. You could certainly do the same with Windows XP/NT/2000/Vista's mapped network drive functionality. ftp login information for the particular client
  
 +
In Access, you'll need to create links to the following tables in CU's database:
 +
;LINPRM
 +
:permanent archived invoices
  
In Access, you’ll need to create links to the following tables in CU’s database:
+
;LINHST
LINPRM—permanent archived invoices
+
:"invoiced" invoices from the current calendar month  
LINHST—“invoiced” invoices from the current calendar month
 
ORDHDR—orderline header info
 
CUSMAS—customer master
 
INVMAS—inventory master
 
CY_BF—cylinder balances
 
ORDLGAS—gas orderline
 
ORDLIN—orderline
 
  
You’ll also need to create a VB module with the following:
+
;ORDHDR
Visual Basic Function to Left pad a number with zeros, to match the format of CU’s scannable invoice numbers.
+
:orderline header info
'*********************************************************************
 
  
'Declarations section of the module.
+
;CUSMAS
 +
:customer master
  
'*********************************************************************
+
;INVMAS:
 +
inventory master
  
Option Explicit
+
;CY_BF
Dim x As Integer
+
:cylinder balances
Dim PadLength As Integer
 
  
'=====================================================================
+
;ORDLGAS
 +
:gas orderline
  
'The following function will left pad a string with a specified
+
;ORDLIN
'character. It accepts a base string which is to be left padded with
+
:orderline
'characters, a character to be used as the pad character, and a
 
'length which specifies the total length of the padded result.
 
  
'=====================================================================
+
==VB Module==
 
+
You'll also need to create a VB module with the following: Visual Basic Function to Left pad a number with zeros, to match the format of CU's scannable invoice numbers.
Function lpad(MyValue$, MyPadCharacter$, MyPaddedLength%)
+
<syntaxhighlight lang="vb">
 
+
'*********************************************************************
      PadLength = MyPaddedLength - Len(MyValue)
+
'Declarations section of the module.  
      Dim PadString As String
+
'*********************************************************************
      For x = 1 To PadLength
+
Option Explicit
        PadString = PadString & MyPadCharacter
+
Dim x As Integer
      Next
+
Dim PadLength As Integer
      lpad = PadString + MyValue
 
 
 
End Function
 
 
 
 
 
In all of the queries below, you’ll need to change the “JWE” to the three letter prefix for your client.
 
 
 
Historical invoice Query: for all invoices not in CURRENT CALENDAR MONTH
 
 
 
SELECT jwe_LINPRM.CUSNO, jwe_CUSMAS.LAST_NAME, lpad(jwe_LINPRM.ORDNO,0,8) & lpad(jwe_LINPRM.BAKNO,0,2) AS Expr1, jwe_LINPRM.LINHST_DATE, jwe_LINPRM.LINPRM_DATE, jwe_LINPRM.SHIP_DATE, jwe_LINPRM.PART, Replace([jwe_INVMAS].[DESCR1]+[jwe_INVMAS].[DESCR2],',',' ') AS Expr2, jwe_LINPRM.CYLSHIP, jwe_LINPRM.CYLRET, jwe_LINPRM.PONO
 
FROM jwe_LINPRM, jwe_CUSMAS, jwe_INVMAS
 
WHERE (((jwe_LINPRM.CUSNO)=[jwe_CUSMAS].[CUSNO]) AND ((jwe_LINPRM.LINPRM_DATE)>=20071001 And (jwe_LINPRM.LINPRM_DATE)<=20071015) AND ((jwe_LINPRM.PART)=[jwe_INVMAS].[PART]) AND ((jwe_LINPRM.GASFLG)=1) AND ((jwe_LINPRM.SUP)=[jwe_INVMAS].[SUP]));
 
  
+
'=====================================================================
 +
'The following function will left pad a string with a specified 'character. It accepts a base string which is to be left padded with 'characters, a character to be used as the pad character, and a 'length which specifies the total length of the padded result.
 +
'=====================================================================
 +
Function lpad(MyValue$, MyPadCharacter$, MyPaddedLength%)
  
Query for "invoiced" invoices in the current calendar month:
+
  PadLength = MyPaddedLength - Len(MyValue)
 +
  Dim PadString As String
 +
  For x = 1 To PadLength
 +
    PadString = PadString &amp; MyPadCharacter
 +
  Next
 +
  lpad = PadString + MyValue
  
SELECT jwe_LINHST.CUSNO, jwe_CUSMAS.LAST_NAME, lpad(jwe_LINHST.ORDNO,0,8) & lpad(jwe_LINHST.BAKNO,0,2) AS Ordno, jwe_LINHST.INVDTE, jwe_LINHST. INVDTE, jwe_LINHST. INVDTE, jwe_LINHST.PART AS Expr3, Replace(jwe_INVMAS.DESCR1+jwe_INVMAS.DESCR2,',',' ') AS Expr4, jwe_LINHST.CYLSHIP, jwe_LINHST.CYLRET, jwe_LINHST.PONO
+
End Function
FROM jwe_LINHST, jwe_CUSMAS, jwe_INVMAS
+
</syntaxhighlight>
WHERE (((jwe_LINHST.CUSNO)=jwe_CUSMAS.CUSNO)
 
And ((jwe_LINHST.GASFLG)=1) And ((jwe_LINHST.SUP)=jwe_INVMAS.SUP)
 
And ((jwe_LINHST.PART)=jwe_INVMAS.PART))
 
And jwe_LINHST. INVDTE >=20071218 And jwe_LINHST. INVDTE <=20071219
 
ORDER BY ordno;
 
  
+
==Queries==
 +
In all of the queries below, you'll need to change the "JWE" to the three letter prefix for your client.
  
Query for "Selected Invoices" (closed invoices that will go to "invoiced" status overnight, but that can still be changed):
+
===Historical invoice Query: for all invoices not in CURRENT CALENDAR MONTH ===
  
SELECT jwe_ORDHDR.OCUSNO, jwe_ORDHDR.OCUSNM, lpad(jwe_ORDHDR.OORDNO,0,8) & lpad(jwe_ORDHDR.OBAKNO,0,2) AS Expr1, jwe_ORDHDR.OORDDT, jwe_ORDHDR.OORDDT, jwe_ORDHDR.OORDDT, jwe_ORDLIN.LITMNO_ITEM, jwe_ORDLIN.LDESCR1, jwe_ORDLGAS.LSHIP, jwe_ORDLGAS.LRET, jwe_ORDHDR.OPONO
+
<syntaxhighlight lang="tsql">
FROM jwe_ORDHDR, jwe_ORDLGAS, jwe_ORDLIN
+
SELECT jwe_LINPRM.CUSNO, jwe_CUSMAS.LAST_NAME, lpad(jwe_LINPRM.ORDNO,0,8) & lpad(jwe_LINPRM.BAKNO,0,2) AS Expr1, jwe_LINPRM.LINHST_DATE, jwe_LINPRM.LINPRM_DATE, jwe_LINPRM.SHIP_DATE, jwe_LINPRM.PART, Replace([jwe_INVMAS].[DESCR1]+[jwe_INVMAS].[DESCR2],',',' ') AS Expr2, jwe_LINPRM.CYLSHIP, jwe_LINPRM.CYLRET, jwe_LINPRM.PONO FROM jwe_LINPRM, jwe_CUSMAS, jwe_INVMAS WHERE (((jwe_LINPRM.CUSNO)=[jwe_CUSMAS].[CUSNO]) AND ((jwe_LINPRM.LINPRM_DATE)>=20071001 And (jwe_LINPRM.LINPRM_DATE)<=20071015) AND ((jwe_LINPRM.PART)=[jwe_INVMAS].[PART]) AND ((jwe_LINPRM.GASFLG)=1) AND ((jwe_LINPRM.SUP)=[jwe_INVMAS].[SUP]));  
WHERE (((jwe_ORDHDR.OORDNO)=[jwe_ORDLGAS].[LGAS_ORDNO]  
+
</syntaxhighlight>
And (jwe_ORDHDR.OORDNO)=[jwe_ORDLIN].[LORDNO])  
 
AND ((jwe_ORDHDR.OBAKNO)=[jwe_ORDLGAS].[LGAS_SEQNO]
 
And (jwe_ORDHDR.OBAKNO)=[jwe_ORDLIN].[LSEQNO])  
 
AND ((jwe_ORDLIN.LITMNO_SUP)='GAS')  
 
AND ((jwe_ORDLIN.LINENUMA)=[jwe_ORDLGAS].[LGAS_LINENUMA]))
 
and jwe_ORDHDR.OFLAG=1;
 
 
  
Query for Customer Balances:
+
===Query for "invoiced" invoices in the current calendar month ===
 +
Adjust the query parameters for the dates.
 +
<syntaxhighlight lang="tsql">
 +
SELECT
 +
jwe_LINHST.CUSNO,
 +
jwe_CUSMAS.LAST_NAME,
 +
lpad(jwe_LINHST.ORDNO,0,8) & lpad(jwe_LINHST.BAKNO,0,2) AS Ordno,
 +
jwe_LINHST.INVDTE,
 +
jwe_LINHST. INVDTE,
 +
jwe_LINHST. INVDTE,
 +
jwe_LINHST.PART AS Expr3,
 +
Replace(jwe_INVMAS.DESCR1+jwe_INVMAS.DESCR2,',',' ') AS Expr4,
 +
jwe_LINHST.CYLSHIP,
 +
jwe_LINHST.CYLRET,
 +
jwe_LINHST.PONO
 +
FROM jwe_LINHST,
 +
jwe_CUSMAS,
 +
jwe_INVMAS
 +
WHERE (((jwe_LINHST.CUSNO)=jwe_CUSMAS.CUSNO) And ((jwe_LINHST.GASFLG)=1) And ((jwe_LINHST.SUP)=jwe_INVMAS.SUP) And ((jwe_LINHST.PART)=jwe_INVMAS.PART)) And jwe_LINHST.INVDTE >=20071218 And jwe_LINHST.INVDTE <=20071219
 +
ORDER BY ordno;
 +
</syntaxhighlight>
  
SELECT [jwe_CYO_BF].[CUSNO], [jwe_CYO_BF].[SUP]+[jwe_CYO_BF].[PART], [QTY], [jwe_CUSMAS].[LAST_NAME]
+
===Query for "Selected Invoices"===
FROM jwe_CYO_BF, jwe_CUSMAS
+
Includes closed invoices that will go to "invoiced" status overnight, but which can still be changed.
WHERE [jwe_CYO_BF].[CUSNO]=[jwe_CUSMAS].[CUSNO];
 
 
  
 +
<syntaxhighlight lang="tsql">
 +
SELECT
 +
jwe_ORDHDR.OCUSNO,
 +
jwe_ORDHDR.OCUSNM,
 +
lpad(jwe_ORDHDR.OORDNO,0,8) & lpad(jwe_ORDHDR.OBAKNO,0,2) AS Expr1,
 +
jwe_ORDHDR.OORDDT,
 +
jwe_ORDHDR.OORDDT,
 +
jwe_ORDHDR.OORDDT,
 +
jwe_ORDLIN.LITMNO_ITEM,
 +
jwe_ORDLIN.LDESCR1,
 +
jwe_ORDLGAS.LSHIP,
 +
jwe_ORDLGAS.LRET,
 +
jwe_ORDHDR.OPONO
 +
FROM jwe_ORDHDR,
 +
jwe_ORDLGAS,
 +
jwe_ORDLIN
 +
WHERE (((jwe_ORDHDR.OORDNO)=[jwe_ORDLGAS].[LGAS_ORDNO] And (jwe_ORDHDR.OORDNO)=[jwe_ORDLIN].[LORDNO]) AND ((jwe_ORDHDR.OBAKNO)=[jwe_ORDLGAS].[LGAS_SEQNO] And (jwe_ORDHDR.OBAKNO)=[jwe_ORDLIN].[LSEQNO]) AND ((jwe_ORDLIN.LITMNO_SUP)='GAS') AND ((jwe_ORDLIN.LINENUMA)=[jwe_ORDLGAS].[LGAS_LINENUMA])) and jwe_ORDHDR.OFLAG=1;
 +
</syntaxhighlight>
  
Query for List of customers with customer numbers:
+
===Query for Customer Balances===
 +
<syntaxhighlight lang="tsql">
 +
SELECT
 +
[jwe_CYO_BF].[CUSNO],
 +
[jwe_CYO_BF].[SUP]+[jwe_CYO_BF].[PART],
 +
[QTY],
 +
[jwe_CUSMAS].[LAST_NAME]
 +
FROM
 +
jwe_CYO_BF,
 +
jwe_CUSMAS
 +
WHERE [jwe_CYO_BF].[CUSNO]=[jwe_CUSMAS].[CUSNO];
 +
</syntaxhighlight>
  
SELECT [jwe_CUSMAS].[CUSNO], [jwe_CUSMAS].[LAST_NAME]
+
===Query for List of customers with customer numbers===
FROM jwe_CUSMAS;
+
<syntaxhighlight lang="tsql">
 +
SELECT [jwe_CUSMAS].[CUSNO], [jwe_CUSMAS].[LAST_NAME] FROM jwe_CUSMAS;
 +
</syntaxhighlight>

Latest revision as of 13:40, 1 December 2021

Overview

CU 3.0 runs on Microsoft SQL Server. TrackAbout customers interact with TIMS 3.0 by logging into a Remote Desktop connection, and running the TIMS front end directly on their server.

The local admin for the TIMS server should also have the administrator login for the TIMS server, and the SQL server login for the TIMS server.

So far, at 2 clients, the sql server login has been: user: sa Password: cusqlxxx with 'xxx' being some three letter abbreviation for the client.

What you'll need on the client PC

  1. Some version of Microsoft Access or other SQL query tool to handle pulling the information from the TIMS database, and exporting the resulting text to TrackAbout.
  2. IP address of the TIMS SQL server Login information for the TIMS server, and SQL server.
  3. Some facility for transferring the file to TrackAbout. Typically we've used Novell's free utility, NetDrive, which maps an FTP site to a network drive on the PC. You could certainly do the same with Windows XP/NT/2000/Vista's mapped network drive functionality. ftp login information for the particular client

In Access, you'll need to create links to the following tables in CU's database:

LINPRM
permanent archived invoices
LINHST
"invoiced" invoices from the current calendar month
ORDHDR
orderline header info
CUSMAS
customer master
INVMAS

inventory master

CY_BF
cylinder balances
ORDLGAS
gas orderline
ORDLIN
orderline

VB Module

You'll also need to create a VB module with the following: Visual Basic Function to Left pad a number with zeros, to match the format of CU's scannable invoice numbers.

'********************************************************************* 
'Declarations section of the module. 
'********************************************************************* 
Option Explicit
Dim x As Integer 
Dim PadLength As Integer 

'===================================================================== 
'The following function will left pad a string with a specified 'character. It accepts a base string which is to be left padded with 'characters, a character to be used as the pad character, and a 'length which specifies the total length of the padded result. 
'===================================================================== 
Function lpad(MyValue$, MyPadCharacter$, MyPaddedLength%) 

   PadLength = MyPaddedLength - Len(MyValue)
   Dim PadString As String
   For x = 1 To PadLength
     PadString = PadString &amp; MyPadCharacter
   Next
   lpad = PadString + MyValue

End Function

Queries

In all of the queries below, you'll need to change the "JWE" to the three letter prefix for your client.

Historical invoice Query: for all invoices not in CURRENT CALENDAR MONTH

SELECT jwe_LINPRM.CUSNO, jwe_CUSMAS.LAST_NAME, lpad(jwe_LINPRM.ORDNO,0,8) & lpad(jwe_LINPRM.BAKNO,0,2) AS Expr1, jwe_LINPRM.LINHST_DATE, jwe_LINPRM.LINPRM_DATE, jwe_LINPRM.SHIP_DATE, jwe_LINPRM.PART, Replace([jwe_INVMAS].[DESCR1]+[jwe_INVMAS].[DESCR2],',',' ') AS Expr2, jwe_LINPRM.CYLSHIP, jwe_LINPRM.CYLRET, jwe_LINPRM.PONO FROM jwe_LINPRM, jwe_CUSMAS, jwe_INVMAS WHERE (((jwe_LINPRM.CUSNO)=[jwe_CUSMAS].[CUSNO]) AND ((jwe_LINPRM.LINPRM_DATE)>=20071001 And (jwe_LINPRM.LINPRM_DATE)<=20071015) AND ((jwe_LINPRM.PART)=[jwe_INVMAS].[PART]) AND ((jwe_LINPRM.GASFLG)=1) AND ((jwe_LINPRM.SUP)=[jwe_INVMAS].[SUP]));

Query for "invoiced" invoices in the current calendar month

Adjust the query parameters for the dates.

SELECT 
 jwe_LINHST.CUSNO, 
 jwe_CUSMAS.LAST_NAME, 
 lpad(jwe_LINHST.ORDNO,0,8) & lpad(jwe_LINHST.BAKNO,0,2) AS Ordno, 
 jwe_LINHST.INVDTE, 
 jwe_LINHST. INVDTE, 
 jwe_LINHST. INVDTE, 
 jwe_LINHST.PART AS Expr3, 
 Replace(jwe_INVMAS.DESCR1+jwe_INVMAS.DESCR2,',',' ') AS Expr4, 
 jwe_LINHST.CYLSHIP, 
 jwe_LINHST.CYLRET, 
 jwe_LINHST.PONO 
FROM jwe_LINHST, 
	jwe_CUSMAS, 
	jwe_INVMAS 
WHERE (((jwe_LINHST.CUSNO)=jwe_CUSMAS.CUSNO) And ((jwe_LINHST.GASFLG)=1) And ((jwe_LINHST.SUP)=jwe_INVMAS.SUP) And ((jwe_LINHST.PART)=jwe_INVMAS.PART)) And jwe_LINHST.INVDTE >=20071218 And jwe_LINHST.INVDTE <=20071219 
ORDER BY ordno;

Query for "Selected Invoices"

Includes closed invoices that will go to "invoiced" status overnight, but which can still be changed.

SELECT 
 jwe_ORDHDR.OCUSNO, 
 jwe_ORDHDR.OCUSNM, 
 lpad(jwe_ORDHDR.OORDNO,0,8) & lpad(jwe_ORDHDR.OBAKNO,0,2) AS Expr1, 
 jwe_ORDHDR.OORDDT, 
 jwe_ORDHDR.OORDDT, 
 jwe_ORDHDR.OORDDT, 
 jwe_ORDLIN.LITMNO_ITEM, 
 jwe_ORDLIN.LDESCR1, 
 jwe_ORDLGAS.LSHIP, 
 jwe_ORDLGAS.LRET, 
 jwe_ORDHDR.OPONO 
FROM jwe_ORDHDR, 
 jwe_ORDLGAS, 
 jwe_ORDLIN 
WHERE (((jwe_ORDHDR.OORDNO)=[jwe_ORDLGAS].[LGAS_ORDNO] And (jwe_ORDHDR.OORDNO)=[jwe_ORDLIN].[LORDNO]) AND ((jwe_ORDHDR.OBAKNO)=[jwe_ORDLGAS].[LGAS_SEQNO] And (jwe_ORDHDR.OBAKNO)=[jwe_ORDLIN].[LSEQNO]) AND ((jwe_ORDLIN.LITMNO_SUP)='GAS') AND ((jwe_ORDLIN.LINENUMA)=[jwe_ORDLGAS].[LGAS_LINENUMA])) and jwe_ORDHDR.OFLAG=1;

Query for Customer Balances

SELECT 
 [jwe_CYO_BF].[CUSNO], 
 [jwe_CYO_BF].[SUP]+[jwe_CYO_BF].[PART], 
 [QTY], 
 [jwe_CUSMAS].[LAST_NAME] 
FROM 
 jwe_CYO_BF,
 jwe_CUSMAS 
WHERE [jwe_CYO_BF].[CUSNO]=[jwe_CUSMAS].[CUSNO];

Query for List of customers with customer numbers

SELECT [jwe_CUSMAS].[CUSNO], [jwe_CUSMAS].[LAST_NAME] FROM jwe_CUSMAS;