Attribute definieren

Name

Attributtyp:

• Datum

• Datum und Uhrzeit

• Ganzzahl

• Liste:

  Geben Sie bei Auswahl von "Liste" die Liste der gültigen Antworten für die Frage ein.

• Mehrzeiliger Text

  Die Zeichenfolge darf maximal 4.000 Zeichen lang sein.

  Wählen Sie Mehrzeiliger Text aus, und geben Sie dann als Angabe für die Zeilenanzahl eine Anzahl zwischen 3 und 50 Zeilen ein. Mit der Option "Mehrzeiliger Text" wird festgelegt, wie viele Textzeilen in den Dialogfeldern für Aktionen ohne Scrollen sichtbar sind.

  Für den Typ "Mehrzeiliger Text": Wählen Sie Anhänge einschließen aus, wenn Sie einen Abschnitt mit Anhängen in das benutzerdefinierte Attribut im Dialogfeld "Aktionen" einschließen möchten.

• Zahl:

  Wählen Sie bei Auswahl von "Zahl" Formatierungsoptionen aus

  • Geben Sie bei Auswahl von "Dezimalstellen" einen Wert für die Anzahl der anzuzeigenden Dezimalstellen an.

  • Wählen Sie die Option "Tausendertrennzeichen" aus, wenn für Zahlen ein Tausendertrennzeichen (z.B. 1.000,00) angezeigt werden soll.

  • Wählen Sie in der Liste " Währungssymbol" ein Währungssymbol aus, z.B. $ für US-Dollar.

  • Wählen Sie in der Liste "Negative Zahl" aus, wie negative Zahlen angezeigt werden sollen, z.B. (123).

  • Wählen Sie in der Liste "Skalierung" einen Skalierungswert für Zahlen aus, z.B. 1000.

• Text

• True oder False

• Benutzer

• Ja oder Nein

Berechnung

Berechnete Attribute sind schreibgeschützt. Berechnungen können nur anhand von Zeitplänen evaluiert werden:

• Zeitpläne: Sie können in den Ansichten "Aufgabenliste", "Gantt" oder "BI Dashboard" jede beliebige Berechnung hinzufügen. Diese wird unabhängig davon evaluiert, ob sie der Aufgabe explizit zugewiesen wurde oder nicht.

• Vorlagen: Sie können kein benutzerdefiniertes Attribut mit ausgewählter Berechnungsoption als Spalten- oder Filterattribut hinzufügen.

Administratoren können Attribute zu den Attributabschnitten in den Aktionsdialogfeldern hinzufügen. Diese Attribute können dann von Workflow-Benutzern angezeigt werden. Administratoren können den Zugriff auf bestimmte Rollen beschränken, indem Sie den Zugriff auf "Nicht anzeigen" setzen. Für das berechnete Attribut "XYZ" beispielsweise könnte ein Administrator den Zugriff "Leseberechtigter: Nicht anzeigen" festlegen, sodass XYZ Leseberechtigten nicht angezeigt würde.

Jede Benutzerrolle kann berechnete Attribute als Spalten in Ansichten und Portlets hinzufügen. Sie können auch als filterbare Attribute in den Filtereinstellungen hinzugefügt werden.

Wenn Sie Berechnung auswählen, wird ein Abschnitt zum Definieren der Berechnung angezeigt:

• Berechnungstyp: Die Liste der Werte wird durch den Attributtyp bestimmt:

  • Wert zu Liste zuweisen - Weisen Sie einem Attribut vom Typ "Liste" benutzerdefinierte Werte zu.

  • Liste zu Wert zuweisen - Weisen Sie benutzerdefinierte Listenwerte den Werten eines anderen Attributs zu.

  • Bedingt - Eine bedingte Berechnung (If-Then-Else)

  • Skript - Eine skriptgesteuerte Freiform-Berechnung. "Skript" ist für Attribute vom Typ "Ganzzahl", "Mehrzeiliger Text", "Zahl" oder "Text" verfügbar.

  In der folgenden Tabelle sind die Berechnungstypen aufgelistet, die jeder Attributtyp verwenden kann, wenn die Option "Berechnung" ausgewählt wird:

  Tabelle 3-2 Attribute definieren

  Attributtyp	Wert zu Liste zuweisen	Bedingung	Skript	Liste zu Wert zuweisen
  Datum
  Datum/Uhrzeit
  Ganzzahl	X	X	X
  Liste		X		X
  Mehrzeiliger Text	X	X	X
  Zahl	X	X	X
  Text	X	X	X
  True/False		X
  Benutzer
  Ja/Nein		X

