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

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

Overview

As funções em tempo de compilação são executadas cedo durante a compilação do código X++. Devem ser usados sempre que possível para tornar o código resiliente a alterações aos metadados armazenados no Explorador de Aplicações. 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 Explorador de Aplicações, o compilador emite um erro. As entradas destas funções devem ser valores literais, porque o compilador não consegue 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. Pega nos argumentos que representam uma entidade no Application Explorer e valida os argumentos em tempo de compilação. 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 em controles. É sempre melhor receber um erro de compilação do que um literal de string e ter erros em tempo de execução.

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

  • tableStr - Verifica que o nome fornecido designa uma tabela.
  • classStr – Verifica que existe uma classe com esse nome.

As funções intrínsecas são formas sintáticas especiais em X++. Os argumentos podem ser apresentados como cadeias incluídas 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, vamos simplesmente mostrar os argumentos, sem especificar um tipo que seja óbvio pelo contexto.

Note

Funções de compilação X++ não podem ser chamadas a partir de um programa .NET.

Funções

attributeStr

Valida se a classe de atributo especificada existe no Application Explorer; caso contrário, ocorre um erro de compilador.

Syntax

str classStr(name)

Parameters

Parameter Description
name O nome do atributo a ser validado.

Return Value

O nome do atributo.

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja 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 gera um erro de sintaxe em tempo de compilação. Para mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja Visão Geral.

dimensionHierarchyLevelStr

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

Syntax

str dimensionHierarchyLevelStr(dimensionHierarchyLevel)

Parameters

Parameter Description
dimensionHierarchyLevel O nome do nível de hierarquia da dimensão.

Return Value

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

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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ão.

Return Value

O nome da hierarquia de dimensão.

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja 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 devolvido do tipo de enumeração.

Return Value

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

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja 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 para converter.

Return Value

O rótulo do campo.

Remarks

Para mais informações sobre funções em tempo de compilação, veja Visão Geral.

Example

O exemplo a seguir imprime a etiqueta 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 especificado.

Syntax

str fieldStr(tableid, fieldid)

Parameters

Parameter Description
tableid A tabela que contém o campo.
fieldid O campo para converter.

Return Value

O nome do campo especificado.

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 Application Explorer.

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja 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 compilação mais específica, se houver disponível. Esta é uma função de tempo de compilação. Não é realizada qualquer verificação do argumento. 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 converter.

Return Value

Uma cadeia de caracteres que representa o índice especificado.

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 que a cadeia de caracteres especificada pode ser uma cadeia de caracteres literal; caso contrário, ocorre um erro de 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

Esta função é por vezes usada para devolver uma cadeia de etiquetas sem que a consulta da etiqueta seja realizada, como mostrado no exemplo abaixo. Para mais informações sobre funções em tempo de compilação, veja 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 do tipo date.

Syntax

date maxDate()

Return Value

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

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 int .

Syntax

int maxInt()

Return Value

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

Remarks

Para mais informações sobre funções em tempo de compilação, veja Visão Geral.

Example

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

measurementStr

Devolve o nome de uma medida.

Syntax

str measurementStr(measurement)

Parameters

Parameter Description
measurement O nome da medição.

Return Value

O nome da medição.

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja Visão Geral.

Devolve o valor de um item do menu Ação.

Syntax

str menuItemActionStr(menuitem)

Parameters

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

Return Value

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

Remarks

Para mais informações sobre funções em tempo de compilação, veja Visão Geral.

Example

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

Devolve o valor de um item do menu Display.

Syntax

str menuitemdisplaystr(menuItem)

Parameters

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

Return Value

O nome do item do menu de visualização especificado.

Remarks

Para mais informações sobre funções em tempo de compilação, veja Visão Geral.

Example

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

Devolve o valor de um item do menu de 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 especificada do item do menu se for válida.

Remarks

Para mais informações sobre funções em tempo de compilação, veja Visão Geral.

Example

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

Devolve 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 mais informações sobre funções em tempo de compilação, veja Visão Geral.

Example

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

methodStr

Devolve 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

Esta função diagnostica erros em métodos que são estáticos. Use staticMethodStr para métodos estáticos. Para mais informações sobre funções em tempo de compilação, veja 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 int .

Syntax

int minInt()

Return Value

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

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja Visão Geral.

queryDatasourceStr

Devolve o nome de uma fonte de dados numa 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 que contém o nome da fonte de dados.

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja Visão Geral.

Example

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

resourceStr

Valida que o recurso especificado existe no Explorador de Aplicações; se não acontecer, ocorre um erro no compilador.

Syntax

str resourceStr(resourcename)

Parameters

Parameter Description
resourcename O nome do recurso a ser validado.

Return Value

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

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja Visão Geral.

ssrsReportStr

Recupera uma cadeia que representa o nome do relatório SSRS especificado. Use essa função quando desejar 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 retornar o nome.
design O nome do design associado ao relatório.

Return Value

O nome do relatório.

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja Visão Geral.

staticMethodStr

Valida que o método estático especificado existe na classe especificada; se não acontecer, ocorre um erro no 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

Esta função falha se o método designado não for estático. Use a função methodStr se quiser devolver os nomes dos métodos de instância. Para mais informações sobre funções em tempo de compilação, veja Visão Geral.

tableCollectionStr

Valida que a coleção de tabelas especificada existe no Application Explorer; se não acontecer, ocorre um erro no 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 for válida.

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja Visão Geral.

Example

O exemplo a seguir recupera o nome do grupo de campos Editando 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 que o método de instância especificado existe na tabela especificada; se não acontecer, ocorre um erro no 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 mais informações sobre funções em tempo de compilação, veja 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 recuperar o nome imprimível.

Return Value

O nome da tabela especificada.

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 que o método estático especificado existe na tabela especificada; se não acontecer, ocorre um erro no 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 mais informações sobre funções em tempo de compilação, veja 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 mais informações sobre funções em tempo de compilação, veja 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
dispor em mosaico O nome do bloco.

Return Value

O nome do bloco em uma cadeia de caracteres.

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 string que contém o nome de um item no âmbito da chamada.

Remarks

O nome deve corresponder a uma variável definida no método em que a chamada ocorre, ou a um campo no âmbito circundante. Para mais informações sobre funções em tempo de compilação, veja 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 que o item de ação web especificado existe no Explorador de Aplicações; se não acontecer, ocorre um erro no 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 da ação web especificada, se for válida.

Remarks

Para mais informações sobre funções em tempo de compilação, veja Visão Geral.

Example

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

webDisplayContentItemStr

Valida que o conteúdo de exibição web especificado existe no Explorador de Aplicações; se não acontecer, ocorre um erro no 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 web especificado, se for válido.

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 Application Explorer da aprovação do fluxo de trabalho.

Return Value

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

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 Application Explorer da categoria de fluxo de trabalho.

Return Value

Uma cadeia de caracteres que representa o nome do Application Explorer da categoria de fluxo de trabalho.

Remarks

Para mais informações sobre funções em tempo de compilação, veja 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 Application Explorer da tarefa de fluxo de trabalho.

Return Value

Uma cadeia de caracteres que representa o nome do Application Explorer da tarefa de fluxo de trabalho.

Remarks

Para mais informações sobre funções em tempo de compilação, veja Visão Geral.

Example

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

workflowTypeStr

Valida que o tipo de fluxo de trabalho especificado existe no Explorador de Aplicações; se não acontecer, ocorre um erro no 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 mais informações sobre funções em tempo de compilação, veja Visão Geral.

Example

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