XKTools - "Minha" "ferramenta"!

Juntei scripts uteis nas tarefas administrativas de ambientes do F&O em um conjunto que chamei de XKTools. São comandos de powershell simples. Utilizei o ChatGPT para otimizar alguns, criar outros e juntar tudo no que chamei de XKTools.

Como sempre, vou documentar o uso do XKTools aqui para meu futuro uso, caso isso ajude mais alguém ótimo!

Em um servidor de F&O abra um Powershell e execute o comando abaixo para efetuar o download dos arquivos que estão no meu Git: 

iwr -useb  https://raw.githubusercontent.com/fsilva-jr/XKtools/main/DownloadXKTools.ps1 | iex

O download será iniciado, na sequência o arquivo será descompactado e a pasta XKTools será criada dentro da pasta C:\temp. Uma nova janela do Powershell será aberta, este é o menu inicial!

Logo ao abrir o Menu, você poderá optar por atualizar Powershell. Se escolher atualizar você será direcionado para a pagina de download, siga o processo de atualização normal. Se escolher não atualizar, as opções do menu serão exibidas:

Algumas das opções são simples, como as opções 1 e 7. Outras são mais especificas, como as opções 3, 4 e 12.

Tentei deixar cada uma delas fácil de usar, mas vou criar novos posts para cada uma das opções que exigem mais informações por parte de quem vai usar a XKTools.

Deixo abaixo uma breve descrição para as opções mais simples e o link para a explicação detalhada de opções que exigem mais interação por parte de quem vai usar a XKTools:

1 - Apenas para todos os serviços relacionados ao F&O

2 - Faz o donwload das versões mais atuais do Azcopy e do SQLPackage, descompacta e salva no C:\Temp

3 - https://fsilvajunior.blogspot.com/2025/08/xktools-3-download-bacpac-from-lcs.html

4 - https://fsilvajunior.blogspot.com/2025/08/xktools-4-cleanbacpac.html

5 - Após parar todos os serviços, use esta opção para renomear o AxDB!

6 - https://fsilvajunior.blogspot.com/2025/08/xktools-6-restore-bacpac.html

7 - Após restaurar o novo AxDB, ou quando quiser, use esta opção para iniciar os serviços do F&O.

8 - Execute um Build de todas as models.

9 - Executa a sincronização do banco de dados.

10 - Faz o deploy dos reports. Há a opção de fazer o deploy de apenas 01 report ou de todos eles.

11 - Executa uma Store Procedure que faz o Reindex do AxDB.

12 - https://fsilvajunior.blogspot.com/2025/08/xktools-12-update-web-e-wif-config.html

13 - Faz o download e instala o Notepad++ e o Postman.

Export SSRS Reports as .RDL files

Today i was forced to export some old reports from one messed up SSRS report server. Security configurations of this SSRS were all crazy and no one could clarify why. I was able to see some reports but could not see other one's... i could download some... but could not open other's...

The internet is really usefull if you look for the right thing!

First, go to the GitHub here: https://github.com/Microsoft/ReportingServicesTools

Download the file into your server, go to the PowerShell and run the .\install.ps1.

After that you can run the following command to export all the reports as a .rdl file extension:

#------------------------------------------------------

#Prerequisites

#Install-Module -Name ReportingServicesTools

#------------------------------------------------------

#Lets get security on all folders in a single instance

#------------------------------------------------------

#Declare SSRS URI

$sourceRsUri = 'http://servername/ReportServer/ReportService2010.asmx?wsdl'

#Declare Proxy so we dont need to connect with every command

$proxy = New-RsWebServiceProxy -ReportServerUri $sourceRsUri

#Output ALL Catalog items to file system

Out-RsFolderContent -Proxy $proxy -RsFolder / -Destination 'C:\SSRSFiles' -Recurse

All done! Be happy!

Dynamics AX2012 - Relatórios - Erro ao validar configurações.

