F&O Summit 2023 Speaker X++ Tips and Tricks.pptx

The Largest Independent Gathering
of the Microsoft User Ecosystem
Decrease Complexities,
Deliver Results.
@ 2023 Dynamic Communities
X++ Extreme: Boost
Your Development
Skills with Proven
Tips and Tricks

Deliver Results.
Nathan Clouse
Technical Architect
enVista Corp.
Microsoft Business Applications MVP (4x)
nclouse@envistacorp.com
www.atomicax.com
www.dynamics.fo
@NathanClouseAX

Deliver Results.
Peter Ramer
Director of Managed Application Services
RSM
Microsoft Business Applications MVP (2x)
www.dynamics365musings.com

Agenda
• Coding Tips
• D365FO.Tools
• Quality of Life Hacks
• Debugging
• Visual Studio Hidden

Deliver Results.
Coding Tips

Use Set Based Operations
• Update_recordset rather than while select w/ update
• RecordInsertList rather looped inserts
• RecordInsertList rather than insert_recordset
• Delete_from rather than while select update

Using FieldNum Ordinals
• Standard: CustTable.AccountNum
• Using Ordinals: CustTable.(fieldNum(CustTable,AccountNum))

Add Financial Dimension for OData
• Dynamics 365 > Addins > Add financial dimensions for OData

Comment Code
CTRL K, CTRL U

Uncomment Code
• CTRL K, CTRL U

Format Code
• CTRL K , D

Toggle Breakpoints
• F9

Go To (Main Thing)
• Hit F9 in design view to go to
the main thing for the item
selected
• F9 on a table extension will
take you to the base table
• F9 on a field will take you to
the EDT
• F9 on a field with a
relationship will take you to
the related table
• F9 on a field in a data
entity will open the
table/entity for that
field
• F9 on COC Extension
Class will take you to
the main class

Copy Event Handlers - Methods
• In design view, expand methods, right click, copy event handler

Copy Event Handler - Events
• In design view, expand events, right click, copy event handler

Sales order Totals
https://dynamics365musings.com/d365-sales-order-totals/

Extensible Controls
• https://www.youtube.com/watch?v=QrIjTN6Vey4&t=149s
• https://sangeethwiki.blogspot.com/2017/09/extensible-controls-i
n-dynamics-365-for.html
• Use Javascript and html to create your own D365 controls.

Paste Special
• Edit > Paste Special
• XML as Class
• JSON as Class

Paste Special
{"menu": {
"id": "file",
"value": "File",
"popup": {
"menuitem": [
{"value": "New", "onclick":
"CreateNewDoc()"},
{"value": "Open", "onclick":
"OpenDoc()"},
{"value": "Close", "onclick": "CloseDoc()"}
]
}
}}
public class Menu
{
public string id { get; set; }
public string value { get; set; }
public Popup popup { get; set; }
}
public class Popup
{
public Menuitem[] menuitem { get; set; }
}
public class Menuitem
{
public string value { get; set; }
public string onclick { get; set; }
}

If XML Option Missing…
• Add ASP.NET to VS

CrossCompany
static void JobDemoCrossCompany(Args _args)
{
BankAccountTable tabBAT; // saveDataPerCompany == true.
container conCompanies = [ 'cm1', 'cm2', 'dat' ];
str 4 sCompanyPrevious = " "; // Maximum length is 4 characters.
int iCountCompanies = 0;
;
while select
crossCompany
: conCompanies
* from tabBAT
order by dataAreaId
{
if ( sCompanyPrevious != tabBAT.dataAreaId )
{
info( tabBAT.dataAreaId + " = tabBAT.dataAreaId" );
iCountCompanies++;
if ( iCountCompanies >= 2 )
{
break;
}
sCompanyPrevious = tabBAT.dataAreaId;
}
}
return;
}

