BRACKETED FIELDS: "Bracketed Fields" is the name of the technique used in ChartNet to merge patient demographic and other database fields into the header, body, footer, or page footer sections of a report is called Bracketed Fields. Bracketed fields get replaced by the database field that they represent at print time. There are two syntaxes used when specifying bracketed fields, "single" and "double".
Here are some examples of bracketed fields:
[r.acctno) - inserts the account number
[r.dict_date) - inserts the dictation date
[r.trans_date) - inserts the transcription date
[r.doctor) - inserts the dictating doctor's code
[r.doctor.d.docname) - inserts the dictating doctor's name
[u.120_ssn) - inserts the patient's social security number 'user-defined field'
[x.age) - inserts the patient's age
Single Bracketed Fields: Single bracketed fields are used to retrieve a value from a single table. For example "'R.DOCTOR' would be single bracketed field and would retrieve just the dictating provider's code.
Single bracketed fields have the syntax ''table code'.'field name':'optional format code''
Double Bracketed Fields: Double bracketed fields are used to get field's value from one table, then go to another table to get the value of another field. For example, "'R.DOCTOR.D.DOCNAME ' would be a double bracketed field and would retrieve the doctor's code from the Reports table, then go out and retrieve the doctor's name from the Provider's table.
Double bracketed fields have the syntax [table code1].[field name1].[table code2].[field name2]:[optional format code]
Table Codes: Bracketed fields 'both single and double' are made up of a "table code", followed by a period '"."', followed by a field name. The following is a list of valid table codes:
R Reports table
F Forms table
A Address table
M MPI table
O Orders table
S Sites table
G Value Lookup List
U User-defined field
E Users table
X Special field
Bracketed field when using a Value Lookup List: Examples of fields using a Value Lookup List are below.
[R.USER1.G.LOCATION) - Will use the value entered in the USER1 field on the RDS to display the value from the description field in the Location Value Lookup List.
[R.USER1.G.LOCATION.EXTRA1) Will use the value entered in the USER1 field on the RDS to display the value from the Extra 1 field in the Location Value Lookup List.
Controlling the Length of the Bracketed Field: The bracketed field needs to be large enough to hold the maximum length of the field being inserted. For example, if the account number is 10 digits, then the total length of the bracketed field must be at least 10 characters 'brackets included'. If the merged field is actually less than the bracketed field width, then spaces will be appended to pad the field out to the width of the bracketed field. If the merged field is longer than the bracketed field width, then the field will be truncated.
Terminating Characters: The following characters can be used to terminate bracketed fields:
"]'" Right bracket. Will cause blanks to be appended to the merged data in order to pad out the field to the width of the bracketed field.
For example, "['R.PTNAME ]'" will result in "SMITH, JOHN ". (i.e. Blanks not trimmed from the name). Note that the total length of the bracketed field, including the brackets, is 20. This means that the name that is merged in will have a length of 20.
")'" Right parenthesis. Will trim trailing blanks from the data field before it is merged in.
For example, "['R.PTNAME )'" will result in "SMITH, JOHN". (i.e. blanks trimmed from name). Use this terminating character when you have multiple bracketed fields on one line, right next to each other, and you do not want large blank spaces in between them.
"}'" Right curly brace. Will cause a line that contains the bracketed field to be physically removed from the report if the merged data field is blank and the bracketed field is the only text on the line. If the merged data is not blank, then the right curly brace acts like the right bracket.
Special Bracketed Fields (X.):
Patient Age - X.AGE
Page Number - X.PAGE
Total Pages - X.TOTPAGES
Copy To - X.COPY
System Date - X.DATE
System Time - X.TIME
Dictated By - X.DICTATED_BY
Attending - X.ATTENDING
Dictating - X.DICTATING
Dictating2 - X.DICTATING2
Dictating Line - X.DICTATING_LINE
Signed By - X.SIGNEDBY
Unsigned - X.UNSIGNED
ChartScript Trans Date - X.TRANS1
Letter/Envelope/CC Name X.NAMEADDR1
Letter/Envelope/CC Address Line 1 X.NAMEADDR2
Letter/Envelope/CC Address Line 2 X.NAMEADDR3
Letter/Envelope/CC Address Line 3 X.NAMEADDR4
Letter/Envelope/CC Address Line 4 X.NAMEADDR5
Letter/Envelope/CC Address Line 5 X.NAMEADDR6
Special bracketed field for CC's:
Bracketed Field Description
X.ALL_CC_NAMES - Prints each cc: name on a separate line
Example:
William P. Smith, M.D.
David S. Jones, M.D.
X.ALL_CC_NAMES2 - Prints all cc: names on one line, separated by a slash character
Example:
William P. Smith, M.D. / David S. Jones, M.D.
X.ALL_CC_ADDRESSES - Prints cc: names and their addresses on separate lines
Example:
William P. Smith, M.D.
1234 Main St.
Hudson, Ohio 44236
David S. Jones, M.D.
78873 S. Broadway Blvd
Twinsburg, Ohio 44234
X.ALL_CC_ADDRESSES2 - Prints each cc: name and address on one line
Example:
William P. Smith, M.D. '1234 Main St., Hudson, Ohio 44236'
David S. Jones, M.D. '78873 S. Broadway Blvd, Twinsburg, Ohio 44234'
X.ALL_CC_ADDRESSES3 - Prints each cc: name and address on one line. If the cc: was sent via Fax or Email, then the text "'FAX'" or "'Email'" will appear next to the cc: name. If the cc: is to be sent via printed copy, then the cc: address will be printed.
Example:
William P. Smith, M.D. 'FAX'
David S. Jones, M.D. '78873 S. Broadway Blvd, Twinsburg, Ohio 44234'
Formatting Codes: Bracketed fields can also contain formatting codes to take care of special formatting requirements. For example, to print a patient name in "First Last" format with proper case, add a colon followed by "N2" to the end of the R.PTNAME field as shown below.
[r.ptname:n2) - will format the patient name "SMITH, JOHN W." to "JOHN W. SMITH"
Normally, data that is merged into a report using the "bracketed field" technique will be formatted according to how the data is stored in the database. You can have ChartNet print the data in a different format by appending a "format code" to the end of the field name in the bracketed field. For example, to have the visit date of "06/20/2004" print out as "June 20, 2004", you would use "'R.VISITDT:D2'", where the ":D2" is the format code. Note that all format codes must be preceded with a colon '":"'.
List of format codes:
Medical Record Number
M1 xx xx xx
M2 xx-xx-xx-xx-x
DATES
DB - dd/mm/yyyy
D1 - yyyymmdd
D2 - June 9, 2001
D2B - 9 June, 2001
D3 - mm/dd/yy
D3B - dd/mm/yy
D4 - strip out "/" if blank date
D5 - yyyy mm dd
D6 - mmddyy
D6B - ddmmyy
D7 - Tue December 31, 2002
D7B - Tue 31 December, 2002
D8 - mm-dd-yy
D8B - dd-mm-yy
D9 - yyyy-mm-dd
D10 - yymmdd
TIMES
T1 - hh mm 'a or p'
T2 - hhmm 'a or p'
T3 - hhmm 'military'
T4 - hh mm 'military'
T5 - hh:mm 'military'
PATIENT NAMES
N1 - ChartScript format
N2 - First MI Last (proper case)
N3 - FIRST MI LAST (upper case)
N4 - LAST FIRST MI (HL7 format)
N5 - LASTNAME
N6 - FIRSTNAME
N7 - LASTNAME (proper case)
N8 - FIRSTNAME (proper case)
N9 - Initials
NI - Patient name: Middle initial
PROVIDER NAMES
P1 - LAST, FIRST M, TITLE (uppercase)
P2 - Last, First M, TITLE (proper case)
P3 - Last name (proper case)
P4 - Initials
P5 - Append provider code
OTHER
PC - convert to proper case (if all uppercase)
UC - convert to upper case
LC - convert to lower case
PC1 - convert to proper case
Ln - returns the left-most n characters
Rn - returns the right-most n characters
ZFn - zero-fills the value to length n
RCxy - replace characters. x is the old characters; y is the new character
Sxxx - strip out characters. xxx is the string of 1-3 characters to strip out.
SA - strip out all alpha characters leaving only numerics
RZ - remove leading zeros
S1 - used with x.signatures. Will create lines to sign on.
S2 - same as S1, but will not put provider names in proper case
Fnd - Get a sub-field from a delimited field. n=field# d=delimiter character