• Wenn Sie den Berechnungstyp Skript auswählen, verwenden Sie "Attribut hinzufügen" und "Funktion hinzufügen", um eine Freiform-Berechnungsgleichung einzugeben:

  Attribut hinzufügen - Wählen Sie ein Attribut aus, und klicken Sie auf , um das Attribut im Feld "Berechnungsdefinition" dort einzufügen, wo sich der Cursor befindet. Wenn sich der Cursor in der Mitte eines Wortes oder Attributs befindet, wird das Wort/das Attribut in der Definition ersetzt. Der Name für jedes Attribut, das hinzugefügt wird, steht entsprechend dem Skripterstellungsformat in Klammern {}.

• Funktion hinzufügen - Wählen Sie eine Funktion aus, und klicken Sie auf , um die Funktion der Berechnungsdefinition hinzuzufügen. Die Funktion wird mit Platzhaltern für jeden Parameter hinzugefügt.

  Beispiel: Fügen Sie die Funktion DATE_DIFF in die Berechnungsdefinition ein:

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

  Ersetzen Sie dann die Platzhalter durch Attribute:

  DATE_DIFF( {Startdatum}, {Enddatum}, 'DAYS')

  Weitere Beispiele für Skriptfunktionen:

  • 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.

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

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

  • Datum: Gibt einen Datumswert basierend auf den angegebenen ganzzahligen Werten für Jahr, Monat und Tag zurück. Beispiel: Diese Funktion erstellt einen Wert des Typs "Datum" aus der Funktion. DATE(2018, 5, 31) wird also in den 31. Mai 2018 konvertiert. Dieses Datum kann anschließend in der Funktion "Datumsdifferenz" verwendet werden, um die Differenz in Tagen zwischen einem Datum, z.B. einem Enddatum, und diesem bestimmten Datum abzurufen.

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

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

    Gültige Typen sind DAYS, HOURS, MINUTES, SECONDS.

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

    Beispiel: DATE_DIFF('TODAY', {Preparer End Date}, 'DAYS') oder 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 bedingte Berechnung in die skriptbasierte Berechnung einzufügen. IF_THEN_ELSE-Berechnungen können verschachtelt werden, um auch Berechnungen vom Typ “ELSE IF” zu unterstützen.

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

    Beispiel:

    IF_THEN_ELSE( ( {Priority} = 'Low'), 'Good'
    IF_THEN_ELSE( ( {Priority} = 'Medium'), 'Better'. 'Best') )

  • Instring: Gibt den Wert der Suche zurück.

    INSTRING(<Value1>, <Value to Search>)

    Beispiel: INSTRING({Name}, 'a')

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

    LOWERCASE(<Value>)

    Beispiel: LOWERCASE ({Aufgabencode})

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

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

    Beispiel: MAX( {Position von skriptgesteuerter Teilzeichenfolge a}, {Position von skriptgesteuerter Teilzeichenfolge s}, {Position von skriptgesteuerter Teilzeichenfolge t} )

  • 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( {Position von skriptgesteuerter Teilzeichenfolge a}, {Position von skriptgesteuerter Teilzeichenfolge s}, {Position von skriptgesteuerter Teilzeichenfolge t} )

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

    MONTH (<DATE>)

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

    (ROUND <Value1>, <Decimal Places>)

    Beispiel: ROUND( ({Position von skriptgesteuerter Teilzeichenfolge t} / 7), '4')

  • Teilzeichenfolge:

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

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

  • Textposition: Gibt den Index der Teilzeichenfolge innerhalb des Wertes zurück, angefangen mit 1 als der ersten Position.

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

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

  • 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>)

ob die Syntax der Berechnung stimmt

ob die in der Berechnung angegebenen Attribute und Funktionen vorhanden sind

ob die Zuordnung von Parametern zu Funktionen stimmt

dass keine logischen Schleifen vorliegen