Funções em tempo de compilação de X++

Este artigo lista as funções de tempo de compilação e descreve sua sintaxe, parâmetros e valores retornados.

Overview

As funções de tempo de compilação são executadas antecipadamente durante a compilação do código X++. Eles devem ser usados sempre que possível para tornar o código resiliente a alterações nos metadados armazenados no Gerenciador de Aplicativos. As funções de tempo de compilação têm seu valor de entrada verificado pelo compilador. Se o valor de entrada não for encontrado para corresponder a nenhum objeto existente no Application Explorer, o compilador emitirá um erro. As entradas para essas funções devem ser valores literais, pois o compilador não pode determinar o valor que uma variável contém em tempo de execução. Uma função de tempo de compilação é uma função de asserção de metadados. Ele usa argumentos que representam uma entidade no Gerenciador de Aplicativos e valida os argumentos em tempo de compilação. Ele não tem efeito em tempo de execução. Para dar suporte à validação de metadados de formulário, relatório, consulta e menu, use a propriedade AutoDeclaration nos controles. É sempre melhor obter um erro de compilação do que um literal de cadeia de caracteres e obter erros em runtime.

Algumas funções comuns de tempo de compilação são as seguintes:

  • tableStr - Verifica se o nome fornecido designa uma tabela.
  • classStr – Verifica se existe uma classe desse nome.

As funções intrínsecas são formas sintacticas especiais em X++. Os argumentos podem ser fornecidos como cadeias de caracteres entre aspas ou simplesmente listando os argumentos. As seguintes referências:

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

and

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

são semanticamente idênticos. Nas descrições abaixo, simplesmente mostraremos os argumentos e não especificaremos um tipo, que é óbvio no contexto.

Note

As funções de tempo de compilação X++ não podem ser chamadas de um programa .NET.

Functions

attributeStr

Valida se a classe de atributo especificada existe no Gerenciador de Aplicativos; caso contrário, ocorrerá um erro do compilador.

Syntax

str classStr(name)

Parameters

Parameter Description
name O nome do atributo a ser validado.

Return Value

O nome do atributo.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

str s = attributeStr(AifDocumentOperationAttribute);

classStr

Recupera o nome de uma classe como uma cadeia de caracteres.

Syntax

str classStr(name)

Parameters

Parameter Description
name O nome da classe a ser retornada.

Return Value

O nome da classe.

Remarks

Use essa função em vez de texto literal para recuperar uma cadeia de caracteres que contém o nome da classe. Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

configurationKeyStr

Recupera o nome de uma chave de configuração como uma cadeia de caracteres.

Syntax

str configurationKeyStr(name)

Parameters

Parameter Description
name O nome da chave de configuração.

Return Value

O nome da chave de configuração.

Remarks

Use essa função em vez de texto literal para recuperar uma cadeia de caracteres que contém o nome da chave de configuração. Se a chave não existir, a função gerará um erro de sintaxe no momento da compilação. Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

dataEntityDataSourceStr

Recupera o nome de uma fonte de dados de uma entidade de dados.

Syntax

str dataEntityDataSourceStr(dataEntity, dataSource)

Parameters

Parameter Description
dataEntity O nome da entidade de dados.
dataSource O nome da fonte de dados.

Return Value

O nome da fonte de dados.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

delegateStr

Retorna o nome do delegado.

Syntax

str delegateStr(class, instanceDelegate)

Parameters

Parameter Description
classe O nome da classe, tabela ou formulário.
instanceDelegate O nome do delegado da instância.

Return Value

O nome do delegado.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

dimensionHierarchyLevelStr

Retorna o nome do nível da hierarquia de dimensão.

Syntax

str dimensionHierarchyLevelStr(dimensionHierarchyLevel)

Parameters

Parameter Description
dimensionHierarchyLevel O nome do nível da hierarquia de dimensões.

Return Value

O nome do nível da hierarquia de dimensões.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

dimensionHierarchyStr

Retorna o nome da hierarquia de dimensão.

Syntax

str dimensionHierarchyStr(dimensionHierarchy)

Parameters

Parameter Description
dimensionHierarchy O nome da hierarquia de dimensões.

Return Value

