Work through a result mapping before connecting the LIMS
Use row A to verify a measured-vial transformation and row B to verify an already-corrected result. Row C establishes the unresolved path. Together they test the receiving field’s meaning, rather than merely proving that it accepts a number.
0.82 mg/mL becomes 0.82 g/L; a tenfold dilution is a separate question.
Run RUN-812 reports three rows. The receiving field is defined as concentration in the original sample, in g/L. A tenfold dilution is supported for A and B, but the export says that B is already corrected. C provides no result-basis evidence.
Scroll across to see every column →
| Source row | Reported concentration | Source meaning | Destination result |
|---|---|---|---|
| A / S-812-A | 0.82 mg/mL | Measured vial; factor 10 not applied | 8.2 g/L in original sample |
| B / S-812-B | 8.2 mg/mL | Original-sample result; factor 10 already applied | 8.2 g/L; no further factor |
| C / S-812-C | 0.82 mg/mL | Result basis unresolved | Do not populate original-sample concentration |
For a concentration, 1 mg/mL equals 1 g/L. Row A therefore gives 0.82 g/L in the vial and 8.2 g/L after the supported factor of 10. Row B is already corrected. Applying that factor again would report 82 g/L. Row C needs evidence before it can enter the destination field.
Download the source exampleTry the result conversion
Change the example inputs to inspect the result. This calculator runs on the website and does not change records in Seal.
Trace the mapping and recovery decisions
Define the quantity before defining the conversion.
Write a destination-field definition that includes the analyte, sample basis and unit. “Concentration” alone may allow a vial concentration, an original-sample concentration and an amount per dry mass to land in the same column. Those are different quantities even when some reports use similar names.
Inspect a representative export together with the method and preparation records. Identify whether a value is observed or calculated, whether software has applied a factor, and where that fact is recorded. If the export omits the basis, obtain it through a supported source or route the result for review. A familiar filename or column heading is insufficient evidence for a missing correction state.
Keep unit conversion and dilution correction as separate steps.
The unit conversion follows (mg ÷ 1,000) / (mL ÷ 1,000), so the two factors cancel: 0.82 mg/mL = 0.82 g/L. For row A only, the supported original-sample calculation is then 0.82 × 10 = 8.2 g/L. This assumes the result and factor have the meanings stated in the example; it is not a general recovery or potency correction.
Record each transformation and its evidence separately. A source result may already incorporate dilution, recovery, dry-mass correction or another method-specific calculation. Do not apply an extra factor just because a preparation record contains it. Keep working precision through the arithmetic and apply the method’s reporting rules at the reporting boundary.
Preserve qualified and missing results.
An empty source cell is not zero. A result written as “<0.10” is also not an ordinary measured value of 0.10. Define how qualifiers, limits, missing values and text-only outcomes travel through the connection. If the receiving design separates numeric value and qualifier, preserve both and verify what downstream calculations are allowed to use.
Dimensional compatibility is necessary but insufficient. Converting a mass concentration into a molar concentration needs additional defined substance information. Converting a volume using a density needs an applicable density and its context. Keep those outside a simple mg/mL-to-g/L rule instead of silently extending that rule.
Write a transformation record that another scientist can reproduce.
For row A, record the exact source row and file, the source quantity 0.82 mg/mL in the measured vial, the destination definition of original-sample concentration in g/L, the unit factor 1 and the supported preparation factor 10. Link the preparation instance rather than merely a method’s usual dilution. Retain mapping revision M-812-1 and its result 8.2 g/L as an illustrative transformation record. Row B requires a different correction decision even though its final quantity is also 8.2 g/L.
Now test a qualified variant: <0.10 mg/mL on a confirmed vial basis with a supported tenfold factor becomes <1.0 g/L in the original sample, retaining the qualifier. It is not a measured result of 1.0 g/L and must not silently enter an ordinary average as one. If the preparation factor is missing, the unit conversion can still express the vial limit as <0.10 g/L, but the original-sample field stays unavailable. This separates a usable partial transformation from a falsely completed result.
Have the scientist compare these expected values against the source report and the receiving record. Have the implementer also test empty text, a nonnumeric status and an unexpected unit. Record the handling of each before enabling unattended use; accepting a number syntactically does not establish its scientific meaning.
Configure a reviewable source-to-result mapping in Seal.
Use separate fields for the source value, unit, result basis and normalised result, with References to the source File and preparation. Attach the conversion formula to the normalised Number field. Explicitly require the expected source basis and correction state before producing an original-sample value; preserve an unresolved outcome when those inputs are absent.
Use a mapping assessment record to hold the approved definition and verification evidence. A proposed result-review Check can require a resolved mapping, preparation identity and complete transformation evidence. Confirm how the connection implements that rule and how updates are versioned. A formula warning is useful feedback, but the workflow must explicitly configure any required Check before it becomes a publication control.
Inspect the proposed fields and acceptance cases
Adapt these fields to the receiving connection. The cases describe expected behaviour to verify with the configured interface.
Download the field list · Download acceptance cases
Source result
Keep the original representation available before applying a mapping.
- Run and source row — Text / Reference
- RUN-812 and the stable row identity from the export contract.
- Reported value — Number
- The original numeric value without replacing it with a converted value.
- Reported unit — Text
- The original mg/mL label, including its stated quantity context.
- Result basis — Select
- Measured vial, original sample or unresolved, based on source evidence.
- Source export — Reference to File
- The retained file containing the result and relevant metadata.
Preparation and mapping
Separate sample preparation from the arithmetic used to express the result.
- Preparation evidence — Reference
- The recorded dilution associated with this sample and preparation.
- Dilution factor — Number
- 10 where supported; a missing factor remains missing.
- Source correction state — Select
- Whether the source result already includes the preparation correction.
- Mapping revision — Text / Reference
- The reviewed source-to-destination quantity and conversion definition.
Normalised result
Describe the quantity the laboratory intends to use.
- Sample and preparation — References
- The scientific identities the result belongs to.
- Original-sample concentration — Number
- 8.2 g/L for A and B; unavailable for C until resolved.
- Transformation evidence — Text / References
- Source value, unit factor, preparation factor and mapping revision.
- Mapping assessment — Select / Text
- Resolved or requiring review, with the reason retained.
An already-corrected export
Input: Import row B with 8.2 mg/mL and the recorded factor of 10.
Expected: The original-sample field shows 8.2 g/L, not 82; the transformation records why no dilution factor was applied.
A qualified source value
Input: Supply “<0.10 mg/mL” where the connection previously received plain numeric values.
Expected: The qualifier is retained or the row requires mapping review. It is not silently reported as a measured 0.10.
A missing factor
Input: Remove preparation-factor evidence from row A while leaving its vial basis.
Expected: The source result remains visible; the original-sample value stays unresolved instead of assuming a factor of one.
Apply this to your records
Take one real source result, its method/preparation evidence and the intended receiving field. Record each transformation separately so a scientist can reproduce the final quantity.
Download the blank working review
Write your working notes here
Notes stay in this tab and are not submitted. Download them before leaving to keep a copy. Use record references to identify your evidence.
Identify the instrument/software, analysis, result/evaluation and exact source row. Preserve the original value text, unit, qualifier, result status and retained file reference.
State the analyte, sample/preparation basis and unit the field represents. Identify whether the source describes the vial, original sample, dry mass or another basis; leave unestablished meanings unresolved.
Record the unit factor and independently supported preparation factor. Identify the actual preparation record and whether the source already applied its correction. Show the calculation and mapping revision, preserving the original representation.
Test an already-corrected result, a qualified limit, a missing basis/factor and an unexpected unit. Record each actual receiving outcome. Confirm that a limit is not silently used as an ordinary measured value and missing text is not zero.
Record the scientist’s source-to-destination comparison, accepted mapping scope and unresolved rows with owners. Specify what evidence would allow a currently unavailable quantity to be populated.
Unanswered sections remain marked ‘Not recorded’ in the download.
Evidence needed to finish
The receiving quantity is reproducible from source value, unit and supported preparation evidence. Each unresolved or qualified row has an explicit handling rule. A value is populated only when the field’s full quantity definition is established.
Choose who owns the sample, test and result.
Keep the laboratory’s source-of-record rules explicit. A sample may be registered in the LIMS while a process investigation or manufacturing record lives in Seal. In that case, retain the LIMS sample identifier on the linked Seal record rather than creating another independent sample identity that people must reconcile manually.
Define the grain below the sample. A sample can have several tests, analytes, replicates and result revisions. Decide which of those objects the integration reads or writes, and how their identifiers relate. A sample-level status is not a substitute for the status of each individual test.
Build a bounded read workflow first.
Confirm the documented interface and enabled operations for the installed provider and edition. Scope credentials to the intended records and fields. Start with a known sample set and compare the returned data against the source system, including result qualifiers and access restrictions. The provider guides below are implementation starting points, not a promise that every endpoint is available in every deployment.
For recurring retrieval, define the selection window and how pagination works. Establish whether the interface exposes creation time, modification time or a change cursor, and test what happens when an older result is corrected. Record progress only after the selected records have been handled successfully so a partial request does not skip the remainder.
Preserve analytical meaning and source evidence.
Map test and analyte codes explicitly rather than matching display labels. Keep units, reported qualifiers, methods and revision identities with the value. A result reported as below a limit is not an exact numeric measurement at that limit; preserve the distinction in the destination fields and any subsequent calculation.
Where the interface supports evidence retrieval, link the relevant report or attachment to the result record. Decide whether Seal stores a captured File, a source link or both, and explain what permissions a reader needs to follow the link. A copy supports the configured workflow; it does not replace the source system’s complete history.
Treat write-back as a separate contract.
Specify the exact supported operation: creating a result, attaching evidence, updating an allowed field or requesting a workflow transition. Define the receiving identifiers, required fields and allowed source state. Keep the review and approval decision in the agreed system; a successful API response does not itself establish analytical approval.
Use a stable operation identity and a record of attempts. If the connection drops after the receiver accepts a write, query or reconcile the destination before retrying. Handle conflicts explicitly when the source record has changed since it was read. Preserve the receiver’s resulting record identifier and error details so an operator can resolve incomplete exchanges.
Test it with your data.
Use these cases to agree and test the connection’s behaviour. They are proposed acceptance checks, not completed tests or automatic connector features.
A corrected result belongs to an older sample
A sample created last month has a result corrected today.
- Expected behaviour
- Ensure the agreed retrieval rule can discover the correction. A selection based only on new sample creation must not silently miss it.
- Evidence to keep
- The source revision, retrieval window or cursor, and the updated receiving record with its earlier evidence retained.
The same test label means different analytes
Two source test definitions share a display name but have different codes or units.
- Expected behaviour
- Use explicit test and analyte mappings. Hold unknown combinations rather than guessing from the label.
- Evidence to keep
- Source codes, mapping version, unit handling and the destination test reference.
More checks for this connection
- Compare a multi-test sample with the LIMS view, including a qualified result and a revised result.
- Force pagination and interrupt a retrieval between pages; verify that recovery neither omits nor duplicates records.
- Check that a user or service account without the required source permission cannot retrieve the restricted data.
- Test a rejected write and an uncertain response in a non-operational configuration, then verify the reconciliation process.
Before you connect
Can neil ask questions across LIMS and Seal records?
A configured connection can provide the permitted records or tools for the task. Define the sample population, fields and evidence needed for the question, and verify that the answer follows the intended access rules and cites the source records.
Is two-way synchronization always the right design?
Often the simpler design is a bounded read workflow with a small number of explicitly supported return operations. Two-way editing of the same fields needs ownership, conflict and revision rules before it can be reliable.
Check your system’s connection options.
Confirm the installed version, available exports and permissions. These pages cover the source interface and link to setup instructions.
- LabWare LIMSVendor documentation
- LabVantage LIMSVendor documentation
- Thermo Scientific SampleManagerVendor documentation
- Benchling
- LabguruVendor documentation
- SciNoteVendor documentation
For configuration: Seal Scripts and local-file collection.
Start with one export.
Bring the source evidence and the records it needs to connect to. For this workflow, a useful starting pack is:
- A known sample with tests, analytes, units and result qualifiers.
- The source result states and revisions the receiving workflow is allowed to use.
- A representative API response, including paging or update-selection information where available.