Freigeben über


Kompilierungszeitfunktionen für X++

Hinweis

Community-Interessensgruppen sind jetzt von Yammer zu Microsoft Viva Engage gewechselt. Um an einer Viva Engage-Community teilzunehmen und an den neuesten Diskussionen teilzunehmen, füllen Sie das Formular "Anfordern des Zugriffs auf Finance and Operations Viva Engage Community" aus , und wählen Sie die Community aus, der Sie beitreten möchten.

In diesem Artikel werden die Kompilierungszeitfunktionen aufgeführt und ihre Syntax, Parameter und Rückgabewerte beschrieben.

Überblick

Kompilierungszeitfunktionen werden frühzeitig während der Kompilierung von X++-Code ausgeführt. Sie sollten nach Möglichkeit verwendet werden, um den Code für Änderungen an den im Anwendungs-Explorer gespeicherten Metadaten widerstandsfähig zu machen. Kompilierungszeitfunktionen haben ihren Eingabewert vom Compiler überprüft. Wenn der Eingabewert nicht mit einem vorhandenen Objekt im Anwendungs-Explorer übereinstimmt, gibt der Compiler einen Fehler aus. Die Eingaben für diese Funktionen müssen Literalwerte sein, da der Compiler den Wert, den eine Variable zur Laufzeit enthält, nicht bestimmen kann. Eine Kompilierungszeitfunktion ist eine Metadaten assertionsfunktion. Es werden Argumente verwendet, die eine Entität im Anwendungs-Explorer darstellen und die Argumente zur Kompilierungszeit überprüfen. Sie hat zur Laufzeit keine Auswirkung. Verwenden Sie die AutoDeclaration-Eigenschaft für Steuerelemente, um die Überprüfung von Formular-, Berichts-, Abfrage- und Menümetadaten zu unterstützen. Es ist immer besser, einen Kompilierungsfehler zu erhalten, als ein Zeichenfolgenliteral und Fehler zur Laufzeit zu erhalten.

Einige gängige Kompilierungszeitfunktionen sind wie folgt:

  • tableStr – Überprüft, ob der angegebene Name eine Tabelle angibt.
  • classStr – Überprüft, ob eine Klasse dieses Namens vorhanden ist.

Systeminterne Funktionen sind spezielle syntaktische Formen in X++. Die Argumente können als Zeichenfolgen bereitgestellt werden, die in Anführungszeichen eingeschlossen sind, oder indem Sie einfach die Argumente auflisten. Die folgenden Verweise:

str s = classStr(MyClass); // No quotes

und

str s = classStr("MyClass"); // class name in quotes.

semantisch identisch. In den folgenden Beschreibungen zeigen wir einfach die Argumente an und geben keinen Typ an, der aus dem Kontext offensichtlich ist.

Hinweis

X++-Kompilierungszeitfunktionen können nicht aus einem .NET-Programm aufgerufen werden.

Funktionen

attributeStr

Überprüft, ob die angegebene Attributklasse im Anwendungs-Explorer vorhanden ist; wenn dies nicht der Fall ist, tritt ein Compilerfehler auf.

Syntax

str classStr(name)

Die Parameter

Parameter Description
name Der Name des zu überprüfenden Attributs.

Rückgabewert

Der Name des Attributs.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

str s = attributeStr(AifDocumentOperationAttribute);

classStr

Ruft den Namen einer Klasse als Zeichenfolge ab.

Syntax

str classStr(name)

Die Parameter

Parameter Description
name Der Name der zurückzugebenden Klasse.

Rückgabewert

Der Name der Klasse.

Bemerkungen

Verwenden Sie diese Funktion anstelle von Literaltext, um eine Zeichenfolge abzurufen, die den Klassennamen enthält. Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

s = classStr(Global); // returns "Global", since there is a class by that name.

configurationKeyStr

Ruft den Namen eines Konfigurationsschlüssels als Zeichenfolge ab.

Syntax

str configurationKeyStr(name)

