Changes between Version 32 and Version 33 of RxNormForVista

Timestamp:

Nov 21, 2013, 4:59:24 PM (10 years ago)

Author:

Sam Habiel

Comment:

--

RxNormForVista

@@ -1 +1 @@
 = !RxNorm Files for Vista/RPMS =
 [[PageOutline(2-5)]]
-[[Image(RxNormForVista.png,align=right,600px)]]
+
 
 Welcome to the homepage for the !RxNorm VISTA/RPMS Support. I am Sam Habiel, and I am the developer for these packages. I can be reached at sam dot habiel at gmail dot com.
@@ -12 +12 @@
 == Why do I want this? ==
 !RxNorm is necessary for interoperability with other systems. If you use VISTA alone without having to talk to any other system, then you don't need !RxNorm. However, if you perform external drug interactions, send CCDA documents, or archive patient records for CCR, you are going to need !RxNorm. For Meaningful Use, you are required to have !RxNorm for various purposes.
+
+
 
 == What does this release contain? ==
@@ -32 +34 @@
 
 TODO: GT.M Example
+
+[[Image(RxNormForVista.png,align=right,600px)]]
 
 === Installation ===
@@ -307 +311 @@
 
 === Programmer APIs ===
-This is a list of APIs available for programmers for converting one terminology to another. Some APIs get 
-
-
-
-{{{
-$$EXIST^C0CRXNLK(RXN)                                        $$ Public - Does this RxNorm CUI exist?
-$$GCN2RXN^C0CRXNLK(GCN)                                      $$ Public - Get RxNorm CUI using GCN
-$$RXN2GCN^C0CRXNLK(RXNCUI)                                   $$ Public - Get GCN(s) given an RxNorm Number
-$$RXN2VUI^C0CRXNLK(RXNCUI)                                   $$ Public - Get VUID(s) for given RXNCUI for Clinical Drug
-$$VUI2VAP^C0CRXNLK(VUID)                                     $$ Public - Get VA Product IEN(s) from VUID
-$$VAP2MED^C0CRXNLK(VAPROD)                                   $$ Public - Get Drug(s) using VA Product IEN
-$$RXN2MEDS^C0CRXNLK(RXNCUI)                                  $$ Public - Convert RxNorm value to currently existing drugs in File 50.
-$$FDI2RXN^C0CRXNLK(BASE)                                     $$ Public - Get RxNorm CUI for FDB Ingredient/Base
-$$RXN2VIN^C0CRXNLK(RXNCUI)                                   $$ Public - Get VUID Ingredient for RxNorm CUI
-$$VIN2VAG^C0CRXNLK(VUID)                                     $$ Public - Get VA Generic for VUID Ingredient
-$$FDI2VAG^C0CRXNLK(BASE)                                     $$ Public - Get VA Generic for FDB Ingredient/Base
-$$VIN2DIN^C0CRXNLK(VUID)                                     $$ Public - Get Drug Ingredient for VUID Ingredient
-$$FDI2DIN^C0CRXNLK(BASE)                                     $$ Public - Get Drug Ingredient for FDB Ingredient/Base
-$$VUI2RXN^C0CRXNLK(VUID)                                     $$ Public - Get RXNCUI for VUID (any VUID type)
-$$VUI2GCN^C0CRXNLK(VUID)                                     $$ Public - Get GCNs for a given VUID (any VUID type)
-$$MED2RXN^C0CRXNLK(DA)                                       $$ Public - Get RxNorm CUI for Drug
-$$MED2SCDN^C0CRXNLK(DA)                                      $$ Public - Medication to Semantic Clinical Drug Name
-$$RXN2NDI^C0CRXNLK(RXNCUI)                                   $$ Public - Get NDDF Ingredient for RXNCUI
-$$VIN2NDI^C0CRXNLK(VUID)                                     $$ Public - Get NDDF Ingredient for VUID
-$$NDC2RXN^C0CRXNLK(NDC)                                      $$ Public - Get RxCUI given the NDC
-$$ISBRAND^C0CRXNLK(RXN)                                      $$ Public - Is this RxCUI for a brand drug?
-$$BR2GEN^C0CRXNLK(RXN)                                       $$ Public - Convert Brand RxCUI to Generic RxCUI (many to 1)
-$$GEN2BR^C0CRXNLK(RXN)                                       $$ Public - Convert Generic RxCUI to Brand RxCUIs (1 to many).
-$$RXN2BNS^C0CRXNLK(RXN)                                      $$ Public - Get all Brand Names associated with an RXN
-$$RXN2NDC^C0CRXNLK(RXN)                                      $$ Public - Get NDC codes for RxNorm code
-}}}
+
+==== Update API ====
+To update RxNorm to a newer monthly version from the NLM, run the following:
+{{{
+D IMPORT^C0CRXNRD("/path/to/rrf/folder/",optional include restricted/copyrighted sources (1 -> yes). Default is no.)
+}}}
+
+If you need FDB or SNOMED-CT codes, you need to pass in the second parameter.
+
+==== Look-up APIs ====
+This is a list of APIs available for programmers for converting one terminology to another. Some APIs return multiple results. If so, they will be delimited by "^".
+
+{{{
+$$EXIST^C0CRXNLK(RXN)               $$ Public - Does this RxNorm CUI exist?
+$$GCN2RXN^C0CRXNLK(GCN)             $$ Public - Get RxNorm CUI using GCN
+$$RXN2GCN^C0CRXNLK(RXNCUI)          $$ Public - Get GCN(s) given an RxNorm Number
+$$RXN2VUI^C0CRXNLK(RXNCUI)          $$ Public - Get VUID(s) for given RXNCUI for Clinical Drug
+$$VUI2VAP^C0CRXNLK(VUID)            $$ Public - Get VA Product IEN(s) from VUID
+$$VAP2MED^C0CRXNLK(VAPROD)          $$ Public - Get Drug(s) using VA Product IEN
+$$RXN2MEDS^C0CRXNLK(RXNCUI)         $$ Public - Convert RxNorm value to currently existing drugs in File 50.
+$$FDI2RXN^C0CRXNLK(BASE)            $$ Public - Get RxNorm CUI for FDB Ingredient/Base
+$$RXN2VIN^C0CRXNLK(RXNCUI)          $$ Public - Get VUID Ingredient for RxNorm CUI
+$$VIN2VAG^C0CRXNLK(VUID)            $$ Public - Get VA Generic for VUID Ingredient
+$$FDI2VAG^C0CRXNLK(BASE)            $$ Public - Get VA Generic for FDB Ingredient/Base
+$$VIN2DIN^C0CRXNLK(VUID)            $$ Public - Get Drug Ingredient for VUID Ingredient
+$$FDI2DIN^C0CRXNLK(BASE)            $$ Public - Get Drug Ingredient for FDB Ingredient/Base
+$$VUI2RXN^C0CRXNLK(VUID)            $$ Public - Get RXNCUI for VUID (any VUID type)
+$$VUI2GCN^C0CRXNLK(VUID)            $$ Public - Get GCNs for a given VUID (any VUID type)
+$$MED2RXN^C0CRXNLK(DA)              $$ Public - Get RxNorm CUI for Drug
+$$MED2SCDN^C0CRXNLK(DA)             $$ Public - Medication to Semantic Clinical Drug Name
+$$RXN2NDI^C0CRXNLK(RXNCUI)          $$ Public - Get NDDF Ingredient for RXNCUI
+$$VIN2NDI^C0CRXNLK(VUID)            $$ Public - Get NDDF Ingredient for VUID
+$$NDC2RXN^C0CRXNLK(NDC)             $$ Public - Get RxCUI given the NDC
+$$ISBRAND^C0CRXNLK(RXN)             $$ Public - Is this RxCUI for a brand drug?
+$$BR2GEN^C0CRXNLK(RXN)              $$ Public - Convert Brand RxCUI to Generic RxCUI (many to 1)
+$$GEN2BR^C0CRXNLK(RXN)              $$ Public - Convert Generic RxCUI to Brand RxCUIs (1 to many).
+$$RXN2BNS^C0CRXNLK(RXN)             $$ Public - Get all Brand Names associated with an RXN
+$$RXN2NDC^C0CRXNLK(RXN)             $$ Public - Get NDC codes for RxNorm code
+}}}
+
+Here's an example call to return all active NDCs for brand name Prozac 20mg capsules:
+{{{
+GTM>W $$RXN2NDC^C0CRXNLK(104849)
+00777310502^58864091730^58016082830^58016082820^66105056403^58016082810^58016082890^52959023320
+^54868051105^00777310507^52959023310^00247037204^58864097130^55289021522^54868051101^52959023314
+^58016082840^52959023340^52959023350^54868051102^00247037210^00777310530^52959023330^54868051100
+^58016082860^16590084390^52959023300^58016082800
+}}}
+
+C0CRXNLK comes with Unit Tests. To run them, make sure M-Unit is installed and run !^C0CRXNLK from the top.
+
+==== Automatic Drug Addition API using RxNorm ====
+To add a drug to the drug file using the RxNorm CUI, call the following entry point:
+
+{{{
+W $$ADDDRUG^C0CRXNLK(RXNCUI for Drug, optional NDC to file, optional barcode to put for BCMA)
+}}}
+
+Please note that this routine does not check to see if the drug is already there; it will add it again.
+
+This routine can be enhanced to use the barcode to figure out which drug it is that is being added from RxNorm. As such, it will enable you to add drugs to the drug file by just bar-code scanning them.
 
 == Technical Details ==