container conCompanies = [ 'cm1', 'cm2', 'dat' ];
str 4 sCompanyPrevious = " "; // Maximum length is 4 characters.
;
while select
crossCompany
: conCompanies
* from tabBAT
order by dataAreaId
{
…
}
return;
}
CrossCompany

static void JobDemoAllowCrossCompany(Args _args)
{
Query qry2;
QueryBuildDataSource qbds3;
QueryRun qrun4;
str sCompanyPrevious = " ";
int iTableNumBAT;
;
qry2 = new Query();
qry2.allowCrossCompany( true );
qry2.addCompanyRange( 'dat' );
qry2.addCompanyRange( 'twf' );
iTableNumBAT = tableNum( BankAccountTable );
qbds3 = qry2 .addDataSource( iTableNumBAT );
//qbds3.company( 'dat' );
qrun4 = new QueryRun( qry2 );
while ( qrun4.next() )
{
if ( qrun4.changed( iTableNumBAT ) )
{
tabBAT = qrun4.get( iTableNumBAT );
if ( sCompanyPrevious != tabBAT.dataAreaId )
{
print( tabBAT.dataAreaId + " = tabBAT.dataAreaId" );
iCountCompanies++;
if ( iCountCompanies >= 2 )
{
break;
}
sCompanyPrevious = tabBAT.dataAreaId;
}
}
}
pause;
return;
}
CrossCompany Queries

Query qry2;
QueryBuildDataSource qbds3;
QueryRun qrun4;
str sCompanyPrevious = " ";
int iTableNumBAT;
;
qry2 = new Query();
qry2.allowCrossCompany( true );
qry2.addCompanyRange( 'dat' );
qry2.addCompanyRange( 'twf' );
CrossCompany Queries

public static container download(container _parms)
{
RunAsPermission perm;
perm = new RunAsPermission("Admin");
perm.assert();
Container returncontainer = runAs("Admin",
classnum(AcxSharepointIntegeration), "get", _parms);
CodeAccessPermission::revertAssert();
return returncontainer;
}
RunAsPermission

str Mobile = "712,3456789";
if (strLen(strRem(Mobile, ",")) != strLen(strKeep(strRem(Mobile, ","),
"1234567890")))
{ throw error("Invalid Mobile Number"); }
else
{ info("Valid Mobile Number"); }
StrKeep

static void testZeroPadding(Args _args)
{
int i = 1;
str padded;
str finalResult;
;
// Create a string, with a length of 5, ending with the value of i and padded
with zeros
padded = strRFix(int2str(i), 5, "0");
finalResult = strFmt("ABC-%1", padded);
// 00001
}
StrRFix and StrLFix

• X++ is good but what it can’t do, C# can do
• Call an external web service
• Handle JSON/XML tedium
• FTP
Use C#

class AAX_AzureQueueTest
{
const str connectionString =
"Endpoint=sb://[urlName]servicebus.windows.net/;SharedAccessKeyName=[SharedAccessName];SharedAccessKey=[SharedAccessKey]=;EntityPath=[QueueName]";
public static void main(Args args)
{
AAX_AzureQueueLibrary.ReceiveAzureQueue ReceiveAzureQueue = new AAX_AzureQueueLibrary.ReceiveAzureQueue();
AAX_AzureQueueLibrary.SendAzureQueue SendAzureQueue = new AAX_AzureQueueLibrary.SendAzureQueue();
//x++ get a guid, not C#
str s = "Test Message " + WinAPIServer::createGUID();
SendAzureQueue.connect(connectionString);
SendAzureQueue.sendMessage(s);
SendAzureQueue.close();
info(strFmt("sent: %1", s));
s = "";
ReceiveAzureQueue.connect(connectionString);
s = ReceiveAzureQueue.readMessage();
ReceiveAzureQueue.completeMessage();
ReceiveAzureQueue.close();
info(strFmt("Received: %1", s));
}
}
Use C#