Die Parameter

Parameter Description
name Der Name des Konfigurationsschlüssels.

Rückgabewert

Der Name des Konfigurationsschlüssels.

Bemerkungen

Verwenden Sie diese Funktion anstelle von Literaltext, um eine Zeichenfolge abzurufen, die den Namen des Konfigurationsschlüssels enthält. Wenn der Schlüssel nicht vorhanden ist, generiert die Funktion zur Kompilierungszeit einen Syntaxfehler. Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

s = configurationKeyStr(AIF); // Returns "AIF" if there is a configuration key of that name

dataEntityDataSourceStr

Ruft den Namen einer Datenquelle einer Datenentität ab.

Syntax

str dataEntityDataSourceStr(dataEntity, dataSource)

Die Parameter

Parameter Description
dataEntity Der Name der Datenentität.
dataSource Der Name der Datenquelle.

Rückgabewert

Der Name der Datenquelle.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

delegateStr

Gibt den Namen der Stellvertretung zurück.

Syntax

str delegateStr(class, instanceDelegate)

Die Parameter

Parameter Description
class Der Name der Klasse, Tabelle oder des Formulars.
instanceDelegate Der Name des Instanzdelegats.

Rückgabewert

Der Name der Stellvertretung.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

dimensionHierarchyLevelStr

Gibt den Namen der Dimensionhierarchieebene zurück.

Syntax

str dimensionHierarchyLevelStr(dimensionHierarchyLevel)

Die Parameter

Parameter Description
dimensionHierarchyLevel Der Name der Dimensionhierarchieebene.

Rückgabewert

Der Name der Dimensionhierarchieebene.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

dimensionHierarchyStr

Gibt den Namen der Dimensionshierarchie zurück.

Syntax

str dimensionHierarchyStr(dimensionHierarchy)

Die Parameter

Parameter Description
dimensionHierarchy Der Name der Dimensionshierarchie.

Rückgabewert

Der Name der Dimensionshierarchie.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

dimensionReferenceStr

Gibt den Namen des Dimensionsverweises zurück.

Syntax

str dimensionReferenceStr(dimensionReference)

Die Parameter

Parameter Description
dimensionReference Der Name des Dimensionsverweises.

Rückgabewert

Der Name des Dimensionsverweises.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

dutyStr

Ruft eine Zeichenfolge ab, die den Namen der angegebenen Sicherheitspflicht darstellt.

Syntax

str dutyStr(securityDuty)

Die Parameter

Parameter Description
securityDuty Der Name der Sicherheitspflicht.

Rückgabewert

Der Name der Sicherheitspflicht in einer Zeichenfolge.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

enumCnt

Ruft die Anzahl der Elemente im angegebenen Enumerationstyp ab.

Syntax

int enumCnt(enumtype)

Die Parameter

Parameter Description
Enumerationstyp Der Enumerationstyp.

Rückgabewert

Die Anzahl der Elemente im angegebenen Enumerationstyp.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

var cnt = enumCnt(NoYes); // Returns 2, as the two elements in the NoYes enum are Yes and No.

enumLiteralStr

Gibt an, ob die angegebene Zeichenfolge ein Element des angegebenen Enumerationstyps ist.

Syntax

enumLiteralStr(enum, literal)

Die Parameter

Parameter Description
enum Der Enumerationstyp, aus dem der angegebene Wert abgerufen werden soll.
Literal Das Literal, das vom Enumerationstyp zurückgegeben werden soll.

Rückgabewert

Der Wert des Literalparameters, wenn die angegebene Zeichenfolge gefunden wurde.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

var literal = enumLiteralStr(ABCEnum, valueInABCEnum);

enumStr

Ruft den Namen einer Enumeration als Zeichenfolge ab.

Syntax

str enumStr(enumName)

Die Parameter

Parameter Description
enumName Der Name der Aufzählung.

Rückgabewert

Der Name der Aufzählung.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

str s = enumStr(ABC); // Returns "ABC" is an enum exists by that name. Otherwise an error is diagnosed.

