Collection-Attribute hinzufügen

Attribute sind benutzerdefinierte Felder, die zentral von Administratoren definiert und an vielen Orten verwendet werden. Sie können verschiedene Werttypen für benutzerdefinierte Attribute angeben: Datum, Datum und Uhrzeit, Liste, Zahl, Text oder True/False.

Für Collections können Sie Datumsberechnungsattribute, wie z.B. ein Start- und ein Enddatum für eine Datenerfassungsperiode, hinzufügen. Sie können auch die historischen Dimensionsattributwerte in vorhandenen Datenformularen persistieren.

So fügen Sie Collection-Attribute hinzu:

  1. Klicken Sie auf der Homepage auf Anwendung, Supplemental Data.
  2. Klicken Sie links auf die Registerkarte Collections.
  3. Wählen Sie eine Collection aus, und klicken Sie auf Bearbeiten. Das Fenster "Collection bearbeiten" wird angezeigt.
  4. Klicken Sie auf die Registerkarte Attribute. Dort werden die folgenden Spalten angezeigt:
    • Schlüssel-ID: Gibt an, ob das Attribut eine Schlüssel-ID ist. Wenn für diese Collection keine Daten vorhanden sind, können Sie die Schlüssel-ID und Attribute ändern.

      Hinweis:

      • Die Kontrollkästchenoptionen Schlüssel-ID und Workflow zuweisen für die Entity sind standardmäßig aktiviert. Wenn Sie Attribute hinzufügen, können Sie mindestens eines dieser Attribute als Schlüssel-ID auswählen.
      • Supplemental Data Manager unterstützt keine Attribute vom Typ "Berechnet" als Schlüssel-ID-Attribut. Wenn Sie diesen Typ von Attribut als Schlüssel-ID auswählen, kann es zu unerwartetem Verhalten und Fehlern in Collections kommen.
    • Workflow zuweisen: Zeigt den im Collection-Intervall definierten Workflow an. Dieses Feld kann nicht bearbeitet werden.
    • Persistieren: Gibt an, ob der Wert des Dimensionsattributs in den referenzierten Formularen persistiert werden soll. Diese Spalte ist nur für den Attributtyp "Dimensionsreferenz" anwendbar.
    • Name: Name des Attributs.
    • Dimensionsname: Diese Spalte ist nur für Dimensionsattribute anwendbar und gibt den Dimensionsnamen an.
    • Attributtyp (wird angezeigt, wenn Attribute vorhanden sind): Gibt den Typ des Attributs an:
      • Eingabe
      • Dimensionsreferenz
      • Berechnet
    • Datentyp: Datum, Datum und Uhrzeit, Ganzzahl, Liste, Mehrzeiliger Text, Zahl, Text, True/False oder Ja/Nein
    • Summe: Ermöglicht die Angabe der Summenmethode für das Attribut:
      • Summe: Additiver Gesamtwert.
      • Durchschnitt: Der Durchschnitt der Zeilen mit Daten. Zeilen ohne Daten werden im Nenner nicht gezählt.
      • Anzahl: Die Anzahl der Zeilen mit Daten.
      • Keine: Es wird keine Summe berechnet.
  5. Klicken Sie auf das Symbol Hinzufügen und anschließend auf eine der folgenden Optionen:

Neues Attribut für eine Collection hinzufügen