Passei por este problema, que devo dizer foi realmente muito estranho, e resolvi posta-lo aqui para futuras consultas!

Estava em um cliente com um ambiente de produção do AX2012 R3 rodando perfeitamente, sem nenhum problema em nenhum dos componentes.

Este cliente solicitou que fosse adicionado um segundo AOS para fins de balanceamento de carga de sessões de usuários. O Setup foi feito e o balanceamento configurado sem problemas!

Neste caso eu precisei configurar a parte de relatórios para este segundo AOS, coisa fácil, bastando apenas abrir o formulário de Servidor de Relatórios do AX e adicionar este novo AOS, certo? NÂO...

Ao adicionar o segundo AOS e clicar no botão validar configurações recebi o seguinte erro:

The SQL Server Reporting Services Server name does not exist or the Web Service URL is not valid.

Lembrem-se, tudo está funcionando perfeitamente para este ambiente...

Neste caso fiz um teste rápido, desabilitei o firewall do servidor onde está o serviço de SSRS, e ai sim consegui validar as configurações. Isso mostrou que o firewall estava bloqueando a conexão deste segundo AOS. Mas porque só deste AOS?????

Reativei o firewall e refiz os testes, o primeiro AOS valida sem problemas, o segundo AOS "da ruim"...

Revisei as portas de entrada no firewall, todas estavam configuradas de acordo com o que a Microsoft indica Firewall settings for Microsoft Dynamics AX components.

Enfim, resolvi ativar o log do firewall do Windows Server...

Tentei validar novamente e ai o seguinte log foi gerado...
#Version: 1.5
#Software: Microsoft Windows Firewall
#Time Format: Local
#Fields:

date time action protocol src-ip dst-ip src-port dst-port size tcpflags tcpsyn tcpack tcpwin icmptype icmpcode info path
                                                                                                                                                              2016-10-27 15:14:24 DROP TCP 10.1.2.88 10.1.2.90 61928 49154 52 S 3477648942 0 8192 - - - RECEIVE
2016-10-27 15:14:27 DROP TCP 10.1.2.88 10.1.2.90 61928 49154 52 S 3477648942 0 8192 - - - RECEIVE
2016-10-27 15:14:33 DROP TCP 10.1.2.88 10.1.2.90 61928 49154 48 S 3477648942 0 8192 - - - RECEIVE
2016-10-27 15:14:46 DROP TCP 10.1.2.88 10.1.2.90 61929 49154 52 S 1269547751 0 8192 - - - RECEIVE
2016-10-27 15:14:49 DROP TCP 10.1.2.88 10.1.2.90 61929 49154 52 S 1269547751 0 8192 - - - RECEIVE
2016-10-27 15:14:55 DROP TCP 10.1.2.88 10.1.2.90 61929 49154 48 S 1269547751 0 8192 - - - RECEIVE
2016-10-27 15:16:59 DROP TCP 10.1.2.88 10.1.2.90 61932 49154 52 S 3322609281 0 8192 - - - RECEIVE
2016-10-27 15:17:02 DROP TCP 10.1.2.88 10.1.2.90 61932 49154 52 S 3322609281 0 8192 - - - RECEIVE
2016-10-27 15:17:08 DROP TCP 10.1.2.88 10.1.2.90 61932 49154 48 S 3322609281 0 8192 - - - RECEIVE
2016-10-27 15:17:20 DROP TCP 10.1.2.88 10.1.2.90 61933 49154 52 S 3088810673 0 8192 - - - RECEIVE
2016-10-27 15:17:23 DROP TCP 10.1.2.88 10.1.2.90 61933 49154 52 S 3088810673 0 8192 - - - RECEIVE
2016-10-27 15:17:29 DROP TCP 10.1.2.88 10.1.2.90 61933 49154 48 S 3088810673 0 8192 - - - RECEIVE