extendedTypeStr

Ruft den Namen eines erweiterten Datentyps als Zeichenfolge ab.

Syntax

str extendedTypeStr(edtName)

Die Parameter

Parameter Description
edtName Der Name des erweiterten Datentyps.

Rückgabewert

Der Name des erweiterten Datentyps.

Bemerkungen

Verwenden Sie diese Funktion anstelle von Literaltext, um eine Zeichenfolge zurückzugeben, die den erweiterten Datentypnamen enthält. Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns "AccountName" is an extended datatype by that name exists. If no
// such type exists, a error is diagnosed.
var edt = extendedTypeStr(AccountName); 

fieldPName

Ruft die Bezeichnung des angegebenen Felds ab.

Syntax

str fieldPName(tableid, fieldid)

Die Parameter

Parameter Description
tableid Die Tabelle, die das angegebene Feld enthält.
fieldid Das zu konvertierende Feld.

Rückgabewert

Die Bezeichnung des Felds.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

Im folgenden Beispiel wird die Bezeichnung des CashDisc-Felds gedruckt.

static void fieldPNameExample(Args _arg)
{
    str myText;

    myText = fieldPName(CustTable, CashDisc);
    info(strfmt("%1 is the label of the CashDisc field.", myText));
}
/****Infolog Display
Message (02:00:57 pm)
Cash discount is the label of the CashDisc field.
****/

fieldStr

Ruft den Feldnamen des angegebenen Felds ab.

Syntax

str fieldStr(tableid, fieldid)

Die Parameter

Parameter Description
tableid Die Tabelle, die das Feld enthält.
fieldid Das zu konvertierende Feld.

Rückgabewert

Der Feldname des angegebenen Felds.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

Im folgenden Beispiel wird der MyText-Variablen der Name des CashDisc-Felds zugewiesen.

static void fieldStrExample(Args _arg)
{
    str myText = fieldStr(CustTable, CashDisc);
    info(strfmt("%1 is the specified field.", myText));
}
/****Infolog Display
Message (09:11:52 am)
CashDisc is the specified field.
****/

formControlStr

Bewirkt, dass der X++-Compiler überprüft, ob das Steuerelement im Formular vorhanden ist, und den Funktionsaufruf durch eine Zeichenfolge des gültigen Steuerelementnamens ersetzen.

Syntax

str formControlStr(formName, controlName)

Die Parameter

Parameter Description
formName Der Name des Formulars, nicht in Anführungszeichen.
controlName Der Name des Steuerelements, das sich im Formular befindet, nicht in Anführungszeichen.

Rückgabewert

Eine Zeichenfolge, die den Namen des Steuerelements enthält, wie es im Anwendungs-Explorer angezeigt wird.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

formDataFieldStr

Gibt den Namen eines Datenfelds in einem Formular zurück.

Syntax

str formDataFieldStr(formName, dataSource, dataField)

Die Parameter

Parameter Description
formName Der Name des Formulars.
dataSource Die Datenquelle des Formulars.
dataField Das Datenfeld der Datenquelle.

Rückgabewert

Der Name eines Datenfelds in einem Formular.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns "RatePerDay" if the FMVehicle form contains a datasource
// called FMModelRate with a datafield called RatePerDay.
str a = formDataFieldStr(FMVehicle, FMModelRate, RatePerDay);

formDataSourceStr

Gibt den Namen einer Datenquelle in einem Formular zurück.

Syntax

str formDataSourceStr(formName, dataSource)

Die Parameter

Parameter Description
formName Der Name des Formulars.
dataSource Die Datenquelle des Formulars.

Rückgabewert

Der Name einer Datenquelle in einem Formular.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns "FMModelRate" is there is a form called FmVehicle with a
// datasource called FMModelRate.
str b = formDataSourceStr(FMVehicle, FMModelRate);

formMethodStr

Gibt den Namen einer Methode eines Formulars zurück.

Syntax

