Files
help365/platform/add-extended-context.html
koziavin 00717a92fb
All checks were successful
Deploy Static Site / deploy (push) Successful in 6m6s
update
2025-05-29 16:42:45 +04:00

219 lines
22 KiB
HTML
Raw Permalink 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 lang="en">
<head>
<title>Add fields to the extended context</title>
<meta name="generator" content="Help+Manual" />
<meta name="keywords" content="" />
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="After importing the solution, you can customize the locked app by adding new fields to its forms through context extension." />
<meta name="picture" content="" />
<meta property="og:type" content="website" />
<meta property="og:title" content="Full documentation for BRIX365 platform. Low-code developer guide. User guide. Admin guide. Developer guide." />
<meta property="og:url" content="https://brix365.com/en/help" />
<meta property="og:image" content="" />
<link rel="icon" href="favicon.png" type="image/png" />
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet" />
<link rel="stylesheet" href="./jquery-ui.min.css" />
<link rel="stylesheet" href="default.css" />
<link rel="stylesheet" href="./search-yandex.css" />
<link rel="stylesheet" href="./article.css" />
<link rel="stylesheet" href="./glossary.css" />
<link rel="stylesheet" href="./theme.css" />
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="helpman_settings.js"></script>
<script type="text/javascript" src="helpman_topicinit.js"></script>
<script type="text/javascript" src="highlight.js"></script>
<script type="text/javascript">
$(document).ready(function(){highlight();});
</script>
</head>
<body>
<script>!function(e,t,c,n,r,a,m){e.ym=e.ym||function(){(e.ym.a=e.ym.a||[]).push(arguments)},e.ym.l=1*new Date;for(var s=0;s<document.scripts.length;s++)if(document.scripts[s].src===n)return;a=t.createElement(c),m=t.getElementsByTagName(c)[0],a.async=1,a.src=n,m.parentNode.insertBefore(a,m)}(window,document,"script","https://mc.yandex.ru/metrika/tag.js"),ym(83179930,"init",{clickmap:!0,trackLinks:!0,accurateTrackBounce:!0,webvisor:!0})</script><noscript><div><img alt=""src=https://mc.yandex.ru/watch/83179930 style=position:absolute;left:-9999px></div></noscript>
<header class="header elma-365">
<div class="container">
<a class="header__logo" href="https://brix365.com/en/help">
<img src="./logo-en.svg" alt="header logo">
</a>
<!-- <div class="hero__search-form" id="search-panel">
<form class="search-form" onsubmit="ym(83180416,'reachGoal','poisk')">
<label class="search-form__label">
<span id="reset-search" class="search__icon"></span>
<input class="search-form__input" type="text">
</label>
<input class="search-form__submit" type="submit" value="Submit">
</form>
</div> -->
<div class="hero__search-form" id="search-panel"> <form class="search-form"> <label class="search-form__label"> <span id="reset-search" class="search__icon"></span> <input class="search-form__input" type="text"> </label> <input class="search-form__submit" type="submit" value="Submit"> </form> </div>
<div class="hero__search">
<a href="#" id="search-icon" class="hero__search-icon">
<img src="search-icon-white.svg" alt="search string">
</a>
<a href="#" id="side-menu-icon" class="hero__side-icon">
<img src="side_menu.svg" alt="side menu">
</a>
</div>
<div class="header__navi">
<ul class="header__list"><li><span class="solution-select"><span class="solution-select__selected"></span><svg width="7" height="4" viewBox="0 0 7 4" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M1 1L3.5 3.5L6 1" stroke="white" stroke-linecap="round" stroke-linejoin="round"/></svg><ul class="solution-select__list"><li><a class="project-link" href="https://brix365.com/en/help/platform/get-trial.html">Platform</a></li><li><a class="project-link" href="https://brix365.com/en/help/ecm/ecm-functions.html">ECM</a></li><li><a class="project-link" href="https://brix365.com/en/help/crm/crm_overview.html">CRM</a></li><li><a class="project-link" href="https://brix365.com/en/help/service/service-functions.html">Service</a></li><li><a class="project-link" href="https://brix365.com/en/help/projects/projects-functions.html">Projects</a></li><li><a class="project-link" href="https://brix365.com/en/help/business_solutions/-elma365-store.html">Business Solutions</a></li></ul></span></li><li><a href="https://api.brix365.com/en/" target="_blank">API</a></li><li><a href="https://tssdk.brix365.com/" target="_blank">SDK</a></li></ul>
</div>
</div>
</header>
<main class="main container">
<aside class="sidebar" id="sidebar">
<div class="sidebar__header">
<a class="header__logo" href="https://brix365.com/en/help">
<img src="./logo-light-en.svg">
</a>
<span class="sidebar__close elma-365-close" id="close"></span>
</div>
<div class="sidebar__wrapper" id="side-menu">
</div>
</aside>
<article class="article" id="article">
<div class="article-inner">
<div class="content">
<header class="article__header">
<div class="article__bread" style="display:flex; gap:10px;">
<span id="subcategory" class="search-res__item-category search-res__item-category_subcategory subcategory article__badge"></span>
<div class="topic__breadcrumbs">
<p>Low-code designer &gt; App builder &gt; <a href="extended-context.html">Context extension in apps</a> / Add fields to the extended context</p>
</div>
</div>
<div class="topic__title"><h1 class="p_Heading1"><span class="f_Heading1">Add fields to the extended context</span></h1>
</div>
</header>
<section class="article__content">
<div class="scroll-top-inner">
<a href="#h1-article" class="scroll-top"></a>
</div>
<!-- Placeholder for topic body. -->
<p style="text-align: justify; line-height: 1.20; margin: 7px 0 16px 0;">After importing the solution, you can customize the locked app by adding new fields to its forms through context extension.</p>
<p style="line-height: 1.28; margin: 0 0 11px 0;">The option is available if the developer <span style="color: #0000ff;"><a href="extended-context-settings.html" class="topiclink">allowed</a></span> to augment the app context when creating the solution.</p>
<ol style="list-style-type:upper-roman">
<li value="1" class="p_Normal">To add a field, click the <img alt="clip0189" width="20" height="22" style="margin:0;width:20px;height:22px;border:none" src="clip0189.png"/> icon next to the app name and select <span style="font-weight: bold;">Context Extension</span>.</li></ol>
<p class="p_Normal" style="text-indent: -2px; margin: 0 0 0 39px;"><img alt="ext_context2" width="455" height="370" style="margin:0;width:455px;height:370px;border:none" src="ext_context2.png"/></p>
<ol style="list-style-type:upper-roman">
<li value="2" class="p_Normal">In the opened window, on the <span style="font-weight: bold;">Context</span> tab, create properties. Note that the <code><b>_extended</b></code> suffix is automatically added to the name of the new property.<br />
You can create a property and perform other actions with it in the same way as on the <a href="360028941112.html#add_new_property" class="topiclink">Context tab</a> in the app form settings.</li></ol>
<p class="p_Normal" style="margin: 0 0 0 35px;"><img alt="ext_context3" width="999" height="306" style="margin:0;width:999px;height:306px;border:none" src="ext_context3.png"/></p>
<ol style="list-style-type:upper-roman">
<li value="3" class="p_Normal">Now place the properties on the app forms. To do this, move them to the <span style="font-weight: bold;">Create</span>, <span style="font-weight: bold;">View</span>, and <span style="font-weight: bold;">Edit</span> tabs. The extended context property will appear on the form in the location where the developer placed the <a href="extended-context-widget.html" class="topiclink">Extended context display</a> widget.</li></ol>
<p class="p_Normal" style="margin: 0 0 0 37px;"><img alt="ext_context4" width="685" height="462" style="margin:0;width:685px;height:462px;border:none" src="ext_context4.png"/></p>
<p class="p_Normal" style="margin: 0 0 0 35px;">If the developer of the solution has not placed the <span style="font-weight: bold;">Extended context display</span> widget on the form you selected, the added properties will not be displayed.</p>
<p class="p_Normal">Note that properties from the extended context are not available in the <a href="360028941112.html" class="topiclink">form settings</a> but are displayed in the general list of context variables when creating a script, business process, and widget.</p>
<h2 class="p_Heading2"><span class="f_Heading2">Create a widget with properties from the extended context</span></h2>
<p class="p_Normal">Properties from the extended context can be used to create a convenient user interface using widgets. Lets consider such an example.</p>
<p style="text-align: justify; line-height: 1.20; margin: 7px 0 16px 0;">The developer of the <span style="font-weight: bold;">Employee page app</span> has customized an extended context and added the <span style="font-weight: bold;">Extended context display </span>widget to the <span style="font-weight: bold;">Additional</span> tab of all app forms.</p>
<p class="p_Normal" style="text-indent: 1px;"><img alt="ext_context5" width="985" height="351" style="margin:0;width:985px;height:351px;border:none" src="ext_context5.png"/></p>
<p style="text-align: justify; line-height: 1.20; margin: 7px 0 16px 0;">We will import the solution with the <span style="font-weight: bold;">Employee page</span> app into our company.</p>
<p style="text-align: justify; line-height: 1.20; margin: 7px 0 16px 0;">Even though the app is locked, we can add new fields thanks to the <span style="font-weight: bold;">Context extension</span> setting. Lets add family information to the forms:</p>
<p class="p_Normal"><img alt="ext_context6" width="1080" height="333" style="margin:0;width:1080px;height:333px;border:none" src="ext_context6.png"/></p>
<p style="line-height: 1.20;"><span style="background-color: #ffffff;">The new fields are displayed on the app form on the&nbsp;</span><span style="font-weight: bold; background-color: #ffffff;">Additional</span><span style="background-color: #ffffff;">&nbsp;tab in a list:</span></p>
<p style="line-height: 1.20;"><img alt="ext_context7" width="659" height="424" style="margin:0;width:659px;height:424px;border:none" src="ext_context7.png"/></p>
<p style="line-height: 1.20;"><span style="background-color: #ffffff;">Lets customize the display of added fields on the form in two columns. To do this, lets create a widget:</span></p>
<ol style="list-style-type:upper-roman">
<li value="1" style="line-height: 1.20;"><span style="background-color: #ffffff;">In the&nbsp;</span><span style="font-weight: bold; background-color: #ffffff;">Context Extension</span><span style="background-color: #ffffff;">&nbsp;settings menu item, open the form tab where you want to place the widget, for example, the&nbsp;</span><span style="font-weight: bold; background-color: #ffffff;">Create</span><span style="background-color: #ffffff;">&nbsp;tab.</span></li><li value="2" style="line-height: 1.20;"><span style="background-color: #ffffff;">In the&nbsp;</span><span style="font-weight: bold; background-color: #ffffff;">Widget</span><span style="background-color: #ffffff;">&nbsp;field, click the&nbsp;</span><span style="font-weight: bold; background-color: #ffffff;">Default</span><span style="background-color: #ffffff;">&nbsp;link. The&nbsp;</span><span style="font-weight: bold; background-color: #ffffff;">Create widget</span><span style="background-color: #ffffff;">&nbsp;button will appear. Click it to proceed to create the widget.</span></li></ol>
<p style="line-height: 1.20; margin: 0 0 0 36px;"><img alt="ext_context8" width="746" height="449" style="margin:0;width:746px;height:449px;border:none" src="ext_context8.png"/></p>
<ol style="list-style-type:upper-roman">
<li value="3" style="line-height: 1.20;"><span style="background-color: #ffffff;">In the opened window, fill in the fields:</span></li></ol>
<p style="text-indent: 1px; line-height: 1.20; margin: 0 0 0 35px;"><img alt="ext_context9" width="735" height="418" style="margin:0;width:735px;height:418px;border:none" src="ext_context9.png"/></p>
<p style="line-height: 1.20; margin: 0 0 0 36px;"><span style="background-color: #ffffff;">Specify the name and code of the widget, add its description and icon. Please note, the &nbsp;</span><code><b>_extended</b></code><span style="background-color: #ffffff;">&nbsp;suffix will be automatically added to the widget code after its creation.&nbsp;</span></p>
<p style="line-height: 1.20; margin: 0 0 0 36px;"><span style="background-color: #ffffff;">Click&nbsp;</span><span style="font-weight: bold; background-color: #ffffff;">Save</span><span style="background-color: #ffffff;">. After that the widget template will open in the&nbsp;<a href="interface_designer.html" class="topiclink">interface designer</a>.</span></p>
<ol style="list-style-type:upper-roman" start="4">
<li value="4" style="line-height: 1.20;"><span style="background-color: #ffffff;">Drag the&nbsp;</span><span style="font-weight: bold; background-color: #ffffff;">Columns</span><span style="background-color: #ffffff;">&nbsp;widget and properties from the extended app context to the modeling field.</span></li></ol>
<p style="line-height: 1.20; margin: 0 0 0 36px;"><img alt="ext_context10" width="1236" height="517" style="margin:0;width:1236px;height:517px;border:none" src="ext_context10.png"/></p>
<p style="line-height: 1.20; margin: 0 0 0 35px;"><span style="background-color: #ffffff;">Read more about how to place the widget in&nbsp;<a href="360029250931.html#addingawidgettothetemplate" class="topiclink">Form templates</a>.</span></p>
<ol style="list-style-type:upper-roman" start="5">
<li value="5" style="line-height: 1.20;"><span style="background-color: #ffffff;">Save and publish the created widget. It will be displayed on the form in the location where the developer placed the&nbsp;</span><span style="font-weight: bold; background-color: #ffffff;">Extended context display</span><span style="background-color: #ffffff;">&nbsp;widget.</span></li></ol>
<p style="line-height: 1.20; margin: 0 0 0 35px;"><img alt="ext_context11" width="1088" height="462" style="margin:0;width:1088px;height:462px;border:none" src="ext_context11.png"/></p>
<p style="line-height: 1.20;"><span style="background-color: #ffffff;">You can use the created widget on other app forms, as well as customize its&nbsp;<a href="widget_functions.html" class="topiclink">system functions</a>.</span></p>
<div class="bottom-nav">
<a id="prev-link" class="topic__navi_prev" href="extended-context-settings.html">
<span class="bottom-nav__arrow bottom-nav__arrow--prev"></span> <span
class="bottom-nav__link">extended-context-settings.html</span>
</a>
<a id="next-link" class="topic__navi_next" href="duplicate-search.html">
<span class="bottom-nav__link">duplicate-search.html</span> <span
class="bottom-nav__arrow bottom-nav__arrow--next"></span>
</a>
</div>
<!-- добавляет на страницу строку блок Была ли статья полезной? -->
<div class="feedback" id="feedback"><div class="feedback-help"><span><b>Was this helpful?</b></span><form action="" method="POST" class="feedback-form" id="feedback-form"><div class="feedback__popup feedback__popup-response" id="feedback__popup_thx" style="display: none;">Thanks for your feedback!</div><div class="feedback__popup" id="feedback__popup_why" style="display: none;"><div class="feedback__popup-header">Please specify why:</div><input type="radio" name="category" id="bad_recommendation" value="bad_recommendation"><label for="bad_recommendation">Recommendations did not help me</label><input type="radio" name="category" id="difficult_text" value="difficult_text"><label for="difficult_text">Article is hard to understand</label><input type="radio" name="category" id="no_answer" value="no_answer"><label for="no_answer">Didn`t answer my question</label><input type="radio" name="category" id="bad_header" value="bad_header"><label for="bad_header">Content does not match the topic</label><input type="radio" name="category" id="other_reason" value="other_reason"><label for="other_reason">Other</label></div><div class="feedback__popup" id="feedback__popup-other" style="display: none;"><div class="feedback__popup-header">How we can improve it?</div><textarea class="feedback__textarea" name="other" id=""></textarea><input type="submit" class="feedback__other-btn" value="Submit"></div><div class="feedback-form__btn-group"><input type="radio" name="useful" id="feedback__useful_yes" value="true"><label for="feedback__useful_yes"><img src="like.svg" class="small-img" alt="like"><spanclass="feedback-form__btn-group_yes-btn">Yes</spanclass="feedback-form__btn-group_yes-btn"></label><input type="radio" name="useful" id="feedback__useful_no" value="false"><label for="feedback__useful_no"><img src="dislike.svg" class="small-img" alt="dislike"><spanclass="feedback-form__btn-group_no-btn">No</spanclass="feedback-form__btn-group_no-btn"></label></div><select name="category"><option disabled="">Please specify why</option><option value="bad_recommendation" selected="">Recommendations did not help me</option><option value="difficult_text">Article is hard to understand</option><option value="no_answer">Didn`t answer my question</option><option value="bad_header">Content does not match the topic</option><option value="other_reason">Other</option></select><input type="submit"></form></div><div class="found_typo"><p style="margin: 0px; margin-top: 16px !important;"><span><b>Found a typo?</b></span> Select it and press <i>Ctrl+Enter</i> to send us feedback</p></div></div>
</section>
</div>
<aside class="article__sidebar" style="display:none">
<input type="checkbox" />
<div class="article__arrow"></div>
<div class="table-of-contents elma365-right" id="toc2Content">
<h3 class="h3-toc">In this topic</h3>
<nav id="toc2"></nav>
</div>
</aside>
</div>
</article>
</main>
<footer class="footer">
<div class="footer-container">
<div class="footer-mobile">
<ul class="footer-mobile__list"><li><a href="https://brix365.com/en/" target="_blank">BRIX</a></li><li><a href="https://tssdk.brix365.com/en/latest/" target="_blank">SDK</a></li><li><a href="https://api.brix365.com/en/" target="_blank">API</a></li></ul><ul class="footer-mobile__list"><li><a href="https://brix365.com/en/help/platform/get-trial.html">Platform</a></li><li><a href="https://brix365.com/en/help/ecm/ecm-functions.html">ECM</a></li><li><a href="https://brix365.com/en/help/service/service-functions.html">Service</a></li><li><a href="https://brix365.com/en/help/projects/projects-functions.html">Projects</a></li></ul>
</div>
<div class="footer-wrap">
<div><span class="mobile-question-popup">Send feedback</span><form method="POST" action class="question__popup question-xs" id="question__popup"><div class="question-wrap"><span class="close"></span><span class="title">Ask a question</span><label for="help_question" style="display: none;"></label><textarea name="help_question" id="help_question"></textarea><input type="submit" value="Send"></div></form><div class="hidden fade-in question-success-xs">Sent</div></div>
<div class="footer-flex-b">
<span class="footer-copy">&copy; 2025 BRIX</span>
<ul class="footer-list">
<li class="footer-item">
<a href="#" class="arrow-top" style="display: block;"></a>
</li>
</ul>
</div>
</div>
</div>
</footer>
<iframe name="hmnavigation" style="display:none!important"></iframe>
<script src="./jquery-ui.js"></script>
<!--script src="//cdn.jsdelivr.net/npm/featherlight@1.7.14/release/featherlight.min.js" type="text/javascript" charset="utf-8"></script-->
<script src="./jquery.tocify.min.js"></script>
<script src="./TypoReporter.min.js"></script>
<script src="./google-search.js"></script>
<script src="./main.js"></script>
</body>
</html>