Partilhar via


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

Observação

Os grupos de interesse da comunidade passaram do Yammer para o Microsoft Viva Engage. Para participar de uma comunidade Viva Engage e participar das últimas discussões, preencha o formulário Solicitar acesso ao Finance and Operations Viva Engage Community e escolha a comunidade à qual deseja participar.

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

Visão geral

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

e ainda

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.

Observação

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.

Sintaxe

str classStr(name)

Parâmetros

Parâmetro Description
nome O nome do atributo a ser validado.

Valor de retorno

O nome do atributo.

Observações

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.

Sintaxe

str classStr(name)

Parâmetros

Parâmetro Description
nome O nome da classe a ser retornada.

Valor de retorno

O nome da classe.

Observações

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.

configuraçãoKeyStr

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

Sintaxe

str configurationKeyStr(name)

Parâmetros

Parâmetro Description
nome O nome da chave de configuração.

Valor de retorno

O nome da chave de configuração.

Observações

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.

Sintaxe

str dataEntityDataSourceStr(dataEntity, dataSource)

Parâmetros

Parâmetro Description
dataEntity O nome da entidade de dados.
dataSource O nome da fonte de dados.

Valor de retorno

O nome da fonte de dados.

Observações

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

delegateStr

Retorna o nome do delegado.

Sintaxe

str delegateStr(class, instanceDelegate)

Parâmetros

Parâmetro Description
classe O nome da classe, tabela ou formulário.
instânciaDelegar O nome do delegado da instância.

Valor de retorno

O nome do delegado.

Observações

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.

Sintaxe

str dimensionHierarchyLevelStr(dimensionHierarchyLevel)

Parâmetros

Parâmetro Description
dimensionHierarchyLevel O nome do nível de hierarquia da dimensão.

Valor de retorno

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

Observações

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.

Sintaxe

str dimensionHierarchyStr(dimensionHierarchy)

Parâmetros

Parâmetro Description
dimensionHierarchy O nome da hierarquia de dimensão.

Valor de retorno

O nome da hierarquia de dimensão.

Observações

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.

Sintaxe

str dimensionReferenceStr(dimensionReference)

Parâmetros

Parâmetro Description
dimensionReference O nome da referência de dimensão.

Valor de retorno

O nome da referência de dimensão.

Observações

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

deverStr

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

Sintaxe

str dutyStr(securityDuty)

Parâmetros

Parâmetro Description
segurançaDever O nome do dever de segurança.

Valor de retorno

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

Observações

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.

Sintaxe

int enumCnt(enumtype)

Parâmetros

Parâmetro Description
enumtype O tipo de enumeração.

Valor de retorno

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

Observações

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.

Sintaxe

enumLiteralStr(enum, literal)

Parâmetros

Parâmetro 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.

Valor de retorno

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

Observações

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.

Sintaxe

str enumStr(enumName)

Parâmetros

Parâmetro Description
enumName O nome da enumeração.

Valor de retorno

O nome da enumeração.

Observações

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.

Sintaxe

str extendedTypeStr(edtName)

Parâmetros

Parâmetro Description
edtName O nome do tipo de dados estendido.

Valor de retorno

O nome do tipo de dados estendido.

Observações

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

campoPName

Recupera o rótulo do campo especificado.

Sintaxe

str fieldPName(tableid, fieldid)

Parâmetros

Parâmetro Description
TableID A tabela que contém o campo especificado.
ID de campo O campo para converter.

Valor de retorno

O rótulo do campo.

Observações

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.

Sintaxe

str fieldStr(tableid, fieldid)

Parâmetros

Parâmetro Description
TableID A tabela que contém o campo.
ID de campo O campo para converter.

Valor de retorno

O nome do campo especificado.

Observações

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.

Sintaxe

str formControlStr(formName, controlName)

Parâmetros

Parâmetro Description
nomedoformulário O nome do formulário, não entre aspas.
nome_do_controle O nome do controle que está no formulário, não entre aspas.

Valor de retorno

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

Observações

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.

Sintaxe

str formDataFieldStr(formName, dataSource, dataField)

Parâmetros