str formMethodStr(formName, methodName)

Die Parameter

Parameter Description
formName Der Name des Formulars.
methodName Die Methode des Formulars.

Rückgabewert

Der Name einer Methode in einem Formular.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns "showDialog" if there is a form called Batch with a 
// method called showDialog.
str c = formMethodStr(Batch,showDialog);

formStr

Ruft den Namen eines Formulars ab.

Syntax

str formStr(form)

Die Parameter

Parameter Description
Formular Der Name eines Formulars.

Rückgabewert

Eine Zeichenfolge, die den Namen des Formulars darstellt.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

Im folgenden Beispiel wird der Name des InventDim-Formulars gedruckt.

// Returns "InventDim" if there is a form defined by that name.
var s = formStr(InventDim); 

identifierStr

Konvertiert den angegebenen Bezeichner in eine Zeichenfolge.

Syntax

str identifierStr(ident)

Die Parameter

Parameter Description
ident Der zu konvertierende Bezeichner.

Rückgabewert

Eine Zeichenfolge, die den angegebenen Bezeichner darstellt.

Bemerkungen

Verwenden Sie eine spezifischere Kompilierungszeitfunktion, wenn eine verfügbar ist. Dies ist eine Kompilierungszeitfunktion. Es wird keine Überprüfung des Arguments ausgeführt. Weitere Informationen, Übersicht.

Example

Im folgenden Codebeispiel wird der Variablenname "myvar" der Variablen zugewiesen.

static void indentifierStrExample(Args _args)
{
    str thevar = "[" + identifierStr(myvar) + "]";
    info(strfmt(thevar));
}
/****Infolog Display
Message (09:19:49 am)
[myvar]
****/

indexStr

Konvertiert den angegebenen Index in eine Zeichenfolge.

Syntax

str indexStr(str tableid, str indexid)

Die Parameter

Parameter Description
tableid Die Tabelle, die den Index enthält.
indexid Der zu konvertierende Index.

Rückgabewert

Eine Zeichenfolge, die den angegebenen Index darstellt.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

Im folgenden Beispiel wird der MyText-Variablen der CashDisc-Indexwert zugewiesen.

// Returns "SSNIndex" if there is a table called MyTable with an index called SSNIndex.
var idx = indexStr(MyTable, SSNIndex);

literalStr

Überprüft, ob die angegebene Zeichenfolge eine Literalzeichenfolge sein kann; wenn dies nicht der Fall ist, tritt ein Compilerfehler auf.

Syntax

str literalStr(literal)

Die Parameter

Parameter Description
Literal Die zu überprüfende Zeichenfolge.

Rückgabewert

Die literale Zeichenfolge, falls gültig.

Bemerkungen

Diese Funktion wird manchmal verwendet, um eine Bezeichnungszeichenfolge zurückzugeben, ohne dass die Bezeichnung gesucht wird, wie im folgenden Beispiel gezeigt. Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns "This is a literal str"
var s = literalStr("This is a literal str");

// Returns the string "@SYS12345", not the label that this
// label specifier may represent.
var labelStr = literalStr("@SYS12345");

maxDate

Ruft den maximal zulässigen Wert für eine Variable vom Typ Datum ab.

Syntax

date maxDate()

Rückgabewert

Der maximal zulässige Wert für eine Variable vom Typ "Date", also 2154-12-31.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

static void maxDateExample(Args _arg)
{
    date maximumDate = maxDate();
    print maximumDate;
    pause;
}

maxInt

Ruft den maximal signierten Wert ab, der in einem Int-Typ gespeichert werden kann.

Syntax

int maxInt()

Rückgabewert

Der maximal zulässige Wert einer ganzen Zahl, die 2147483647 ist.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

static void maxIntExample(Args _arg)
{
    print "The maximum value for type int is " + int2Str(maxInt());
    pause;
}

measurementStr

Gibt den Namen einer Maßeinheit zurück.

Syntax

str measurementStr(measurement)

Die Parameter

Parameter Description
Messung Der Name der Maßeinheit.

Rückgabewert

Der Name der Maßeinheit.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

measureStr

Gibt den Namen eines Measures zurück.

Syntax

str measureStr(measure)

Die Parameter

Parameter Description
Measure Der Name der Maßnahme.

Rückgabewert

Der Name der Maßnahme.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Gibt den Wert eines Aktionsmenüelements zurück.

Syntax

str menuItemActionStr(menuitem)

Die Parameter

Parameter Description
Menuitem Der Name des zu überprüfenden Aktionsmenüelements.

Rückgabewert

Der Name des Aktionsmenüelements, sofern er gültig ist.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// returns 'AssetCopy' if there is an Action menu of that name defined.
var s1 = menuItemActionStr(AssetCopy);

Gibt den Wert eines Anzeigemenüelements zurück.

Syntax

str menuitemdisplaystr(menuItem)

Die Parameter

Parameter Description
Menuitem Der Name des zu überprüfenden Anzeigemenüelements.

Rückgabewert

Der Name der angegebenen Anzeigemenüelementanzeige.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns "Address" if a display menu item of that name is defined.
var s2 = menuItemDisplayStr(Address);

Gibt den Wert eines Ausgabemenüelements zurück.

Syntax

str menuItemOutputStr(menuitem)

Die Parameter

Parameter Description
Menuitem Der Name der zu überprüfenden Menüelementausgabe.

Rückgabewert

Die angegebene Ausgabe des Ausgabemenüelements, sofern gültig.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns "AssetBarCode" if an output menu item by that name exists.
var s = menuItemOutputStr(AssetBarcode);

Gibt den Namenswert eines Menüs zurück.

Syntax

str menuStr(menu)

Die Parameter

Parameter Description
Menü Der Name des zu überprüfenden Menüs.

Rückgabewert

Der Name des angegebenen Menüelements, sofern gültig.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns "Administration" if a menu by that name is defined.
var s = menuStr(Administration);

methodStr

Gibt den Namen einer Klasseninstanzmethode zurück.

Syntax

str methodStr(class, method)

Die Parameter

Parameter Description
class Der Name der Klasse.
method Der Name der zu überprüfenden Methode.

Rückgabewert

Der Name der angegebenen Instanzmethode, sofern dies gültig ist.

Bemerkungen

Diese Funktion diagnoset Fehler für statische Methoden. Verwenden Sie staticMethodStr für statische Methoden. Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns "timeout" if there is a class called SysHelpInitTimeout that 
// has a method called timeout.
var s = methodStr(SysHelpInitTimeOut, timeout);

minInt

Ruft den minimal signierten Wert ab, der in einem Int-Typ gespeichert werden kann.

Syntax

int minInt()

Rückgabewert

Der Mindestwert eines Int-Typs , der -2147483648 ist.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

static void minIntExample(Args _arg)
{
    int i = minInt();
    print "minInt() is " + int2Str(i);    
    pause;
}

privilegeStr

Gibt den Namen der Berechtigung zurück.

Syntax

str privilegeStr(privilege)

Die Parameter

Parameter Description
Privileg Die Berechtigung, für die der Name zurückgegeben werden soll.

Rückgabewert

Der Name des Rechts.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

queryDatasourceStr

Gibt den Namen einer Datenquelle für eine Abfrage zurück.

Syntax

str queryDataSourceStr(queryName, dataSourceName)

Die Parameter

Parameter Description
queryName Der Name der Abfrage, nicht in Anführungszeichen.
dataSourceName Der Name der Datenquelle, die sich in der Abfrage befindet, nicht in Anführungszeichen.

Rückgabewert

Eine Zeichenfolge, die den Namen der Datenquelle enthält.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

queryMethodStr

Gibt den Namen einer Methode einer Abfrage zurück.

Syntax

str queryMethodStr(queryName, methodName)

Die Parameter

Parameter Description
queryName Der Name der Abfrage.
methodName Die Methode des Formulars.