• Can’t locate an error that is being thrown? Add a breakpoint in
info.Add() (on switch (logLevel))
• Use funcName() to help with figuring problems out
• QueryBuildDataSource.toString() to see the SQL for a query
• Data Entities can be temperamental; DB Sync, delete entity (from
Data Entity Screen), rebuild list, test again
Other Stuff

Deliver Results.
D365FO.Tools

• PowerShell module to handle the different management tasks
during a Dynamics 365 Finance & Operations
• Install-Module -Name d365fo.tools
• Update-Module -name d365fo.tools
D365FO.Tools

• Stop-D365Environment -All
• Stop-D365Environment -Aos -Batch
• Stop-D365Environment -FinancialReporter -DMF
• Stop-D365Environment -All -Kill
Stop An Environment

• Start-D365Environment -ShowOriginalProgress
• Start-D365Environment -All
• Start-D365Environment -Aos -Batch
• Start-D365Environment -FinancialReporter -DMF
Start An Environment

• Restart-D365Environment -All -ShowOriginalProgress
Restart

• Set-D365Admin "claire@contoso.com"
(Re)Set D365FO Admin

• Invoke-D365LcsDatabaseExport -ProjectId 123456789 -
SourceEnvironmentId "958ae597-f089-4811-abbd-c1190917eaae" -
BackupName "BackupViaApi" -BearerToken "JldjfafLJdfjlfsalfd..." -
LcsApiUri "https://lcsapi.lcs.dynamics.com"
Export Database from Sandbox

• Invoke-D365LcsDatabaseRefresh -ProjectId 123456789 -
SourceEnvironmentId "958ae597-f089-4811-abbd-c1190917eaae" -
TargetEnvironmentId "13cc7700-c13b-4ea3-81cd-2d26fa72ec5e" -
BearerToken "JldjfafLJdfjlfsalfd..." -LcsApiUri
"https://lcsapi.lcs.dynamics.com"
Refresh Database (Prod To Sandbox)

• Invoke-D365DbSyncModule -Module "MyModel1"
• Invoke-D365DbSyncModule -Module "MyModel1","MyModel2"
• Get-D365Module -Name "MyModel*" | Invoke-D365DbSyncModule
Sync Database for Module(s)

• Invoke-D365DBSyncPartial -SyncList
"CustCustomerEntity","SalesTable"
• Invoke-D365DBSyncPartial -SyncList
"CustCustomerEntity","SalesTable" -Verbose
Partial DB Sync

• Invoke-D365DBSync
• Invoke-D365DBSync -Verbose
DB Sync

• Install-D365SupportingSoftware -Name vscode
• Install-D365SupportingSoftware -Name "vscode","fiddler"
• Install-D365SupportingSoftware -Name googlechrome
Install Supporting Software

• Get-D365Url
Getting Environment URL

• Get-D365AOTObject -Name *flush* -ObjectType AxClass -Path "C:AOSService
PackagesLocalDirectoryApplicationFoundation"
• Get-D365AOTObject -Name *flush* -ObjectType AxClass -IncludePath -Path "C:
AOSServicePackagesLocalDirectoryApplicationFoundation"
• Get-D365InstalledPackage -Name Application* | Get-D365AOTObject -Name
*flush* -ObjectType AxClass
• Get-D365AOTObject -Path "C:AOSServicePackagesLocalDirectory*" -Name
*flush* -ObjectType AxClass -SearchInPackages
Searching for an AOT Object

• Enable-D365MaintenanceMode -ShowOriginalProgress
• Disable-D365MaintenanceMode -ShowOriginalProgress
Maintenance Mode

• Invoke-D365InstallSqlPackage
• Import-D365Bacpac -ImportModeTier1 -BacpacFile "C:temp
uat.bacpac" -NewDatabaseName "ImportedDatabase_YYYYMMDD"
Import Database into Dev (T1)

• New-D365Bacpac -ExportModeTier1 -BackupDirectory c:Temp
backup -NewDatabaseName Testing1 -BacpacFile "C:TempBacpac
Testing1.bacpac"
Export Database from Dev (T1)

