{"title":"Create budget template in Report Designer","url":"https://docs.vismasoftware.no/onestopreporting/budgeting/budget/create-budget-template-in-report-designer/","link":"/onestopreporting/budgeting/budget/create-budget-template-in-report-designer/","description":"Define storage rules and reference data to ensure correct budget storage.","content":"\u003cp\u003eSee \u003ca href=\"./../../../reporting/reports/report-designer/\"\u003eReport Designer\u003c/a\u003e  for an overview of the user interface and basic functionality in \u003cstrong\u003eReport Designer\u003c/strong\u003e.\u003c/p\u003e\n\u003cp\u003eA budget template is created in a similar manner as a report. However, a budget template also includes storage rules that define how the budget data are stored in the OneStop Reporting budget table. It is important that you know how to use the Report Designer before you start creating a budget template.\u003c/p\u003e\n\u003cp\u003eIn this section, we will discuss how you can add measure and storage rules to create a budget template. The storage rules are defined at the cell level.\u003c/p\u003e\n\u003cp\u003eIn the following example, we have already defined the data that will be displayed in the budget template, such as accounts and periods.\u003c/p\u003e\n\u003ch2 id=\"add-measure-or-calculated-storage-cell-to-the-template\" class=\"group\"\u003eAdd measure or calculated storage cell to the template\u003ca class=\"prose-heading-self-link\" href=\"#add-measure-or-calculated-storage-cell-to-the-template\" aria-label=\"Heading self-link\"\u003e\u003c/a\u003e\n\u003c/h2\u003e\n\u003cp\u003eDrag the desired measure from the OSR budgeting Dataset, such as \u003cstrong\u003eBudget Amount\u003c/strong\u003e, into the form. The Budget Amount will be the input cell where the end user will enter their Budget numbers in the finished executed and prepared Budget template. Locate the Budget Amount in the Module bar and drag it into cell F12, as shown in the figure below. You define the storage rule on this level.\u003c/p\u003e\n\u003cp\u003e\u003cimg src=\"/onestopreporting/budgeting/budget/create-budget-template-in-report-designer/img/en/word-image-4674-1.png\"\u003e\u003c/p\u003e\n\u003cp\u003eIf you have a calculated value that you want to store to the budget table;\u003c/p\u003e\n\u003col\u003e\n\u003cli\u003eClick in the cell where the calculation is.\u003c/li\u003e\n\u003cli\u003eOn the \u003cstrong\u003eBudgeting\u003c/strong\u003e tab, click \u003cstrong\u003eCreate storage\u003c/strong\u003e.\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp\u003e\u003cimg src=\"/onestopreporting/budgeting/budget/create-budget-template-in-report-designer/img/en/word-image-4674-2.png\"\u003e\u003c/p\u003e\n\u003ch3 id=\"budgeting-tab-mapping-dimensions-for-storage\" class=\"group\"\u003eBudgeting tab \u0026ndash; Mapping Dimensions for storage\u003ca class=\"prose-heading-self-link\" href=\"#budgeting-tab-mapping-dimensions-for-storage\" aria-label=\"Heading self-link\"\u003e\u003c/a\u003e\n\u003c/h3\u003e\n\u003cp\u003eAfter the \u003cstrong\u003eBudget Amount\u003c/strong\u003e measure is dragged into the cell, or you have manually created a storage cell, you can see that a new tab appears in the \u003cstrong\u003eLayout Editor\u003c/strong\u003e. This is the \u003cstrong\u003eBudgeting\u003c/strong\u003e tab and it will appear when a cell contains a value, it is allowed to store back to the database.\u003c/p\u003e\n\u003cp\u003eThe \u003cstrong\u003eBudgeting\u003c/strong\u003e tab contains information about which dimensions a transaction will be stored back to.\u003c/p\u003e\n\u003cp\u003eThere are three main sections in this tab you need to pay attention to. They are:\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003e\u003cstrong\u003eStore To section\u003c/strong\u003e. In this section, you will enter the Dataset and measure you will store back to. Normally this will be the same measure you dragged into the cell.\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003eMandatory fields\u003c/strong\u003e. These are the fields that make up the key for selecting which dimensions that will be part of the selection for insert/update/delete a value.\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003eOptional fields\u003c/strong\u003e. These are the fields that will get a value from the form, but they are not part of the key to select transactions for insert/update/delete.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eThe figure below illustrates the definition of storage of the value in a specific cell in the budget template:\u003c/p\u003e\n\u003cp\u003e\u003cimg src=\"/onestopreporting/budgeting/budget/create-budget-template-in-report-designer/img/en/word-image-4674-3.png\"\u003e\u003c/p\u003e\n\u003cp\u003eThe data input cell will automatically get a set of default fields that will define the value in the database. The fields are inherited from the context of the cell.\u003c/p\u003e\n\u003cp\u003eIn this example, the dimensions, \u003cem\u003eOSR Scenario\u003c/em\u003e, \u003cem\u003eAccount\u003c/em\u003e, \u003cem\u003ePeriod\u003c/em\u003e, and \u003cem\u003eRegion\u003c/em\u003e define the context of this particular cell. The stored value will get the current expanded values of these dimensions when the end users work with the budget template in the portal.\u003c/p\u003e\n\u003cp\u003eThe Budgeting store-back allows storage of both user-input cells and calculated cells. This is a strong feature as you may want to make allocations and store values to other accounts based on input values entered by the user.\u003c/p\u003e\n\u003ch3 id=\"budgeting-tab-comparable-data\" class=\"group\"\u003eBudgeting tab \u0026ndash; Comparable data\u003ca class=\"prose-heading-self-link\" href=\"#budgeting-tab-comparable-data\" aria-label=\"Heading self-link\"\u003e\u003c/a\u003e\n\u003c/h3\u003e\n\u003cp\u003eThe \u003cstrong\u003eBudgeting\u003c/strong\u003e tab has two sub dialogs. They are the \u003cstrong\u003eDefine storage\u003c/strong\u003e and the \u003cstrong\u003eComparable Data\u003c/strong\u003e dialogs. You can toggle between them by clicking the two arrows in the right bottom part of the \u003cstrong\u003eBudgeting\u003c/strong\u003e tab. The first picture shows the label when in the \u003cem\u003eDefine storage\u003c/em\u003e mode.\u003c/p\u003e\n\u003ch2 id=\"\" class=\"group\"\u003e\u003cimg src=\"/onestopreporting/budgeting/budget/create-budget-template-in-report-designer/img/en/word-image-4674-4.png\"\u003e\u003ca class=\"prose-heading-self-link\" href=\"#\" aria-label=\"Heading self-link\"\u003e\u003c/a\u003e\n\u003c/h2\u003e\n\u003cp\u003eWhen the \u003cstrong\u003eBudgeting\u003c/strong\u003e tab is in the \u003cem\u003eComparable data\u003c/em\u003e mode, it will look like this:\u003c/p\u003e\n\u003ch2 id=\"\" class=\"group\"\u003e\u003cimg src=\"/onestopreporting/budgeting/budget/create-budget-template-in-report-designer/img/en/word-image-4674-5.png\"\u003e\u003ca class=\"prose-heading-self-link\" href=\"#\" aria-label=\"Heading self-link\"\u003e\u003c/a\u003e\n\u003c/h2\u003e\n\u003cp\u003eSee the following sections for detailed descriptions of the two different modes.\u003c/p\u003e\n\u003ch2 id=\"define-storage\" class=\"group\"\u003eDefine storage\u003ca class=\"prose-heading-self-link\" href=\"#define-storage\" aria-label=\"Heading self-link\"\u003e\u003c/a\u003e\n\u003c/h2\u003e\n\u003cp\u003eBelow is a picture of the \u003cstrong\u003eBudgeting\u003c/strong\u003e tab and the different functions and elements in it. See table below for descriptions of the various elements.\u003c/p\u003e\n\u003cp\u003e\u003cimg src=\"/onestopreporting/budgeting/budget/create-budget-template-in-report-designer/img/en/word-image-4674-6.png\"\u003e\u003c/p\u003e\n\u003ctable\u003e\n  \u003cthead\u003e\n      \u003ctr\u003e\n          \u003cth\u003eV\u003c/th\u003e\n          \u003cth\u003eName\u003c/th\u003e\n          \u003cth\u003eDescription\u003c/th\u003e\n      \u003c/tr\u003e\n  \u003c/thead\u003e\n  \u003ctbody\u003e\n      \u003ctr\u003e\n          \u003ctd\u003e1.0\u003c/td\u003e\n          \u003ctd\u003eStore To\u003c/td\u003e\n          \u003ctd\u003eIn this section, you will select the Dataset and field you will store back to. Normally this will be the same field you dragged into the cell. NOTE: It is not only the selected field (in this case the Budget Amount field) that is affected by the choice you make in the Store to section. You actually select the total transaction row that will be affected by the choice you make in the Mandatory fields and Optional fields sections described below.\u003c/td\u003e\n      \u003c/tr\u003e\n      \u003ctr\u003e\n          \u003ctd\u003e2.0\u003c/td\u003e\n          \u003ctd\u003eMandatory fields\u003c/td\u003e\n          \u003ctd\u003eThe Mandatory fields are also referred to as Key fields. These are the fields that make up the key for selecting which dimensions will be part of the selection for insert/update/delete a row in the Dataset selected in the Store to section. This means that if it doesn\u0026rsquo;t already exist in a Dataset row with the combination of the values of the fields in this section in the form instance, a new row will be inserted in the Dataset. The value in the cell in the context of these fields get written to the field selected in the Store to section. If a row with the combination of these fields already exists, the value in the cell will overwrite the existing value in the row. Some fields are absolutely mandatory. They are defined as mandatory by the metadata model for that specific ERP integration. They are marked with a lock symbol to the right and cannot be removed from the Mandatory fields section. Other fields you choose to be part of the Mandatory field key can be deleted again. These are marked with a delete symbol (cross). Technically speaking, all fields in the Mandatory fields section will be part of the WHERE \u0026ndash; clause when the row to insert, update, or delete will be searched for. The fields in the Mandatory fields section will get the assigned values specified in the right side of the mapping view.\u003c/td\u003e\n      \u003c/tr\u003e\n      \u003ctr\u003e\n          \u003ctd\u003e3.0\u003c/td\u003e\n          \u003ctd\u003eOptional fields\u003c/td\u003e\n          \u003ctd\u003eThese fields will also get values from the form, but they are not part of the key to select transactions for insert/update/delete. These fields will not play a role when rows are searched for being candidates for an insert/update/delete operation in the Dataset table selected in the \u0026lsquo;Store to\u0026rsquo; section. Technically speaking, these fields will not be part of the WHERE clause when the row to insert/update/delete will be searched for. They will simply be inserted or updated when a row is found for the combination of the fields in the Mandatory fields section.\u003c/td\u003e\n      \u003c/tr\u003e\n      \u003ctr\u003e\n          \u003ctd\u003e4.0\u003c/td\u003e\n          \u003ctd\u003eData source reference options\u003c/td\u003e\n          \u003ctd\u003eDepending on the data type of the field and/or the placement in the Mandatory or Optional sections, the number and type of options may differ. Here is the complete list: Blank (empty) If you select the empty field, you will get a lookup option to help you select a value to assign to the field. This will be a constant value. \u0026lt;None\u0026gt; This option means that you will have to enter a constant numeric value to be assigned to the field. \u0026lsquo;\u0026lt;None\u0026gt;\u0026rsquo; This option means that you will have to enter a constant string value within the apostrophes to be assigned to the field. =\u0026lt;cell reference\u0026gt; This option allows you to specify that a value in a cell should be stored into the field it is associated with. When selected, the Excel cell-reference functionality for selecting a cell in the Excel workbook will appear. This functionality supports the dynamic cell reference technology used by Excel. *\u0026lt;cell reference\u0026gt; This option works the same way as the =\u0026lt;cell reference\u0026gt; option when it comes to how a cell reference value is selected and used. The difference is that this option will multiply the value of the cell to the value of the field. It can only be used with a field of a numeric data type. {\u0026lt;attribute\u0026gt;} There will be a list of attributes in braces. This list will be dynamic and depends on which attributes are already in the Excel form. In the example in the picture above the {Period}, {Account} and {Account Name} attributes are listed. All of them can be used for referencing values you can store back on the dimension that is selected. @\u0026lt;parameter\u0026gt; There will be a list of parameters in braces. This list will be dynamic and depends on which parameters are already in the budget form. The example in the picture above, the {@Period}, {@Scenario}, and {@Region} attributes are listed. All of them can be used for referencing values you can store back on the dimension that is selected.\u003c/td\u003e\n      \u003c/tr\u003e\n      \u003ctr\u003e\n          \u003ctd\u003e5.0\u003c/td\u003e\n          \u003ctd\u003eSettings\u003c/td\u003e\n          \u003ctd\u003eConditional storage settings. For more information, see the \u0026quot;Conditional storage settings section\u0026quot; below.\u003c/td\u003e\n      \u003c/tr\u003e\n  \u003c/tbody\u003e\n\u003c/table\u003e\n\u003ch3 id=\"conditional-storage-settings\" class=\"group\"\u003eConditional storage settings\u003ca class=\"prose-heading-self-link\" href=\"#conditional-storage-settings\" aria-label=\"Heading self-link\"\u003e\u003c/a\u003e\n\u003c/h3\u003e\n\u003cp\u003e\u003cimg src=\"/onestopreporting/budgeting/budget/create-budget-template-in-report-designer/img/en/word-image-4674-7.png\"\u003e\u003c/p\u003e\n\u003cp\u003e\u003cstrong\u003eStore unchanged cells:\u003c/strong\u003e This option will force data from this cell to always be stored. The application will not do a check whether the input cell has changed its value or not.\u003c/p\u003e\n\u003cp\u003e\u003cstrong\u003eIgnoring rows or columns:\u003c/strong\u003e\u003c/p\u003e\n\u003cp\u003e\u003cstrong\u003e\u003cimg src=\"/onestopreporting/budgeting/budget/create-budget-template-in-report-designer/img/en/word-image-4674-8.png\"\u003e\u003c/strong\u003e\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003e\u003cstrong\u003eUse ignore flag on row:\u003c/strong\u003e If the first cell in a row contains a value, the entry is ignored; hence not stored. False, 0, or empty string count as no value.\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003eUse ignore flag on column:\u003c/strong\u003e If the first cell in a column contains a value, the entry is ignored; hence not stored. False, 0, or empty string count as no value.\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003eUse ignore flag on row or column:\u003c/strong\u003e If the first cell in either the row or column contains a value, the entry is ignored; hence not stored. False, 0, or empty string count as no value.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003e\u003cstrong\u003eDelete transactions if cell value is 0:\u003c/strong\u003e Means that cells including 0, NULL, or empty are not stored. This is useful when you have larger budgets to avoid creating unnecessary records.\u003c/p\u003e\n\u003cp\u003e\u003cstrong\u003eDelete transactions for empty cells:\u003c/strong\u003e Normally, values in a cell are deleted after pressing BACKSPACE or DEL or blanking out the value. If this option is selected, the value is used to update existing/insert a record in the storage dimension. This will also apply to transactions where there has been a value that has now been set to 0.\u003c/p\u003e\n\u003ch3 id=\"validation-of-content\" class=\"group\"\u003eValidation of content\u003ca class=\"prose-heading-self-link\" href=\"#validation-of-content\" aria-label=\"Heading self-link\"\u003e\u003c/a\u003e\n\u003c/h3\u003e\n\u003cp\u003eThere is also a certain validation process going on as you configure your \u003cstrong\u003eDefine storage\u003c/strong\u003e dialog. When you have a valid set of mappings, the icon at the bottom left corner will be a green checkmark. If incomplete or the mapping was incorrectly done, you will get a red stop icon. In this case, the \u003cem\u003eRegion\u003c/em\u003e dimension field does not have a value or reference assigned:\u003c/p\u003e\n\u003cp\u003e\u003cimg src=\"/onestopreporting/budgeting/budget/create-budget-template-in-report-designer/img/en/word-image-4674-9.png\"\u003e\u003c/p\u003e\n\u003ch2 id=\"define-comparable-data\" class=\"group\"\u003eDefine Comparable data\u003ca class=\"prose-heading-self-link\" href=\"#define-comparable-data\" aria-label=\"Heading self-link\"\u003e\u003c/a\u003e\n\u003c/h2\u003e\n\u003cp\u003eThe \u003cstrong\u003eComparable data\u003c/strong\u003e functionality allows the budget template creator to set up comparison data for the users performing the budgeting in the portal when using the \u003cstrong\u003eSpreading and Line Item Detail\u003c/strong\u003e tool (see \u003ca href=\"./../report/edit-budget-data/add-line-item-details\"\u003eLine item details\u003c/a\u003e, \u003ca href=\"./../report/edit-budget-data/spreading\"\u003eSpread function\u003c/a\u003e and \u003ca href=\"./../report/edit-budget-data/adjusting\"\u003eAdjust function\u003c/a\u003e).\u003c/p\u003e\n\u003cp\u003eThere are two main options for defining the comparable data;\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003e\u003cstrong\u003eBased on historical data:\u003c/strong\u003e If you use this option, you will get data from your accounting system.\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003eBased on Excel range:\u003c/strong\u003e If you use this option, you must define the area in the Excel sheet you want to show when using comparable data in the \u003cstrong\u003eSpreading and Line Item Detail\u003c/strong\u003e tool.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003e\u003cimg src=\"/onestopreporting/budgeting/budget/create-budget-template-in-report-designer/img/en/word-image-4674-10.png\"\u003e\u003c/p\u003e\n\u003cp\u003e\u003cimg src=\"/onestopreporting/budgeting/budget/create-budget-template-in-report-designer/img/en/word-image-4674-11.png\"\u003e\u003c/p\u003e\n\u003cp\u003eWhen using the \u003cstrong\u003eBased on historical data\u003c/strong\u003e option, you must do the following:\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eDrag a Measure field, such as posted amount, into the top part of the window as shown in the example below.\u003c/li\u003e\n\u003cli\u003eEnter a title for the comparable data in the \u003cstrong\u003eTitle\u003c/strong\u003e\u003c/li\u003e\n\u003cli\u003eSelect or deselect the \u003cstrong\u003eInclude data from current fiscal year\u003c/strong\u003e checkbox: If you select this option, the current fiscal year and the previous year will be included (depending on the selected period parameter you run the budget for). If left blank, you will get the two previous years.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003e\u003cimg src=\"/onestopreporting/budgeting/budget/create-budget-template-in-report-designer/img/en/word-image-4674-12.png\"\u003e\u003c/p\u003e\n\n    \u003cdiv class=\"admonition admonition-note\" role=\"note\"\u003e\n    \u003cdiv class=\"admonition-title\"\u003e\n        \n        Note\n        \n    \u003c/div\u003e\n    \u003cdiv class=\"admonition-body\"\u003e\n        \u003cp\u003eIn the description above, only the period dimension is mentioned.\nOther dimensions that are used for selecting the Comparable data are inherited from the selections used in the template. If you want to override those selections, you can drag in dimensions from the module list and drop them in the section called \u003cem\u003eFilters override\u003c/em\u003e. This is an advanced feature and should be used with care.\u003c/p\u003e\n    \u003c/div\u003e\n    \u003c/div\u003e\n\n","children":[]}