Rückgabewert

Der Name einer Methode in einer Abfrage.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

queryStr

Ruft eine Zeichenfolge ab, die eine vorhandene Abfrage darstellt.

Syntax

str queryStr(query)

Die Parameter

Parameter Description
Anfrage Die abzurufende Abfrage.

Rückgabewert

Der Name der Abfrage.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns 'AssetTable' if a query by that name is defined.
str myText = queryStr(AssetTable);

reportStr

Ruft eine Zeichenfolge ab, die den Namen des angegebenen Berichts darstellt.

Syntax

str reportStr(report)

Die Parameter

Parameter Description
report Der Bericht, für den der Name zurückgegeben werden soll.

Rückgabewert

Der Name des Berichts.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns "AssetAddition" if a report by that name is defined.
var r = reportStr(AssetAddition);

resourceStr

Überprüft, ob die angegebene Ressource im Anwendungs-Explorer vorhanden ist; Wenn dies nicht der Fall ist, tritt ein Compilerfehler auf.

Syntax

str resourceStr(resourcename)

Die Parameter

Parameter Description
ressourcenname Der Name der zu überprüfenden Ressource.

Rückgabewert

Der Name der angegebenen Ressource, sofern sie gültig ist.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// R'eturns 'StyleSheet_Help_Axapta' if a resource by that name is defined.
var r = resourceStr(StyleSheet_Help_Axapta);

roleStr

Ruft eine Zeichenfolge ab, die den Namen der angegebenen Sicherheitsrolle darstellt.

Syntax

str roleStr(securityRole)

Die Parameter

Parameter Description
securityRole Der Name der Sicherheitsrolle.

Rückgabewert

Der Name der Sicherheitsrolle in einer Zeichenfolge.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

ssrsReportStr

Ruft eine Zeichenfolge ab, die den Namen des angegebenen SSRS-Berichts darstellt. Verwenden Sie diese Funktion, wenn Sie den Bericht angeben möchten, der von einer Berichtscontrollerklasse ausgeführt werden soll.

Syntax

str ssrsReportStr(report, design)

Die Parameter

Parameter Description
report Der Bericht, für den der Name zurückgegeben werden soll.
Entwurf Der Name des Entwurfs, der dem Bericht zugeordnet ist.

Rückgabewert

Der Name des Berichts.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

public static void main(Args _args)
{
    // Initializing the object for a controller class, in this case, the class named AssetListingController.
    SrsReportRunController controller = new AssetListingController();

    // Getting the properties of the called object (in this case AssetListing MenuItem)
    controller.parmArgs(_args);

    // Setting the Report name for the controller.
    controller.parmReportName(ssrsReportStr(AssetListing, Report));

    // Initiate the report execution.
    controller.startOperation();
}

staticDelegateStr

Gibt den Namen einer statischen Stellvertretung zurück.

Syntax

str staticDelegateStr(class, delegate)

Die Parameter

Parameter Description
class Der Name einer Klasse, einer Tabelle oder eines Formulars.
delegieren Der Name der Stellvertretung.

Rückgabewert

Der Name der Stellvertretung.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

staticMethodStr

Überprüft, ob die angegebene statische Methode in der angegebenen Klasse vorhanden ist; Wenn dies nicht der Fall ist, tritt ein Compilerfehler auf.

Syntax

str staticMethodStr(class, int method)

Die Parameter

Parameter Description
class Der Name der Klasse.
method Der Name der zu überprüfenden statischen Methode.

Rückgabewert

Der Name der statischen Methode, sofern sie gültig ist.

Bemerkungen

Diese Funktion schlägt fehl, wenn die angegebene Methode nicht statisch ist. Verwenden Sie die MethodStr-Funktion, wenn Sie die Namen der Instanzmethoden zurückgeben möchten. Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

tableCollectionStr

Überprüft, ob die angegebene Tabellenauflistung im Anwendungs-Explorer vorhanden ist; Wenn dies nicht der Fall ist, tritt ein Compilerfehler auf.

