Files
help365/platform/extention-settings.html
2025-05-27 21:32:35 +04:00

202 lines
19 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 lang="en">
<head>
<title>Module settings</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="Module settings are global properties that can be used in server-side scripts written for widgets and business processes set up in modules. They also allow creating API..." />
<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><a href="360024498352.html">Modules</a> &gt; <a href="extentions.html">Custom modules</a> / Module settings</p>
</div>
</div>
<div class="topic__title"><h1 class="p_Heading1"><span class="f_Heading1">Module settings</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 class="p_Normal">Module settings are global properties that can be used in server-side scripts written for widgets and business processes set up in modules. They also allow creating API methods. For example, you may want to add a property that stores a token or an API key.</p>
<p class="p_Normal">You can access properties in scripts in the following way:</p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample" style="font-family: Consolas;">Namespace.params.data.&quot;property&nbsp;name&quot;</span></p>
<p class="p_Normal">To configure or edit a module<span style="font-family: Inter;">s</span> settings:</p>
<ol style="list-style-type:upper-roman">
<li value="1" class="p_Normal">Go to <span style="font-weight: bold;">Administration &gt; Modules</span>.</li><li value="2" class="p_Normal">Hover over the module and click on the gear icon that appears.<br />
<img alt="widget_module_settings" width="472" height="133" style="margin:0;width:472px;height:133px;border:none" src="widget_module_settings.png"/></li><li value="3" class="p_Normal">Go to the <span style="font-weight: bold;">Settings</span> tab.</li><li value="4" class="p_Normal">Click <span style="font-weight: bold;">+Add</span> and fill in the fields:</li></ol>
<p style="text-indent: 1px; line-height: 1.20;"><img alt="custom-extension-settings-3" width="582" height="604" style="margin:0;width:582px;height:604px;border:none" src="custom-extension-settings-3.png"/></p>
<ul style="list-style-type:disc">
<li class="p_Normal"><span style="font-weight: bold;">Display Name</span>. The name of the property that will be displayed on different forms of the module and in its settings.</li><li class="p_Normal"><span style="font-weight: bold;">Property Name</span>. The name of the property used when working with APIs and scripts.</li><li class="p_Normal"><span style="font-weight: bold;">Tip</span>. Additional information about the property.</li><li class="p_Normal"><span style="font-weight: bold;">Type</span>. The <a href="360009707032.html" class="topiclink">type</a> of the property, for example, <span style="font-weight: bold;">String</span>.</li><li class="p_Normal"><span style="font-weight: bold;">Search and sort by field</span>. If you select this option, the value of this field will be used as a <a href="360009669952.html" class="topiclink">search parameter</a>.</li><li class="p_Normal"><span style="font-weight: bold;">Full-text search</span>. If you select this option, the value will be used in full-text search.</li><li class="p_Normal"><span style="font-weight: bold;">Set a formula for the field</span>.<span style="font-weight: bold;"> </span>This option is available only for fields of the <span style="font-weight: bold;">String</span>, <span style="font-weight: bold;">Number</span>, and <span style="font-weight: bold;">Money</span> types. You can specify a formula by which the system will automatically calculate the value for this property. Read more in the <a href="360013448740.html" class="topiclink">Calculated fields</a> article.</li><li class="p_Normal"><span style="font-weight: bold;">Show only when a condition is met</span>. This option allows you to hide/show the property based on the conditions you set. Read more in the <a href="360013448740.html" class="topiclink">Calculated fields</a> article.</li></ul>
<ol style="list-style-type:upper-roman" start="5">
<li value="5" class="p_Normal">When you finish, click <span style="font-weight: bold;">Save</span>.</li></ol>
<p class="p_Normal"><a id="module-parameters" class="hmanchor"></a>By default, all settings that you create are added to the module connection page. The user will see them when they click on the module<span style="font-family: Inter;"></span>s name in the <span style="font-weight: bold;">Administration</span> workspace.</p>
<p class="p_Normal"><img alt="extension-settings-4" width="694" height="322" style="margin:0;width:694px;height:322px;border:none" src="extension-settings-4.png"/></p>
<h2 class="p_Heading2"><a id="settings" class="hmanchor"></a><span class="f_Heading2">Arrange the settings</span></h2>
<p class="p_Normal">You can rearrange how a module<span style="font-family: Inter;">s</span> settings are displayed. For example, hide some of the settings, add fields for checking tokens, or customize the page to immediately display the necessary data from an external service.</p>
<p class="p_Normal">To do this, click <span style="font-weight: bold;">Change Form</span> on the <span style="font-weight: bold;">Settings</span> tab of the module.</p>
<p class="p_Normal"><img alt="extention-settings-3" width="722" height="392" style="margin:0;width:722px;height:392px;border:none" src="extention-settings-3.png"/></p>
<p class="p_Normal">The <a href="interface_designer.html" class="topiclink">Interface designer</a> will open. Here you can set up a custom widget to display the settings in any way you want. When you go to the designer, the <span style="font-weight: bold;">Template</span> tab opens. In the center you can see the modeling canvas, and on the right you can find all the available widgets. The <span style="font-weight: bold;">Properties</span> tab contains the module<span style="font-family: Inter;">s</span> settings.</p>
<p class="p_Normal"><img alt="extention-settings-5" width="750" height="327" style="margin:0;width:750px;height:327px;border:none" src="extention-settings-5.png"/></p>
<p class="p_Normal">On the <span style="font-weight: bold;">Context</span> tab you can add properties that can be used in the widget<span style="font-family: Inter;"></span>s scripts. Read more about this in <a href="context_types.html" class="topiclink">Context types</a> and <a href="360009707032.html" class="topiclink">System data types</a>.</p>
<p class="p_Normal">On the <span style="font-weight: bold;">Scripts</span> tab, you can write scripts that determine the widget<span style="font-family: Inter;">s</span> behavior.</p>
<p class="p_Normal">When you finish setting up the widget, don<span style="font-family: Inter;"></span>t forget to publish it.</p>
<div class="bottom-nav">
<a id="prev-link" class="topic__navi_prev" href="create-extention.html">
<span class="bottom-nav__arrow bottom-nav__arrow--prev"></span> <span
class="bottom-nav__link">create-extention.html</span>
</a>
<a id="next-link" class="topic__navi_next" href="extention-widegets.html">
<span class="bottom-nav__link">extention-widegets.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>