How does one get a copy of your company logo saved to file? (if you forgot to archive it like you should have originally)
One mechanism is using X++ as follows:
|
1 2 3 4 5 6 7 8 |
Bitmap logo; BinData data = new BinData(); changeCompany("[companydataarea]") { logo = FormLetter::companyLogo(); data.setData(logo); data.saveFile("C:\\Users\\jonathan.halland\\Desktop\\logo.bmp"); } |
Requirement: When choosing email as the report destination in, allow the user to edit the email contents in Outlook rather than automatically sending.
A number of users have been concerned that outlook automatically sends email destination reports, rather than allowing them to first modify or verify the email, subject and addresses in a “new email” window.
Solution: To fix this you can modify the “SRSReportRunMailer.emailReport” method. Depending on your version of AX, modify the section around line 41 as below.
|
1 2 3 4 5 6 7 |
result = inetMailer.sendMailAttach(_emailContract.parmTo(), _emailContract.parmCc(), _emailContract.parmSubject(), _emailContract.parmBody(), true, /* Ensure dialog is shown */ //original false, /* do not show dialog*/ _attachmentPath); |
Requirement: Allow requests made via AIF to modify fields with the table field property “AllowEdit” set to NO to be modified. By default if you modify a field in a service call that is non editable no errors occur but the field is not updated.
Solution: On your AXD service contract class, right click on the class , click “Override method” choose method “initFieldAccessOverrides” to override. Append the following line to the method
this.overRideFieldAccess(tableNum([YourTable]), fieldNum([YourTable], [YourField]), AxdFieldAccess::AllowEdit, NoYes::Yes);
Note: This can also be used to override the “editOnCreate” property of a table field for AIF usage.
I’ve had it a number of times when trying to update parameters on batch job tasks that I’ve received the cryptic message “Cannot edit a record in Batch transactions (Batch). The corresponding AOS validation failed.” Due to laziness or business I’ve always dismissed the problem and found a work around, but never fully tried to understand why this message occurs.
I’ve finally had the opportunity to drill into it and decided to share what I found.
Firstly: The message is generated because of the value “false” being returned from the overwritten method “aosValidateUpdate” on table “Batch”, this explains the text of the message “AOS validation failed”, but not the business logic reasons. Drilling into this method one can see the following business logic for allowing updates of batch tasks
1. The user doing the update must either be the person who created the record (createdBy field) or a person with access to the Display MenuItem “BatchJob” (see Batch->IsBatchOperator). (This does work for administrators who don’t have explicit access).
2. Batch tasks may not change the company, dataPartition or batchJobId. (This is unlikely to happen as they are disable from forms anyway)
3. If the user doing the update is NOT the person who created the job then the parameters and Class of the task cannot be changed – this is the primary reason why we were experiencing the issue.
Notes: I’m not sure why the rule around changing the parameters exists, but it does, so if you want to change this then you would need to either login as the creator and change the parameters, or modify via SQL the batch task to run under your user in the case of historical batch jobs where the user does not exist.
A few months ago I wrote a series of posts on things I wish somebody had told me as an X++ developer right at the beginning of my explorations into the world of Dynamics AX. Today I want to start on a new list, one prompted by years of looking over the shoulders of users and realizing that many of the very basic navigation tools that I know and take for granted are often not taught to or effectively utilized by users.
For example I’ve seen way too many users copying field data on one form E.G. Employee Id on Purchase requisition and then navigating to the Employee form to go and search for it instead of simply right clicking and then clicking view details.
The target audience of this series is not seasoned users of AX (although you may benefit too) but rather new users wanting a quick centralized list of tips and tricks that can be used to make your usage of Dynamics AX that much more efficient. Where possible I have will try to link the tips to pre-existing blog posts from other experts rather than than create yet more of the same AX posts for the web.
Just over a month ago I embarked on a series of posts on SQL scripts that I use when restoring Dynamics AX databases from one environment to another. We have covered topics including server setups, general configurations as well as data cleans to get your new environment up and smoothly running as quickly as possible. We are now at the end of the series and I trust it has been helpful to you in structuring your scripts.
I’d just like to remind you that these posts and scripts are not meant to be used as is but rather to serve as a guide to adapt for your specific scenario and to prompt your own thinking as to what you will need.
That said you can download my templated script here or view it below (download)
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 |
Declare @AOS varchar(30) = '[AOSID]' --must be in the format '01@SEVERNAME' ---Reporting Services--- Declare @REPORTINSTANCE varchar(50) = 'AX' Declare @REPORTMANAGERURL varchar(100) = 'http://[DESTINATIONSERVERNAME]/Reports_AX' Declare @REPORTSERVERURL varchar(100) = 'http://[DESTINATIONSERVERNAME]/ReportServer_AX' Declare @REPORTCONFIGURATIONID varchar(100) = '[UNIQUECONFIGID]' Declare @REPORTSERVERID varchar(15) = '[DESTINATIONSERVERNAME]' Declare @REPORTFOLDER varchar(20) = 'DynamicsAX' Declare @REPORTDESCRIPTION varchar(30) = 'Dev SSRS'; ---SSAS Services--- Declare @SSASSERVERNAME varchar(20) = '[YOURSERVERNAME]\AX' Declare @SSASDESCRIPTION varchar(30) = 'Dev SSAS'; -- Description of the server configuration ---BC Proxy Details --- Declare @BCPSID varchar(50) = '[BCPROXY_SID]' Declare @BCPDOMAIN varchar(50) = '[yourdomain]' Declare @BCPALIAS varchar(50) = '[bcproxyalias]' ---Service Accounts --- Declare @WFEXECUTIONACCOUNT varchar(20) = 'wfexc' Declare @PROJSYNCACCOUNT varchar(20) = 'syncex' ---Help Server URL--- Declare @helpserver varchar(200) = 'http://[YOURSERVER]/DynamicsAX6HelpServer/HelpService.svc' ---Outgoing Email Settings--- Declare @SMTP_SERVER varchar(100) = 'smtp.mydomain.com' --Your SMTP Server Declare @SMTP_PORT int = 25 ---DMF Folder Settings --- Declare @DMFFolder varchar(100) = '\\[YOUR FILE SERVER]\AX import\ ' ---Email Template Settings--- Declare @EMAIL_TEMPLATE_NAME varchar(50) = 'Dynamics AX Workflow QA - TESTING' Declare @EMAIL_TEMPLATE_ADDRESS varchar(50) = 'workflowqa@mydomain.com' ---Email Address Clearing Settings--- DECLARE @ExclUserTable TABLE (id varchar(10)) insert into @ExclUserTable values ('userid1'), ('userid2') --List of users separated by | to keep enabled, while disabling all others Declare @ENABLE_USERS NVarchar(max) = '|Admin|TIM|' --List of users separated by | to disable, while keeping all the rest enabled all others --Declare @DISABLE_USERS NVarchar(max) = '|BOB|JANE|' --*****BEGIN UPDATES*******--- ---Update AOS Config--- delete from SYSSERVERCONFIG where RecId not in (select min(recId) from SYSSERVERCONFIG) update SYSSERVERCONFIG set serverid=@AOS, ENABLEBATCH=1 where serverid != @AOS -- Optional if you want to see the "affected row count" after execution. ---Update Batch Servers--- delete from BATCHSERVERGROUP where RecId not in (select min(recId) from BATCHSERVERGROUP group by GROUPID) update BATCHSERVERGROUP set SERVERID=@AOS where serverid != @AOS -- Optional to see "affected row count" update batchjob set batchjob.status=4 where batchjob.CAPTION = '[BATCHJOBNAME]' update batch set batch.STATUS=4 from batch inner join BATCHJOB on BATCHJOBID=BATCHJOB.RECID AND batchjob.CAPTION = '[BATCHJOBNAME]' ---Update Reporting Services--- delete from SRSSERVERS where RecId not in (select min(recId) from SRSSERVERS) update SRSSERVERS set SERVERID=@REPORTSERVERID, SERVERURL=@REPORTSERVERURL, AXAPTAREPORTFOLDER=@REPORTFOLDER, REPORTMANAGERURL=@REPORTMANAGERURL, SERVERINSTANCE=@REPORTINSTANCE, AOSID=@AOS, CONFIGURATIONID=@REPORTCONFIGURATIONID, DESCRIPTION=@REPORTDESCRIPTION where SERVERID != @REPORTSERVERID -- Optional if you want to see the "affected row count" after execution. ---Update SSAS Services--- delete from BIAnalysisServer where RecId not in (select min(recId) from BIAnalysisServer) update BIAnalysisServer set SERVERNAME=@SSASSERVERNAME, DESCRIPTION=@SSASDESCRIPTION, ISDEFAULT = 1 WHERE SERVERNAME <> @SSASSERVERNAME -- Optional where clause if you want to see the "affected rows ---Set BCPRoxy Account--- update SYSBCPROXYUSERACCOUNT set SID=@BCPSID, NETWORKDOMAIN=@BCPDOMAIN, NETWORKALIAS= @BCPALIAS where NETWORKALIAS != @BCPALIAS --optional to display affected rows. ---Set WF Execution Account--- update SYSWORKFLOWPARAMETERS set EXECUTIONUSERID=@WFEXECUTIONACCOUNT where EXECUTIONUSERID != @WFEXECUTIONACCOUNT ---Set Proj Sync Account--- update SYNCPARAMETERS set SYNCSERVICEUSER=@PROJSYNCACCOUNT where SyncServiceUser!= @PROJSYNCACCOUNT ---Set help server URL--- update SYSGLOBALCONFIGURATION set value=@helpserver where name='HelpServerLocation' and value != @helpserver ---Update Email Parameters--- Update SysEmailParameters set SMTPRELAYSERVERNAME = @SMTP_SERVER, @SMTP_PORT=@SMTP_PORT ---Update DMF Settings--- update DMFParameters set SHAREDFOLDERPATH = @DMFFolder where SHAREDFOLDERPATH != @DMFFolder --Optional to see affected rows ---Set BCPRoxy Account--- update SYSBCPROXYUSERACCOUNT set SID=@BCPSID, NETWORKDOMAIN=@BCPDOMAIN, NETWORKALIAS= @BCPALIAS where NETWORKALIAS != @BCPALIAS --optional to display affected rows. ---Set WF Execution Account--- update SYSWORKFLOWPARAMETERS set EXECUTIONUSERID=@WFEXECUTIONACCOUNT where EXECUTIONUSERID != @WFEXECUTIONACCOUNT ---Set Proj Sync Account--- update SYNCPARAMETERS set SYNCSERVICEUSER=@PROJSYNCACCOUNT where SyncServiceUser!= @PROJSYNCACCOUNT ---Set help server URL--- update SYSGLOBALCONFIGURATION set value=@helpserver where name='HelpServerLocation' and value != @helpserver ---Update Email Templates--- update SYSEMAILTABLE set SENDERADDR = @EMAIL_TEMPLATE_ADDRESS, SENDERNAME = @EMAIL_TEMPLATE_NAME where SENDERADDR!=@EMAIL_TEMPLATE_ADDRESS OR SENDERNAME!=@EMAIL_TEMPLATE_NAME; update SYSEMAILSYSTEMTABLE set SENDERADDR = @EMAIL_TEMPLATE_ADDRESS, SENDERNAME = @EMAIL_TEMPLATE_NAME where SENDERADDR!=@EMAIL_TEMPLATE_ADDRESS OR SENDERNAME!=@EMAIL_TEMPLATE_NAME; ---Update User Email Addresses--- update sysuserinfo set sysuserinfo.EMAIL = '' where sysuserInfo.ID not in (select id from @ExclUserTable) ---Disable all users except for a specific set--- update userinfo set userinfo.enable=0 where CharIndex('|'+ cast(ID as varchar) + '|' , @ENABLE_USERS) = 0 ---Disable specific users--- ---update userinfo set userinfo.enable=0 where CharIndex('|'+ cast(ID as varchar) + '|' , @DISABLE_USERS) > 0 --Clean up server sessions delete from SYSSERVERSESSIONS --Clean up client sessions. delete from SYSCLIENTSESSIONS |
A few weeks ago I embarked on a series of posts on SQL scripts I use when restoring Dynamics AX databases from one environment to another. We have covered a variety of topics including various configuration and setting changes to Dynamics AX. This post will be the last in the set of “data cleanup scripts” designed to help scrub your data for use in a development or testing environment.
Disabling users.
Quite often companies or partners will require access to development environments to be restricted to a very select group of users that are aware of what to test and are also careful enough to work methodically in the correct environments (i.e. not trying to to real work in the wrong environment or test work in production). To ensure all of the above one could follow a few paths.
All of these solutions do not physically stop users from accessing the alternate environment. So if you need an additional security mechanism, simply disable the users either manually in AX after doing a restore or disable then along with the SQL scripts we have been building up over the past few weeks.
To disable users in AX navigate to “System Administration -> Common -> Users -> Users. Double click on the user in question, click “edit”, uncheck the “enabled” button.
The accomplish the same in a SQL script you can do the following. I have parameterised the SQL for easier reuse or adjustment.
|
1 2 3 4 5 6 7 8 9 10 |
--List of users separated by | to keep enabled, while disabling all others Declare @ENABLE_USERS NVarchar(max) = '|Admin|TIM|' update userinfo set userinfo.enable=0 where CharIndex('|'+ cast(ID as varchar) + '|' , @ENABLE_USERS) = 0 --List of users separated by | to disable, while keeping all the rest enabled all others Declare @DISABLE_USERS NVarchar(max) = '|BOB|JANE|' update userinfo set userinfo.enable=0 where CharIndex('|'+ cast(ID as varchar) + '|' , @DISABLE_USERS) > 0 |
Note 1: Parameterising a list can be tricky in TSQL, so the above trick is what i found easiest.
Note 2: You will need to decide whether the list of users provided is inclusive (i.e. provide the list of all the users you WANT to disable) or exclusive (i.e. disable all users except for a small subset). I have provided both options, but would recommend the exclusive approach as it is more likely to give you safely give you what you expect.
I hope this assists you and will be useful in your management of your AX environments. Keep an eye out for new posts in this series!
View Previous – AX DB Restore Scripts #7 – Setting Email Templates and User Email Addresses
One of the nifty features of Dynamics AX is to share form personalisations between user. To see how to do so check out Murray Fife’s article over here. However it seems that a distinct restriction is that you cannot effectively share personalisations between companies, even for the same user. This means that you need to perform the same setups for every form that you are working on.
I thought I would share with you today a quick customization that will assist allow you to copy your own customizations from one company to another or copy from a different user’s profile in another company to yours.
Our customization will make a modification to the “SysSetupForm” in AX. This is the form that is displayed when right clicking on a field in AX and clicking “Personalise”
In this post we will basically duplicate the “Retrieve from User” button to provide a “Retrieve from Alternate company” option in addition to the basic functionality. You could also simply customize the standard function as well.
Step 1. Create a new button
Step 2. Update button to display profiles from all users and companies
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 |
void loadFromUserAll() { SysLastValue sysLastValue; userId userId; CompanyId companyId; ; if (!loadFromUserMapAll) { loadFromUserMapAll = new Map(Types::String, Types::String); while select sysLastValue group by UserId, Company where sysLastValue.Company != this.lastValueDataAreaId() && sysLastValue.RecordType == UtilElementType::Usersetup && sysLastValue.ElementName == this.lastValueElementName() && sysLastValue.DesignName { loadFromUserMapAll.insert(sysLastValue.UserId+"|"+sysLastValue.company, strFmt("%1 (%2)", sysLastValue.UserId, sysLastValue.company)); } } if (loadFromUserMapAll.elements()) { [userId,companyId] = str2con(pickUser(loadFromUserMapAll, true),"|"); if (userId) { element.loadSetupCompany(userId,companyId); } } else { info("@SYS73299"); } } |
Step 3: Provide logic to load the setup on selection
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 |
// AosRunMode::Client public void loadSetupCompany(userId userId, CompanyId _company) { SysLastValue sysLastValue; container value; Name designName; Map map; ; select firstonly sysLastValue where sysLastValue.Company == _company && sysLastValue.UserId == userId && sysLastValue.RecordType == this.lastValueType() && sysLastValue.ElementName == this.lastValueElementName() && sysLastValue.DesignName != ''; if (sysLastValue) { map = new Map(Types::String, Types::String); while select designName from sysLastValue where sysLastValue.Company == _company && sysLastValue.UserId == userId && sysLastValue.RecordType == this.lastValueType() && sysLastValue.ElementName == this.lastValueElementName() && sysLastValue.DesignName != '' { map.insert(sysLastValue.DesignName, sysLastValue.DesignName); } designName = pickList(map, "@SYS28107","@SYS28107", true); if (designName) { value = xSysLastValue::getValue( _company, userId, this.lastValueType(), this.lastValueElementName(), designName); xSysLastValue::putValue( value, this.lastValueDataAreaId(), curUserId(), this.lastValueType(), this.lastValueElementName(), ''); element.disableLayoutChanges(); } } else { info(strfmt("@SYS28106", userId)); } } |
You’re all done!
Compile your form and access it from anywhere in AX by right clicking on a field and clicking Personalise.
You should now have a “Retrieve from Company” button.
When clicking on this button you will see a list of all user profiles for other companies, including your own with the company listed in brackets. Double click on the user name, then double click on the the personalisation name to load it.
I hope this helps make life more efficient and easy!
In my series of posts on SQL scripts I use when restoring Dynamics AX databases from one environment to another, we have so far covered various configuration and setting changes to Dynamics AX. Today I will move on to some suggested data changes that you may wish to consider making when doing database restores. These changes won’t affect the functioning of AX, but may prevent some awkward or confusing situations like clients or user’s receiving emails etc..
These data cleanup scripts are really meant as guidelines to help you in creating your own scripts, rather than a comprehensive set of “must-do” scripts.
The two changes for today are as follows
These settings can be found under System Administration -> Users -> Options (ribbon button) -> Email
The following SQL code will accomplish the above. I have parameterised the SQL for easier reuse or adjustment.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
---Email Template Settings---Declare @WFAPPROVER_ADD varchar(50) = 'workflowqa@norplats.co.za' Declare @EMAIL_TEMPLATE_NAME varchar(50) = 'Dynamics AX - DEVELOPMENT' Declare @EMAIL_TEMPLATE_ADDRESS varchar(50) = 'dev@mydomain.com' ---Email Address Clearing Settings--- DECLARE @ExclUserTable TABLE (id varchar(10)) insert into @ExclUserTable values ('userid1'), ('userid2') ---Update Email Templates--- update SYSEMAILTABLE set SENDERADDR = @EMAIL_TEMPLATE_ADDRESS, SENDERNAME = @EMAIL_TEMPLATE_NAME where SENDERADDR!=@EMAIL_TEMPLATE_ADDRESS OR SENDERNAME!=@EMAIL_TEMPLATE_NAME; update SYSEMAILSYSTEMTABLE set SENDERADDR = @EMAIL_TEMPLATE_ADDRESS, SENDERNAME = @EMAIL_TEMPLATE_NAME where SENDERADDR!=@EMAIL_TEMPLATE_ADDRESS OR SENDERNAME!=@EMAIL_TEMPLATE_NAME; ---Update User Email Addresses--- update sysuserinfo set sysuserinfo.EMAIL = '' where sysuserInfo.ID not in (select id from @ExclUserTable) |
Note, the above example clears all user email addresses except for a specific set, you could easily adjust this to set them all to a specific address as follows:
|
1 |
update sysuserinfo set sysuserinfo.EMAIL = 'youraddress@mydomain.com' |
I hope this assists you and will be useful in your management of your AX environments. Keep an eye out for new posts in this series!
View Previous – AX DB Restore Scripts #6 – SMTP Server and DMF Folder
Recently I started creating a list and a series of posts on SQL scripts I use when restoring Dynamics AX databases from one environment to another, typically from production to QA or development.
We have so far discussed a number of configurations that must be changed for the new system to operate effectively and starting yesterday we moved onto exploring more optional configurations.
Today we will cover two of these items namely re-configuring the outgoing SMTP server in AX and configuring the settings for the DMF working folder.
Note: In my experience the SMTP server will most likely not change between a production and development server, but you may need to reconfigure it if moving to a new domain etc. Similarly it will work to use the same DMF shared folder between PROD and DEV, however I would recommend changing this to keep the data 100% separate.
These two configurations are located in the Dynamics AX 2012 client under the following paths.
1. SMTP Server, accessed via System Administration -> Setup -> System -> E-mail parameters.
2. Data import, export framework shared working directory. Accessed via “Data import export framework -> Setup -> Data import export framework parameters”
To update these 2 settings above we need to do the following:
1. Update the SysEmailParameters table to update the SMTP server name (and additional login parameters)
2. Update the DMFParameters table to reflect the new shared folder path.
The following SQL code will accomplish the above. I have parameterised the SQL for easier reuse or adjustment.
|
1 2 3 4 5 6 7 8 9 10 11 12 |
---Outgoing Email Settings--- Declare @SMTP_SERVER varchar(100) = 'smtp.mydomain.com' --Your SMTP Server Declare @SMTP_PORT int = 25 ---DMF Folder Settings --- Declare @DMFFolder varchar(100) = '\\[YOUR FILE SERVER]\AX import\' ---Update Email Parameters--- Update SysEmailParameters set SMTPRELAYSERVERNAME = @SMTP_SERVER, @SMTP_PORT=@SMTP_PORT ---Update DMF Settings--- update DMFParameters set SHAREDFOLDERPATH = @DMFFolder where SHAREDFOLDERPATH != @DMFFolder --Optional to see affected rows |
I hope this assists you and will be useful in your management of your AX environments.
View next – AX DB Restore Scripts #7 – Setting Email Templates and User Email Addresses
View Previous – AX DB Restore Scripts #5 – Configure Service Accounts and Help Server
Last week I embarked on a series of posts on DB restore scripts for Dynamics AX by creating a list of items in your AX database that need to be updated/reconfigured when restoring a database from a production environment to a development or QA one.
So far we have covered the majority of the most critical issues to fix when doing a DB restore, so from today on most of the scripts are basically optional. They are optional for one of the following reasons: 1. It may be common to have the same configuration in both live and dev, yet in some circumstances they may differ e.g. Business connector may remain the same if you are restoring from live to dev, but not from live to a demo VPC.
2. The data is correct but for safety or security you may want to manipulate it for a development environment. E.G. Changing all email templates to clearly indicate the source is from a dev system.
Today we will cover two topics namely re-configuring the service accounts in AX and configuring the AX help server URL.
In the Dynamics AX 2012 client, the configurations that we are going to look at are:
1. System Service Accounts, accessed via System Administration -> Setup -> System -> System service Accounts
2. Batch Jobs, accessed via System Administration -> Setup -> System -> Help system parameters
To update the settings above we need to do the following:
1. Update the SYSBCPROXYUSERACCOUNT table to reflect the business connector user’s SID, networkdomain and network alias. For this step you will need to find out the SID of the business connector either by setting it manually the first time and then running select SID from SYSBCPROXYUSERACCOUNT where NETWORKDOMAIN='[yourdomain]’ and NETWORKALIAS='[yourbcuseralias]’ or follow one of the suggestions over here http://blogs.msdn.com/b/gaurav/archive/2014/06/03/get-sid-of-the-object-registry-wmic-powershell.aspx
2. Update the SYSWORKFLOWPARAMETERS table to reflect the userId of the workflow execution account.
3. Update the SYNCPARAMETERS table to reflect the userId of the Microsoft Project server synchronization service account.
4. Update SYSGLOBALCONFIGURATION to reflect new help server URL if necessary.
Notes:
1. If you are wanting to use an Alias/Network domain combination for either of the two execution accounts, I would recommend setting them manually in AX as they create users and permissions automatically when you do this.
2. The above script assumes that execution accounts you are setting exist in the new system and have the necessary permissions.
The following SQL code will accomplish the above. I have parameterised the SQL for easier reuse or adjustment.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
---BC Proxy Details --- Declare @BCPSID varchar(50) = '[BCPROXY_SID]' Declare @BCPDOMAIN varchar(50) = '[yourdomain]' Declare @BCPALIAS varchar(50) = '[bcproxyalias]' ---Service Accounts --- Declare @WFEXECUTIONACCOUNT varchar(20) = 'wfexc' Declare @PROJSYNCACCOUNT varchar(20) = 'syncex' ---Help Server URL--- Declare @helpserver varchar(200) = 'http://[YOURSERVER]/DynamicsAX6HelpServer/HelpService.svc' ---Set BCPRoxy Account--- update SYSBCPROXYUSERACCOUNT set SID=@BCPSID, NETWORKDOMAIN=@BCPDOMAIN, NETWORKALIAS= @BCPALIAS where NETWORKALIAS != @BCPALIAS --optional to display affected rows. ---Set WF Execution Account--- update SYSWORKFLOWPARAMETERS set EXECUTIONUSERID=@WFEXECUTIONACCOUNT where EXECUTIONUSERID != @WFEXECUTIONACCOUNT ---Set Proj Sync Account--- update SYNCPARAMETERS set SYNCSERVICEUSER=@PROJSYNCACCOUNT where SyncServiceUser!= @PROJSYNCACCOUNT ---Set help server URL--- update SYSGLOBALCONFIGURATION set value=@helpserver where name='HelpServerLocation' and value != @helpserver |
I hope this assists you and will be useful in your management of your AX environments.
View Next – AX DB Restore Scripts #6 – SMTP Server and DMF Folder
View Previous – AX DB Restore Scripts #4 – Reconfigure batch jobs
Last week I embarked on a series of posts on DB restore scripts for Dynamics AX by creating a list of items in your AX database that need to be updated/reconfigured when restoring a database from a production environment to a development or QA one.
This post is closely tied to and relies on my previous post on re-configuring your AOS and Batch AOS instances to work, so ensure you have completed that script before continuing. Today I will be looking at re-configuring your actual batch jobs and batch groups to function correctly under your new environment.
In the Dynamics AX 2012 client the configurations that we are going to look at are:
1. Batch Groups, accessed via System Administration -> Setup -> Batch Groups
2. Batch Jobs, accessed via System Administration -> Inquiries -> Batch Jobs -> Batch Jobs
Depending on the configuration of your source system (e.g. Production) you may have multiple AOSs setup as batch servers whereas your DEV and QA would most likely just have a single AOS that functions as the batch AOS. You may also have a number of batch jobs that that you explicitly don’t want to run in a development environment, such as integrations to vendors, automatic ordering etc… Therefore our scripts will need to do the following:
1. For each of our batch groups we want to:
– Delete all but one of their selected/linked “batch servers”
– Re-point the remaining link to the current batch server setup in our previous script.
2. Disable batch jobs that we do not want to run in our development environment.
Before proceeding, please note, these scripts are intended as guidelines and do make various assumptions on the state of your environment. For example I’m assuming that your batch jobs were cleanly shutdown with their status’ either in “Error, ended, or waiting” (not Cancelling or Executing). Please adjust these scripts to suit your environment.
The following SQL code will accomplish the above. I have parameterised the SQL for easier reuse or adjustment.
|
1 2 3 4 5 6 7 8 9 10 11 |
--Reuse the parameter declared for the SSRS and AOS update script Declare @AOS varchar(30) = '[AOSID]' -- Must be in the format '01@SEVERNAME' -- #1.1 Clear out but one link between each batch server group and batch server. delete from BATCHSERVERGROUP where RecId not in (select min(recId) from BATCHSERVERGROUP group by GROUPID) -- #1.2 Repoint remaining links to the active aos/batch server. update BATCHSERVERGROUP set SERVERID=@AOS where serverid != @AOS -- Optional to see "affected row count" -- #2 - Disable batch jobs that should not run in a production environment. Copy the two lines below for each batch job you want to disable. update batchjob set batchjob.status=4 where batchjob.CAPTION = '[BATCHJOBNAME]' update batch set batch.STATUS=4 from batch inner join BATCHJOB on BATCHJOBID=BATCHJOB.RECID AND batchjob.CAPTION = '[BATCHJOBNAME]' |
I hope this assists you and will be useful in your management of your AX environments.
View Next – AX DB Restore Scripts #5 – Configure Service Accounts and Help Server
View Previous – AX DB Restore Scripts #3 – Configure AX servers and batch servers
Earlier this week I embarked on a series of posts on DB restore scripts for Dynamics AX by providing a list of data entities in your AX database that need to be updated when restoring a database from a production environment to a development or QA one.
Today I will be drilling into how to reset/configure your AX AOS and batch AOS configurations via DB scripts. These scripts are necessary especially for the SSRS script and for the batch server update script (available soon) as these rely on a correct AOS configuration.
Note: Under normal circumstances a new configuration for your AOS will automatically be created if it does not exist when the AOS starts up after a restore, however all your other configs like batch jobs, SSRS settings etc won’t be pointing to it, but rather the old settings that are not cleared. Thus I prefer to fix this in my script.
In the Dynamics AX 2012 client these configurations are located under System Administration -> Setup -> System -> Server Configuration
Depending on the configuration of your source system (e.g. Production) you may have multiple AOSs setup here and typically your destination may only have a single AOS configuration therefore your script would need to do the following:
1. Remove all but one of the AOS configurations
2. Update the server details of the remaining configuration
3. Enable the remaining server as the “batch” server.
The following SQL code will accomplish the above. I have parameterised the SQL for easier reuse or adjustment.
|
1 2 3 4 5 6 7 8 |
--Reuse the parameter declared for the SSRS update script Declare @AOS varchar(30) = '[AOSID]' -- Must be in the format '01@SEVERNAME' -- Clear out all but one server config. delete from SYSSERVERCONFIG where RecId not in (select min(recId) from SYSSERVERCONFIG) -- Update the remaining one to point to your current AOS and enable it for batch processing update SYSSERVERCONFIG set serverid=@AOS, ENABLEBATCH=1 where serverid != @AOS -- Optional if you want to see the "affected row count" after execution. |
Note: These changes assume everything is setup correctly on the SSAS server itself.
View Next – AX DB Restore Scripts #4 – Reconfigure batch jobs
Recently I started a series of posts on DB restore scripts for Dynamics AX by providing a list of data entities in your AX database that may need to be updated when restoring from one environment to another, in particular a production DB to a development or QA environment.
Today I will be drilling into how to reset the SSAS (SQL Server analysis services) configurations via DB scripts.
In the Dynamics AX 2012 client these configurations are located under System Administration -> Setup -> Business Intelligence -> Analysis Services -> Analysis Servers.
Depending on the configuration of your source system (e.g. Production) you may have multiple servers setup here and typically your destination would only have a single server (Development) therefore your script would need to do the following:
1. Remove all but one of the SSAS configurations
2. Update the server details of the remaining configuration
The following SQL code will accomplish the above. I have parameterised the SQL for easier reuse or adjustment.
|
1 2 3 4 5 6 7 8 9 |
Declare @SSASSERVERNAME varchar(20) = '[YOURSERVERNAME]\AX' Declare @SSASDESCRIPTION varchar(30) = 'Dev SSAS'; -- Description of the server configuration delete from BIAnalysisServer where RecId not in (select min(recId) from BIAnalysisServer) update BIAnalysisServer set SERVERNAME=@SSASSERVERNAME, DESCRIPTION=@SSASDESCRIPTION, ISDEFAULT = 1 WHERE SERVERNAME <> @SSASSERVERNAME -- Optional where clause if you want to see the "affected rows |
Note: These changes assume everything is setup correctly on the SSAS server itself.
View Next – AX DB Restore Scripts #3 – Configure AX servers and batch servers
Yesterday I started a series of posts on DB restore scripts for Dynamics AX by providing a list of data entities in your AX database that should be updated when restoring from one environment to another.
Today I will start drilling into the details of each of these items starting with SSRS (SQL Server reporting services) configurations.
In the Dynamics AX 2012 client these configurations are located under System Administration -> Setup -> Business Intelligence -> Reporting Services -> Report Servers.
Depending on the configuration of your source system (e.g. Production) you may have multiple servers setup here and typically your destination would only have a single server (Development) therefore your script would need to do the following
1. Remove all but one of the SSRS configurations
2. Update the remaining one to be default and update the relevant data fields.
The following SQL code will accomplish the above. I have parameterised the SQL for easier reuse or adjustment.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
Declare @AOS varchar(30) = '[AOSID]' --must be in the format '01@SEVERNAME' Declare @REPORTINSTANCE varchar(50) = 'AX' Declare @REPORTMANAGERURL varchar(100) = 'http://[DESTINATIONSERVERNAME]/Reports_AX' Declare @REPORTSERVERURL varchar(100) = 'http://[DESTINATIONSERVERNAME]/ReportServer_AX' Declare @REPORTCONFIGURATIONID varchar(100) = '[UNIQUECONFIGID]' Declare @REPORTSERVERID varchar(15) = '[DESTINATIONSERVERNAME]' Declare @REPORTFOLDER varchar(20) = 'DynamicsAX' Declare @REPORTDESCRIPTION varchar(30) = 'Dev SSRS'; delete from SRSSERVERS where RecId not in (select min(recId) from SRSSERVERS) update SRSSERVERS set SERVERID=@REPORTSERVERID, SERVERURL=@REPORTSERVERURL, AXAPTAREPORTFOLDER=@REPORTFOLDER, REPORTMANAGERURL=@REPORTMANAGERURL, SERVERINSTANCE=@REPORTINSTANCE, AOSID=@AOS, CONFIGURATIONID=@REPORTCONFIGURATIONID, DESCRIPTION=@REPORTDESCRIPTION where SERVERID != @REPORTSERVERID -- Optional if you want to see the "affected row count" after execution. |
Note: These changes assume everything is setup correctly on the SSRS side.
A common task in the administration of a Dynamics AX installation is restoring databases from a live application to a development environment or quality assurance (QA) environment. However when doing so one needs to be very careful to re-configure the database so that it behaves correctly in its new context. For example you would need to re-configure your SSRS servers to point to the correct DEV/QA SSRS instance. Many of these changes can be done via the front-end, but it is very useful to script these in SQL so that nothing is missed and alot of effort is saved.
The following post aims to list as many of the potential data items that need to be changed when doing a DB restore. I will in the following days be posting the relevant SQL alongside the front-end equivalent and ultimately a full DB restore script that you can use when doing such a restore. Some of these may need to be adapted for your specific configurations and you may need to add your own based on customization etc.
Let me say at the outset that I am very new to Dynamics AX role centers and analysis services and really have a lot to learn. However I thought I would share the following problem with setting up role centers and the associated solution that I found.
Problem description: After installing role centers on AX2012 RTM CU 3 with SQL Server 2012 the following error is displayed “An attempt has been made to use a data extension ‘AXADOMD’ that is either not registered for this report server or is not supported in this edition of Reporting Services. (rsDataExtensionNotFound)”
The Event log on the SSRS machine says the following: Role Centers / Analysis Services: Report Server (AX) cannot load the AXADOMD extension.
Problem resolution / investigation: After chasing my tail on this one for quite a while (including multiple re-installation etc) trying to figure out why the “AXADOMD” SSRS datasource extension was not installed I discovered that the problem did not lie with “AXADOMD” being missing but rather it might be having issues when it was loading.
Looking at the SSRS log files (C:\Program Files\Microsoft SQL Server\MSRS11.AX\Reporting Services\LogFiles) I discovered the following message:
ERROR: Exception caught instantiating AXADOMD report server extension: System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. —> System.IO.FileNotFoundException: Could not load file or assembly ‘Microsoft.AnalysisServices.AdomdClient, Version=10.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91′ or one of its dependencies. The system cannot find the file specified.
File name: ‘Microsoft.AnalysisServices.AdomdClient, Version=10.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91′
at Microsoft.Dynamics.Framework.Reports.AxAdomdConnection..ctor()
This lead me to think something might be wrong with the Microsoft.AnalysisServices.AdomdClient itself despite the AX installation validation showing up that it was installed already.
Paying a quick visit to C:\Windows\Assembly revealed that only AdomdClient version 11.0.0.0 was installed
The simple solution to this issue was to install the 10.0.0.0 client from http://www.microsoft.com/en-za/download/details.aspx?id=23089 after which SSRS no longer complained.
I hope this saves somebody some of the hassle and time that I have spent on figuring this one out.
Recently a question was asked on the Dynamics AX community forums about the reason for and the use of manual decisions in Workflow. (see original thread)
Basically manual decisions allow you as a implementation consultant at configuration time to define a question for a user to answer with two outcomes (answers) that can be used to change the logical process flow of the workflow.
Normally in my experience with workflow, processes tend to not rely on a user’s choice to define the flow, but rather on a pre-decided flow and set of rules that can be catered for by automatic decisions (conditional statements), assignment etc. However there may, from time to time, be choices that are simply too fuzzy or complex for system to handle and we can therefore delegate the decision to a human user to make. For example: We may want a purchase requisition to go through an RFQ cycle if a senior manager thinks that the amount “looks” too much, or that he thinks there “may be” preferential treatment of a selected vendor. There is no conditional statements in AX that can cater for these subjective scenarios. So we can simple ask a user using a manual decision.
So here is how we setup a manual decision.
Configuration
1. Create a new workflow configuration of your choice and fill in all the basic details. E.G. Purchase Requisition review.
2. Drag the “Manual decision” control from the “Flow controls” onto your workflow configuration.
3. Select the newly created Manual decision and click the properties Icon in ribbon bar.
4. Provide a name for the element so that it makes sense in your configuration.
5. In the “Workitem Subject” field pose a question to the user. E.G. Does this requisition require a Review / RFQ?
6. Provide a description with more details in the “Work item instructions”.
7. Select the “Outcomes” tab (under Basic settings) and enter the two answers for the user. E.G. “Review Document” and “Do not review”
8. Select the assignment tab and choose who to pose the question to. (beyond the scope of this blog)
9. Click close.
10. On your workflow diagram create the relevant elements such as requisition review and approval nodes (beyond the scope of this blog)
11. Connect up your Manual decision
11.1 Connect an incoming flow to your decision e.g. From the start element (or from any other workflow element.
11.2 Connect (from the left of your decision) the Outcome one node to the element that your want to process should the user select what you defined as Outcome one. E.G. In our example Outcome 1 was to review document, so we connect outcome 1 to the review element. Hint: Hover over the decision to see the handle to drag the process flow
11.3 Repeat 11.2 for outcome 2.
12. Save and close your workflow. (ensure you select the “activate new version” option) when prompted
Test your workflow.
1. Create your document and submit it into workflow.
2. The user you selected in step 8 above should (after workflow has processed for a minute or two) see the following screen with our question and two outputs.
3. The user can now select an option and workflow will be redirected as needed.
I hope this is helpful in understanding Manual decisions in Workflow in Dynamics AX.
Happy Daxing
Its not really my habit in my blog to re-post or re-blog other users content, but rather to write up my own findings as I explore Dynamics AX. However this post is a bit of a worthy exception.
If you have been in AX for an period of time you have most likely heard of Murray Fife and his very practical Companion guides to Dynamics AX. Right now you can download his “AN INTRODUCTION TO DYNAMICS AX 2012″ for free over here. It is highly useful material for anyone new to AX or even old hats looking for some new easy to use tips and tricks. I’ve been compiling some introductory basic training material for our company and this book will go along way in assisting me with this!
Thank you Murray Fife for this awesome content.
See his original post over here too.
Update: Unfortunately this was only a limited time offer, but I would still encourage you to get hold of this book either from Murray Fife’s website http://www.dynamicsaxcompanions.com/ or from amazon Here
Recently while debugging some legacy code I came across the following interesting observation regarding transaction scopes (ttsbegin, ttscommit) and the exception handling surrounding it. While walking the legacy code was observing very strange and unexpected behaviour and after some online investigation i found the following statement from Microsoft:
“When an exception is thrown inside a ttsBegin – ttsCommit transaction block, no catch statement inside that transaction block can process the exception. Instead, the innermost catch statements that are outside the transaction block are the first catch statements to be tested.”
(https://msdn.microsoft.com/en-us/library/aa893385.aspx)
In its simplest form this means that for the following code:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
try { ttsBegin; try { throw error("Thrown Error"); } catch (Exception::Error) { error("Inside Error"); } ttsCommit; } catch (Exception::Error) { error("Outside Error"); } |
Prints the following results:
Now when it comes to a simple block of code like above one may say “Well that is simply silly coding”, however it becomes harder to anticipate results when that inner try…catch is within a method somewhere deeper inside the call stack (perhaps in standard code somewhere) e.g.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 |
void innerFunction() { try { ttsbegin; throw error("Thrown Error"); ttscommit; } catch (Exception::Error) { error("Inside Error"); } } try { ttsBegin; innerFunction(); ttsCommit; } catch (Exception::Error) { error("Outside Error"); } |
Further more if your inner exception does cleanups or logging of information this will not happen by carelessly adding ttsBegins and ttsCommits around the calling code E.G. “writeErrorLog” will never be called in the following function regardless of what the writer of “innerFunction” does if the writer of the caller adds TTSBEGIN AND COMMIT
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 |
static void testTransactions(Args _args) { void innerFunction() { while forUpdate select myTable { try { ttsBegin; if (someCondition) { throw error("Throw Error"); } else { myTable.myField = "update"; myTable.update(); } ttsCommit; } catch (Exception::Error) { writeErrorLog(strFmt("Failed on record %1", myTable.RecId)); error("Inside Error"); } } } try { ttsBegin; innerFunction(); ttsCommit; } catch (Exception::Error) { error("Outside Error"); } } |
I thought I would just paste these observations for anyone who like me has experienced this type of “strange behavior” in the past and didn’t know the exact reason and also as a warning to beware of the “Catch”.
Feel free to share your comments, observations and thoughts.
Setting up AX Database logging via the user interface wizard can at times be a bit of a cumbersome and slow task, especially for tables that are not very common. The job below will simply set database logging for all fields on a specific table. Simply replace “InventSalesSetup” with the table name of your own choosing. As always, test this in a non-production environment to confirm that it performs suits your own needs.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 |
static void setDBLogOnTable(Args _args) { TableId tableId = tableNum(InventItemSalesSetup); DatabaseLog log; SysDictTable dictT = new SysDictTable(tableId); SysDictField dictF; Set fields; SetEnumerator se; log.logType = DatabaseLogType::Update; log.logTable = tableId; fields = dictT.fields(false,false,true); se = fields.getEnumerator(); while (se.moveNext()) { dictF = se.current(); log.logField = dictF.id(); log.insert(); info(strFmt("Adding field %1", dictF.name())); } SysFlushDatabaselogSetup::main(); } |
Its always a great opportunity to interact with other AX developers and have the opportunity to learn from each other. A few weeks ago I published a blog post on searching the AX AOT in code for objects with specific properties, after the post went out I got a comment on the post of a much easier way to search the AOT from the frontend, that for some reason I have never really noticed before. So here is a quick way to do an advanced search of the AOT using a real situation I encountered this morning.
Example: Find all privileges in the AOT that have a specific menuitem as an entry point. e.g. “PurchFormLetter_PackingSlip”
1. Open an AOT and select the section of the AOT that you wish to search. Obviously the narrower the search the quicker it will be. I selected Security->Privileges.
2. Right click on the object. Click Find
3. Select “All Nodes” in the search dropdown
4. Select properties tab.
5. Right click on any field in the “Property” Column, Click filter by field.
6. Enter the name of the property you wish to search on. In my case I’m looking for all entry points that points that have the ObjectName set to PurchFormLetter_PackingSlip, so i enter “ObjectName”
7. Click Ok.
8. Click the “Selected” checkbox
9. Enter the value you want to search for under “Range” e.g. “PurchFormLetter_PackingSlip”
10. Repeat steps 5-9 if you want to search for multiple properties.
11. Click Find now
12. You will now have a list of all the subobjects of whatever you selected in step 1 containing a specific property with a specific value.
Note 1: You can also do some pretty neat searches using both the date and advanced tabs on this form so be sure to check them out too.
I hope this helps somebody who like me has just overlooked this for years.
Thanks Martin for the tip!
Disclaimer: For my specific example it may have been easier to use either the Security development tool or right click on the menu-item in AX -> Add-ins -> Security Tools -> View related security objects. But I needed an example for this post 
When one is exposed to a new AX environment, one of the first things to do is check exactly what version of AX kernel is running. Obviously the easiest way to do this is to open the “about” box in AX and note the build number and compare it with the common build numbers on a site such as Axaptapedia or MSDN
http://blogs.msdn.com/b/axsupport/archive/2012/03/29/overview-of-ax-build-numbers.aspx
http://www.axaptapedia.com/Build_numbers
However on occasion when a kernel hotfix has been installed you will not find your build numbers on these pages. Searching for the build number on google, customersource or partner source also doesnt reveal anything. So here is the slightly round-about way I have found to find out what kernel hotfix has been installed. If you have an easier way, please let me know!
1. Take note of your kernel number in the about box of Dynamics AX
2. Confirm that the build number is not a major CU release by reviewing the sites above
3. Open up programs and features on the AOS, select “View installed updates”
4. Locate the section on “Microsoft Dynamics AX 2012 Object Server”. Take not of the KB article numbers listed
5. Logon to Microsoft customer or partnersource.
6. Open any existing KB article e.g. https://mbs2.microsoft.com/Knowledgebase/KBDisplay.aspx?scid=kb;EN-US;2998197
7. Replace the KB number in the URL with the KB number noted in step 4. E.G:
https://mbs2.microsoft.com/Knowledgebase/KBDisplay.aspx?scid=kb;EN-US;2998197
becomes
https://mbs2.microsoft.com/Knowledgebase/KBDisplay.aspx?scid=kb;EN-US;2936094
This example reveals that we have a hotfix to resolve “SysGlobalObjectCache is not invalidated in multi Application Object Server (AOS) environment for CIL code”
I hope this helps anybody who has ever struggled to find out what kernal hotfixes are installed.
I also hope there is an easier way!
I’ve recently moved into an environment with multiple load balanced AOSs that need to be controlled during code deployment and maintenance. If one needs to stop and start these services include either to logging into each machine individually or using the Windows services control panel to connect to the indivual machines to shutdown each AOS service.
Both of these options unfortunately are rather tedious and time consuming especially if you have numerous services to control and need to do it quickly. A simple way to do this is to batch/script the process using command line instructions to control the remote services. You can use sc.exe application to do so. Here are some examples:
sc \\[SERVERNAME] stop [SERVICENAME] e.g. sc \\JH-Srv-01 stop AOS60$01
sc \\[SERVERNAME] start [SERVICENAME] e.g. sc \\JH-Srv-01 start AOS60$01
This will issue the commands but won’t necessarily wait around while the services are stopping or starting.
Adding multiple of these commands to a single .BAT file will make you environment management life much easier! You can also use it to control other services like SSRS etc…
Note 1: You will obviously need the necessary permissions on each of these servers to do these tasks.
Note 2: The service name is the name listed under the properties (right click on the service, click properties) of the service not the one in the list of services.
Issue: One cannot install SQL Server required for Dynamics AX without .Net 3.5 on a server with limited internet access
Description: One of the obvious requirements for installing Microsoft Dynamics AX is SQL Server which in turn requires the .Net Framework 3.5 to be installed as one of Windows features. However both the Windows feature installer as well as the download versions of .Net Framework 3.5 require an active intenet connection to Window Update servers even if you have the Windows install files. If you do not have this connection due to some reason like a corporate proxy etc installation can be big problematic.
There is hope though. One can force the installation from the Windows disk using the following technique.
1. Insert your Windows installation disk into your computer or mount the disk image.
2. Open a command window running with Administrative privileges
3. Enter the following command: “Dism.exe /online /enable-feature /featurename:NetFX3 /All /Source:E:\sources\sxs /LimitAccess” replacing “E:\” with the path or drive of your windows install disk
4. Press enter and .Net 3.5 will install.
Many thanks to Reza Faisal for saving us many hours with your article on this, it has saved myself and my colleagues much frustration. View the article here: https://support.microsoft.com/en-us/kb/2785188
As part of my series on “Things new X++ Developers Should know”. I have been writing a few basic howtos and checklists for new X++ Developers. These are really meant to be simple step by step guides to get new developers more productive by exposing the little secrets of the AX development that sometimes take years before discovering.
Today’s post is a checklist of things you need to have in place to ensure that you can debug X++ code.
You will need to restart your user session by logging off and back on again
I hope this checklist will help somebody stuggling with their debugging in AX. Please let me know if there are additional tips for debugging that this list may be missing.
For some additional details on debugging see MSDN:
https://msdn.microsoft.com/en-us/library/gg860898.aspx
For diagnostics purposes it is often useful to search the AOT for all objects matching cetain properties. For example you may want to find all display menutitems that are pointing to a specific form. The below job illustrates how to simply traverse the Display Menuitems node in the AOT to locate all items who’s “ObjectType” is “Form” and object is a specific form name. E.G. “PurchReqTable”.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
static void FindMenuItemsForForm(Args _args) { #AOT str find = "PurchReqTable"; TreeNode root = TreeNode::findNode(#MenuItemsDisplayPath); TreeNode current; TreeNodeTraverser trav = new TreeNodeTraverser(root,false); current = trav.next(); while (current) { if ((current.AOTgetProperty('ObjectType') == "Form") && (current.AOTgetProperty('Object') == find)) info(strFmt("Found menuitem %1",current.AOTname())); current = trav.next(); } |
Adapting this to search other nodes is as simple as changing the original node instantiation to search a different path as well as changing the AOTgetProperty() method to search through the properties relevant to you.
Happy Daxing
Original community post: https://community.dynamics.com/ax/f/33/p/161258/387257#387257
As part of my series on “Things new X++ Developers Should know”. I have been writing a few basic howtos for new X++ Developers. These are really meant to be simple instructions to get new developers more productive by exposing the little secrets of the AX development that sometimes take years before discovering.
Today is the simple trick of moving elements up and down in list in the AOT using your keyboard. E.G. Re-arranging fields in a grid control or field group. Sometimes the mouse re-arranging produces unexpeded results and is quite frankly much slower.
Notes on this functionality:
As part of my series on “Things new X++ Developers Should know”. I have been writing a few basic howtos for new X++ Developers.
Today’s post relates to quickly navigating to specific objects in the AOT without endless scrolling.
So often when working over the should of new developers or consultants exploring the AOT I see them scrolling endlessly or dragging the scrollbar back and forth for a while before finding the object they are looking for.
A common technique to navigate through lists in both Windows (e.g. My computer etc) and windows based environments (SQL management studio etc..) is to simply start typing the name of the object you are looking for. Windows automatically moves to the first object matching the sequence typed.
AX is by no means an exception to this rule. Simply click and expand the main node of the object you are looking for e.g. “Forms”
and start typing E.G. “PurchReqT…..”
As you type AX will move to the first object found matching what you have typed so far..
E.G. P moves to PartitionAdministration, Pu to PurchArgreement etc….
There are some bonus features when using this in AX:
1. You can always see what you have typed so far by looking at the bottom left of your screen
2. The typing timeout is long compared to applications like SQL etc where you need to have taken a speed typing course to get this right. As long as you still see the search term in the bottom you can just continue typing (this normally takes around 7 seconds or until you use your keyboard arrows or mouse to do something different
I know this may be a very obvious tip, but I’ve witnessed too many people taking forever to find objects by scrolling to not include this in the “Things new X++ Developers Should know” series.
Enjoy
As part of my series on “Things new X++ Developers Should know”. I have been writing a few basic howtos for new X++ Developers.
Today’s post relates to quickly navigating to the source code from where an info log error, warning or information message is called from. It took me a while to figure out that for many info log messsages you can simply double click on the message in the info log window and the code that called the message will be displayed for you.
E.G. If you see the normal error log icon or warning icons with a small arrow in the bottom left corner, you are normally able to double click the message to see the code behind it. These icons look like this:
Error Log
Info Message
Warning Message
Simply Double click the message as below
To be presented with the code that called it.
NOTE 1: If you have your “Execute business operations in CIL” user option enabled, a lot of business logic like postings etc will not allow you to drill down.
NOTE 2: If the code calling the info message makes use of the SysInfoAction parameter, you will be taken to an alternate form specified by the developer and not the source code. (See Axaptapedia Article)
As part of my series on “Things new X++ Developers Should know”. I have been writing a few basic howtos for new X++ Developers.
Today’s post relates to quickly navigating to the source or parent type of an object in the AOT. This is often useful to drill through to a parent object to discover, debug or modify properties and code. The following are some examples of drill-downs you can perform
1. Open the Data Dictionary Table from a Form’s datasource
2. Open the Data Dictionary Enum used from a table field
3. Open the Extended Data Type used by a table field
4. Open the AOT Form object (or class, report etc) from a Menu-item object
5. Open the Data Dictionary Table object from a Query datasource
6. Open a parent EDT from an extended EDT
7. Open a parent class from an extending class.
1. Open the object in question e.g. a Table field.
2. Right click on the field.
3. Select “Add-ins”
4. Select Open new Window
5. Click “Open used Extended Data Type”
6. The parent type is now displayed in a new window. In this example the ProjId EDT is displayed
As part of my series on “Things new X++ Developers Should know”. I have been writing a few basic howtos for new X++ Developers.
With some of the more complex forms in AX 2012 it can sometimes be quite tricky to navigate through the form hierarchy in the AOT to debug which table and field certain controls on your form are bound to. So today I’ll cover how to determine the Table and Field name or the name of a control directly from an AX Client form. A quick and easy way to do so is to simply use the “personalise” function in AX.
NOTE: This requires you to have system administrator privileges (which you probably have if you are a developer)
1. From any form in AX. Right click on the form control or field that you would like to diagnose.
2. Click “personalise”
3. From the personalise screen you can now view the following:
#1. The location in the Design node of the AOT where the control resides
#2. The name of the Control in the AOT
#3. The name of the AOT Table name that the control is bound to
#4. The name of the datasource on the form that the control is bound to (normally the same as the Table Name)
#5. The name of the field on the table that the control is bound to
As part of my series on “Things new X++ Developers Should know”. I have been writing a few basic howtos for new X++ Developers.
Today we cover how to determine the AOT name of the current form that you are accessing and edit it directly without having to go through the tedious process of navigating/searching in the AOT. This can be very useful in increasing productivity as well as debugging functionality
1. From any form in AX right click on an control.
2. Click “Personalise”.
3. Select the “Information” tab.
4. The AOT name of the form is visible under “Form name”.
5. Click Edit to acess the form in the AOT.
Note: This won’t work for forms created in code like dialogs etc..
Since my start in X++ development over 6 years ago there are many small things that I have learnt that I wish I had known from the start. Small things that won’t necessarily help you post a stock journal from code or perform complex integration tasks, but none the less makes your day ever so much more productive. If you are a seasoned developer you will most probably already know most of these, but I thought I’d put them all down in a neat list for new guys to go through. Here are some of my favourites along with links to short articles on how to do them. (I will hopefully add some more over time).
1. Keyboard Shortcut to view properties of an AOT element: Simply Hit “Alt+Enter” on any AOT element to view its’ properties list. Much quicker than fumbling with right clicking on the mouse. (view more shortcuts)
2. Drilling down to the AOT from an open form: Instead of reverse engineering forms from menu structures or navigating in the AOT to edit a specific form, simply right click on any form, click “Personalise”, select the “Information” tab, click on the “Edit” button next to the form name. (view details)
3. Drilling down to the dictionary type of an object in the AOT. E.G. Edit enum or EDT being used by a field on a table. Navigate to an element in the AOT e.g. A enum field on a table. Right click on the element, click “add-ins”, click “Open in new Window”, click “Open used Enum” etc…. (view details)
4. Drill through to code from Info log – Quite often the info log will allow you to drill down into the code the called the error message. If you notice a small arrow on the error icon you can simply double click on the line to take you to the code. (view details)
5. Infolog code drill down does not work if code is running in CIL. As an addition to the above you will not be able to drill down to code if it is running in CIL. For DEVELOPMENT/DEBUGGING purposes only you can simply disable code from running in CIL in your User Options.
6. Run AX as an alternative user. For debugging security or processing workflow it is often needed to run AX as an alternative user. Simply press Shift and right click on the AX icon on your desktop. You can then select “Run as different user”. (view more)
7. Determine Field name from control on Form. Sometimes you need to quickly find out the database table and field that is shown on a form without navigating through the complex AOT form. Simply right click on the field, click “personalise”. Under “System Name” you will see the following: Control name, Datasource Name, Table Name and finally Field Name. (view details)
8. Locate specific AOT object without scrolling. This may be an obvious one as Windows uses this technique in many other applications. Open the AOT and expand and click on the main node of the object you are looking for e.g. Classes. Then simply type the name to navigate to the specific object. (view details)
9. Creating an Development Environment shortcut. As a developer you don’t necessarily want to login to the Dynamics AX front end whenever accessing the AX shortcut, but rather want to open a development workspace directly. To do so right click on the AX shortcut on your desktop, click properties, on the shortcut tab in the “target” field add “-development” after the path to the Ax32.exe file. (View step by step)
10. Enabling breakpoints / debugger. One of the most important tools in a developers toolbag is the debugger. There are a few items on the checklist that you should ensure before you can successfully debug code: View them here.
11. Enabling viewing of Layer and Models. In a complex AX environment it is very useful to know what model and layer an object forms part of in order to search for patches or fix yourself. You can easily enable the AOT to display these by navigating to: File -> Tools -> Options -> Development -> Application Object Tree -> Application Object layer -> Select “Show All layers” and Application Object Model -> “show on All elements”.
12. AX Layer Config files. Create AX shortcut files to allow you to easily logon to the layer of your choice. View how here. (link available soon)
13. Profiler / SQL Trace. You can easily make use SQL Tracing or profiler to see the exact SQL being executed behind the scenes. This can be very useful for debugging purposes. (link available soon)
14. Using Alt+[Up/Down] keys to reorder AOT elements. To rearrange object elements like controls on a form grid simply hold in ALT and press the Up and Down keys to rearrange its order in the parent. (view details)
Anyway thats my list for now. Please let me know of any other quick tips and tricks that you think new developers (or old) should know about!
Keep a lookout for some more detailed explainations on some of these coming up in the follow days.
For some more advanced tips, tricks and coding patterns please also checkout the knowledge base at dynamicsaxtraining.com
Before I start: As a disclaimer, I’m posting this to show a potential way to solve this issue or similar issues, and to spark thought not necessarily as a production recommended solution.
I have had the requirement in the past to ensure that our environments (DEV, UAT and PROD) are reliably color coded to reflect the true environment that is currently open. This should not be application dependent (code only existing in individual environements) or database dependent (settings residing in the database) as these may change, be restored or be overwritten.
The best solution out there on how to physically color forms is Palle Agermarks’ solution. I would recommend you look at his code to get started as this is not the primary purpose of this post.
This solution however relies on a database table with the required color settings. This means that if a database is restored the color settings in UAT may reflect the color settings in Prod. For some purposes this may be ok or indeed what is needed, but we want to be able to clearly and confidently differentiate between our environments without having to remember restore scripts etc.
To do this I took Palle Agermarks‘ color coding code and modified it to look (in code) at what the current database is and color code my environment accordingly. Unfortunately this does require a bit of hard-coding a set of database names, but the colors will change correctly regardless of database or application loaded.
The key to this is to use SysSQLSystemInfo::construct().getLoginServer(); to determine the current database server you are connecting to.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
public void setFormStatusBarColor() { int a,r,g,b; Color color; str serverName = SysSQLSystemInfo::construct().getLoginServer(); if (formRun) { switch (serverName) { case "MYDEVSERVER" : color = "33CC33"; //green break; case "MYPRODSERVER" : color = "FF9933"; //red break; case "MYUATSERVER" : color = "0066FF"; //blue break; } |
|
1 2 3 4 5 6 7 8 |
if (color) { a = 254; [b,g,r] = WinAPI::RGBint2Con(hex2Int(color)); formRun.setStatusBarBackgroundColor(a,r,g,b); } } } |
Some variations on this, depending on your setup, would include looking for keywords in your server names instead of the whole name to determine what environement is being used. E.G. Does servername contain “DEV”. This may make it a bit more flexible and re-usable.
Although not often needed within workflow, one sometimes has the requirement to set due dates, escalation dates etc based on some sort of custom criteria E.G Complete by My Birthday or Complete at least one day before the documents requested date. Recently on the Dynamics AX forum this question was raised (https://community.dynamics.com/ax/f/33/t/156937.aspx) so I thought I’d write up a “short” post on how to create a custom WorkflowDueDate provider.
1. Create a new class in the AOT that implements “WorkflowDueDateProvider” e.g. MyCustomDueDateProvider
public class MyCustomDueDateProvider implements WorkflowDueDateProvider
{
}
2. Create method getCalendarTokens
The getCalendarTokens method will return a list of items that will display in the Time Limit’s Calendar option in your workflow configuration.
You can return any list of items here that you would like to allow the user to select for resolution. For example in the standard Calendar Due Date provider a list of all the configured calendars in the system. However you could customise this to return an entirely personal list of options such as “My Birthday” and “My Anniversary” that will set the workitem’s due date to my next birthday (26th of June 2015) or next anniversary (24 of March 2016). You could also provide an option that is document specific such as “1 Day Before Requested Date”. For this example I am going to use these options to illustrate the true arbitrary nature of the tokens.
public WorkflowCalendarTokenList getCalendarTokens()
{
WorkflowCalendarTokenList tokens = WorkflowCalendarTokenList::construct();
;
tokens.add(“MYBIRTHDAY”, “My Birthday”);
tokens.add(“MYANNIVERSARY”, “My Anniversary”);
tokens.add(“1DAYBEFOREREQ”, “1 Day Before Requested Date”);
return tokens;
}
3. Create the resolve and resolveNonUser methods
After creating the tokens list we need to create a way to resolve the specific option that the user has selected in his configuration. I’ve kept my code very simple (and hardcoded) to illustrate how this works.
public WorkflowDateTime resolve(WorkflowContext _context, WorkflowCalendarToken calendarToken, WorkflowTimeSpanMinutes _timeSpanMinutes, WorkflowUser _userId)
{
Date tmpDate;
WorkflowDateTime ret;
PurchReqTable req;
;
if (!_calendarToken)
throw error(“@SYS105450″);
if (_calendarToken == “MYBIRTHDAY”)
{
tmpDate = str2DateDMY(“26062010″); //specific date
ret = DateTimeUtil::newDateTime(tmpDate, 0);
ret = MyCustomDueDateProvider::nextDate(ret);
}
else if (_calendarToken == “MYANNIVERSARY”)
{
tmpDate = str2DateDMY(“24032010″); //specific date
ret = DateTimeUtil::newDateTime(tmpDate, 0);
//next date is a custom method that simply finds the next occurance of my birthday by adding years to the provided date until it is greater than today.
ret = MyCustomDueDateProvider::nextDate(ret);
}
else if (_calendarToken == “1DAYBEFOREREQ”)
{
if (_context.parmTableId() == tableNum(PurchReqTable))
{
//retrieve original document form WorkflowContext
req = PurchReqTable::find(_context.parmRecId());
ret = DateTimeUtil::newDateTime(req.RequiredDate,0);
ret = DateTimeUtil::addDays(ret, -1);
}
else
{
throw error(“Cannot use 1DAYBEFOREREQ with any document except PurchReqTable”);
}
}
return ret;
}
For this example we are not going to use user specific resolution, so the resolveNonUser and resolve methods will return the same values
public WorkflowDateTime resolveNonUser(WorkflowContext _context,
WorkflowCalendarToken _calendarToken,
WorkflowTimeSpanMinutes _timeSpanMinutes)
{
return this.resolve(_context, _calendarToken, _timeSpanMinutes, ”);
}
4. Create new and construct methods
protected void new()
{
}
public static MyCustomDueDateProvider construct()
{
return new MyCustomDueDateProvider();
}
5. Create a due Date provider in the AOT.
1. Navigate to Workflow -> Providers -> Due Date Calculation
2. Right click, click “new Due Date Calculation Provider”
3. Right click on your new provider and click properties.
4. Provide an appropriate name e.g. “MyCustomDueDateProvider”
5. Provide a relevant label. This will appear in your workflow configuration under “Calendar Name”
6. Depending on how you have coded your provider you may need to select an Association Type of company and AvailableForAllWorkflowTypes as “no” if you rely on company specific information or on record specific information.
7. Most importantly: Select the the class that you have created under “ProviderClass”
6. Perform CIL Compile and restart your client
7. Configure your workflow: Open your workflow configuration and navigate to the place where you would like to make use of your new functionality. E.G. Any Assignment’s “Time Limit” tab. You should now be able to select your provider under the “Calendar Name” option and select the resolution type under the “Calendar” option. Note our code didnt make use of the “_timespanInMinutes” parameter so the Duration option can be set to anything. We could have used this parameter to increase the flexibility on the “Before Requested Date” option if necessary.
I hope this assists someone sometime! Happy Daxing
Problem statement: It is quite frequent in workflow in Dynamics AX that one would like to notify users when certain approvals have occurred, tasks have been completed or when errors occur. This is pretty easy to accomplish out of the box with Dynamics AX by using the notifications on approvals, tasks or on the workflow as a whole. However the options are pretty limited and not very dynamic (especially in AX 2009) and up until AX2012 you have only really been allowed to assign to specific users (i.e. by user id). This means that it is very difficult to accomplish complex notifications such as notify the following people when a document has been approved: Document Creator, Project Manager for the document’s project and all users assigned to the “Accountants” security role in AX.
AX 2012 however has now allowed you the ability to make use of “Participant Providers” as an assignment option in notifications.
This means that you can create a Custom “notification” participant provider for your system that can resolve any number of personalised lists of users as above.
For example we created a particpant provider with a couple these lists. In our custom participant provider we returned a unique token per list e.g. “Originator, Project Manager, Requester and CEO” and “Originator, Project Manager, Financial Manager and CEO”.
In the resolve method of the participant provider we then retrieved the workflow document out of the workflow context object and returned the “Created by” user, looked up the project on the document and returned the associated Project manager and finally looked up the Financial Manager and CEO from a custom parameters table in AX and returned them as well.
The actual creation of a custom participant provider is beyond the scope of this article but you can find some more resources over here:
https://workflowax.wordpress.com/2009/10/30/participant-provider-example/
I hope this sparks some thought and is useful to some:
Inspired by: https://community.dynamics.com/ax/f/33/t/155436.aspx
Dynamics AX makes us the RefRecId, RefTable and RefCompany data pattern in a number of tables the system to provide flexible linking from a common/generic table such as WorkflowWorkitemTable to a variety of specific tables such as PurchReq or PurchTable.
Examples of this include Workflowtables, DocuRef, SpecTrans, etc…
From time to time you may want to identify which of the records in these tables have become “orphaned” i.e. the documents that they refer to no longer exist. To do this in a fairly generic way you can make use SysDictTable’s makeRecord functionality as below (Using DocuRef as an example)
static void Check_Orphans(Args _args)
{
SpecTrans specTrans;
DocuRef docuref;
counter i;
Common record;
SysDictTable table;
while select forupdate * from docuref// where SpecTrans.RefTableId == 865 && SpecTrans.RefCompany==’an’// 866 for Debtors
{
table = new SysDictTable(docuref.RefTableId);
changeCompany(docuref.RefCompanyId)
{
record = table.makeRecord();
select firstonly * from record where record.RecId == docuref.RefRecId;
if(!record.RecId)
{
info(strFmt(“Record %1 has been orphaned”, docuref.caption()));
//Delete if necessary over here…
i++;
}
}
}
info(strFmt(“%1 orphaned records found”,i));
}
I hope you find this a useful trick in your AX wanderings.
A question that has come across on a number of occassions on the Dynamics Community forum is how can one allow the creator of a document to select an approver to approve the document. We did do a variation on this request for a client a couple of years ago, so here is one way to do it.
Summary
1. Create a custom field to store the approver on the record you are workflowing
2. Allow the user to populate this field (either directly on the record’s form, or via a pop-up request) on submission.
3. Create a custom participant provider that can resolve the user selected in #2
4. Modify your configuration to use this participant provider.
Details
For this example I will make use of the PurchReqTable and its workflows
1. Create Custom Approver field
2. Allow the user to populate this field
Option A – Allow modification directly on the form:
Option B:
3. Create a custom participant provider to resolve the ChosenApprover
4. Modify your configuration to use this participant provider.
All done! Test and enjoy!
With the various ways in AX2012 that you can allow permissions to objects it can sometimes be very difficult to diagnose why your role is not working as required. There are a number of very useful tools to use to assist in finding the problem, including the security development tool from Microsoft.
In this post however I will describe how to analyse a specific problem in a security role using the AOT.
Example: We have created a new Role that should allow users to have read only access to a number of forms including the Users form in the System Administration Module. A number of standard “Inquiry” duties were added to the role as well as a custom duty explicitly allowing view only access to the SysUserInfoDetail form. On testing of the role the user still had access to edit the users. To resolve the issue we followed the following procedure.
I hope this will assist you in debugging your custom security roles.