github
/
nocodb
mirror of https://github.com/nocodb/nocodb
1
0
Fork 0
Code Issues Releases Wiki Activity
多维表格
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
17198 Commits
155 Branches
278 Tags
1.3 GiB
Tree: 0d6b881558
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '0d6b881558'
${ noResults }
nocodb/packages/noco-docs/dist/0.109.7/setup-and-usages/links/index.html

27 lines
29 KiB
Raw Normal View History Unescape

docs: build Signed-off-by: Raju Udava <86527202+dstala@users.noreply.github.com>
1 year ago
<!doctype html>
<html lang="en" dir="ltr" class="docs-wrapper docs-doc-page docs-version-0.109.7 plugin-docs plugin-id-default docs-doc-id-setup-and-usages/links">
<head>
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v2.4.1">
<title data-rh="true">Links | NocoDB</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://nocodb.com/img/docusaurus-social-card.jpg"><meta data-rh="true" name="twitter:image" content="https://nocodb.com/img/docusaurus-social-card.jpg"><meta data-rh="true" property="og:url" content="https://nocodb.com/0.109.7/setup-and-usages/links"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="0.109.7"><meta data-rh="true" name="docusaurus_tag" content="docs-default-0.109.7"><meta data-rh="true" name="docsearch:version" content="0.109.7"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-0.109.7"><meta data-rh="true" property="og:title" content="Links | NocoDB"><meta data-rh="true" name="description" content="Understanding Link Columns!"><meta data-rh="true" property="og:description" content="Understanding Link Columns!"><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://nocodb.com/0.109.7/setup-and-usages/links"><link data-rh="true" rel="alternate" href="https://nocodb.com/0.109.7/setup-and-usages/links" hreflang="en"><link data-rh="true" rel="alternate" href="https://nocodb.com/0.109.7/setup-and-usages/links" hreflang="x-default"><link rel="search" type="application/opensearchdescription+xml" title="NocoDB" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.ce2b6fcc.css">
<link rel="preload" href="/assets/js/runtime~main.430bde0d.js" as="script">
<link rel="preload" href="/assets/js/main.ba728574.js" as="script">
</head>
<body class="navigation-with-keyboard">
<script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){var t=null;try{t=new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}return t}()||function(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}();t(null!==e?e:"light")}()</script><div id="__docusaurus">
<div role="region" aria-label="Skip to main content"><a class="skipToContent_fXgn" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="navbar navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/"><div class="navbar__logo"><img src="/img/nocodb-full-color.png" alt="NocoDB" class="themedImage_ToTc themedImage--light_HNdA"><img src="/img/nocodb-full-color.png" alt="NocoDB" class="themedImage_ToTc themedImage--dark_i4oU"></div><b class="navbar__title text--truncate"></b></a></div><div class="navbar__items navbar__items--right"><div class="navbar__item dropdown dropdown--hoverable dropdown--right"><a aria-current="page" class="navbar__link active" aria-haspopup="true" aria-expanded="false" role="button" href="/0.109.7/">0.109.7 - Old UI</a><ul class="dropdown__menu"><li><a class="dropdown__link" href="/">Latest</a></li><li><a aria-current="page" class="dropdown__link dropdown__link--active" href="/0.109.7/setup-and-usages/links">0.109.7 - Old UI</a></li></ul></div><a href="https://github.com/nocodb/nocodb" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link header-github-link" aria-label="GitHub repository"></a><div class="toggle_vylO colorModeToggle_DEke"><button class="clean-btn toggleButton_gllP toggleButtonDisabled_aARS" type="button" disabled="" title="Switch between dark and light mode (currently light mode)" aria-label="Switch between dark and light mode (currently light mode)" aria-live="polite"><svg viewBox="0 0 24 24" width="24" height="24" class="lightToggleIcon_pyhR"><path fill="currentColor" d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" class="darkToggleIcon_wfgR"><path fill="currentColor" d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"></path></svg></button></div><div class="searchBox_ZlJk"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><svg width="20" height="20" class="DocSearch-Search-Icon" viewBox="0 0 20 20"><path d="M14.386 14.386l4.0877 4.0877-4.0877-4.0877c-2.9418 2.9419-7.7115 2.9419-10.6533 0-2.9419-2.9418-2.9419-7.7115 0-10.6533 2.9418-2.9419 7.7115-2.9419 10.6533 0 2.9419 2.9418 2.9419 7.7115 0 10.6533z" stroke="currentColor" fill="none" fill-rule="evenodd" stroke-linecap="round" stroke-linejoin="round"></path></svg><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSe
It is important to note that, earlier supported column type <strong>LinkToAnotherRecord</strong> for creating relations is considered deprecated. While the old datatype is still supported for backward compatibility, it is no longer possible to create new fields of that type.</p><p>The main distinction between these two column types lies in how the contents are displayed within the cell when links are established between two tables. With the <strong>LinkToAnotherRecord</strong> column type, the cell displays the <strong>Primary value</strong> of the related records. On the other hand, the <strong>Links</strong> column type only shows the <strong>count</strong> of related records.
The decision to switch over to new column type was made to ensure better performance and scalability of the application, more so when the records &amp; the number of records in the related table is large.</p><p>Child list to display the related records can be accessed by clicking on the link count displayed on the cell.
Except for the column type, the following procedures remain same as before </p><ul><li>Create, update &amp; delete a relationship column, </li><li>Link &amp; unlink a record, </li><li>Create a lookup and rollup columns </li></ul><p>Workflow details are captured below.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="adding-a-relationship">Adding a relationship<a href="#adding-a-relationship" class="hash-link" aria-label="Direct link to Adding a relationship" title="Direct link to Adding a relationship">​</a></h2><p><img loading="lazy" src="https://github.com/nocodb/nocodb/assets/86527202/b3762fc8-4bba-42ef-8415-41428840ee0e" alt="Screenshot 2023-06-27 at 11 03 20 AM" class="img_ev3q"></p><ol><li><p>Create column
Click on &#x27;+&#x27; button at end of column headers</p></li><li><p>Update column name
Input name in the text box provided</p></li><li><p>Select column type
Select Column type as &quot;Links&quot; from the drop-down menu</p></li><li><p>Choose relationship type</p></li></ol><ul><li>&#x27;Has Many&#x27; corresponds to the &#x27;One-to-many&#x27; relationships</li><li>&#x27;Many To Many&#x27; corresponds to the &#x27;Many-to-many&#x27; relationships</li></ul><ol start="5"><li><p>Select child table from drop down menu</p></li><li><p>Click on &#x27;Save&#x27;
A new column will get created in both the parent table &amp; child table</p></li></ol><h2 class="anchor anchorWithStickyNavbar_LWe7" id="linking-records">Linking records<a href="#linking-records" class="hash-link" aria-label="Direct link to Linking records" title="Direct link to Linking records">​</a></h2><h3 class="anchor anchorWithStickyNavbar_LWe7" id="1-open-link-record-tab">1. Open link record tab<a href="#1-open-link-record-tab" class="hash-link" aria-label="Direct link to 1. Open link record tab" title="Direct link to 1. Open link record tab">​</a></h3><p>Click on the &#x27;+&#x27; icon in corresponding row - cell
<img loading="lazy" src="https://github.com/nocodb/nocodb/assets/86527202/96a90a6d-544e-4e43-b6d1-fe1aef784257" alt="Screenshot 2023-06-27 at 11 06 52 AM" class="img_ev3q"></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="2-select-from-the-option-displayed">2. Select from the option displayed<a href="#2-select-from-the-option-displayed" class="hash-link" aria-label="Direct link to 2. Select from the option displayed" title="Direct link to 2. Select from the option displayed">​</a></h3><p>Use &#x27;Filter box&#x27; to narrow down on search items.<br>
<!-- -->You can opt to insert a new record as well, using &quot;+ New Record&quot; button.<br>
<!-- -->You can use <code>ALT + Click</code> to insert multiple options together. </p><p><img loading="lazy" src="https://github.com/nocodb/nocodb/assets/86527202/68246783-8d01-488b-8926-644fca8fa164" alt="Screenshot 2023-06-27 at 11 08 40 AM" class="img_ev3q"></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="3-column-display-for-has-many-relationship">3. Column display for &quot;Has Many&quot; relationship<a href="#3-column-display-for-has-many-relationship" class="hash-link" aria-label="Direct link to 3. Column display for &quot;Has Many&quot; relationship" title="Direct link to 3. Column display for &quot;Has Many&quot; relationship">​</a></h3><p>Country &#x27;has many&#x27; City</p><p><img loading="lazy" src="https://github.com/nocodb/nocodb/assets/86527202/b5bb62b7-37ad-480e-8bf2-d666b775b07a" alt="Screenshot 2023-06-27 at 11 11 50 AM" class="img_ev3q"></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="4-column-display-for-belongs-to-relationship-automatically-updated">4. Column display for &quot;Belongs to&quot; relationship <!-- -->[Automatically updated]<a href="#4-column-display-for-belongs-to-relationship-automatically-updated" class="hash-link" aria-label="Direct link to 4-column-display-for-belongs-to-relationship-automatically-updated" title="Direct link to 4-column-display-for-belongs-to-relationship-automatically-updated">​</a></h3><p>City &#x27;belongs to&#x27; Country.<br>
<!-- -->Note: Primary value is still used as cell display value for &quot;Belongs to&quot; as it can have only one associated record.</p><p><img loading="lazy" src="https://github.com/nocodb/nocodb/assets/86527202/54e9ee75-4af5-49f6-8cd9-275dc53a8915" alt="Screenshot 2023-06-27 at 11 12 27 AM" class="img_ev3q"></p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="unlinking-records">Unlinking records<a href="#unlinking-records" class="hash-link" aria-label="Direct link to Unlinking records" title="Direct link to Unlinking records">​</a></h2><ol><li>Click on link count to open Child modal</li><li>Click on Unlink icon against required item</li></ol><p><img loading="lazy" src="https://github.com/nocodb/nocodb/assets/86527202/dad3cbc7-289d-45a7-9c49-a72264ed36b1" alt="Screenshot 2023-06-27 at 11 22 00 AM" class="img_ev3q"></p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="link-label-reconfiguration">Link label reconfiguration<a href="#link-label-reconfiguration" class="hash-link" aria-label="Direct link to Link label reconfiguration" title="Direct link to Link label reconfiguration">​</a></h2><p>Use column edit menu for <strong>Links</strong> to reconfigure display label</p><p><img loading="lazy" src="https://github.com/nocodb/nocodb/assets/86527202/1aabdd8c-7102-4917-b0c0-b72e1187b0b7" alt="Screenshot 2023-06-27 at 11 16 19 AM" class="img_ev3q"></p></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/nocodb/nocodb/tree/develop/packages/noco-docs/docs/versioned_docs/version-0.109.7/030.setup-and-usages/220.links.md" target="_blank" rel="noreferrer noopener" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_vwxv"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/0.109.7/setup-and-usages/usage-information"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Usage Information</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/0.109.7/setup-and-usages/team-and-auth"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Team &amp; Auth</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#supported-relationship-types" class="table-of-contents__link toc-highlight">Supported relationship types:</a></li><li><a href="#adding-a-relationship" class="table-of-contents__link toc-highlight">Adding a relationship</a></li><li><a href="#linking-records" class="table-of-contents__link toc-highlight">Linking records</a><ul><li><a href="#1-open-link-record-tab" class="table-of-contents__link toc-highlight">1. Open link record tab</a></li><li><a href="#2-select-from-the-option-displayed" class="table-of-contents__link toc-highlight">2. Select from the option displayed</a></li><li><a href="#3-column-display-for-has-many-relationship" class="table-of-contents__link toc-highlight">3. Column display for &quot;Has Many&quot; relationship</a></li><li><a href="#4-column-display-for-belongs-to-relationship-automatically-updated" class="table-of-contents__link toc-highlight">4. Column display for &quot;Belongs to&quot; relationship Automatically updated</a></li></ul></li><li><a href="#unlinking-records" class="table-of-contents__link toc-highlight">Unlinking records</a></li><li><a href="#link-label-reconfiguration" class="table-of-contents__link toc-highlight">Link label reconfiguration</a></li></ul></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container contain
<script src="/assets/js/runtime~main.430bde0d.js"></script>
<script src="/assets/js/main.ba728574.js"></script>
</body>
</html>