Parâmetro Description
nomedoformulário O nome do formulário.
dataSource A fonte de dados do formulário.
dataField O campo de dados da fonte de dados.

Valor de retorno

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

Observações

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.

Sintaxe

str formDataSourceStr(formName, dataSource)

Parâmetros

Parâmetro Description
nomedoformulário O nome do formulário.
dataSource A fonte de dados do formulário.

Valor de retorno

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

Observações

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.

Sintaxe

str formMethodStr(formName, methodName)

Parâmetros

Parâmetro Description
nomedoformulário O nome do formulário.
methodName O método do formulário.

Valor de retorno

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

Observações

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.

Sintaxe

str formStr(form)

Parâmetros

Parâmetro Description
formulário O nome de um formulário.

Valor de retorno

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

Observações

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.

Sintaxe

str identifierStr(ident)

Parâmetros

Parâmetro Description
ident O identificador a ser convertido.

Valor de retorno

Uma cadeia de caracteres que representa o identificador especificado.

Observações

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.

Sintaxe

str indexStr(str tableid, str indexid)

Parâmetros

Parâmetro Description
TableID A tabela que contém o índice.
indexido O índice a converter.

Valor de retorno

Uma cadeia de caracteres que representa o índice especificado.

Observações

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.

Sintaxe

str literalStr(literal)

Parâmetros

Parâmetro Description
literal A cadeia de caracteres a ser validada.

Valor de retorno

A cadeia de caracteres literal, se válida.

Observações

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");

data-máx.

Recupera o valor máximo permitido para uma variável do tipo date.

Sintaxe

date maxDate()

Valor de retorno

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

Observações

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 .

Sintaxe

int maxInt()

Valor de retorno

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

Observações

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;
}

mediçãoStr

Devolve o nome de uma medida.

Sintaxe

str measurementStr(measurement)

Parâmetros

Parâmetro Description
Medição O nome da medição.

Valor de retorno

O nome da medição.

Observações

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

measureStr

Retorna o nome de uma medida.

Sintaxe

str measureStr(measure)

Parâmetros

Parâmetro Description
medida O nome da medida.

Valor de retorno

O nome da medida.

Observações

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.

Sintaxe

str menuItemActionStr(menuitem)

Parâmetros

Parâmetro Description
menu O nome do item do menu de ação a validar.

Valor de retorno

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

Observações

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.

Sintaxe

str menuitemdisplaystr(menuItem)

Parâmetros

Parâmetro Description
menuItem O nome do item do menu de exibição a validar.

Valor de retorno

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

Observações

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.

Sintaxe

str menuItemOutputStr(menuitem)

Parâmetros

Parâmetro Description
menu O nome da saída do item de menu a ser validado.

Valor de retorno

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

Observações

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.

Sintaxe

str menuStr(menu)

Parâmetros

Parâmetro Description
menu O nome do menu a ser validado.

Valor de retorno

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

Observações

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

métodoStr

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

Sintaxe

str methodStr(class, method)

Parâmetros

Parâmetro Description
classe O nome da classe.
método O nome do método a ser validado.

Valor de retorno

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

Observações

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 .

Sintaxe

int minInt()

Valor de retorno

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

Observações

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;
}

privilégioStr

Retorna o nome do privilégio.

Sintaxe

str privilegeStr(privilege)

Parâmetros

Parâmetro Description
privilégio O privilégio para o qual retornar o nome.

Valor de retorno

O nome do privilégio.

Observações

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.

Sintaxe

str queryDataSourceStr(queryName, dataSourceName)

Parâmetros

Parâmetro 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.

Valor de retorno

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

Observações

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.

Sintaxe

str queryMethodStr(queryName, methodName)

Parâmetros

Parâmetro Description
queryName O nome da consulta.
methodName O método do formulário.

Valor de retorno

O nome de um método em uma consulta.

Observações

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.

Sintaxe

str queryStr(query)

Parâmetros

Parâmetro Description
consulta A consulta a ser recuperada.

Valor de retorno

O nome da consulta.

Observações

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.

Sintaxe

str reportStr(report)

Parâmetros

