{"id":9540,"date":"2021-07-08T17:32:35","date_gmt":"2021-07-08T21:32:35","guid":{"rendered":"http:\/\/beersmith.com\/blog\/?p=9540"},"modified":"2022-08-14T12:47:16","modified_gmt":"2022-08-14T16:47:16","slug":"creating-custom-reports-in-beersmith-desktop","status":"publish","type":"post","link":"https:\/\/beersmith.com\/blog\/2021\/07\/08\/creating-custom-reports-in-beersmith-desktop\/","title":{"rendered":"Creating Custom Reports in BeerSmith Desktop"},"content":{"rendered":"<div style=\"float: right; margin-left: 10px;\"><a href=\"https:\/\/twitter.com\/share\" class=\"twitter-share-button\" data-via=\"beersmith\" data-count=\"vertical\" data-url=\"https:\/\/beersmith.com\/blog\/2021\/07\/08\/creating-custom-reports-in-beersmith-desktop\/\">Tweet<\/a><\/div>\n<figure class=\"wp-block-image alignright size-large is-resized\"><a href=\"https:\/\/beersmith.com\/blog\/wp-content\/uploads\/2021\/07\/reports.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/beersmith.com\/blog\/wp-content\/uploads\/2021\/07\/reports.png\" alt=\"\" class=\"wp-image-9544\" width=\"387\" height=\"248\" srcset=\"https:\/\/beersmith.com\/blog\/wp-content\/uploads\/2021\/07\/reports.png 864w, https:\/\/beersmith.com\/blog\/wp-content\/uploads\/2021\/07\/reports-300x192.png 300w, https:\/\/beersmith.com\/blog\/wp-content\/uploads\/2021\/07\/reports-768x492.png 768w\" sizes=\"auto, (max-width: 387px) 100vw, 387px\" \/><\/a><\/figure> <p>This week I take a look at how you can create custom reports in the BeerSmith desktop program. This feature is currently only available on the desktop version of BeerSmith. The process described below applies to BeerSmith 3. BeerSmith 2 had a slightly different setup where you need to copy your template to the Documents\/Reports directory before adding it.<\/p> <h3 class=\"wp-block-heading\">Custom Reports in BeerSmith<\/h3> <p>BeerSmith desktop uses a simple HTML format or plain text format for all of its generated recipe reports. Many users want to customize their reports to display additional information, add new instructions on brew day or display custom batch data. You can do this by starting with one of the default reports.<\/p> <p>You can download the most popular default reports from the links here to use as a template for your custom report. Note you can right click on the link and &#8220;save as&#8221; the report to a file for editing.<\/p> <ul class=\"wp-block-list\"><li><a rel=\"noreferrer noopener\" href=\"https:\/\/beersmithrecipes.com\/Reports\/NewRecipe.htm\" target=\"_blank\">NewRecipe.htm<\/a> &#8211; Current default recipe file<\/li><li><a rel=\"noreferrer noopener\" href=\"https:\/\/beersmithrecipes.com\/Reports\/NewBrewsheet.htm\" target=\"_blank\">NewBrewSheet.htm<\/a> &#8211; Current default brew sheet (brewing instructions) file<\/li><li><a rel=\"noreferrer noopener\" href=\"https:\/\/beersmithrecipes.com\/Reports\/Competition.htm\" target=\"_blank\">Competition.html<\/a> &#8211; Competition recipe file<\/li><li><a href=\"https:\/\/beersmithrecipes.com\/Reports\/recipetxt.txt\" target=\"_blank\" rel=\"noreferrer noopener\">recipetxt.txt<\/a> &#8211; Current default text format recipe file<\/li><li><a href=\"https:\/\/beersmithrecipes.com\/Reports\/ExtractBrewsheet.htm\" target=\"_blank\" rel=\"noreferrer noopener\">ExtractBrewsheet.htm<\/a> &#8211; Current default brew sheet (brewing instructions) file<\/li><li><a href=\"https:\/\/beersmithrecipes.com\/Reports\/MeadBrewsheet.htm\" target=\"_blank\" rel=\"noreferrer noopener\">MeadBrewsheet.htm<\/a> &#8211; Current default brew sheet (brewing instructions) file<\/li><li><a href=\"https:\/\/beersmithrecipes.com\/Reports\/CiderBrewSheet.htm\" target=\"_blank\" rel=\"noreferrer noopener\">CiderBrewSheet.htm<\/a> &#8211; Current default brew sheet (brewing instructions) file<\/li><\/ul> <h3 class=\"wp-block-heading\">Editing the HTML Files and Using Tags<\/h3> <p>To edit the HTM files I recommend using a simple text editor or a simple HTML editor. I don&#8217;t recommend using complex programs like Microsoft Word as they introduce a lot of HTML styling that can cause problems when you post your edited file back to BeerSmith. Even something as simple as TextEdit on the Mac or Notepad on the PC will let you view this file.<\/p> <p>When editing the file I do recommend storing it under a different name such as &#8220;MyRecipe.htm&#8221; so you can differentiate it. You can have multiple custom reports for different purposes and some users have even created reports to print beer labels and other interesting artwork.<\/p> <p>If we look at the top of the NewRecipe.html file in a simple text editor we see there is a bunch of text along with various tags. The tags all begin with a &#8216;$&#8217; character and are in upper case such as $NAME. Here&#8217;s a sample below from the recipe file &#8211; $TYPE is the recipe type (All Grain, Extract, Partial Mash, Cider, etc&#8230;), $DISPLAY_BATCH_SIZE is the batch size with units, etc&#8230;<\/p> <pre class=\"wp-block-code\"><code>Type: $TYPE\nBatch Size: $DISPLAY_BATCH_SIZE\nBoil Size: $DISPLAY_BOIL_SIZE\nBoil Time: $BOIL_TIME min\nEnd of Boil Vol: $POST_BOIL_VOLUME<\/code><\/pre> <p>Many of these tags are from the BeerXML standard, but there are also over 100 custom tags you can include for just about any conceivable recipe field to display whatever you like in your report. When the report is displayed these tags are replaced with the real data.<\/p> <p>How do you find the tags? Well we have a complete list <a href=\"http:\/\/www.beersmith.com\/forum\/index.php?topic=1465.0\" target=\"_blank\" rel=\"noreferrer noopener\">here on the <\/a><a href=\"https:\/\/beersmith.com\/forum\/index.php?threads\/beersmith-xml-tags-updated.1465\/\">forum <\/a><a href=\"http:\/\/www.beersmith.com\/forum\/index.php?topic=1465.0\" target=\"_blank\" rel=\"noreferrer noopener\">of tags you can use in your reports<\/a>. You can also use HTML and CSS within the file to style various elements if you are familiar with those constructs. For example adding &lt;B&gt;&#8230;&lt;\/B&gt; around an element will make it bold.<\/p> <h3 class=\"wp-block-heading\">Using Your Custom Report with BeerSmith<\/h3> <p>Lets say you have finished editing your custom report file and want to try it in BeerSmith. To add it go to <strong>Options-&gt;Reports<\/strong> (or <strong>BeerSmith-&gt;Preferences <\/strong>on the Mac) within BeerSmith. From there click on the the <strong>Add Report<\/strong> button and give your report a name. Next select the type (usually HTML) and finally click on the <strong>Import Template File<\/strong> to import your template file that you just created in the steps above.<\/p> <p>Once you have completed that press <strong>Ok <\/strong>twice to save your changes, and go back to <strong>My Recipes<\/strong> view in the program. On the bottom half of My Recipes view you have the preview pane that shows a preview of the currently selected recipe. Select any recipe and then go to the drop down <strong>Report<\/strong> which is on the bar between the list of recipes and the preview window. Your newly named report should be in the list &#8211; select it now.<\/p> <p>The program will now display your named custom report in the preview pane. You can scale it, print it or save a copy of the report from that same menu bar (splitting the preview pane and recipe list).<\/p> <p>If you need to make changes to your template, edit the template first, and then go back to <strong>Options-&gt;Reports<\/strong> and select the custom report and then click on <strong>Edit<\/strong>. From here you can rename it or import your template again to get the latest version imported into the system.<\/p> <p>I hope you enjoyed this week\u2019s article from the <a href=\"https:\/\/beersmith.com\/blog\">BeerSmith Home Brewing Blog<\/a>. Please <a href=\"https:\/\/beersmith.com\/blog\/subscribe\">subscribe<\/a> for regular weekly delivery, and don\u2019t hesitate to leave a comment or send this article to a friend.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Tweet This week I take a look at how you can create custom reports in the BeerSmith desktop program. This [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":9544,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_uag_custom_page_level_css":"","site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[3,6],"tags":[826,825,21,1390,1387,35,1388,1389],"class_list":["post-9540","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-beersmith-software","category-homebrewing","tag-beer","tag-homebrewing","tag-beersmith","tag-brewsheet","tag-custom","tag-recipe","tag-reports","tag-tags"],"spectra_custom_meta":{"_edit_lock":["1660495636:2"],"_edit_last":["2"],"_thumbnail_id":["9544"],"thesis_title":["Creating Custom Reports in BeerSmith Desktop"],"thesis_description":["This week I take a look at how you can create custom reports in the BeerSmith desktop program. "],"rp4wp_auto_linked":["1"],"_uag_css_file_name":["uag-css-9540.css"],"_uag_page_assets":["a:9:{s:3:\"css\";s:263:\".uag-blocks-common-selector{z-index:var(--z-index-desktop) !important}@media (max-width: 976px){.uag-blocks-common-selector{z-index:var(--z-index-tablet) !important}}@media (max-width: 767px){.uag-blocks-common-selector{z-index:var(--z-index-mobile) !important}}\n\";s:2:\"js\";s:0:\"\";s:18:\"current_block_list\";a:5:{i:0;s:10:\"core\/image\";i:1;s:14:\"core\/paragraph\";i:2;s:12:\"core\/heading\";i:3;s:9:\"core\/list\";i:4;s:9:\"core\/code\";}s:8:\"uag_flag\";b:0;s:11:\"uag_version\";s:10:\"1778375024\";s:6:\"gfonts\";a:0:{}s:10:\"gfonts_url\";s:0:\"\";s:12:\"gfonts_files\";a:0:{}s:14:\"uag_faq_layout\";b:0;}"]},"uagb_featured_image_src":{"full":["https:\/\/beersmith.com\/blog\/wp-content\/uploads\/2021\/07\/reports.png",864,554,false],"thumbnail":["https:\/\/beersmith.com\/blog\/wp-content\/uploads\/2021\/07\/reports-150x150.png",150,150,true],"medium":["https:\/\/beersmith.com\/blog\/wp-content\/uploads\/2021\/07\/reports-300x192.png",300,192,true],"medium_large":["https:\/\/beersmith.com\/blog\/wp-content\/uploads\/2021\/07\/reports-768x492.png",768,492,true],"large":["https:\/\/beersmith.com\/blog\/wp-content\/uploads\/2021\/07\/reports.png",864,554,false],"1536x1536":["https:\/\/beersmith.com\/blog\/wp-content\/uploads\/2021\/07\/reports.png",864,554,false],"2048x2048":["https:\/\/beersmith.com\/blog\/wp-content\/uploads\/2021\/07\/reports.png",864,554,false]},"uagb_author_info":{"display_name":"Brad Smith","author_link":"https:\/\/beersmith.com\/blog\/author\/beersmith\/"},"uagb_comment_info":0,"uagb_excerpt":"Tweet This week I take a look at how you can create custom reports in the BeerSmith desktop program. This [&hellip;]","_links":{"self":[{"href":"https:\/\/beersmith.com\/blog\/wp-json\/wp\/v2\/posts\/9540","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/beersmith.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/beersmith.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/beersmith.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/beersmith.com\/blog\/wp-json\/wp\/v2\/comments?post=9540"}],"version-history":[{"count":11,"href":"https:\/\/beersmith.com\/blog\/wp-json\/wp\/v2\/posts\/9540\/revisions"}],"predecessor-version":[{"id":10478,"href":"https:\/\/beersmith.com\/blog\/wp-json\/wp\/v2\/posts\/9540\/revisions\/10478"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/beersmith.com\/blog\/wp-json\/wp\/v2\/media\/9544"}],"wp:attachment":[{"href":"https:\/\/beersmith.com\/blog\/wp-json\/wp\/v2\/media?parent=9540"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/beersmith.com\/blog\/wp-json\/wp\/v2\/categories?post=9540"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/beersmith.com\/blog\/wp-json\/wp\/v2\/tags?post=9540"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}