Skip to content

Commit

Permalink
Deployed 29a983d with MkDocs version: 1.5.3
Browse files Browse the repository at this point in the history
  • Loading branch information
Unknown committed Nov 4, 2024
1 parent 0534c8b commit ee10109
Show file tree
Hide file tree
Showing 38 changed files with 795 additions and 759 deletions.
15 changes: 12 additions & 3 deletions col-refs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -347,8 +347,8 @@
</a>
</li>
<li class="wm-toc-li">
<a class="wm-article-link wm-page-toc-text" href="#creating-a-two-way-reference">
Creating a two-way Reference
<a class="wm-article-link wm-page-toc-text" href="#two-way-references">
Two-way References
</a>
</li>
<li class="wm-toc-li">
Expand Down Expand Up @@ -1174,12 +1174,21 @@ <h2 id="adding-values-to-a-reference-column">Adding values to a Reference column
<code>+</code> value in the dropdown list. Grist will automatically add a new record containing this value to
the underlying table and insert the proper reference:</p>
<p class="screenshot-half"><em><img alt="Add reference value" src="../images/column-ref-add-value.png" /></em></p>
<h2 id="creating-a-two-way-reference">Creating a two-way Reference<a class="headerlink" href="#creating-a-two-way-reference" title="Permanent link">#</a></h2>
<h2 id="two-way-references">Two-way References<a class="headerlink" href="#two-way-references" title="Permanent link">#</a></h2>
<p>By default, new reference columns are added to a table as one-way references. This means they exist only as a single column within that specific table. Grist also allows you to configure a reference column with two-way references. This creates a new column in the referenced (or target) table, meaning that references between the two will be shown in both tables and remain synchronized.</p>
<p>For example, we can make the existing reference column, <strong>Client</strong>, a two-way reference. Under the &lsquo;Column&rsquo; tab of the Creator Panel, select &lsquo;Add two-way reference&rsquo;.</p>
<p><em><img alt="two-way-ref" src="../images/columns/two-way-ref.png" /></em></p>
<p>This creates a new reference column in the referenced table, <em>Clients</em>. Since there can be multiple projects for a single client, the automatically-created <strong>Projects</strong> column is a <a href="../col-types/#reference-list-columns">Reference List</a>. When part of a two-way reference, updates made in one column will be reflected in the other.</p>
<p><em><img alt="two-way-ref-2" src="../images/columns/two-way-ref-2.png" /></em></p>
<p>Two-way references will respect if a column is a Reference or Reference List. For example, the <strong>Client</strong> column in the <em>Projects</em> table is a Reference column, meaning only one <strong>Client</strong> can be assigned to each project.</p>
<p>The <strong>Project</strong> &ldquo;Newsletter template&rdquo; is already assigned to the <strong>Client</strong> &ldquo;Prime Builders International&rdquo;. What happens if we try to assign this project to &ldquo;ABC Construction Company&rdquo;?</p>
<p><em><img alt="two-way-error-1" src="../images/columns/two-way-error-1.png" /></em></p>
<p>A pop-up will appear that tells us the record is already assigned. If needed, you can reassign the record to the new <strong>Client</strong> by checking the box.</p>
<p class="screenshot-half"><em><img alt="two-way-error-2" src="../images/columns/two-way-error-2.png" /></em></p>
<p>To delete a two-way reference, select the reference column you wish to keep. Then in the Creator Panel, click the trash icon next to &lsquo;Two-Way Reference&rsquo;. This will delete the reference column in the target table. For example, when the <strong>Client</strong> column in the <em>Projects</em> table is selected, clicking the trash icon will delete the <strong>Projects</strong> column in the target table, <em>Clients</em>.</p>
<p><em><img alt="two-way-delete" src="../images/columns/two-way-delete.png" /></em></p>
<p>Alternatively, you can delete a two-way reference by selecting the column then by either selecting &lsquo;Delete column&rsquo; from the column menu or using the <code class="keys"><em>Alt</em> + <em>Minus</em></code> keyboard shortcut.</p>
<p>Please note that two-way references cannot be used on <a href="../formulas/">Formula</a> columns.</p>
<h2 id="converting-text-column-to-reference">Converting Text column to Reference<a class="headerlink" href="#converting-text-column-to-reference" title="Permanent link">#</a></h2>
<p>When working with existing data, it&rsquo;s common to have existing text values that should really be
reference values. Don&rsquo;t worry, conversion is simple! Just change the column type to &lsquo;Reference&rsquo; and
Expand Down
Binary file added fr/images/columns/two-way-delete.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added fr/images/columns/two-way-error-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added fr/images/columns/two-way-error-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion fr/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -1091,5 +1091,5 @@ <h2 id="contactez-nous">Contactez-nous<a class="headerlink" href="#contactez-nou
</html>
<!--
MkDocs version : 1.5.3
Build Date UTC : 2024-10-31 20:27:43.015658+00:00
Build Date UTC : 2024-11-04 16:52:37.902937+00:00
-->
Loading

0 comments on commit ee10109

Please sign in to comment.