De acordo com este log a porta 49154 era "dropada" a cada tentativa de validação da configuração do servidor de relatórios no AX.

Voltei nas configurações de entrada do firewall e liberei esta porta... e ai PAAAHHHH

Sucesso!!!

Busquei na IANA referencias sobre esta porta em especifico e não encontrei nada... no Google também não.

Como o problema resolvido optei por não abrir chamado para este caso. Preferi apenas adicionar mais esta porta à minha lista de exceções nas próximas implementações!

Talvez alguém na Microsoft veja este post e resolva contribuir dizendo o por que de esta porta ser usada e não estar na lista de exceções do Technet, talvez!

Até a próxima!!!

A call to the Microsoft Dynamics AX SRSFrameworkService failed. Arithmetic operation resulted in an overflow.

Olá pessoal!

Breve resumo do cenário onde o problema ocorreu...

Havia um servidor de banco de dados com o serviço de SSRS também instalado nele, e havia um segundo servidor, o de AOS, que apontava para este SQL Server e SSRS.

Obtive um terceiro servidor, instalei o SSRS e o atualizei de acordo com o SQL Server do primeiro servidor.

Instalei o client do AX, perfeito, funcionando sem nenhum problema e devidamente atualizado!

Antes de instalar o Report Extensions do AX2012 R3 CU10, eu compilei o AX, gerei o CIL completo, sincronizei o banco de dados e atualizei o WCF só pra me garantir!

Instalei o Reporting Extensions e ai PAHHH...

No momento do deploy dos relatórios veio este erro:

A call to the Microsoft Dynamics AX SRSFrameworkService failed. Arithmetic operation resulted in an overflow.

O que eu fiz?.... obviamente fui tomar um café, é claro!!!

Na volta eu parei todos os serviços relacionados ao AX (SQL também)... Limpei o cache da conta que eu estava usando em todos os servidores e reiniciei os serviços que havia parado.

Registrei os serviços de SRSFramework no AX.

Executei novamente o deploy dos relatórios e tudo ocorreu sem problemas.

Resumo das acções:
Parar serviço de AOS.
Parar serviço de SSRS (Relatórios)
Deletar arquivos UAC de todos os servidores para a conta de serviço do AX, do SSRS e do usuários que você está utilizando.
Iniciar os serviços.
Fazer o deploy.

Tudo isso depois de ter compilado e gerado cil sem erros, assim como ter registrado o serviço do SRSFrameworkService!

Até a próxima!

AX2012 - Alteraçao de Fontes

Bom dia pessoal!

Após um período um tanto quanto longo sem nenhuma nova postagem, venho hoje compartilhar uma dica com vocês! Esta é uma dica simples, raramente usada, mas que creio eu valha apena ser compartilhada!

Vou mostrar como alterar a fonte utilizada nos formulários do AX, esta alteração pode ser feita por cada usuário de forma independente, mas para isso o administrador do sistema precisa habilitar esta opção!

Para habilitar a opção de alteração de fontes acesso o AX e abra a área de desenvolvimento (AOT). Na AOT expanda o nó Forms > SysUserSetups(sys) > Designs > Design > [Tab:Tab](sys) e clique com o botão direito do mouse sobre a opção "[TabPage:Fonts](sys)". Olhe o exemplo da imagem abaixo:

Nas propriedades altere a opção "Visible" de "No" para "Yes". Olhe a imagem abaixo:

Salve as alterações e feche a área de desenvolvimento. Agora abra o menu Arquivo do AX, no canto superior direito, clique em "Ferramentas > Opções" e note que teremos o menu fontes do lado esquerdo da tela.

Pronto, você poderá alterar as fontes conforme seu gosto!

Espero que esta dica seja, de alguma forma, útil!

Até a próxima!

Dica do dia!

Olá pessoal!

Segue abaixo um link muito util que os ajudará a evitar problemas na execução de relatorios do AX2012.

Talvez vocês já tenham visto esta pagina, mas com certeza ela será útil sempre!