Syntax

str tableCollectionStr(tablecollection)

Die Parameter

Parameter Description
tablecollection Der Name der zu überprüfenden Tabellensammlung.

Rückgabewert

Der Name der angegebenen Tabellenauflistung, sofern dies gültig ist.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

tableFieldGroupStr

Ruft den Namen einer Feldgruppe als Zeichenfolge ab.

Syntax

str tableFieldGroupStr(tableName, fieldGroupName)

Die Parameter

Parameter Description
tableName Die Tabelle, die die Feldgruppe enthält.
fieldGroupName Die Feldgruppe in der Tabelle.

Rückgabewert

Der Name der Feldgruppe als Zeichenfolge.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

Im folgenden Beispiel wird der Name der Bearbeitungsfeldgruppe als Zeichenfolge abgerufen.

// Returns 'Editing' if there is a table called AccountingDistribution that has a
// fieldgroup called Editing.
var fg = tableFieldGroupStr(AccountingDistribution, Editing);

tableMethodStr

Überprüft, ob die angegebene Instanzmethode in der angegebenen Tabelle vorhanden ist; Wenn dies nicht der Fall ist, tritt ein Compilerfehler auf.

Syntax

str tableMethodStr(table, method)

Die Parameter

Parameter Description
Tisch Der Name der Tabelle.
method Der Name der zu überprüfenden Methode.

Rückgabewert

Der Name der Instanzmethode, sofern sie gültig ist.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

tablePName

Ruft eine Zeichenfolge ab, die den druckbaren Namen der angegebenen Tabelle enthält.

Syntax

str tablePName(str table)

Die Parameter

Parameter Description
Tisch Die Tabelle, für die der druckbare Name abgerufen werden soll.

Rückgabewert

Der Name der angegebenen Tabelle.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

Im folgenden Beispiel wird der MyText-Variablen die Beschriftung der CustTable-Tabelle zugewiesen.

static void tablePNameExample(Args _args)
{
    str MyText = tablePname(CustTable);
    info(strfmt("%1 is the label of the CustTable table.", MyText));
}
/**** Infolog Display.
Message (12:13:53 pm)
Customers is the label of the CustTable table.
****/

tableStaticMethodStr

Überprüft, ob die angegebene statische Methode in der angegebenen Tabelle vorhanden ist; Wenn dies nicht der Fall ist, tritt ein Compilerfehler auf.

Syntax

str tableStaticMethodStr(table, method)

Die Parameter

Parameter Description
Tisch Der Name der Tabelle.
method Der Name der zu überprüfenden statischen Methode.

Rückgabewert

Der Name der angegebenen statischen Methode.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

tableStr

Ruft eine Zeichenfolge ab, die den Namen der angegebenen Tabelle enthält.

Syntax

str tableStr(table)

Die Parameter

Parameter Description
Tisch Die Tabelle, für die eine Zeichenfolge abgerufen werden soll.

Rückgabewert

Ein Zeichenfolgenwert, der den Namen der angegebenen Tabelle enthält.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns 'CustTable' if a table by that name is defined.
var t = tableStr(CustTable);

tileStr

Ruft eine Zeichenfolge ab, die den Namen der angegebenen Kachel darstellt.

Syntax

str tileStr(tile)

Die Parameter

Parameter Description
Fliese Der Name der Kachel.

Rückgabewert

Der Name der Kachel in einer Zeichenfolge.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

varStr

Ruft eine Zeichenfolge ab, die den Namen der angegebenen Variablen enthält.

Syntax

str varStr(name)

Die Parameter

Parameter Description
Varname Der Name einer definierten Entität.

Rückgabewert

Eine Zeichenfolge, die den Namen eines Elements im Bereich des Aufrufs enthält.

Bemerkungen

Der Name muss mit einer Variablen übereinstimmen, die in der Methode definiert ist, in der der Aufruf erfolgt, oder einem Feld im umgebenden Bereich. Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

