Sist endret: 11. feb. 2025

Konfigurere et underskjema i en app

Følg disse stegene for å sette inn et underskjema i appen din.

1. Innledning

Et underskjema er et skjema som er en del av et annet skjema. Du setter opp underskjemaene i tilhørende tabeller. Denne veiledningen forklarer hvordan du oppretter en tabell for underskjema og konfigurere underskjemaet som skal være knyttet til den.

2. Konfigurere et underskjema

    I denne delen av veiledningen bruker du for det meste Utforming-siden i Studio. Klikk Utforming i toppmenyen for å gå dit.
    1. Legg til en tabell for underskjema
      I listen over komponenter, gå til Avansert og velger Tabell for underskjema.
      Når du legger til tabellen, får du en veiledning i et eget vindu.
    2. Lag underskjemaet
      Følg veiledningen for å lage et nytt underskjema eller velge et eksisterende.
      Opprette underskjema - veiledning
      Opprette underskjema - veiledning
      Hvis du trenger å endre datamodellen for underskjemaet, gå til Datamodell i toppmenyen og velg datamodellen fra nedtrekkslisten. På fanen Metadata kan du angi antall dataelementer brukeren kan eller skal legge til i underskjemaet.
      Klikk på knappen Generer modeller for å kunne ta i bruk endringene.
    3. Velg underskjemaet på Utforming-siden
      Velg underskjemaet i nedtrekkslisten som er koblet til tabellen. Du kan også gå dit ved å klikke på knappen Utform underskjemaet.
    4. Legg til komponentene
      Komponenten Knapp for å lukke underskjema blir automatisk lagt til. Den lar brukerne gå tilbake til hovedskjemaet. Du kan slette den manuelt på sider som ikke skal ha den.
    5. Legg til kolonner i tabellen for underskjema
      Gå tilbake til hovedskjemaet og klikk på Tabell for underskjema. Åpne trekkspillisten Tekster, og legg til de kolonnene du vil ha med.
    6. Konfigurer kolonnene
      Velg det antallet kolonner du vil ha i tabellen.
      Velg en komponent fra underskjemaet for hver kolonne.
      Du kan legge til en egen tittel. Hvis du ikke gjør det, bruker appen komponentenes tittel.
      Klikk på Lagre når du er ferdig.
      Konfigurasjon av kolonner
      Konfigurasjon av kolonner
    1. Opprett en datamodell for underskjemaet.
    2. Du skal nå se tre filer under App/model. Klassen i c#, json schema og xsd.
    3. Sett appLogic.allowInSubform til true i applicationMetadata.json.
    4. Opprett en mappe under App/ui med det navnet du vil ha på underskjemaet.
    5. Naviger til underskjemamappen, legg til Settings.json filen og en mappe med navn layouts.
    6. Du kan legge til side layouts til layouts mappen slik du ville gjort for hovedskjemaet.
      Underskjema støtter ikke vedlegg, og nøsting av underskjema er ikke tillatt (underskjema i underskjema).
    7. Konfigurer filen for underskjema, Settings.json, som normalt.
    8. Velg en egendefinert knapp for å lukke underskjemaet: CustomButton med closeSubform action. Du bestemmer selv om du vil at underskjemaet skal valideres før det før det lukkes.
      {
  "id": "subform-exitbutton",
  "type": "CustomButton",
  "textResourceBindings": {
    "title": "The button title" // Blir `general.done` om utelatt
  },
  "actions": [
    {
      "type": "ClientAction",
      "id": "closeSubform",
      // Validering er valgfritt
      "validation": {
        "page": "all",
        "show": ["All"]
      }
    }
  ]
}
    9. Legg til et layout set i layout-sets.json med datatypen til datamodellen fra steg 1. Sett type til subform. Bruk navnet på underskjemamappen som id.
           {
         "id": "underskjema-mappe-navn",
         "dataType": "underskjema-datatype",
         "type": "subform"
     },
    10. Naviger til layout for siden i hovedskjemaet der du ønsker å legge inn underskjematabellen.
    11. Legg til Subform med ønsket konfigurasjon. Eksempel:
      {
  "id": "subform-test",
  "type": "Subform",
  "textResourceBindings": {
    "title": "subform-test.title",
    "addButton": "subform-test.add"
  },
  "layoutSet": "subform-layout-folder-name",
  "showAddButton": true,
  "showDeleteButton": true,
  "tableColumns": [
    {
      "headerContent": "subform-test.name-header",
      "cellContent": {
        "query": "Name"
      }
    },
    {
      "headerContent": "subform-test.age-header",
      "cellContent": {
        "query": "Age"
      }
    },
    {
      "headerContent": "subform-test.extrainfo-header",
      "cellContent": {
        "query": "ExtraInfo",
        "default": "subform-test.extrainfo.default"
      }
    }
  ]
}
    Et underskjema kan ha sin egen oppsummeringsside, men kan også være en del av oppsummeringen for hovedskjemaet. Hvis du vil legge til underskjemaet i oppsummeringen til hovedskjemaet, bruker du den ID-en som lagt inn i utformingen for hovedskjemaet og typen “component”.