Skip to main content

State Form Field Translation

Create cross-walk dictionaries to relate myAvatar codes and values to those that are expected to appear on a state form.

Values for fields included in State Form File Generation are translated to the equivalent state form code before being passed to the form.

Wild cards may be used for field translations. An asterisk (*) may be used to signify any number of characters (or none), and any value matching the pattern will be mapped to the specified value.

Prerequisites:

  1. Go to: RADplus Utilities > State Forms Tools > State Form Field Translation
  2. Select the state form from the State Form drop-down list.
  3. In the Record field, select a record.

    Note: Records are defined in the State Form Definition form, within the Record Definition section.
  4. In the Table field, select the table.
  5. In the Table Property field, select the table property.
  6. In the Action field, indicate the type of translation:
    • Single Translation - Map one dictionary code to a new value for the selected table property. 
    • Import Dictionary - Map the selected table property to another dictionary. 
    • Change Multiple Select Dictionary Delimiter - Replace the default delimiter of a multiple-select dictionary field ('&') with another delimiter. 
       
    • If Single Translation is selected:
       
      • In the Dictionary Code field, enter the myAvatar dictionary code to be translated. This field can accommodate up to 80 characters.
      • In the State Forms Dictionary Code field, enter the new code that should be displayed in the compiled file. The code defined within myAvatar will be translated to this code.
      • Example:  Use '1' for male and '2' for female.
        Table=SYSTEM.patient_current_demographics
        Table Property=patient_sex_code
        Specify Single Translation or Import Dictionary=Single Translation
        Dictionary Code=M
        State Forms Dictionary Code=1
         
    • If Import Dictionary is selected:
       
      • In the File field, select the dictionary file where the data element is stored.
      • In the Data Element field, select the data element to translate the dictionary values into.
      • If the selected element has an extended dictionary associated with it, select that element from the Extended Dictionary Data Element drop-down list. The values in the extended dictionary will be displayed in the report. If changes are made to the extended dictionary after the translation is applied, the translation will need to be re-filed for the modifications to appear. 
      • Example:  Use the 837 codes for gender.
        Table=SYSTEM.patient_current_demographics
        Table Property=patient_sex_code
        Specify Single Translation or Import Dictionary=Import Dictionary
        File=Client
        Data Element=(3) Sex
        Extended Dictionary Element=(284) Gender (837 Professional/Institutional)
         
    • If Change Multiple Select Dictionary Delimiter is selected:
      • The Multiple Select Dictionary Delimiter field is enabled. Select a value that will replace the default delimiter of '&.' If 'Other' is selected, enter the delimiter value.
  7. Click Submit to record the changes.

Printing Translations

  1. Select a state form from the dropdown list.
  2. Select a record and table.
  3. To view a report of the translations specific to a certain property, select that property from the Table Property drop-down list.
  4. In the All Properties or Selected Property field, specify whether the report should include all properties or only the property designated in the Table Property dropdown. 
  5. Click Print Translations to view the report.

Deleting Translations

  1. Select the state form from the dropdown list.
  2. Select the record, table and table property.
  3. Click Select Translations To Delete.
  4. Select the rows (translations) that you'd like to remove.