O nome da hierarquia de dimensões.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

dimensionReferenceStr

Retorna o nome da referência de dimensão.

Syntax

str dimensionReferenceStr(dimensionReference)

Parameters

Parameter Description
dimensionReference O nome da referência de dimensão.

Return Value

O nome da referência de dimensão.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

dutyStr

Recupera uma cadeia de caracteres que representa o nome do dever de segurança especificado.

Syntax

str dutyStr(securityDuty)

Parameters

Parameter Description
securityDuty O nome do dever de segurança.

Return Value

O nome do dever de segurança em uma cadeia de caracteres.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

enumCnt

Recupera o número de elementos no tipo de enumeração especificado.

Syntax

int enumCnt(enumtype)

Parameters

Parameter Description
enumtype O tipo de enumeração.

Return Value

O número de elementos no tipo de enumeração especificado.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

enumLiteralStr

Indica se a cadeia de caracteres especificada é um elemento do tipo de enumeração especificado.

Syntax

enumLiteralStr(enum, literal)

Parameters

Parameter Description
enumeração O tipo de enumeração do qual recuperar o valor especificado.
literal O literal a ser retornado do tipo de enumeração.

Return Value

O valor do parâmetro literal se a cadeia de caracteres especificada foi encontrada.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

var literal = enumLiteralStr(ABCEnum, valueInABCEnum);

enumStr

Recupera o nome de uma enumeração como uma cadeia de caracteres.

Syntax

str enumStr(enumName)

Parameters

Parameter Description
enumName O nome da enumeração.

Return Value

O nome da enumeração.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

extendedTypeStr

Recupera o nome de um tipo de dados estendido como uma cadeia de caracteres.

Syntax

str extendedTypeStr(edtName)

Parameters

Parameter Description
edtName O nome do tipo de dados estendido.

Return Value

O nome do tipo de dados estendido.

Remarks

Use essa função em vez de texto literal para retornar uma cadeia de caracteres que contém o nome do tipo de dados estendido. Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

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

Recupera o rótulo do campo especificado.

Syntax

str fieldPName(tableid, fieldid)

Parameters

Parameter Description
tableid A tabela que contém o campo especificado.
fieldid O campo a ser convertido.

Return Value

O rótulo do campo.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

O exemplo a seguir imprime o rótulo do campo CashDisc .

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

Recupera o nome do campo do campo especificado.

Syntax

str fieldStr(tableid, fieldid)

Parameters

Parameter Description
tableid A tabela que contém o campo.
fieldid O campo a ser convertido.

Return Value

O nome do campo especificado.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

O exemplo a seguir atribui o nome do campo CashDisc à variável myText .

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

Faz com que o compilador X++ verifique se o controle existe no formulário e substitua a chamada de função por uma cadeia de caracteres do nome de controle válido.

Syntax

str formControlStr(formName, controlName)

Parameters

Parameter Description
formName O nome do formulário, não entre aspas.
controlName O nome do controle que está no formulário, não entre aspas.

Return Value

Uma cadeia de caracteres que contém o nome do controle como ele aparece no Gerenciador de Aplicativos.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

formDataFieldStr

Retorna o nome de um campo de dados em um formulário.

Syntax

str formDataFieldStr(formName, dataSource, dataField)

Parameters

Parameter Description
formName O nome do formulário.
dataSource A fonte de dados do formulário.
dataField O campo de dados da fonte de dados.

Return Value

O nome de um campo de dados em um formulário.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

formDataSourceStr

Retorna o nome de uma fonte de dados em um formulário.

Syntax

str formDataSourceStr(formName, dataSource)

Parameters

Parameter Description
formName O nome do formulário.
dataSource A fonte de dados do formulário.

Return Value

O nome de uma fonte de dados em um formulário.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

formMethodStr

Retorna o nome de um método de um formulário.

Syntax

str formMethodStr(formName, methodName)

Parameters

Parameter Description
formName O nome do formulário.
methodName O método do formulário.

Return Value

O nome de um método em um formulário.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

formStr

Recupera o nome de um formulário.

Syntax

str formStr(form)

Parameters

Parameter Description
formulário O nome de um formulário.

Return Value

