Interpretation of GDT file

The interpretation of GDT files is specified in structures named im and om which can be found in the configuration file config.json.

Take great care when changing import mapping!

Import and Output Mapping IM, OM are read at start of execution from the protocol definition in the backend and overwrite the specification in the configuration file. The actually used IM and OM are taken from the protocol specified in t2007rr_protocol_id in the config.json.

Standard GDT Interpretation

"im": {
    "address": {
      "address_type": {
        "need": "",
        "return": "return \"L\""
      },
      "city": {
        "need": "3106",
        "return": "return strings.TrimSpace(strings.TrimLeft(gdtrec.GetField(\"3106\"), strings.Fields(gdtrec.GetField(\"3106\"))[0]))"
      },
      "country": {
        "need": "3114",
        "return": "return gdtrec.GetField(\"3114\")"
      },
      "state": {
        "need": "3116",
        "return": "return gdtrec.GetField(\"3116\")"
      },
      "street_address": {
        "need": "3107",
        "return": "return gdtrec.GetField(\"3107\")"
      },
      "zip_code": {
        "need": "3106",
        "return": "return strings.TrimSpace(strings.Fields(gdtrec.GetField(\"3106\"))[0])"
      }
    },
    "insurance_info": {
      "company_region": {
        "need": "4106",
        "return": "return gdtrec.GetField(\"4106\")"
      },
      "dmp_indicator": {
        "need": "4113",
        "return": "return gdtrec.GetField(\"4113\")"
      },
      "insurance_company": {
        "need": "0202",
        "return": "return gdtrec.GetField(\"0202\")"
      },
      "insurance_company_id": {
        "need": "4111",
        "return": "return gdtrec.GetField(\"4111\")"
      },
      "insurance_status": {
        "need": "3108",
        "return": "return gdtrec.GetField(\"3108\")"
      },
      "name_of_insured": {
        "need": "",
        "return": "return \"\""
      },
      "policy_number": {
        "need": "3119",
        "return": "return gdtrec.GetField(\"3119\")"
      }
    },
    "observation": {
      "created": {
        "need": "6200 6201",
        "return": "return gdtrec.GetField(\"6200\") + gdtrec.GetField(\"6201\")"
      },
      "equipment": {
        "need": "8404",
        "return": "return gdtrec.GetField(\"8404\")"
      },
      "last_update": {
        "need": "6200 6201",
        "return": "return gdtrec.GetField(\"6200\") + gdtrec.GetField(\"6201\")"
      },
      "method": {
        "need": "8402",
        "return": "return gdtrec.GetField(\"8402\")"
      },
      "note": {
        "need": "6227",
        "return": "return gdtrec.GetField(\"6227\")"
      },
      "observer": {
        "need": "8615",
        "return": "return gdtrec.GetField(\"8615\")"
      },
      "status": {
        "need": "",
        "return": "return \"0\""
      },
      "visit_number": {
        "need": "8310",
        "return": "return gdtrec.GetField(\"8310\")"
      }
    },
    "observation_result": {
      "created": {
        "need": "6200 6201",
        "return": "return gdtrec.GetField(\"6200\") + gdtrec.GetField(\"6201\")"
      },
      "last_update": {
        "need": "6201",
        "return": "return gdtrec.GetField(\"6200\") + gdtrec.GetField(\"6201\")"
      },
      "note": {
        "need": "6227",
        "return": "return gdtrec.GetField(\"6227\")"
      },
      "result": {
        "need": "",
        "return": "return \"\""
      },
      "result_status": {
        "need": "",
        "return": "return \"\""
      },
      "result_type": {
        "need": "8402",
        "return": "return gdtrec.GetField(\"8402\")"
      }
    },
    "patient": {
      "created": {
        "need": "",
        "return": "return \"\""
      },
      "dob": {
        "need": "3103",
        "return": "return gdtrec.GetField(\"3103\")"
      },
      "email": {
        "need": "3619",
        "return": "return gdtrec.GetField(\"3619\")"
      },
      "gender": {
        "need": "3110",
        "return": "return gdtrec.GetField(\"3110\")"
      },
      "language": {
        "need": "3628",
        "return": "return gdtrec.GetField(\"3628\")"
      },
      "last_update": {
        "need": "",
        "return": "return \"\""
      },
      "marital_status": {
        "need": "",
        "return": "return \"\""
      },
      "patient_id": {
        "need": "3000",
        "return": "return gdtrec.GetField(\"3000\")"
      },
      "priority": {
        "need": "",
        "return": "return \"0\""
      },
      "race": {
        "need": "",
        "return": "return \"\""
      },
      "religion": {
        "need": "",
        "return": "return \"\""
      },
      "status": {
        "need": "",
        "return": "return \"0\""
      },
      "telephone": {
        "need": "3626",
        "return": "return gdtrec.GetField(\"3626\")"
      }
    },
    "patient_alt_id": {
      "alt_id": {
        "need": "3000",
        "return": "return gdtrec.GetField(\"3000\")"
      },
      "other_system": {
        "need": "",
        "return": "return \"P\""
      }
    },
    "patientname": {
      "degree": {
        "need": "3104",
        "return": "return gdtrec.GetField(\"3104\")"
      },
      "further_given_names": {
        "need": "3102",
        "return": "return \"\""
      },
      "given_name": {
        "need": "3102",
        "return": "return gdtrec.GetField(\"3102\")"
      },
      "name_type_code": {
        "need": "",
        "return": "return \"L\""
      },
      "prefix": {
        "need": "",
        "return": "return \"\""
      },
      "suffix": {
        "need": "",
        "return": "return \"\""
      },
      "surname": {
        "need": "3101",
        "return": "return gdtrec.GetField(\"3101\")"
      },
      "surname_prefix": {
        "need": "3100",
        "return": "return gdtrec.GetField(\"3100\")"
      }
    }
  },

IM specifies, how data read from a GDT file are placed into Internal data structures. Individually for each field in internal data structures:

"need": list of GDT fields required to fill the internal field
"return": coding of the value that is placed into the internal data field. This can consist of constants, values from the GDT file and combinations thereof.