Feat: Add ability to disable and set default values for answers in sp…

…ecificQuestions (#84)

(feat) Add ability to disable and set default values for answers in specificQuestions

Co-authored-by: Jose Francisco <[email protected]>

src/group-form-entry-workflow/SessionDetailsForm.tsx

@@ -9,7 +9,7 @@ import { AttendanceTable } from './attendance-table';
 import GroupFormWorkflowContext from '../context/GroupFormWorkflowContext';
 import useGetPatients from '../hooks/useGetPatients';
 import ConfigurableQuestionsSection from './configurable-questions/ConfigurableQuestionsSection';
-import useSpecificQuestions from '../hooks/useForm';
+import useSpecificQuestions from '../hooks/useSpecificQuestions';
 
 interface ParamTypes {
   formUuid?: string;

src/group-form-entry-workflow/configurable-questions/ConfigurableQuestionsSection.tsx

@@ -18,6 +18,8 @@ const ConfigurableQuestionsSection: React.FC<ConfigurableQuestionsSectionProps>
               {...register(specificQuestion.question.id, { required: false })}
               id={specificQuestion.question.id}
               labelText={specificQuestion.question.display}
+              readOnly={!!specificQuestion.question.disabled}
+              defaultValue={specificQuestion.question.defaultAnswer}
             >
               <SelectItem value="" text="" />
               {specificQuestion.answers.map((answer) => (
@@ -30,6 +32,8 @@ const ConfigurableQuestionsSection: React.FC<ConfigurableQuestionsSectionProps>
               {...register(specificQuestion.question.id, { required: false })}
               type="text"
               labelText={specificQuestion.question.display}
+              readOnly={!!specificQuestion.question.disabled}
+              defaultValue={specificQuestion.question.defaultAnswer}
             />
           )}
         </div>

src/hooks/index.ts

@@ -2,7 +2,7 @@ import useGetAllForms from './useGetAllForms';
 import useGetPatient from './useGetPatient';
 import useFormState from './useFormState';
 import useGetEncounter from './useGetEncounter';
-import useForm from './useForm';
+import useSpecificQuestions from './useSpecificQuestions';
 
-export { useGetAllForms, useGetPatient, useFormState, useGetEncounter, useForm };
+export { useGetAllForms, useGetPatient, useFormState, useGetEncounter, useSpecificQuestions };
 export * from './usePostEndpoint';

src/hooks/useSpecificQuestions.ts

@@ -0,0 +1,68 @@
+import { type FetchResponse, openmrsFetch, restBaseUrl } from '@openmrs/esm-framework';
+import useSWR from 'swr';
+import { type SpecificQuestion, type SpecificQuestionConfig } from '../types';
+import { useMemo } from 'react';
+
+const formUrl = `${restBaseUrl}/o3/forms`;
+
+export const useSpecificQuestions = (formUuid: string, specificQuestionConfig: Array<SpecificQuestionConfig>) => {
+  const specificQuestionsToLoad = useMemo(
+    () => getQuestionByFormId(formUuid, specificQuestionConfig),
+    [formUuid, specificQuestionConfig],
+  );
+
+  const { data, error } = useSWR<FetchResponse, Error>(
+    specificQuestionsToLoad ? `${formUrl}/${formUuid}` : null,
+    openmrsFetch,
+  );
+
+  const specificQuestions = getQuestions(specificQuestionsToLoad, data?.data);
+
+  return {
+    questions: specificQuestions || null,
+    isError: error,
+    isLoading: !data && !error,
+  };
+};
+
+function getQuestionByFormId(formUuid: string, specificQuestionConfig: Array<SpecificQuestionConfig>) {
+  return specificQuestionConfig.filter((question) => question.forms.includes(formUuid));
+}
+
+function getQuestions(specificQuestions: Array<SpecificQuestionConfig>, formSchema): Array<SpecificQuestion> {
+  if (!formSchema || specificQuestions.length <= 0) {
+    return [];
+  }
+
+  const specificQuestionsMap = new Map<string, SpecificQuestionConfig>(
+    specificQuestions.map((sq) => [sq.questionId, sq]),
+  );
+
+  const questionIds = new Set(specificQuestionsMap.keys());
+  const conceptLabels = formSchema.conceptReferences;
+
+  return formSchema.pages.flatMap((page) =>
+    page.sections.flatMap((section) =>
+      section.questions
+        .filter((question) => questionIds.has(question.id))
+        .map((question) => {
+          const specificQuestion = specificQuestionsMap.get(question.id) || {};
+
+          return {
+            question: {
+              display: question.label ?? conceptLabels[question.questionOptions.concept]?.display,
+              id: question.id,
+              disabled: (specificQuestion as SpecificQuestionConfig).disabled,
+              defaultAnswer: (specificQuestion as SpecificQuestionConfig).defaultAnswer,
+            },
+            answers: (question.questionOptions.answers ?? []).map((answer) => ({
+              value: answer.concept,
+              display: answer.label ?? conceptLabels[answer.concept]?.display,
+            })),
+          };
+        }),
+    ),
+  );
+}
+
+export default useSpecificQuestions;

src/types.ts

@@ -7,6 +7,8 @@ export interface SpecificQuestion {
   question: {
     id: string;
     display: string;
+    defaultAnswer?: string;
+    disabled?: boolean;
   };
   answers: Array<{
     value: string;
@@ -17,4 +19,6 @@ export interface SpecificQuestion {
 export interface SpecificQuestionConfig {
   forms: Array<string>;
   questionId: string;
+  defaultAnswer?: string;
+  disabled?: boolean;
 }