Uma cadeia de caracteres que representa o nome do formulário.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

O exemplo a seguir imprime o nome do formulário InventDim.

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

identifierStr

Converte o identificador especificado em uma cadeia de caracteres.

Syntax

str identifierStr(ident)

Parameters

Parameter Description
ident O identificador a ser convertido.

Return Value

Uma cadeia de caracteres que representa o identificador especificado.

Remarks

Use uma função de tempo de compilação mais específica se houver uma disponível. Essa é uma função de tempo de compilação. Nenhuma verificação do argumento é executada. Para obter mais informações, visão geral.

Example

O exemplo de código a seguir atribui o nome da variável myvar à variável thevar .

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

indexStr

Converte o índice especificado em uma cadeia de caracteres.

Syntax

str indexStr(str tableid, str indexid)

Parameters

Parameter Description
tableid A tabela que contém o índice.
indexid O índice a ser convertido.

Return Value

Uma cadeia de caracteres que representa o índice especificado.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

O exemplo a seguir atribui o valor do índice CashDisc à variável myText .

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

literalStr

Valida se a cadeia de caracteres especificada pode ser uma cadeia de caracteres literal; caso contrário, ocorrerá um erro do compilador.

Syntax

str literalStr(literal)

Parameters

Parameter Description
literal A cadeia de caracteres a ser validada.

Return Value

A cadeia de caracteres literal, se válida.

Remarks

Às vezes, essa função é usada para retornar uma cadeia de caracteres de rótulo sem que a pesquisa do rótulo ocorra, conforme mostrado no exemplo abaixo. Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

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

Recupera o valor máximo permitido para uma variável de data de tipo.

Syntax

date maxDate()

Return Value

O valor máximo permitido para uma variável de data de tipo, que é 2154-12-31.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

maxInt

Recupera o valor máximo assinado que pode ser armazenado em um tipo de int .

Syntax

int maxInt()

Return Value

O valor máximo permitido de um inteiro, que é 2147483647.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

measurementStr

Retorna o nome de uma medida.

Syntax

str measurementStr(measurement)

Parameters

Parameter Description
medida O nome da medida.

Return Value

O nome da medida.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

measureStr

Retorna o nome de uma medida.

Syntax

str measureStr(measure)

Parameters

Parameter Description
medida O nome da medida.

Return Value

O nome da medida.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Retorna o valor de um item de menu Ação.

Syntax

str menuItemActionStr(menuitem)

Parameters

Parameter Description
menuitem O nome do item de menu de ação a ser validado.

Return Value

O nome do item de menu de ação, se for válido.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

Retorna o valor de um item de menu Exibir.

Syntax

str menuitemdisplaystr(menuItem)

Parameters

Parameter Description
menuItem O nome do item de menu de exibição a ser validado.

Return Value

O nome da exibição do item de menu de exibição especificado.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

Retorna o valor de um item de menu Saída.

Syntax

str menuItemOutputStr(menuitem)

Parameters

Parameter Description
menuitem O nome da saída do item de menu a ser validado.

Return Value

A saída do item de menu de saída especificada, se válida.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

Retorna o valor do nome de um menu.

Syntax

str menuStr(menu)

Parameters

Parameter Description
menu O nome do menu a ser validado.

Return Value

O nome do item de menu especificado, se válido.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

methodStr

Retorna o nome de um método de instância de classe.

Syntax

str methodStr(class, method)

Parameters

Parameter Description
classe O nome da classe.
método O nome do método a ser validado.

Return Value

O nome do método de instância especificado, se for válido.

Remarks

Essa função diagnostica erros para métodos estáticos. Use staticMethodStr para métodos estáticos. Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

minInt

Recupera o valor mínimo assinado que pode ser armazenado em um tipo de int .

Syntax

int minInt()

Return Value

O valor mínimo de um tipo int , que é -2147483648.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

privilegeStr

Retorna o nome do privilégio.

Syntax

str privilegeStr(privilege)

Parameters

Parameter Description
privilégio O privilégio para o qual retornar o nome.

Return Value

O nome do privilégio.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

queryDatasourceStr

Retorna o nome de uma fonte de dados em uma consulta.

Syntax

str queryDataSourceStr(queryName, dataSourceName)