So fügen Sie ein neues Attribut für eine Collection hinzu:

  1. Geben Sie im Fenster "Neues Attribut erstellen" Folgendes in der Registerkarte Eigenschaften an:
    • Name: Geben Sie einen Namen für das Attribut ein. Sie können maximal 80 Zeichen eingeben.
    • Beschreibung: Geben Sie eine Beschreibung ein. Sie können maximal 255 Zeichen eingeben.
    • Wählen Sie die Option Eingabe oder Berechnet als Attributtyp aus.

      "Eingabe" ist die Standardeinstellung. Die Registerkarte Validierungen ist aktiviert. Für offene Perioden und erstellte Formularinstanzen gilt die geänderte Validierungsregel nicht. Vorgenommene Änderungen gelten nur für neue Formularinstanzen.

      Wenn Sie Berechnet auswählen, wird die Registerkarte Berechnungen aktiviert.

      Hinweis:

      Wenn Sie Eingabe oder Berechnet auswählen und das Attribut speichern, können Sie diese Einstellung nach Erstellung des Attributs nicht mehr ändern. Wenn Sie den Attributtyp ändern, werden alle zuvor angegebenen Validierungen oder Berechnungen überschrieben.
    • Datentyp: Wählen Sie eine der folgenden Optionen als Datentyp aus. Nachdem Sie den Datentyp ausgewählt haben, können Sie auch die Optionen Erforderlich und/oder Wert verwenden auswählen.
      • Datum
      • Datum/Uhrzeit
      • Ganzzahl
      • Liste: Klicken Sie auf Hinzufügen, und geben Sie Werte für das Attribut ein. Die Liste ist dem Dataset lokal zugeordnet und kann nicht mit anderen Collections geteilt werden.
      • Mehrzeiliger Text: Wenn Sie diese Option auswählen, wählen Sie unter Anzahl Zeilen einen Wert zwischen 3 und 50 aus. Der Standardwert ist 3. Mit mehrzeiligem Text wird die Anzahl der Textzeilen bestimmt, die im Formular in den Dialogfeldern für Aktionen ohne Scrollen sichtbar sind. Die Länge darf maximal 2000 Zeichen betragen. Die Breite für den Textbereich bleibt jedoch fest.

        Aktivieren Sie das Kontrollkästchen Erforderlich, wenn der Datentyp diesen Wert enthalten muss. Wenn Sie das Kontrollkästchen Wert verwenden aktivieren, gilt hier standardmäßig auch der unter Anzahl Zeilen eingegebene Wert. Darüber hinaus ist im Text ein Scroll-Vorgang möglich.

      • Zahl: Wählen Sie diese Option aus, um die Formatierungsoptionen anzugeben. Dadurch werden die Standardeinstellungen im Abschnitt Voreinstellungen der Systemeinstellungen überschrieben.

        Hinweis:

        Für dieses Attribut können Sie nur numerische Werte eingeben.
        • Dezimalstellen: Geben Sie die Anzahl der anzuzeigenden Dezimalstellen ein.
        • Als Prozentsatz anzeigen: Zeigt ein Prozentzeichen an.
        • Tausendertrennzeichen verwenden: Zeigt ein Tausendertrennzeichen an (z.B. 1.000,00) an. Das System zeigt das entsprechende Tausendertrennzeichen für das Benutzergebietsschema an.
        • Währung: Wählen Sie die Währung aus.
        • Format für negative Zahlen: Legen Sie fest, wie negative Zahlen angezeigt werden sollen.
        • Skalierung: Skaliert die Zahl. Der gültige Bereich liegt zwischen 1.000 und 1.000.000.000.000.
      • Text: Geben Sie maximal 255 Zeichen ein.
      • True/False
      • Ja/Nein
    • Erforderlich: Wenn das Attribut erforderlich ist, müssen Sie bei der Dateneingabe einen Wert in dieses Feld eingeben.
    • Wert verwenden: Wenn Sie diesen Wert angeben, wendet das System den vom Designer eingegebenen Wert auf alle vom Benutzer erstellten Datensätze an. Sie können den Standardwert bei der Dateneingabe ändern.
  2. Klicken Sie zum Speichern des Attributs auf OK. Das Fenster "Neues Attribut erstellen" wird geschlossen.
  3. Klicken Sie im Fenster "Collection bearbeiten" auf Speichern, um die Collection zu speichern.

    Hinweis:

    Sie müssen das neue Attribut und die Collection speichern. Erst danach können Sie auf die Registerkarte Validierungen oder Berechnung für das Attribut zugreifen.
  4. Wählen Sie das erstellte Attribut aus, und klicken Sie auf das Symbol Bearbeiten.

    Das Fenster "Attribut bearbeiten" wird angezeigt.

  5. Wenn Sie die Option Eingabe ausgewählt haben (Schritt 1), können Sie in der Registerkarte Validierungen einen bedingten Ausdruck hinzufügen:
    1. Klicken Sie auf Hinzufügen. Der Tabelle wird eine Zeile hinzugefügt.
    2. Klicken Sie auf die Spalten in der ersten Zeile, um die Dropdown-Listen anzuzeigen, in denen Sie den Operator auswählen und entsprechend Wert 1 und Wert 2 eingeben können.
    3. Wenn Sie eine zweite Bedingung benötigen, klicken Sie auf Hinzufügen, um eine weitere Zeile einzufügen.
    4. Klicken Sie auf die Spalten in der zweiten Zeile, um die Dropdown-Listen anzuzeigen, in denen Sie die Konjunktion auswählen können, z.B. Und oder Oder.
    5. Klicken Sie auf OK, um die Bedingungen zu speichern.
  6. Wenn Sie die Option Berechnet ausgewählt haben (Schritt 1), können Sie in der Registerkarte Berechnungen eine Berechnung hinzufügen. Wählen Sie den Berechnungstyp aus:
    • Wert zu Liste zuweisen: Wählen Sie das zugeordnete Attribut aus.
    • Bedingung: Fügen Sie die Bedingung für die Berechnungsdefinition hinzu.
    • Skript: Geben Sie die Berechnungsdefinition an, und wählen Sie Attribut und Funktion aus.
  7. Um einen Berechnungsausdruck hinzuzufügen, geben Sie den Datentyp und den Berechnungstyp an, wie in der folgenden Tabelle beschrieben.

    Tabelle 43-2 Datentyp und Berechnungstyp

    In Registerkarte "Eigenschaften" ausgewählter Datentyp Berechnungstyp Beschreibung
    Für alle Datentypen Wählen Sie Wert zu Liste zuweisen und dann den Wert für Attribut aus.

    Sie müssen die Listenattributwerte gespeichert haben.

    		 Einen Attributwert basierend auf der Zuweisung zu einem Listenelement zurückgeben.
    Für alle Datentypen Bedingt Für ein bestimmtes Attribut Wert A zurückgeben, wenn die angegebenen Bedingungen erfüllt wurden. Attributwert B zurückgeben, wenn die Bedingungen nicht erfüllt wurden.
    Liste Liste zu Wert zuweisen Das zugehörige Element basierend auf dem Wert eines Attributs aus der Liste zurückgeben.
         
         
         
    Ganzzahl, Zahl, Text Skript

    Informationen hierzu finden Sie unter Skriptfunktionen.

    		 Eine skriptgesteuerte Freiform-Berechnung. "Skript" ist für Attribute vom Typ "Ganzzahl", "Mehrzeiliger Text", "Zahl" oder "Text" verfügbar.
  8. Klicken Sie zum Speichern des Attributs auf OK.

    Hinweis:

    Änderungen an Attributen werden nur auf die nachfolgenden Datenerfassungsperioden angewendet.