Deliver Results.
Quality Of Life

• https://learn.microsoft.com/en-us/dynamics365/fin-ops-core/fin-ops/
get-started/grid-capabilities
• Just copy and paste.
• Plus, lots of other features (Enabled in Feature Management)
Copy data from excel to D365 grid

• https://dynamics365musings.com/d365-table-browser/
• https://<environmentURL>/?
mi=SysTableBrowser&tablename=<tablename>
Table Browser

Run VS as Admin
• Start
• Search for Visual Studio 2019
• Right click > Open file location
• Find icon, right click > Properties > Advanced
• Check “Run As Administrator”

Run SSMS as Admin
• Nearly the same as for VS 2019

Run D365FO.Tools in VS
• Run PowerShell from VS
• Like D365FO.Tools

Plus Aliases
• Use notepad $profile

• Using NOLOCK when directly querying SQL can show uncommitted
records
• Useful when debugging
• I.e.:
SELECT *
FROM SalesTable WITH (nolock)
WHERE SalesId = ‘SO04381969’
AND DataAreaId = ‘USMF’
Querying in SQL w/ nolock

Deliver Results.
Debugging

Debugging Batch Jobs
• Attached to process
• Show all processes from all users
• Look for Batch.exe

Loading Symbols
• Tools > Options

Loading Symbols

Load all modules

Deliver Results.
Visual Studio
Hidden Gems

• Create code extension
Create code extension

• Update model parameters
Update Model Parameters

Order Labels in label file by ID

Build Options

Dark Mode Plus Custom Colors

Metadata Search
• Search on any option, value, metadata, whatever,
on an element
• type:"form" ccount
• type:"class"
extensionpoint:"eventhandlers,eventdelegates"

• type:"dataentityview"
property:"PublicCollectionName=CustomerStatisticsGroups"
• type:"dataentityview"
property:"PublicEntityName=CustomerStatisticsGroup"
Metadata Search

• Open Source
• https://github.com/TrudAX/TRUDUtilsD365
• Prototyping Tools that help with productivity
• Configurable
• Similar idea from AX 2009/2012 with configurable MorphX tools
TRUDUtilsD365

VS E: on Form Extensions

VS L: on Form Extensions

• http://www.atomicax.com/article/d365fotools-and-vs2017-manhattan-project
• https://docs.microsoft.com/en-us/dynamics365/fin-ops-core/dev-itpro/dev-ref/x
pp-business-run-time-functions
• https://docs.microsoft.com/en-us/dynamics365/fin-ops-core/dev-itpro/dev-ref/x
pp-string-run-time-functions
• https://jatomas.com/en/2020/05/02/dark-mode-visual-studio-x-code-editor/
• https://dynamics365musings.com/d365-sales-order-totals/
• https://www.youtube.com/watch?v=QrIjTN6Vey4&t=149s
• https://sangeethwiki.blogspot.com/2017/09/extensible-controls-in-dynamics-36
5-for.html
Resources

• https://ariste.info/en/2021/06/socratex-application-checker/
• https://github.com/TrudAX/TRUDUtilsD365
Resources

Deliver Results.
Questions?

• Nathan Clouse
• nclouse@envistacorp.com
• www.atomicax.com
• www.dynamics.fo
• @NathanClouseAX
• https://www.linkedin.com/in/nath
anclouseax/
Thanks!
• Peter Ramer
• www.dynamics365musings.com
• https://www.linkedin.com/in/peter-r
amer/
82

Deliver Results.
Thank you for
Attending!

F&O Summit 2023 Speaker X++ Tips and Tricks.pptx

More Related Content

Similar to F&O Summit 2023 Speaker X++ Tips and Tricks.pptx (20)

Recently uploaded (20)

F&O Summit 2023 Speaker X++ Tips and Tricks.pptx

Editor's Notes