Tips to help prevent long-running reports from timing out [AX 2012]

Reports do AX2012 R2 Solicitando Autenticação.

Olá pessoal!

Hoje quero compartilhar com vocês mais um "causo" que tive que resolver na semana passada!

Um cliente entrou em contato comigo solicitando ajuda para um problema relacionado aos relatórios do AX2012. Estes relatórios estavam funcionando perfeitamente bem até apresentar problemas com a chave de criptografia. A mensagem abaixo era exibida:

Error while setting server report parameters. Error message: The report server cannot decrypt the symmetric key that is used to access sensitive or encrypted data in a report server database. You must either restore a backup key or delete all encrypted content. (rsReportServerDisabled)

No momento em que a primeira mensagem de erro foi exibida não foi possível efetuar o restore da chave pois a senha necessária para o restore era desconhecida. Para resolver este problema o cliente optou, corretamente de acordo com a situação em que se encontrava, por recriar a chave de criptografia. Após recriar esta chave todos os relatórios do AX passaram a exigir autenticação como na imagem abaixo:

Após recriar a chave de criptografia todos os relatórios e também o Datasource tiveram suas configurações de autenticação alteradas, cada relatório passou a ter uma configuração diferente, veja imagem abaixo:

Por esta razão todos os relatórios do AX passaram a exigir a autenticação.

Agora um breve resumo da situação:

Solicitação: Verificar reports solicitando autenticação

Problema: O método de autenticação da fonte de dados "Dynamics" e de todos os reports foi alterado de "Autenticação do Windows" para outros metodos de autenticação diferentes em cada report.

Causa: A deleção da chave privada no "Reporting Services Configuration Manager" e, em sequencia, a criação de uma nova chave privada, alterou os métodos de autenticação nos reports e também no datacource.

Solução: Seria possível alterar as configurações dos reports um a um, mas o método mais pratico foi deletar toda a pasta "DynamicsAX", recriar esta pasta utilizando o client do AX e efetuar o deploy de todos os reports via power shell. Após este processo os reports estão acessíveis sem os problemas mencionados anteriormente.

Espero que este post seja útil!

Permissões Reporting Services AX2012 R2

Neste video eu tento explicar como configurar as permissões de acesso aos relatorios do Dynamics AX2012 R2.

Até a próxima!!!

Deploy de Reports do AX2012 R2.

Olá pessoal!

No vídeo abaixo demonstrarei como efetuar o deploy dos Reports do AX2012 R2 de forma simples com a intenção de mostrar a vocês como corrigir um erro comum após o deploy destes Reports padrões.

Espero que este video seja util a vocês!

Até a próxima!

AX2012 R2. Reports. Erros

Nesta semana passei por um problema com os relatórios padrões do AX2012 R2.

No mais simples dos cenários possíveis, apenas 01 servidor para todas as funções do AX, efetuei com sucesso o deploy dos reports.

Depois de algum tempo precisei mudar a URL do Reporting services, refiz o deploy dos reports novamente e com sucesso.

Ao testar os reports alguns erros começaram a aparecer.

O primeiro e mais estranho era o fato de o report de confirmação de ordem de venda não apresentar nenhum valor, nenhum mesmo.

O segundo erro ocorria em alguns relatórios e estava relacionado a erros de classes no AX. A seguinte mensagem era exibida neste erro:

(S)\Classes\xInfo\add
(S)\Classes\Info\add - line 94
(S)\Classes\Global\error - line 3
(S)\Classes\SRSQueryBuilder\initialize - line 21
(S)\Jobs\

Estes erros estavam ocorrendo em ambiente de produção, alterações que exigiam parada de serviços e/ou reinicialização do servidor eram impossíveis.

Abrimos chamado na Microsoft e após 02 dias tentando resolver estes problemas validando todas as configurações não conseguimos.

Na noite de ontem executei os passos abaixo:

Desinstalei os componentes de BI do AX2012

Deletei a configuração de BI no modulo de administração do AX
Deletei todos os relatórios e a pasta DynamicsAX do Reporting Services
Removi o SQL Server Reporting Services do servidor
Reiniciei o servidor

Após reiniciar o servidor fiz o seguinte:

Revisei as configurações do AX Confguration utility para cliente e business conector.
Confirmei a conta utilizada para o Business conector
Reinstalei o SQL Server Reporting Services utilizando a conta bcproxy como conta de serviço para o SRSS
Testei os acessos as url’s do Reporting Services
Configurei as permissões de acesso ao Reporting Services para demais contas de usuários
Instalei os componentes de BI do AX2012 sem fazer o deploy dos reports
Via Shell efetuei o deploy de todos os reports (publish-axreport –reportname *)

E somente após executar os passos acima os erros pararam de ocorrer!

Espero que vocês não passem por este problema, mas fica ai a dica!

FullyQualifiedErrorId : The deployment was aborted.

Hoje ao iniciar o deploy dos reports padrões do AX2012 R2 em um servidor dedicado ao Reporting Services encontrei o seguinte erro:

"The deployment was aborted. You do not have privileges to deploy to server: (servername). For deployment, you must have administrative rights to the SQL Server Reporting Services (SSRS) server. Contact your administrator to deploy."

A conta que eu estava utilizando para efetuar este deploy faz parte de grupo "Local Administrator" dos servidores de AOS, SQL Server e também do servidor de Reporting Services. Esta conta também é sysadmin no banco de dadose logicamente possui as devidas permissões nas paginas e pastas do Reporting Services. E por ultimo esta mesma conta é System Administrator no AX.

Após verificar todas as permissões e requisitos mínimos inúmeras vezes, desativar UAC dos servidores e também reinicia-los, mais de 01 vez, o erro persistia em acontecer.

Explorando um pouco os comandos de Power Shell para deploy dos reports achei uma opção que salvou meu dia! Eu executei o seguinte comando:

"Publish - AXReport -ReportName * -SkipReportServerAdminCheck"

E finalmente os reports foram criados com sucesso!

Este comando simplesmente pula a parte de verificação de permissões no servidor. Logicamente utilizei este comando após ter absoluta certeza de que minha conta de usuário possuía todas as permissões necessárias.

Depois disso os reports estavam acessíveis normalmente pelo AX2012 R2!

Durante as pesquisas que fiz na internet achei o link abaixo que deixo como dica e que talvez seja o caso de alguns:

http://dynamics-ax.blogspot.com.br/2011/08/ax-2012-ssrs-security-deployment-issue.html

Espero ter ajudado!

Instalação Dynamics AX2012 R2. Parte 9 - Business Intelligence.

Nesta parte do tutorial vou demonstrar como configurar o Dynamics AX2012 R2 para que possamos efetuar a instalação dos componentes de BI com sucesso.

Os componentes de BI para o Microsoft Dynamics AX fornecem relatórios e funcionalidades de análise que permite visualizar e interpretar dados de negócios.

Em ambientes de produção devemos instalar estes componentes em um servidor de relatórios dedicado para não haver problemas de performance. Para obter mais detalhes sobre cenários para implementação do AX2012 R2 e seus componentes consulte o TechNet.

Logicamente para termos os componentes de BI precisamos do SQL Server 2008 R2 com Analysis Services e Reporting Services instalados e atualizados com o ultimo service pack. Depois de atualizado precisamos verificar se as URL's estão configuradas e acessíveis. Por ultimo precisamos configurar estes parâmetros dentro do AX antes de iniciarmos o processo de instalação.

Existem muitos posts sobre instalação e configuração do SQL Server 2008 R2 e componentes, o TechNet é uma ótima fonte para isso!

Com todos os componentes do SQL Instalados e configurados, vamos iniciar as configurações do AX.

