De ER-functie LISTOFFIELDS
De functie LISTOFFIELDS retourneert een recordlijstwaarde die wordt gemaakt op basis van de structuur van het opgegeven argument van het type Opsomming of Container (record).
Syntaxis 1
LISTOFFIELDS (path)
Syntaxis 2
LISTOFFIELDS (path, language)
Argumenten
path: Gegevensbronverwijzing
Het geldige verwijzingspad van een gegevensbron van een van de volgende gegevenstypen:
- Modelopsomming
- Opsomming van indelingen
- Toepassingsopsomming
- Container (record)
language: Tekenreeks
Tekst die een taalcode vertegenwoordigt.
Retourwaarden
Recordlijst
De resulterende lijst met records.
Gebruiksaanwijzingen
De lijst die wordt gemaakt bestaat uit records met de volgende velden:
- Naam (gegevenstype Tekenreeks)
- Label (gegevenstype Tekenreeks)
- Beschrijving (gegevenstype Tekenreeks)
- Istranslated (gegevenstype Booleaans)
Als het argument path verwijst naar een gegevensbron van het type Container (record), wordt voor elk veld van de container record waarnaar wordt verwezen een nieuwe record toegevoegd aan de lijst die wordt gemaakt. Voor elke record die wordt gemaakt, retourneert het veld Naam de naam van het veld van de containerrecord waarnaar wordt verwezen waarvoor de huidige record is gemaakt.
Als het argument path verwijst naar een gegevensbron van een van de typen Opsomming, wordt voor elke opsommingswaarde van de opsomming waarnaar wordt verwezen een nieuwe record toegevoegd aan de lijst die wordt gemaakt. Voor elke record die wordt gemaakt, retourneert het veld Naam de waarde van de opsomming waarnaar wordt verwezen en waarvoor de huidige record is gemaakt. Het veld Beschrijving retourneert de beschrijving van die opsomming en het veld Label retourneert het label van die opsomming.
Wanneer bij uitvoering syntaxis 1 wordt gebruikt, moeten de velden Label en Beschrijving waarden retourneren die zijn gebaseerd op de taalinstellingen van de ER-indeling (Elektronische rapportage) die wordt uitgevoerd:
- Als de labels en beschrijvingen voor de gevraagde taal beschikbaar zijn, retourneren de velden Label en Beschrijving waarden die zijn gebaseerd op die taal en retourneert het veld IsTranslated de waarde True.
- Als de labels en beschrijvingen voor de gevraagde taal niet beschikbaar zijn, retourneren de velden Label en Beschrijving waarden die zijn gebaseerd op de standaardtaal EN-US en retourneert het veld IsTranslated de waarde False.
Wanneer bij uitvoering syntaxis 2 wordt gebruikt, moeten de velden Label en Beschrijving waarden retourneren die zijn gebaseerd op de taal die is gedefinieerd als het tweede argument van de aangeroepen functie:
- Als de labels en beschrijvingen voor de gevraagde taal beschikbaar zijn, retourneren de velden Label en Beschrijving waarden die zijn gebaseerd op die taal en retourneert het veld IsTranslated de waarde True.
- Als de labels en beschrijvingen voor de gevraagde taal niet beschikbaar zijn, retourneren de velden Label en Beschrijving waarden die zijn gebaseerd op de taal EN-US en retourneert het veld IsTranslated de waarde False.
Voorbeeld 1
In het volgende voorbeeld wordt een opsomming geïntroduceerd in een ER-gegevensmodel.
De volgende afbeelding toont deze details:
- De modelopsomming wordt in een rapport ingevoegd als gegevensbron.
- Een ER-expressie gebruikt de modelopsomming als een parameter van de functie
LISTOFFIELDS. - Een gegevensbron van het type Recordlijst wordt ingevoegd in een rapport met de gemaakte ER-expressie.
In het volgende voorbeeld ziet u de elementen van de ER-indeling die gebonden zijn aan de gegevensbron van het type Recordlijst die is gemaakt met de functie LISTOFFIELDS.
In de volgende afbeelding ziet u het resultaat wanneer de ontworpen indeling wordt uitgevoerd.
Notitie
Op basis van de taalinstellingen van de bovenliggende indelingselementen BESTAND en MAP worden labels en beschrijvingen in de uitvoer van de ER-indeling ingevoerd.
Voorbeeld 2
U gebruikt het gegevensbrontype Berekend veld om de gegevensbronnen enumType_de en enumType_deCH te configureren voor de gegevensmodelopsomming enumType:
- enumType_de =
LISTOFFIELDS (enumType, "de") - enumType_deCH =
LISTOFFIELDS (enumType, "de-CH")
In dit geval kunt u de volgende expressie gebruiken om het label van de opsommingswaarde in Zwitsers Duits te krijgen, als deze vertaling beschikbaar is. Als de Zwitsers Duitse vertaling niet beschikbaar is, is het label in het Duits.
IF (NOT (enumType_deCH.IsTranslated), enumType_de.Label, enumType_deCH.Label)