Parâmetro Description
relatório O relatório para o qual retornar o nome.

Valor de retorno

O nome do relatório.

Observações

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.

Sintaxe

str resourceStr(resourcename)

Parâmetros

Parâmetro Description
nome_do_recurso O nome do recurso a ser validado.

Valor de retorno

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

Observações

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.

Sintaxe

str roleStr(securityRole)

Parâmetros

Parâmetro Description
securityRole O nome da função de segurança.

Valor de retorno

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

Observações

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.

Sintaxe

str ssrsReportStr(report, design)

Parâmetros

Parâmetro Description
relatório O relatório para retornar o nome.
Desenho O nome do design associado ao relatório.

Valor de retorno

O nome do relatório.

Observações

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.

Sintaxe

str staticDelegateStr(class, delegate)

Parâmetros

Parâmetro Description
classe O nome de uma classe, tabela ou formulário.
delegado O nome do delegado.

Valor de retorno

O nome do delegado.

Observações

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.

Sintaxe

str staticMethodStr(class, int method)

Parâmetros

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

Valor de retorno

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

Observações

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.

Sintaxe

str tableCollectionStr(tablecollection)

Parâmetros

Parâmetro Description
coleção de tabelas O nome da coleção de tabelas a ser validada.

Valor de retorno

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

Observações

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.

Sintaxe

str tableFieldGroupStr(tableName, fieldGroupName)

Parâmetros

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

Valor de retorno

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

Observações

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.

Sintaxe

str tableMethodStr(table, method)

Parâmetros

Parâmetro Description
tabela O nome da tabela.
método O nome do método a ser validado.

Valor de retorno

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

Observações

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

tabelaPName

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

Sintaxe

str tablePName(str table)

Parâmetros

Parâmetro Description
tabela A tabela para recuperar o nome imprimível.

Valor de retorno

O nome da tabela especificada.

Observações

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.

Sintaxe

str tableStaticMethodStr(table, method)

Parâmetros

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

Valor de retorno

O nome do método estático especificado.

Observações

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.

Sintaxe

str tableStr(table)

Parâmetros

Parâmetro Description
tabela A tabela para a qual recuperar uma cadeia de caracteres.

Valor de retorno

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

Observações

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.

Sintaxe

str tileStr(tile)

Parâmetros

Parâmetro Description
dispor em mosaico O nome do bloco.

Valor de retorno

O nome do bloco em uma cadeia de caracteres.

Observações

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.

Sintaxe

str varStr(name)

Parâmetros

Parâmetro Description
varName O nome de uma entidade definida.

Valor de retorno

Uma string que contém o nome de um item no âmbito da chamada.

Observações

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.

Sintaxe

str webActionItemStr(webactionitem)

Parâmetros

Parâmetro Description
WebActionItem O nome do item de ação da Web a ser validado.

Valor de retorno

O nome da ação web especificada, se for válida.

Observações

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.

Sintaxe

str webDisplayContentItemStr(webdisplaycontentitem)

Parâmetros

Parâmetro Description
WebDisplayContentItem O nome do item de conteúdo de exibição da Web a ser validado.

Valor de retorno

O nome do item de conteúdo web especificado, se for válido.

Observações

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.

Sintaxe

str workflowapprovalstr(approval)

Parâmetros

Parâmetro Description
aprovação O nome do Application Explorer da aprovação do fluxo de trabalho.

Valor de retorno

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

Observações

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.

Sintaxe

str workflowcategorystr(category)

Parâmetros

Parâmetro Description
categoria O nome do Application Explorer da categoria de fluxo de trabalho.

Valor de retorno

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

Observações

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.

Sintaxe

str workflowtaskstr(task)

Parâmetros

Parâmetro Description
tarefa O nome do Application Explorer da tarefa de fluxo de trabalho.

Valor de retorno

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

Observações

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.

Sintaxe

str workflowTypeStr(workflow)

Parâmetros

Parâmetro Description
fluxo de trabalho O nome do tipo de fluxo de trabalho a ser validado.

Valor de retorno

O nome do tipo de fluxo de trabalho.

Observações

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.