Parameters

Parameter Description
queryName O nome da consulta, não entre aspas.
dataSourceName O nome da fonte de dados que está na consulta, não entre aspas.

Return Value

Uma cadeia de caracteres que contém o nome da fonte de dados.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

queryMethodStr

Retorna o nome de um método de uma consulta.

Syntax

str queryMethodStr(queryName, methodName)

Parameters

Parameter Description
queryName O nome da consulta.
methodName O método do formulário.

Return Value

O nome de um método em uma consulta.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

queryStr

Recupera uma cadeia de caracteres que representa uma consulta existente.

Syntax

str queryStr(query)

Parameters

Parameter Description
consulta A consulta a ser recuperada.

Return Value

O nome da consulta.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

reportStr

Recupera uma cadeia de caracteres que representa o nome do relatório especificado.

Syntax

str reportStr(report)

Parameters

Parameter Description
relatório O relatório para o qual retornar o nome.

Return Value

O nome do relatório.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

resourceStr

Valida se o recurso especificado existe no Gerenciador de Aplicativos; se isso não acontecer, ocorrerá um erro do compilador.

Syntax

str resourceStr(resourcename)

Parameters

Parameter Description
resourcename O nome do recurso a ser validado.

Return Value

O nome do recurso especificado, se ele for válido.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

roleStr

Recupera uma cadeia de caracteres que representa o nome da função de segurança especificada.

Syntax

str roleStr(securityRole)

Parameters

Parameter Description
securityRole O nome da função de segurança.

Return Value

O nome da função de segurança em uma cadeia de caracteres.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

ssrsReportStr

Recupera uma cadeia de caracteres que representa o nome do relatório SSRS especificado. Use essa função quando quiser especificar o relatório que deve ser executado por uma classe de controlador de relatório.

Syntax

str ssrsReportStr(report, design)

Parameters

Parameter Description
relatório O relatório para o qual retornar o nome.
design O nome do design associado ao relatório.

Return Value

O nome do relatório.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

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

Retorna o nome de um delegado estático.

Syntax

str staticDelegateStr(class, delegate)

Parameters

Parameter Description
classe O nome de uma classe, tabela ou formulário.
delegado O nome do delegado.

Return Value

O nome do delegado.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

staticMethodStr

Valida se o método estático especificado existe na classe especificada; se isso não acontecer, ocorrerá um erro do compilador.

Syntax

str staticMethodStr(class, int method)

Parameters

Parameter Description
classe O nome da classe.
método O nome do método estático a ser validado.

Return Value

O nome do método estático, se for válido.

Remarks

Essa função falhará se o método designado não for estático. Use a função methodStr se desejar retornar os nomes dos métodos de instância. Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

tableCollectionStr

Valida se a coleção de tabelas especificada existe no Application Explorer; se isso não acontecer, ocorrerá um erro do compilador.

Syntax

str tableCollectionStr(tablecollection)

Parameters

Parameter Description
tablecollection O nome da coleção de tabelas a ser validada.

Return Value

O nome da coleção de tabelas especificada, se ela for válida.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

tableFieldGroupStr

Recupera o nome de um grupo de campos como uma cadeia de caracteres.

Syntax

str tableFieldGroupStr(tableName, fieldGroupName)

Parameters

Parameter Description
tableName A tabela que contém o grupo de campos.
fieldGroupName O grupo de campos na tabela.

Return Value

O nome do grupo de campos como uma cadeia de caracteres.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

O exemplo a seguir recupera o nome do grupo de campos De edição como uma cadeia de caracteres.

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

tableMethodStr

Valida se o método de instância especificado existe na tabela especificada; se isso não acontecer, ocorrerá um erro do compilador.

Syntax

str tableMethodStr(table, method)

Parameters

Parameter Description
tabela O nome da tabela.
método O nome do método a ser validado.

Return Value

O nome do método de instância, se for válido.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

tablePName

Recupera uma cadeia de caracteres que contém o nome imprimível da tabela especificada.

Syntax

str tablePName(str table)

Parameters

Parameter Description
tabela A tabela para a qual recuperar o nome imprimível.

Return Value

O nome da tabela especificada.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

