Elab 7.20 Upgrading Flashcards
Elab 7.20 Upgrade
What timezone should backend and DB handle date times in?
UTC, and where needed, strings formatted per ISO8601
Elab 7.20 Upgrade
Will servers always be set to UTC?
While that is the intent, there will be a period for many between upgrade and server being set to UTC. On prem instances also may choose to set server to local time. Thus, backend functions that just get current date/time are generally inadequate.
Elab 7.20 Upgrade
How are Dates different than Date times?
Dates do not have a time, and are not different in different timezeones. The date of a scheduled event, a persons date of birth, marriage or death are all good examples.
The upgrade will not convert date fields, and applications should not attempt to convert between client and UTC time.
Elab 7.20 Upgrade
How can you tell if something is a date or a datetime?
From the UI: A time will not be present for a COTS date field.
When setting up fields in the screen designer, or custom attributes, elab provides different data types that must be selected.
Past work, because the server was set to client time, was somewhat less distinctive in presentation, and in some cases, dates were shown with times.
Elab 7.20 Upgrade
What app layer do conversions between client time and UTC occur?
As close to the user as possible.
For web apps, such as Elab, this is the UI layer. APIs will generally choose to simply pass date times through, unless presenting a finished object, such as a report from a report engine. For integrations, this will be a consideration as data is consumed from API or file, or similar.
Elab 7.20 Upgrade
What timezone standard is implemented?
IANA
This has the widest technological support, and fits best with future product plans.
https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
Elab 7.20 Upgrade
What settings control which timezone client time is set to?
Each user has an independent timezone selection. The location will also require a timezone selection.
The timezone a client is currently in is checked at time of login.
Elab 7.20 Upgrade
When would a location based timezone be used?
When a user is not known.
For example, when a report is issued, this is typically run by the queue/job processor. Integrations, such as those in Nodered, will generally not be user aware, either.
Elab 7.20 Upgrade
Can a field be a datetime in the LIMS, but a date in the portal? Or vice-versa?
Not without erroneous behavior.
Take collection dates. Elab treats these as date times. Some portals present these as dates. If a user enters the date into elab, and it is not converted to client time in the portal, it may show a different date altogether, relative to Elab UI.
Note that internal usage is also required to be consistent. For example, sample completed dates are set automatically when all tests are completed. This is stored in UTC as a datetime by code. If one were to try to present as a date, which does not convert, the date shown will not always be correct, as it is using the UTC date as is.
Elab 7.20 Upgrade
What custom layer date functionality is converted by upgrade?
All date time data is converted to UTC
All varchar data is converted to Nvarchar (can store unicode)
All database code is formatted and switched from varchar to nvarchar, and getdate() switched to getutcdate().
All inserts into tables that now use identities are adjusted to get ID from scope_identity.
Library references in cs_scripts and user exits are adjusted
Elab 7.20 Upgrade
What custom layer datetime functionality is not converted by upgrade?
Integrations, custom tasks, any SQL in sql jobs, reports (AR and Excel), APIs, portal code.
Date formatting in procs. Dynamic sample number references. Inline SQL in user exits or cs_scripts.
Elab 7.20 Upgrade
Look and feel has changed. Will custom layer UI elements be auto-upgraded?
No. “Wonky” buttons are likely.
Elab 7.20 Upgrade
How would one adjust the format of date time in UI?
Elab Configurations (often, but not always, called “current configuration” in the menu):
- “Date Time Format” is for elab UI
- “Export to Excel DateTime format” is for excel exports (not reports)
Elab 7.20 Upgrade
Does adjusting format of date time UI impact the 24h based time inputs?
No. Time inputs will still use a 24 hr format.
Elab 7.20 Upgrade
What must be present in Excel based report templates to convert date times?
On the “Lookup” tab of the spreadsheet template, the data type of “DateTime” must be specified for those columns that are date times.