web-apps/apps/spreadsheeteditor/main/resources/help/en/UsageInstructions/UseNamedRanges.htm
2021-04-30 17:41:43 +03:00

95 lines
10 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html>
<head>
<title>Use named ranges</title>
<meta charset="utf-8" />
<meta name="description" content="Use named ranges to simplify working with formulas" />
<link type="text/css" rel="stylesheet" href="../editor.css" />
<script type="text/javascript" src="../callback.js"></script>
<script type="text/javascript" src="../search/js/page-search.js"></script>
</head>
<body>
<div class="mainpart">
<div class="search-field">
<input id="search" class="searchBar" placeholder="Search" type="text" onkeypress="doSearch(event)">
</div>
<h1>Use named ranges</h1>
<p>Names are meaningful notations that can be assigned to a cell or cell range and used to simplify working with formulas in the <a href="https://www.onlyoffice.com/spreadsheet-editor.aspx" target="_blank" onclick="onhyperlinkclick(this)"><b>Spreadsheet Editor</b></a>. Creating a formula, you can insert a name as its argument instead of using a reference to a cell range. For example, if you assign the <em>Annual_Income</em> name to a cell range, it will be possible to enter <em>=SUM(Annual_Income)</em> instead of <em>=SUM(B1:B12)</em>. Thus, formulas become clearer. This feature can also be useful in case a lot of formulas are referred to one and the same cell range. If the range address is changed, you can make the correction once by using the Name Manager instead of editing all the formulas one by one.</p>
<p>There are two types of names that can be used:</p>
<ul>
<li><b>Defined name</b> an arbitrary name that you can specify for a certain cell range. Defined names also include the names created automatically when setting up <a href="SavePrintDownload.htm#printarea" onclick="onhyperlinkclick(this)">print areas</a>.</li>
<li><b>Table name</b> a default name that is automatically assigned to a <a href="FormattedTables.htm" onclick="onhyperlinkclick(this)">new formatted table</a> (<em>Table1</em>, <em>Table2</em> etc.). You can edit this name later.</li>
</ul>
<p>If you have created a <a href="Slicers.htm" onclick="onhyperlinkclick(this)">slicer for a formatted table</a>, an automatically assigned slicer name will also be displayed in the <b>Name Manager</b> (<em>Slicer_Column1</em>, <em>Slicer_Column2</em> etc. This name consists of the <em>Slicer_</em> part and the field name corresponding to the column header from the source data set). You can edit this name later.</p>
<p>Names are also classified by <b>Scope</b>, i.e. the location where a name is recognized. A name can be scoped to the whole workbook (it will be recognized for any worksheet within this workbook) or to a separate worksheet (it will be recognized for the specified worksheet only). Each name must be unique within a single scope, the same names can be used within different scopes.</p>
<h3>Create new names</h3>
<p>To create a new defined name for a selection:</p>
<ol>
<li>Select a cell or cell range you want to assign a name to.</li>
<li>Open a new name window in a suitable way:
<ul>
<li>Right-click the selection and choose the <b>Define Name</b> option from the contextual menu,</li>
<li>or click the <b>Named ranges</b> <img alt="Named ranges icon" src="../images/namedranges.png" /> icon on the <b>Home</b> tab of the top toolbar and select the <b>Define Name</b> option from the menu.</li>
<li>or click the <img alt="Named ranges icon" src="../images/namedrangesicon.png" /> <b>Named ranges</b> button on the <b>Formula</b> tab of the top toolbar and select the <b>Name manager</b> option from the menu. Choose option <b>New</b> in the opened window.</li>
</ul>
<p>The <b>New Name</b> window will open:</p>
<p><img alt="New Name window" src="../images/newnamewindow.png" /></p>
</li>
<li>Enter the necessary <b>Name</b> in the text entry field.
<p class="note"><b>Note</b>: a name cannot start with a number, contain spaces or punctuation marks. Underscores (_) are allowed. Case does not matter.</p>
</li>
<li>Specify the name <b>Scope</b>. The <em>Workbook</em> scope is selected by default, but you can specify an individual worksheet selecting it from the list.</li>
<li>Check the selected <b>Data Range</b> address. If necessary, you can change it. Click the <img alt="Source data range icon" src="../images/changerange.png" /> icon - the <b>Select Data Range</b> window will open.
<p><img alt="Select Data Range window" src="../images/selectdatarange.png" /></p>
<p>Change the link to the cell range in the entry field or select a new range on the worksheet with the mouse and click <b>OK</b>.</p>
</li>
<li>Click <b>OK</b> to save the new name.</li>
</ol>
<p>To quickly create a new name for the selected cell range, you can also enter the desired name into the name box located to the left of the the formula bar and press <b>Enter</b>. The name created in such a way is scoped to the <em>Workbook</em>.</p>
<p><img alt="Name Box" src="../images/namefield.png" /></p>
<h3>Manage names</h3>
<p>All the existing names can be accessed via the <b>Name Manager</b>. To open it:</p>
<ul>
<li>click the <b>Named ranges</b> <img alt="Named ranges icon" src="../images/namedranges.png" /> icon on the <b>Home</b> tab of the top toolbar and select the <b>Name manager</b> option from the menu,</li>
<li>or click the arrow in the name field and select the <b>Name Manager</b> option.</li>
</ul>
<p>The <b>Name Manager</b> window will open:</p>
<p><img alt="Name Manager window" src="../images/namemanagerwindow.png" /></p>
<p>For your convenience, you can filter the names selecting the name category you want to be displayed: <b>All</b>, <b>Defined names</b>, <b>Table names</b>, <b>Names Scoped to Sheet</b> or <b>Names Scoped to Workbook</b>. The names that belong to the selected category will be displayed in the list, the other names will be hidden.</p>
<p>To change the sort order for the displayed list, you can click on the <b>Named Ranges</b> or <b>Scope</b> titles in this window.</p>
<p><b>To edit a name</b>, select it in the list and click the <b>Edit</b> button. The <b>Edit Name</b> window will open:</p>
<p><img alt="Edit Name window" src="../images/editnamewindow.png" /></p>
<p>For a defined name, you can change the name and the data range it refers to. For a table name, you can change the name only. When all the necessary changes are made, click <b>OK</b> to apply them. To discard the changes, click <b>Cancel</b>. If the edited name is used in a formula, the formula will be automatically changed accordingly.</p>
<p><b>To delete a name</b>, select it in the list and click the <b>Delete</b> button.</p>
<p class="note"><b>Note</b>: if you delete the name that is used in a formula, the formula will no longer work (it will return the <em>#NAME?</em> error).</p>
<p>You can also create a new name in the <b>Name Manager</b> window by clicking the <b>New</b> button.</p>
<h3 id="usingnames">Use names when working with the spreadsheet</h3>
<p><b>To quickly navigate through cell ranges</b>, you can click the arrow in the name box and select the necessary name from the name list the data range that corresponds to this name will be selected in the worksheet.</p>
<p><img alt="Name list" src="../images/namelist.png" /></p>
<p class="note"><b>Note</b>: the name list displays the defined names and table names scoped to the current worksheet and to the whole workbook.</p>
<p><b>To add a name as an argument of a formula</b>:</p>
<ol>
<li>Place the insertion point where you need to add a name.</li>
<li>Make one of the following steps:
<ul>
<li>enter the name of the necessary named range manually using the keyboard. Once you type the initial letters, the <b>Formula Autocomplete</b> list will be displayed. As you type, the items (formulas and names) that match the entered characters are displayed in it. You can select the necessary <b>defined name</b> or <b>table name</b> from the list and insert it into the formula by double-clicking it or pressing the <b>Tab</b> key.</li>
<li>
or click the <b>Named ranges</b> <img alt="Named ranges icon" src="../images/namedranges.png" /> icon on the <b>Home</b> tab of the top toolbar, select the <b>Paste name</b> option from the menu, choose the necessary name from the <b>Paste Name</b> window and click <b>OK</b>:
<p><img alt="Paste Name window" src="../images/pastenamewindow.png" /></p>
</li>
</ul>
</li>
</ol>
<p class="note"><b>Note</b>: the <b>Paste Name</b> window displays the defined names and table names scoped to the current worksheet and to the whole workbook.</p>
<p id="internallink"><b>To use a name as an internal hyperlink</b>:</p>
<ol>
<li>Place the insertion point where you need to add a hyperlink.</li>
<li>Go to the <b>Insert</b> tab and click the <img alt="Hyperlink icon" src="../images/addhyperlink.png" /> <b>Hyperlink</b> button.</li>
<li>In the opened <b>Hyperlink Settings</b> window, select the <b>Internal Data Range</b> tab and choose a named range.
<p><img alt="Hyperlink Settings" src="../images/name_hyperlink.png" /></p>
</li>
<li>Click <b>OK</b>.</li>
</ol>
</div>
</body>
</html>