3,311
edits
Changes
Jump to navigation
Jump to search
Line 1:
Line 1: − + Line 5:
Line 5: − + + + + + + + + + + + + − + + + + + + + + +
How to document your solutions (view source)
Revision as of 07:45, 16 November 2022
, 07:45, 16 November 2022no edit summary
This page gathers information about tips and tricks (tools) you can use when documenting your Power Platform solutions.
This page gathers information about what documentation is needed for your Power Platform solutions.
== General ==
== General ==
Examples of what documentation that is useful to have:
Examples of what documentation that is useful to have:
* Entity tionship RD ()
* Best Practice and naming conventions - Best to figure this out before you start with your project in order to establish a common way of working.
* Entity Relationship Diagram (ERD) visualizing the essential OOTB Tables that make up your solution as well as all custom tables and the relationships in between.
* Environments that are used and settings specific for each environment (that are not deployed through solutions, e.g. search settings or configuration data).
* ALM and deploy procedure - info about pipelines, the setup and who is responsible for deploys.
* Solution Components - Description of Tables, relationships in between, Business Rules, Business Process Flows (BPF), Cloud flows, Plugins etc.
* For Canvas Apps - Data Sources
* Integrations - What integrations there are, diagram illustrating integration flows, integration techniques, mappings.
* Functional description
If Azure DevOps is used, a Project Wiki can be used to store information about environments, settings and pipelines. If Microsoft Teams is used, a OneNote can be used as wiki.
== Tools ==
== Tools ==
* [https://www.xrmtoolbox.com/plugins/LinkeD365.ERDVisioBuilder/ Visio Builder on the XTB page]
There are some tools to be used as part of creating documentation for your solutions.
* [https://www.xrmtoolbox.com/plugins/LinkeD365.ERDVisioBuilder/ XTB - ERD Visio Builder]
* [https://www.xrmtoolbox.com/plugins/LinkeD365.FlowToVisio/ XTB - Flow to Visio]
* [https://www.xrmtoolbox.com/plugins/ExportSecurityRole/ XTB - Role Documenter]
* [https://www.xrmtoolbox.com/plugins/MsCrmTools.MetadataDocumentGenerator/ XTB - Metadata Document Generator]
* [https://www.xrmtoolbox.com/plugins/LinkeD365.BotToVisio/ XTB - PVA to Visio Builder] (In progress)
* [https://jonasr.app/uml/ XTB - UML Diagram Generator]
* [https://github.com/modery/PowerDocu Power Docu] to document Power Apps canvas apps and Power Automate flows