{"id":1104,"date":"2018-10-26T09:05:41","date_gmt":"2018-10-26T08:05:41","guid":{"rendered":"http:\/\/frenchtouchdreamin.com\/?p=1104"},"modified":"2023-11-04T17:36:13","modified_gmt":"2023-11-04T16:36:13","slug":"elements-cloud-documentation-is-an-accelerator","status":"publish","type":"post","link":"https:\/\/frenchtouchdreamin.com\/index.php\/2018\/10\/26\/elements-cloud-documentation-is-an-accelerator\/","title":{"rendered":"Elements.cloud : Documentation is an Accelerator"},"content":{"rendered":"<p><img loading=\"lazy\" class=\"size-full wp-image-535 aligncenter\" src=\"http:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2017\/05\/Elements_CLOUD_RGB_FINAL-e1495272664784.png\" alt=\"Elements_CLOUD_RGB_FINAL\" width=\"170\" height=\"85\" \/><\/p>\n<p><b>\u201cDocumenting stuff takes time and stops me doing the important stuff.\u201d <\/b><\/p>\n<p><span style=\"font-weight: 400;\">You need to change that mindset. <\/span><\/p>\n<p><span style=\"font-weight: 400;\">\u201cSpend to Save. 2 steps back to take 3 forward. Paying forward.\u201d <\/span><\/p>\n<p><span style=\"font-weight: 400;\">Call it what you want, but deep down you know that you should be documenting what you are customizing as you are doing it. If your Salesforce implementation is strategic, then making changes without any documentation could be considered negligent.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">What is stopping you?<\/span><br \/>\n<img class=\"size-full wp-image-1105 alignright\" src=\"http:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element1.png\" alt=\"element1\" width=\"300\" srcset=\"https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element1.png 663w, https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element1-259x300.png 259w, https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element1-183x212.png 183w, https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element1-212x245.png 212w, https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element1-204x236.png 204w, https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element1-163x188.png 163w, https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element1-370x428.png 370w, https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element1-336x389.png 336w\" sizes=\"(max-width: 663px) 100vw, 663px\" \/><\/p>\n<ul>\n<li style=\"font-weight: 400;\"><b>We don\u2019t have the time; <\/b><span style=\"font-weight: 400;\">you know that doing it will save time in the long run. You need to plan time into the project.<\/span><\/li>\n<li style=\"font-weight: 400;\"><b>Consultants are doing it<\/b><span style=\"font-weight: 400;\">; you need to be clear in your SOW what you need them to do which support the Org long term<\/span><\/li>\n<li style=\"font-weight: 400;\"><b>Our developers are doing; <\/b><span style=\"font-weight: 400;\">just like the consultants you need documentation that works for the entire Org<\/span><\/li>\n<li style=\"font-weight: 400;\"><b>No systematic, sustainable approach; <\/b><span style=\"font-weight: 400;\">this is the key issue <\/span><\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<p><span style=\"font-weight: 400;\">The fundamental issue is there is no approach that ties the documentation back to the customizations that is EASY and SUSTAINABLE. Until now. \u00a0That is why we are writing a book, developing trailhead-style training and running<\/span><i><span style=\"font-weight: 400;\"> Chaos to Control<\/span><\/i><span style=\"font-weight: 400;\"> webinars. <\/span><\/p>\n<p>&nbsp;<\/p>\n<p><b>Why document?<\/b><\/p>\n<p><span style=\"font-weight: 400;\">What are the reasons that are forcing (encouraging) Admins to document their org? \u00a0Here are three:<\/span><\/p>\n<p>&nbsp;<\/p>\n<ul>\n<li><b><b>Migrating to Lightning<\/b><\/b><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Everyone wants to be on Lightning. The UI is engaging. All the new productivity enhancing features are in Lightning. And Salesforce\u2019s investments are in Lightning. \u00a0<\/span><\/p>\n<p><span style=\"font-weight: 400;\">The migration to Lightning gives you an opportunity to simplify and optimize your Org. With the new features you can rethink the operational processes and get the huge benefits you see other customers are talking about. You can eliminate page layouts by combining them using dynamic Lightning pages. Managed packages that were installed but then rarely used can be deleted, and work arounds found for those managed packages that are not yet Lightning ready. Finally, the Lightning Migration Readiness report has probably identified that there are customizations that need to be changed to make Lightning work. <\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span style=\"font-weight: 400;\">All this raises the ugly question. \u201cHow does our Org work?\u201d It is difficult to optimize and simplify if your view of the business processes and related customizations is hazy. The risk is that making changes them could have unforeseen results. The worst-case scenario is that the Org stops working.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">The Salesforce <\/span><i><span style=\"font-weight: 400;\">Rollout Lightning Experience to your company<\/span><\/i><span style=\"font-weight: 400;\"> ebook http:\/\/bit.ly\/2yWcSyG <\/span><\/p>\n<p><span style=\"font-weight: 400;\"> has some really valuable advice as you start to look at migration. Our approach dovetails with the Salesforce Lightning Experience Rollout planning methodology which is in the image below.<\/span><\/p>\n<p><img loading=\"lazy\" class=\"alignnone size-large wp-image-1106\" src=\"http:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element2-1024x412.png\" alt=\"element2\" width=\"1024\" height=\"412\" srcset=\"https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element2-1024x412.png 1024w, https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element2-300x121.png 300w, https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element2-768x309.png 768w, https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element2-212x85.png 212w, https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element2-400x161.png 400w, https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element2-355x143.png 355w, https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element2-306x123.png 306w, https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element2-642x259.png 642w, https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element2-966x389.png 966w, https:\/\/frenchtouchdreamin.com\/wp-content\/uploads\/2018\/10\/element2.png 1142w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<p><b>DISCOVER PHASE: <\/b><span style=\"font-weight: 400;\">You need a quick and efficient Discover Phase to kick off your migration project. The first 3 activities in the Discover phase are:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Revisit Your Processes<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Perform Gap Analysis<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Optimize your Implementation<\/span><\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<p><span style=\"font-weight: 400;\">Elements Catalyst was built to accelerate these steps. The process mapping capability is designed to engage end users and get shared agreement on processes in a way that Visio, PowerPoint or Lucidchart never could. The Org analysis eliminates man-months of tedious work combing through Setup to establish relationships and field usage. So you can perform the gap analysis faster and work out where to focus your optimization efforts.<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><b>ROLL-OUT PHASE: <\/b><span style=\"font-weight: 400;\">As you configure your Org for Lightning, document the changes you are making. Now. Not Later. There is no later.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Lightning Experience gives ultimate configurability. Lightning pages are now super sexy with dynamic components. In the pipeline, it\u2019s even more power to make those components dynamic based on more complex rules. Data from multiple objects can be dropped onto a single page using standard or 3rd party components. Page can be designed to support every use case so an Admin walking into another organization could look at their Salesforce Org and not even recognize it. This is why it is even more important to document why you have configured things as you have. Your Lightning migration project is the perfect time to start the documentation habit.<\/span><\/p>\n<p>&nbsp;<\/p>\n<ul>\n<li><b><b>Critical integrations to Salesforce being broken<\/b><\/b><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Salesforce is not an island. In most large organizations, particularly those where it has evolved into a strategic platform, Salesforce has integrations with other systems. But it is often not clear how those integrations work. They may use custom fields that hold temporary data, so at first glance, the fields don\u2019t seem to be used, have no data, are not on page layouts, reports or email templates. So, they can be deleted. Perhaps the integration relies on validation rules or process-builder to make sure the data is clean. Someone must have thought it through and written a spec. Figuring that out is often trial and error, or firefighting the results of the integration failing. This is a huge risk. How and why you built that integration is gold dust. As you try to understand how it works, capture the information as process diagrams, notes, whiteboard sketches and store them alongside all the customizations that are involved. That same bit of documentation may be linked to multiple customizations; object, fields, Apex trigger, validation rule\u2026 \u00a0<\/span><\/p>\n<p>&nbsp;<\/p>\n<ul>\n<li><b><b>Cannot continue development \u2013 maxed out fields<\/b><\/b><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">The ecosystem is rife with stories of Orgs with objects with fields maxed out (normally Account, Contact, Lead and Opportunity). The sad fact is that many of these additional fields are no longer used but were never deleted. Also, ISV\u2019s managed packages often add custom fields to the standard object in addition to all the custom objects that they install. Deleting fields is often the bulk of the clean-up activities. But of course, you daren\u2019t delete a field if you don\u2019t know where it is used. <\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span style=\"font-weight: 400;\">This bloating can reach a hiatus. Objects are maxed out, so no new fields can be added without upgrading the entire Org to the next edition level \u2013 a huge, unnecessary cost. And there are Ultimate Edition Orgs that have maxed out their fields so have nowhere to go. Yes, seriously.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">We heard of a client who had maxed out the fields on Task object. That is 500 custom fields! Pause for a moment to let that sink in.<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span style=\"font-weight: 400;\">Great documentation means that you can reuse and leverage all the work you have done, rather than creating all this duplication.<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><b>Fantastic. What do I do next?<\/b><\/p>\n<p><span style=\"font-weight: 400;\">You can run a 14-day trial of the Elements Catalyst app. Go to the AppExchange: bit.ly\/elementscatalyst <\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span style=\"font-weight: 400;\">The free ebook and Trailhead training will be available before FrenchTouch Dreamin\u2019. But you can register now to get sent a copy: https:\/\/elements.cloud\/chaos<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span style=\"font-weight: 400;\">Visit the Elements.cloud stand at FrenchTouch Dreamin\u2019 to find out how you can clean-up, document and build your Org using the Elements Catalyst app.<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u201cDocumenting stuff takes time and stops me doing the important stuff.\u201d You need to change that mindset. \u201cSpend to Save. 2 steps back to take 3 forward. Paying forward.\u201d Call it what you want, but deep down you know that you should be documenting what you are customizing as you are doing it. If your [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":1987,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[37],"tags":[],"_links":{"self":[{"href":"https:\/\/frenchtouchdreamin.com\/index.php\/wp-json\/wp\/v2\/posts\/1104"}],"collection":[{"href":"https:\/\/frenchtouchdreamin.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/frenchtouchdreamin.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/frenchtouchdreamin.com\/index.php\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/frenchtouchdreamin.com\/index.php\/wp-json\/wp\/v2\/comments?post=1104"}],"version-history":[{"count":2,"href":"https:\/\/frenchtouchdreamin.com\/index.php\/wp-json\/wp\/v2\/posts\/1104\/revisions"}],"predecessor-version":[{"id":1108,"href":"https:\/\/frenchtouchdreamin.com\/index.php\/wp-json\/wp\/v2\/posts\/1104\/revisions\/1108"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/frenchtouchdreamin.com\/index.php\/wp-json\/wp\/v2\/media\/1987"}],"wp:attachment":[{"href":"https:\/\/frenchtouchdreamin.com\/index.php\/wp-json\/wp\/v2\/media?parent=1104"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/frenchtouchdreamin.com\/index.php\/wp-json\/wp\/v2\/categories?post=1104"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/frenchtouchdreamin.com\/index.php\/wp-json\/wp\/v2\/tags?post=1104"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}