Pmorey: /* Common Parameters */

2024-05-25T01:33:16Z

Common Parameters

← Older revision		Revision as of 01:33, 25 May 2024
Line 204:		Line 204:
	ING_ID_WATER_TRUCK ;alternate batch weights ingredient id for truck water [default=Truck Water] (Keystone 3.6.23.3+)		ING_ID_WATER_TRUCK ;alternate batch weights ingredient id for truck water [default=Truck Water] (Keystone 3.6.23.3+)
	ING_ID_WATER_PRELOADED ;alternate batch weights ingredient id for preloaded water [default=Manual Water] (Keystone 3.6.23.3+)		ING_ID_WATER_PRELOADED ;alternate batch weights ingredient id for preloaded water [default=Manual Water] (Keystone 3.6.23.3+)
			CONVERTPER100 ;apply ingredient per-hundred weight conversion when sending mix design to batch control (Y/N) [default=N] (Keystone 4.6.2.3+)

	;serial devices		;serial devices

Pmorey: /* Batch Control Links */

2024-02-14T01:24:45Z

Batch Control Links

@@ Line 69: / Line 69: @@
 | style="text-align:center;" | 20
 | style="text-align:center;" | 3.3.1.4
 |-
 | Email (SMTP)
@@ Line 303: / Line 317: @@
 HTMLHEADER=<HTML for header portion of the email body>
 HTMLFOOTER=<HTML for footer portion of the email body>
 </PRE>

WikiAdmin: 1 revision imported

2023-07-14T12:58:48Z

1 revision imported

← Older revision	Revision as of 12:58, 14 July 2023
(No difference)

Pmorey: /* Common Parameters */

2021-01-21T15:19:53Z

Common Parameters

New page

[[Category: BATCH LINKS]]
== Batch Interface ==
[[CommandAlkon Eagle Batch Ticket Export]]

== Batch Control Links ==

Batch Control Links are handled through the [[Device Server]].