O exemplo a seguir atribui o rótulo da tabela CustTable à variável MyText .

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

Valida se o método estático especificado existe na tabela especificada; se isso não acontecer, ocorrerá um erro do compilador.

Syntax

str tableStaticMethodStr(table, method)

Parameters

Parameter Description
tabela O nome da tabela.
método O nome do método estático a ser validado.

Return Value

O nome do método estático especificado.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

tableStr

Recupera uma cadeia de caracteres que contém o nome da tabela especificada.

Syntax

str tableStr(table)

Parameters

Parameter Description
tabela A tabela para a qual recuperar uma cadeia de caracteres.

Return Value

Um valor de cadeia de caracteres que contém o nome da tabela especificada.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

tileStr

Recupera uma cadeia de caracteres que representa o nome do bloco especificado.

Syntax

str tileStr(tile)

Parameters

Parameter Description
bloco O nome do bloco.

Return Value

O nome do bloco em uma cadeia de caracteres.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

varStr

Recupera uma cadeia de caracteres que contém o nome da variável especificada.

Syntax

str varStr(name)

Parameters

Parameter Description
varName O nome de uma entidade definida.

Return Value

Uma cadeia de caracteres que contém o nome de um item no escopo da chamada.

Remarks

O nome deve corresponder a uma variável definida no método no qual a chamada ocorre ou a um campo no escopo ao redor. Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

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

Valida se o item de ação da Web especificado existe no Gerenciador de Aplicativos; se isso não acontecer, ocorrerá um erro do compilador.

Syntax

str webActionItemStr(webactionitem)

Parameters

Parameter Description
webactionitem O nome do item de ação da Web a ser validado.

Return Value

O nome do item de ação da Web especificado, se for válido.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

webDisplayContentItemStr

Valida se o item de conteúdo de exibição da Web especificado existe no Gerenciador de Aplicativos; se isso não acontecer, ocorrerá um erro do compilador.

Syntax

str webDisplayContentItemStr(webdisplaycontentitem)

Parameters

Parameter Description
webdisplaycontentitem O nome do item de conteúdo de exibição da Web a ser validado.

Return Value

O nome do item de conteúdo de exibição da Web especificado, se for válido.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

workflowApprovalStr

Recupera o nome de uma aprovação de fluxo de trabalho na Árvore de Objetos do Aplicativo (Application Explorer) como uma cadeia de caracteres.

Syntax

str workflowapprovalstr(approval)

Parameters

Parameter Description
aprovação O nome do Gerenciador de Aplicativos da aprovação do fluxo de trabalho.

Return Value

Uma cadeia de caracteres que representa o nome do Gerenciador de Aplicativos da aprovação do fluxo de trabalho.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

workflowCategoryStr

Recupera o nome de uma categoria de fluxo de trabalho na Árvore de Objetos do Aplicativo (Application Explorer) como uma cadeia de caracteres.

Syntax

str workflowcategorystr(category)

Parameters

Parameter Description
categoria O nome do Gerenciador de Aplicativos da categoria de fluxo de trabalho.

Return Value

Uma cadeia de caracteres que representa o nome do Gerenciador de Aplicativos da categoria de fluxo de trabalho.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

workflowTaskStr

Recupera o nome de uma tarefa de fluxo de trabalho na Árvore de Objetos do Aplicativo (Application Explorer) como uma cadeia de caracteres.

Syntax

str workflowtaskstr(task)

Parameters

Parameter Description
tarefa O nome do Gerenciador de Aplicativos da tarefa de fluxo de trabalho.

Return Value

Uma cadeia de caracteres que representa o nome do Gerenciador de Aplicativos da tarefa de fluxo de trabalho.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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

workflowTypeStr

Valida se o tipo de fluxo de trabalho especificado existe no Gerenciador de Aplicativos; se isso não acontecer, ocorrerá um erro do compilador.

Syntax

str workflowTypeStr(workflow)

Parameters

Parameter Description
fluxo de trabalho O nome do tipo de fluxo de trabalho a ser validado.

Return Value

O nome do tipo de fluxo de trabalho.

Remarks

Para obter mais informações sobre funções de tempo de compilação, consulte Visão geral.

Example

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