Skriptfunktionen

  • Absoluter Wert: Gibt den absoluten Wert einer angegebenen Zahl zurück. Wenn eine Zahl kleiner als null ist, wird der positive Wert der Zahl zurückgegeben. Wenn die angegebene Zahl größer-gleich null ist, wird die angegebene Zahl zurückgegeben.

    ABS(<Number>)

  • Monat hinzufügen: Gibt einen Datumsversatz um eine angegebene Anzahl von Monaten ab den Startdatum zurück. Das Datum fällt immer in den angegebenen Monatsversatz. Wenn das Startdatum einen Tageswert angibt, der über die Tage in dem Versatzmonat hinausgeht, wird der letzte Tag des Versatzmonats verwendet. Beispiel: EDate (31-Jan-2017, 1) gibt (28-Feb-2017) zurück. Geben Sie bei Monaten die Anzahl von Monaten vor oder nach dem Startdatum ein. Ein positiver Wert für Monate ergibt ein zukünftiges Datum. Ein negativer Wert ergibt ein vergangenes Datum.

    ADD_MONTH(<Start Date>, <Months>, <Length>)

    Beispiel: ADD_MONTH(DATE(2017, 2, 15) 3)

  • Durchschnitt aus vorherigen: Errechnet den Durchschnitt eines numerischen Betrags für die vorherigen X Perioden.

    AVERAGE_PRIOR(<Value>, <Number of Periods>, <To Currency*>

    Beispiel: AVERAGE_PRIOR( {Balance (Reporting)}, '2', 'EUR'

  • Datum: Gibt einen Datumswert basierend auf den angegebenen ganzzahligen Werten für Jahr, Monat und Tag zurück.

    DATE(<Year>, <Month>, <Day>)

  • Datumsdifferenz: Gibt die Differenz zwischen zwei Daten in Tagen, Stunden, Minuten oder Sekunden zurück. Für DATE 1 und DATE 2 können die Werte TODAY und NOW verwendet werden, die das aktuelle Datum (ohne Zeitkomponente) und Datum/Uhrzeit angeben.

    DATE_DIFF(<Date1>, <Date2>, <Type>)

    Beispiel: DATE_DIFF('TODAY', {Preparer End Date}, 'DAYS') or DATE_DIFF({Preparer End Date}, 'NOW', 'HOURS')

  • Tag: Gibt den Tageswert eines Datums als Ganzzahl zurück

    DAY(<DATE>)

  • Text extrahieren: Gibt die Teilzeichenfolge innerhalb des Wertes von den angegebenen Positionen zurück.

    SUBSTRING(<Value>, <Location>, <Length>)

    Beispiel: SUBSTRING( {Name} , 5, 10)

  • If/Then/Else: Ermöglicht dem Benutzer, eine Konditionalberechnung in die Skriptberechnung einzufügen. IF_THEN_ELSE-Berechnungen können auch verschachtelt werden, um Berechnungen des Typs "ELSE IF" zu unterstützen.

    IF_THEN_ELSE(<Condition>, <Value1>, <Value2>)

    Beispiel:

    IF_THEN_ELSE( {Risk Rating} = 'Low', 'Good',
IF_THEN_ELSE( {Risk Rating} = 'Medium', 'Better',
IF_THEN_ELSE({Risk Rating} = 'High', 'Best','Bad')))
  • Länge: Verwendet einen Textwert als Parameter und gibt eine Ganzzahl zurück, die der Anzahl der Zeichen im Text entspricht. Wenn der Wert leer/null ist, ergibt die Berechnung 0.

    Length ({<attribute>})

    Beispiel: LENGTH('Value') würde 5 ergeben, und LENGTH({Name}) würde die Anzahl der Zeichen im Namen des Objekts ergeben.

    Verwenden Sie die Berechnung mit SUBSTRING, um die letzten vier Zeichen eines Textwertes zu extrahieren.

    SUBSTRING( {MyString}, LENGTH ({MyString}) - 4

  • Kleinbuchstaben: Gibt den Wert in Kleinbuchstaben zurück.

    LOWERCASE(<Value>)

    Beispiel: LOWERCASE( {Description} )

  • Maximum: Gibt den Höchstwert aus einer Liste mit Attributen zurück. Es kann eine beliebige Anzahl von Parametern vorhanden sein.

    MAX(<Value1>, <Value2>,<ValueN>)

    Beispiel: MAX( TRANSLATE( {Source System Balance (Entered)}, 'USD', 'Accounting'), TRANSLATE( {Source System Balance (Functional)}, 'USD', 'Accounting'), TRANSLATE( {Source System Balance (Reporting)}, 'USD', 'Accounting') )

  • Maximum über vorherige: Gibt den Höchstwert für die vorherigen X Perioden zurück.

    MAX_PRIOR (<Value>, <Number of Periods>)

    Beispiel: MAX_PRIOR( {Balance (Functional)}, '6', 'CAD', 'REC')

  • Minimum: Gibt den Mindestwert aus einer Liste mit Attributen zurück. Es kann eine beliebige Anzahl von Parametern vorhanden sein.

    MIN(<Value1>, <Value2>,<ValueN>)

    Beispiel: MIN( TRANSLATE( { Balance (Entered)}, 'CAD', 'REC'), TRANSLATE( {Balance (Functional)}, 'CAD', 'REC'), TRANSLATE( {Balance (Reporting)}, 'CAD', 'REC') )

  • Minimum über vorherige: Gibt den Mindestwert für die vorherigen X Perioden zurück.

    MIN_PRIOR (<Value>, (<Value>, <Number of Periods>). Beispiel: MIN_PRIOR( {Source System Balance (Functional)}, '6', 'EUR', 'Simplified')

  • Monat: Gibt den Monatswert eines Datums als Ganzzahl (1-12) zurück

    MONTH (<DATE>)

  • Potenz: Erhöht eine Zahl um die Potenz einer anderen (Exponentialrechnung).

    POWER(x,y) wobei x=BASE NUMBER, y=EXPONENT, und x sowie y können Attribute oder Berechnungen sein, solange sie numerisch sind.

    Beispiel: POWER(3,4)=81

    Hinweis:

    Bruchzahlen verringern die Zahl um die Wurzel. Beispiel: POWER(27, 1/3) = 3 , die Kubikwurzel.

    Negative Werte führen zu einer Umkehrung der Exponentialrechnung. Beispiel: POWER(2, -2) = 1 / (2^2) = 1 / 4 = .25.

  • Vorherige: Gibt den Wert für die angegebene vorherige Periode zurück.

    PRIOR(<Value>, <Number of Periods Prior>)

    Beispiel: PRIOR( {Source System Balance (Entered)}, '1', 'EUR'')

  • Gerundet: Gibt den Wert auf die angegebenen Dezimalstellen gerundet zurück.

    ROUND(<Value>, <Decimal Places>)

    Beispiel: ROUND( ({Scripted Translate} /7), 4)

  • Summe über vorherige: Gibt die Summe der Werte für die vorherigen X Perioden zurück.

    SUM_PRIOR(<Value>, <Number of Periods>)

    Beispiel: SUM_PRIOR( {Balance (Reporting)}, '3', 'EUR')

  • Textposition: Gibt die Position der Teilzeichenfolge innerhalb des Attributwertes zurück, beginnend bei 1 als Startposition.

    INSTRING(<Value>, <Value To Search>)

    Beispiel: INSTRING( UPPERCASE( {Name} ), 'TAX' )

  • Umrechnen: Rechnet ein Währungsattribut in ein numerisches Attribut mit dem angegebenen Kurstyp um.

    TRANSLATE(<Value>, <To Currency>, <Rate Type>)

    Beispiel: TRANSLATE( {Balance (Entered)}, 'EUR', 'Acct')

  • Großbuchstaben: Gibt den Wert in Großbuchstaben zurück.

    UPPERCASE(<Value>)

    Beispiel: UPPERCASE( {Name} )

  • Jahr: Gibt den Jahreswert eines Datums als Ganzzahl zurück

    YEAR (<DATE>)

Beispiel für das Hinzufügen eines Berechnungsattributs

  1. Erstellen Sie eine Collection mit den folgenden Attributen:

    Int1: Eingabe als Attributtyp und Ganzzahl als Datentyp. Klicken Sie auf OK, und wählen Sie unter "Collection bearbeiten" den Wert Int1 als Schlüssel-ID aus.

    TextInput: Eingabe als Attributtyp und Text als Datentyp.

  2. Speichern Sie die Daten.
  3. Erstellen Sie das Attribut TextCalc mit dem Attributtyp Berechnet und Datentyp "Text".
  4. Geben Sie in der Registerkarte Berechnungen Folgendes an:
    • Berechnungstyp: Wählen Sie Skript aus.
    • Funktion hinzufügen: Wählen Sie TextLocation aus, und klicken Sie anschließend auf Hinzufügen.

      INSTRING(<Value>, <Value To Search>) wird der Berechnungsdefinition hinzugefügt.

    • Klicken Sie auf <Value>, und geben Sie entweder einen Wert ein (in einfache Anführungszeichen gesetzt und unter Berücksichtigung der Groß-/Kleinschreibung), oder wählen Sie unter Attribut hinzufügen das Attribut "TextInput" aus, und klicken Sie auf Hinzufügen.

      <Value> ändert sich in {TextInput}.

    • Ersetzen Sie <Value to Search> durch 'tion'.

      Hinweis: Achten Sie darauf, <xxx> durch einfache Anführungszeichen zu ersetzen: 'xxx'. Beispiel: INSTRING({TextInput}, 'tion')

  5. Klicken Sie zum Speichern der Attribute auf OK.

Attribute aus Dimension hinzufügen

Gehen Sie im Fenster "Attribut aus Dimension hinzufügen" wie folgt vor:

  1. Wählen Sie eine Dimension aus.
  2. Wählen Sie in der Liste Verfügbare Attribute Attribute aus, und verschieben Sie diese in die Liste Ausgewähltes Attribut.

    Das System schließt das Schlüsselattribut der Dimension als ausgewähltes Attribut ein. Sie können das Schlüsselattribut nicht löschen.

  3. Klicken Sie auf OK.

    Das Fenster "Attribut aus Dimension hinzufügen" wird geschlossen, und die ausgewählten Attribute werden im Fenster "Collection bearbeiten" angezeigt.

  4. Sie können das Kontrollkästchen in der Spalte Persistieren aktivieren, um den Wert des Attributs in den referenzierten Formularen zu persistieren. Wenn das Dimensionsattribut aktualisiert wird, werden die Änderungen nicht in den Formularen aktualisiert, in denen das Attribut referenziert wird. Wenn Sie dieses Kontrollkästchen nicht aktivieren, wird das referenzierte Attribut mit den letzten Änderungen aktualisiert. Nach dem Speichern der Collection können Sie diese Einstellung nicht mehr ändern.
  5. Klicken Sie auf Speichern oder Speichern und schließen.