static void varStrExample(Args _arg)
{
    str myString;
    anytype myVariable;

    myString = varStr(myVariable);
    info(strfmt("%1 is the variable name.", myString));
}
/****Infolog Display.
Message (02:26:56 pm)
myVariable is the variable name.
****/

webActionItemStr

Überprüft, ob das angegebene Webaktionselement im Anwendungs-Explorer vorhanden ist; Wenn dies nicht der Fall ist, tritt ein Compilerfehler auf.

Syntax

str webActionItemStr(webactionitem)

Die Parameter

Parameter Description
webactionitem Der Name des zu überprüfenden Webaktionselements.

Rückgabewert

Der Name des angegebenen Webaktionselements, sofern es gültig ist.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns 'EPFlushData' if a web action by that name is defined.
str s = webActionItemStr(EPFlushData);

webDisplayContentItemStr

Überprüft, ob das angegebene Webanzeigeinhaltselement im Anwendungs-Explorer vorhanden ist; Wenn dies nicht der Fall ist, tritt ein Compilerfehler auf.

Syntax

str webDisplayContentItemStr(webdisplaycontentitem)

Die Parameter

Parameter Description
webdisplaycontentitem Der Name des zu überprüfenden Webanzeigeinhaltselements.

Rückgabewert

Der Name des angegebenen Webanzeigeinhaltselements, sofern er gültig ist.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns 'EPAdmin' if a web display content item by that name is defined.
str s = webDisplayContentItemStr(EPAdmin);

workflowApprovalStr

Ruft den Namen einer Workflowgenehmigung in der Anwendungsobjektstruktur (Anwendungs-Explorer) als Zeichenfolge ab.

Syntax

str workflowapprovalstr(approval)

Die Parameter

Parameter Description
Genehmigung Der Name des Anwendungs-Explorers der Workflowgenehmigung.

Rückgabewert

Eine Zeichenfolge, die den Anwendungs-Explorer-Namen der Workflowgenehmigung darstellt.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns 'MyWorkflowApproval' if a workflow approval by that name is defined.
str s = workflowapprovalstr(MyWorkflowApproval);

workflowCategoryStr

Ruft den Namen einer Workflowkategorie in der Anwendungsobjektstruktur (Anwendungs-Explorer) als Zeichenfolge ab.

Syntax

str workflowcategorystr(category)

Die Parameter

Parameter Description
Kategorie Der Name des Anwendungs-Explorers der Workflowkategorie.

Rückgabewert

Eine Zeichenfolge, die den Anwendungs-Explorer-Namen der Workflowkategorie darstellt.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns 'MyWorkflowCategory' if a workflow category by that name is defined.
str s = workflowcategorystr(MyWorkflowCategory);

workflowTaskStr

Ruft den Namen einer Workflowaufgabe in der Anwendungsobjektstruktur (Anwendungs-Explorer) als Zeichenfolge ab.

Syntax

str workflowtaskstr(task)

Die Parameter

Parameter Description
Aufgabe Der Anwendungs-Explorer-Name der Workflowaufgabe.

Rückgabewert

Eine Zeichenfolge, die den Anwendungs-Explorer-Namen der Workflowaufgabe darstellt.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns 'MyWorkflowTask' si a workflow task by that name has been defined.
str s = workflowtaskstr(MyWorkflowTask);

workflowTypeStr

Überprüft, ob der angegebene Workflowtyp im Anwendungs-Explorer vorhanden ist; Wenn dies nicht der Fall ist, tritt ein Compilerfehler auf.

Syntax

str workflowTypeStr(workflow)

Die Parameter

Parameter Description
Arbeitsablauf Der Name des zu überprüfenden Workflowtyps.

Rückgabewert

Der Name des Workflowtyps.

Bemerkungen

Weitere Informationen zu Kompilierungszeitfunktionen finden Sie unter Übersicht.

Example

// Returns 'BudgetAccountEntryType' if a workflow by that name is defined.