{| border="3" cellspacing="0" cellpadding="3" class="wikitable"
! colspan="3"|
! colspan="5"|Supported Functions
! colspan="2"|Number of Products
! colspan="2"|Product Code Length
!
|-
! Batch Control Type
! PROTOCOL
! Documents/Links
! Send Ticket
! Void Ticket
! Poll Weights
! Mix Designs
! Test Link
! Default
! Maximum
! Default
! Maximum
! Keystone Version
|-
| Auto-Control TransNet
| TRANSNET
| [[Setting up a TRANSNET batch control interface in Keystone]]
| style="text-align:center;" | X
| style="text-align:center;" | X
|
|
| style="text-align:center;" | X
| style="text-align:center;" | 4
| style="text-align:center;" | 4
| style="text-align:center;" | 7
| style="text-align:center;" | 7
|
|-
| CA Link-20
| LINK20
| [[Media:Link-20 Manual.pdf|Link-20 User's Guide]]<BR>[[Link 20|Link-20 (ancient)]]
| style="text-align:center;" | X
| style="text-align:center;" | X
|
|
| style="text-align:center;" | X
| style="text-align:center;" | 6
| style="text-align:center;" | 6
| style="text-align:center;" | 10
| style="text-align:center;" | 10
|
|-
| CA Universal Link (ULINK)
| UNIVERSAL
| [[Media:UDI Comm Link Rev. C.pdf|ULINK Serial Document]]<BR>[[Media:Universal Link TCPIP.pdf|ULINK TCP/IP Document]]<BR>[[Media:ULINK to KEYSTONE Field Mappings.pdf|ULINK to KEYSTONE Field Mappings (as of Keystone 3.1.8)]]
| style="text-align:center;" | X
| style="text-align:center;" | X
| style="text-align:center;" | X
| style="text-align:center;" | X
| style="text-align:center;" | X
| style="text-align:center;" | 6
| style="text-align:center;" | 12
| style="text-align:center;" | 10
| style="text-align:center;" | 20
| style="text-align:center;" | 3.3.1.4
|-
| Email (SMTP)
| EMAILSMTP
| Notification of new tickets for Dispatch/Ticketing
| style="text-align:center;" | X
| style="text-align:center;" |
| style="text-align:center;" |
| style="text-align:center;" |
| style="text-align:center;" |
| style="text-align:center;" | None
| style="text-align:center;" | None
| style="text-align:center;" | None
| style="text-align:center;" | None
| style="text-align:center;" | 3.6.11.4
|-
| Keystone Batch
| KEYSTONE
| [[Media:Universal Link TCPIP.pdf|ULINK TCP/IP Document]]
| style="text-align:center;" | X
| style="text-align:center;" | X
| style="text-align:center;" | X
| style="text-align:center;" | X
| style="text-align:center;" | X
| style="text-align:center;" | 12
| style="text-align:center;" | 12
| style="text-align:center;" | 10
| style="text-align:center;" | 20
| style="text-align:center;" | 3.3.1.4
|-
| RexCon
| REXCON
| [[Media:Universal Link TCPIP.pdf|ULINK TCP/IP Document]]
| style="text-align:center;" | X
| style="text-align:center;" | X
| style="text-align:center;" | X
| style="text-align:center;" | X
| style="text-align:center;" | X
| style="text-align:center;" | 6
| style="text-align:center;" | 12
| style="text-align:center;" | 10
| style="text-align:center;" | 20
| style="text-align:center;" | 3.3.1.4
|-
| TrakIt (Integra XML)
| INTEGRAXML
| [[Media:Integra_XML_V2_5.pdf|Integra XML Specifications]]
| style="text-align:center;" | X
| style="text-align:center;" | X
|
|
| style="text-align:center;" | X
| style="text-align:center;" | 100
| style="text-align:center;" | 100
| style="text-align:center;" | 20
| style="text-align:center;" | 20
|
|-
| TrimFleet (GPS)
| TRIMBLEXML
| [[Media:Trimble_Generic_XML_Integration_Interface_%282.17%29.pdf|Trimble XML Specifications]]
| style="text-align:center;" | X
| style="text-align:center;" | X
|
|
| style="text-align:center;" | X
| style="text-align:center;" | None
| style="text-align:center;" | None
| style="text-align:center;" | None
| style="text-align:center;" | None
| style="text-align:center;" | 3.2.7.3
|-
| Verifi
| VERIFI
| [[Media:Ticketing-Api-1.3-_Documentation_2018Jul13.pdf|Verifi Ticketing (XML)]]
| style="text-align:center;" | X
|
|
|
|
| style="text-align:center;" | None
| style="text-align:center;" | None
| style="text-align:center;" | None
| style="text-align:center;" | None
| style="text-align:center;" | 3.4.5.6
|}

=== Device Maintenance Sample Configurations ===

==== Common Parameters ====
<PRE>
PROTOCOL ;batch link protocol
PROTOCOLMOD ;supports special customer modifications
EOLHEX ;batch record end of line sequence in hex (ex: 0D0A) [default=link specific]
ID ;batch link unit ID (ex: 001)
RETRY ;number of retries per batch command [default=3]
CRCTYPE ;batch CRC type (N/B/A/R) [default=R]
DATEFORMAT ;batch date format override (ex: mm/dd/yy) [default=link specific]
IGNOREBATCHWEIGHTS ;do not poll/store batch weights (Y/N) [default=Y]
TIMEOUT ;time to wait for batch control response in MILLISECONDS [default=5000]
TIMEDUEONJOB ;Keystone field to use for Time Due On Job (ULINK only) [default=TGT_ARRIVE_JOB_TIME]
TIMETICKETSENT ;Keystone field to use for Time Ticket Sent (ULINK only) [default=TICKET_TIME]
POLLBATCHWEIGHTS ;time between batch weight polls in SECONDS (0=disabled) [default=60]
SENDMIXTOBATCH ;send Keystone mix design to batch control (Y/N) [default=N]
KEEPALIVE ;keep communication link open to batch control (Y/N) [default=N]
MIXDESIGNDECIMALS ;number of decimal places to use when sending water & admix ingredients in the mix design (ULINK only, 1-4) [default=1]
EXTRAPRODUCTS ;number of extra products to send to batch control (allowed range is 6-12) [default=6 for UNIVERSAL/REXCON, 12 for KEYSTONE]
FMTPRODDESC ;maximum length for extra product description fields (allowed range is 1-35) [default=16]
FMTQTY ;format for QTY_SOLD, ORDER_QTY and CUMUL_QTY fields [default=4.2 for UNIVERSAL/REXCON, 9.2 for KEYSTONE]
FMTQTYSHORT ;[Keystone 3.2.8+] format for mix QTY_SOLD and QTY_OB fields [default=2.2 for UNIVERSAL/REXCON, 9.2 for KEYSTONE]
FMTTOTAL ;format for EXT_PRICE, SUB_TOTAL, TAX_TOTAL and ORDER_BALANCE fields [default=5.2 for UNIVERSAL/REXCON, 9.2 for KEYSTONE]
FMTUNITPRICE ;format for UNIT_PRICE field [default=3.2 for UNIVERSAL/REXCON, 9.2 for KEYSTONE]
DUALPLANTID ;specify second Plant Id in the case where one batch system can feed two plants
PRODUCTCODELENGTH ;maximum length for UNIVERSAL/KEYSTONE/REXCON product codes (allowed range is 10-20) [default=10]
PRODUCTCLASS ;batch/order device only: a list of product classes which must match the line 1 product class in order to send to the device
PRODUCTTYPE ;batch/order device only: a list of product types which must match the line 1 product type in order to send to the device (Keystone 3.4.6.3+)
FORCEPLANT ;batch device only: if specified this will be used as the Plant Id when sending/voiding tickets [sent as-is, include leading zeroes if needed ex: 002] (Keystone 3.5.2.2+)
IGNORELOADTIME ;if specified Keystone will not use the Load Time from the batch results as the ticket Batch Start time (Y/N) [default=N] (Keystone 3.6.16.3+)
ING_ID_WATER_TEMPER ;alternate batch weights ingredient id for temper water [default=Temper Water] (Keystone 3.6.23.3+)
ING_ID_WATER_TRIM ;alternate batch weights ingredient id for trim water [default=Trim Water] (Keystone 3.6.23.3+)
ING_ID_WATER_TRUCK ;alternate batch weights ingredient id for truck water [default=Truck Water] (Keystone 3.6.23.3+)
ING_ID_WATER_PRELOADED ;alternate batch weights ingredient id for preloaded water [default=Manual Water] (Keystone 3.6.23.3+)

;serial devices
COMPORT ;serial port # (ex: 1)
BAUDRATE ;serial port baud rate (ex: 9600)
DATABITS ;serial port # of data bits (7/8)
STOPBITS ;serial port # of stop bits (1/2)
PARITY ;serial port parity (N/O/E/M/S)

;network devices (TCP/UDP)
IPADDRESS ;network IP address (ex: 192.168.1.1)
IPPORT ;network IP port (ex: 7000)
CONNECTTIMEOUT ;network connection timeout (msecs)

;message queues (MSMQ)
MSMQFORMATNAME ;Microsoft Message Queue Format Name
</PRE>

==== Keystone Batch ====
<PRE>
ID=001
PROTOCOL=KEYSTONE
IPADDRESS=192.168.0.3
IPPORT=7000
PRODUCT_SEP=.
SUPPRESSPRINT=Y
POLLBATCHWEIGHTS=30
SENDMIXTOBATCH=Y
</PRE>

==== ULINK/TCP Generic (incl. Alkon) ====
<PRE>
ID=001
PROTOCOL=UNIVERSAL
IPADDRESS=192.168.0.3
IPPORT=7000
PRODUCT_SEP=.
SUPPRESSPRINT=Y
POLLBATCHWEIGHTS=30
SENDMIXTOBATCH=Y
</PRE>

==== PSI Eagle Serial ====
(NOTE: The ID parameter is critical and must match the Eagle setting!)<BR>
<PRE>
PROTOCOL=UNIVERSAL
ID=01
COMPORT=1
BAUDRATE=9600
EOLHEX=0D
DATABITS=8
STOPBITS=1
CRCTYPE=R
TIMEOUT=5000
SUPPRESSPRINT=Y
</PRE>

==== RexCon (6 extra products) ====
<PRE>
ID=001
PROTOCOL=REXCON
IPADDRESS=192.168.0.3
IPPORT=7000
PRODUCT_SEP=.
SUPPRESSPRINT=Y
POLLBATCHWEIGHTS=30
SENDMIXTOBATCH=Y
IGNORELOADTIME=Y
</PRE>

==== RexCon (12 extra products, 20 character product codes) ====
<PRE>
ID=001
PROTOCOL=REXCON
IPADDRESS=192.168.0.3
IPPORT=7000
PRODUCT_SEP=.
SUPPRESSPRINT=Y
POLLBATCHWEIGHTS=30
SENDMIXTOBATCH=Y
EXTRAPRODUCTS=12
PRODUCTCODELENGTH=20
IGNORELOADTIME=Y
</PRE>

==== Verifi ====

The Verifi batch device is meant to be linked from another batch control device. Here is an example from Device Maintenance:

[[File:BatchDeviceVerifiLink.PNG|400px]]

<PRE>
PROTOCOL=VERIFI
ROOTURL=https://portal.verificoncrete.com/rs/api/1.3/
VERIFIUSER=givenhansco@company.com
VERIFIUSERPASS=**************
</PRE>

==== Email (SMTP) ====

This device can be used to send an email notification when a new ticket is generated in either Dispatch or Ticketing.

<PRE>
PROTOCOL=EMAILSMTP
SMTPHOST=<hostname/IP address of SMTP server>
SMTPPORT=<SMTP server IP port (25 default)>
SMTPSSLMETHOD=<SSLv2 | SSLv23 | SSLv3 | TLSv1 | TLSv1_1 | TLSv1_2>
SMTPUSERNAME=<SMTP server login username>
SMTPPASSWORD=<SMTP server login password>
SMTPREADTIMEOUT=<SMTP server read timeout (msec)>
EMAILFROM=<email address of sender>
EMAILSUBJECT=<subject line for the email>
HTMLHEADER=<HTML for header portion of the email body>
HTMLFOOTER=<HTML for footer portion of the email body>
</PRE>

Batch Control Devices - Revision history

Pmorey: /* Common Parameters */

Pmorey: /* Batch Control Links */

WikiAdmin: 1 revision imported

Pmorey: /* Common Parameters */