Abra o AX no modulo de Administração do Sistema > Configuração > Business Intelligence > Reporting Services > Servidores de Relatórios.

Preencha os campos conforme as configurações de seu servidor e depois clique no botão "Criar pasta de relatórios".

Agora clique no botão "Validar configurações".

Agora acesse o modulo de Administração do Sistema > Configuração > Business Intelligence > Analysis Services > Servidores de análise.

Altere o nome do servidor.

Agora vamos ao Setup para instalação dos componentes de BI. Novamente execute o setup do AX e avance até a tela para selecionarmos os componentes a serem adicionados, nela selecione a opção "Business Intelligence componentes" e clique em Next.

Caso tudo esteja ok na validação clique em Next.

Agora digite a senha da conta Business Connector, o detalhe importante é que esta conta deve ser utilizada também pelo serviço do Reporting Services, caso contrario teremos erros no processo.

Selecione a instancia do servidor de analysis services. Neste servidor eu só tenho uma única escolha.

Agora selecione o servidor de banco de dados do AX e o banco de dados utilizado pelo AX.

Certifique-se de que a conta de serviço do Analysis Services possui acesso ao banco de dados do Dynamics AX.

Clique em next.

Clique em Install.

Componentes instalados com sucesso.

Logo após o fim da instalação dos componentes é iniciado o processo de deploy dos relatórios padrões, este deploy é executado pelo power shell, nenhuma ação é necessária, basta aguardar o final do deploy.

Notem que os relatórios estão sendo configurados pelo power shell.

Ao fim do processo, caso nenhum erro tenha ocorrido, nenhuma mensagem será exibida, para confirmar se os relatórios foram configurados corretamente tente acessar algum relatório utilizando o cliente do AX, ou acesse a URL do Reporting Services e veja que diversos relatórios estarão lá.

Agora temos os relatórios padrões do AX prontos para utilização. O próximo passo é efetuar a configuração e o deploy dos cubos padrões do AX2012 R2.

Abra o client do Dynamics AX2012 R2 e clique em Arquivo > Ferramentas > Ferramentas de Business Intelligence (BI) > Assistente de projeto do SQL Server Analysis Services.

Clique em Avançar.

Selecione a opção Configurar e avance.

Selecione o projeto Dynamics AX da AOT e avance.

Caso tudo esteja ok a verificação exibira uma mensagem como a da imagem abaixo, clique em avançar.

Clique em avançar novamente.

Selecione os idiomas para exibição dos cubos e clique em avançar.

Agora aguarde a geração do projeto com os parâmetros configurados.

Após a conclusão clique em Concluir!

Agora ao abrir o AX2012 Client o role center exibirá o conteúdo como o da imagem abaixo.

Assim como no Enterprise Portal.

Agora temos os componentes de BI instalados e os reports e cubos padrões do AX2012 R2 funcionando corretamente!

Até o próximo post!

Ao som de Jason Mraz - 93 Million Miles (e outras)!!!

Permissões no Reports do SQL para Dynamics AX.

Para acessar os reports gerados no AX2009 precisamos de permissões de acesso na pagina do Reports (http://sqlserver/reports). Estas permissões "devem" ser configuradas pelo administrador da rede que efetuou a instalação do SQL Server, inicialmente somente a conta utilizada durante a instalação do SQL Server tem os privilegio necessários para liberar acesso a paginas do Reports.

Acesse a pagina do Report utilizando a mesma conta de usuário utilizada durante a instalação do SQL Server e clique na aba "Configuração de Pasta".

Agora clique em "Atribuição de Nova Função"

Digite o nome de login da conta do usuário, apenas o nome de login, sem o domínio. Selecione também as permissões, privilegios, que o usuário terá na pagina dos Reports, clique em "OK".

Agora o usuário escolhido tem as permissões selecionadas e já possui acesso a pagina de relatórios do Reports do SQL Server.