Formatação de strings com macro e strFmt no Dynamics AX 2012

As informações nesta postagem são baseadas no Dynamics AX 2012 R3. Elas podem ou não ser válidas para outras versões.

Recentemente, encontrei um problema com a função strFmt que me deixou um pouco perplexo. A parte mais desconcertante foi que, por alguma estranha coincidência, eu nunca havia encontrado isso antes em meus muitos anos como desenvolvedor Axapta/Dynamics AX.

O problema foi que tentei usar uma macro como string de formato para a função strFmt e ela simplesmente não funcionou. Ela ignorou completamente os parâmetros % e retornou apenas o restante da string.

Depois de pesquisar, descobri que as próprias macros podem ser usadas para formatar cadeias de caracteres, o que também era algo que eu não sabia. Bem, é sempre bom aprender algo novo, mas ainda assim fiquei muito surpreso por não ter me deparado com isso antes.

Basicamente, algo como isto

não funcionará porque os sinais % na macro são, na verdade, usados para os recursos de formatação de cadeia de caracteres da própria macro. Nesse caso, a função strFmt verá a string de formatação como "--" e, portanto, retornará apenas isso.

Algo como isto:

funcionará, mas provavelmente não da maneira que você deseja. Em vez de produzir os valores das três variáveis, ele produzirá os nomes das variáveis, nesse caso "salesId-itemId-lineNum". (Observe que não coloquei espaços após as vírgulas ao passar parâmetros para a macro, como normalmente faço nas chamadas de método. Isso se deve ao fato de que a macro também usará esses espaços, de modo que o resultado seria "salesId- itemId- lineNum" se eu fizesse isso).

Para realmente usar uma macro como string de formatação com strFmt, você precisa escapar dos sinais de porcentagem com barras invertidas, assim:

Na verdade, isso funcionará como se você tivesse fornecido a string de formatação diretamente.

Esse pequeno trabalho ilustra os exemplos: