Тізім көріністерінде мәндермен бірге реттелетін белгішелерді көрсету

Мақала
03/14/2023

Power Apps ортасының әкімшілері және реттеушілері JavaScript арқылы көрініске графиканы қоса және баған мәнінің негізінде графиканы таңдау үшін пайдаланылатын логиканы орната алады. Мүмкіндік белгішелерді мәтінмен немесе сандық мәндермен бірге көрсететін тізім көріністерін реттеу мүмкіндігін береді.

Бұл мысалда Dynamics 365 Sales сияқты кейбір бағдарламаларда қолжетімді мүмкіндік кестесінің көрінісіндегі теңшелетін белгішелер көрсетіледі. Теңшелетін белгішелерді басқа стандартты кестелермен, мысалы, тіркелгімен немесе контакт кестесімен, сондай-ақ реттелетін кестелермен көріністерде көрсете аласыз.

Тізім көріністеріндегі реттелетін белгішелер бірыңғай интерфейс, бұрыннан бар веб-клиент, мобильді бағдарлама және App for Outlook бағдарламасында көрсетілуі мүмкін.

Ескерім

Қолданба мобильді офлайн режимінде болғанда, пайдаланушы белгішелер қолжетімді емес.

Теңшелетін графиканы және JavaScript кодын веб-ресурстар ретінде қосу

Теңшеу үшін қажетті жаңа графика файлдарын жасаңыз. Белгішенің 16x16 пиксел өлшемін пайдаланған жөн (үлкендеу кескіндер кішірейтіледі).
Мәндерге көрсетілетін белгішелерді орнататын бір немесе бірнеше JavaScript функциясын жазыңыз (әдетте теңшеу қажет әрбір баған үшін бір функция қажет болады). Әрбір функция бастапқы деректер нысанын және енгізу ретінде тіл (LCID) кодын қабылдап, құрамында кескін атауы және кеңес мәтіні бар массивті қайтаруы керек. Функцияның мысалын осы тақырыптың кейінірек бөлігінде қараңыз: JavaScript функциясының үлгісі.
Ортаға әкімші ретінде кіріп, шешім жетектеушісін ашыңыз.
Әдепкі шешім қалқымалы терезесі ашылады. Осында Құрамдастар > Веб-ресурстар тармағына өтіңіз.
Енді теңшелетін графиканы бір бірден веб-ресурстар ретінде жүктеп салыңыз. Жаңа веб-ресурс жасау үшін құралдар тақтасында Жаңа түймешігін таңдаңыз. Ресурс жасау үшін басқа қалқымалы терезе ашылады. Келесі қадамдарды орындаңыз::
1. Жаңа ресурсқа түсінікті Атау беріңіз. Бұл JavaScript кодынан әрбір графикаға сілтеме жасау үшін пайдаланылатын атау болып табылады.
2. Түрі параметрін графика файлын сақтау үшін пайдаланылатын графика пішіміне (PNG, JPEG немесе GIF) орнатыңыз.
3. Файл браузері терезесін ашу үшін Файлды таңдау пәрменін таңдаңыз. Оны графика файлын тауып, таңдау үшін пайдаланыңыз.
4. Қажет болған кезде Көрсетілетін атау және/немесе Сипаттама параметрін қосыңыз.
5. Сақтау пәрменін таңдаңыз, содан кейін Веб-ресурс терезесін жабыңыз.
Алдыңғы қадамды бар әрбір графика файлына қайталаңыз.
Енді JavaScript функциясын соңғы веб-ресурс ретінде қосасыз. Жаңа веб-ресурс жасау үшін құралдар тақтасында Жаңа түймешігін таңдаңыз. Ресурс жасау үшін басқа қалқымалы терезе ашылады. Келесі әрекеттерді орындаңыз:
1. Жаңа ресурсқа түсінікті Атау беріңіз.
2. Түрі параметрін Сценарий (JScript) мәніне орнатыңыз.
3. Мәтін өңдегіш терезесін ашу үшін Мәтін өңдегіш (Түрі параметрінің жанында) параметрін таңдаңыз. Javascript кодын осында қойыңыз және оны сақтау үшін OK пәрменін таңдаңыз.
4. Қажет болған кезде Көрсетілетін атау және/немесе Сипаттама параметрін қосыңыз.
5. Сақтау пәрменін таңдаңыз, содан кейін Веб-ресурс терезесін жабыңыз.
Әдепкі шешім қалқымалы терезесі ашық болған кезде Құрамдастар > Кестелер тармағын кеңейтіңіз және теңшеу қажет кестені тауып алыңыз.
Кестені кеңейтіңіз және оның Көріністер белгішесін таңдаңыз.
Енді таңдалған кестенің көріністер тізімін көресіз. Тізімнен көріністі таңдаңыз. Құралдар тақтасындағы Басқа әрекеттер ашылмалы тізімін ашыңыз және Өңдеу пәрменін таңдаңыз.
Таңдалған көріністі өңдеуге арналған басқару элементтері бар қалқымалы терезе ашылады. Ол тармақ бөлігі болып табылатын әрбір бағанды көрсетеді. Мақсатты бағанды таңдаңыз, содан кейін Жалпы тапсырмалар жолағындағы Сипаттарды өзгерту пәрменін таңдаңыз. Баған сипаттарын өзгерту диалогтік терезесі ашылады; осында төмендегі параметрлерді жасаңыз:
- Веб-ресурс: Javascript функцияларын ұстау үшін жасалған веб-ресурс атауын көрсетіңіз (тізімнен таңдау үшін Шолу түймешігін басыңыз).
- Функция атауы: таңдалған баған мен көріністі өзгерту үшін жазылған функция атауын теріңіз.
Баған сипаттарын өзгерту диалогтік терезесін жабу үшін OK пәрменін таңдаңыз.
Көріністі сақтау үшін Сақтау және жабу пәрменін таңдаңыз.
Осы қадамдарды қажет болған кезде әрбір кесте, көрініс және баған үшін қайталаңыз.
Дайын болған кезде өзгерістерді жариялау үшін Барлық реттеулерді жариялау опциясын таңдаңыз. Содан кейін Әдепкі шешім терезесін жабыңыз.

JavaScript функциясының үлгісі

Теңшелетін белгішелерді және кеңестерді көрсетуге арналған JavaScript функциясы мына екі аргументті күтеді: layoutxml ішінде көрсетілген толық жол нысаны және шақыратын пайдаланушының тіл идентификаторы (LCID). LCID параметрі кеңес мәтінін бірнеше тілде көрсету мүмкіндігін береді. Орта қолдау көрсететін тілдер туралы қосымша ақпаратты Тілдерді қосу және Тіл бумаларын орнату немесе жаңарту бөлімдерінде қараңыз. Кодта пайдалануға болатын тіл идентификаторы (LCID) мәндерінің тізімін Microsoft белгілеген тіл идентификаторлары бетін қараңыз.

Теңшелетін белгішелердің алдын ала анықталған параметрлердің шектеулі жиыны бар төлсипаттың параметрлер жиыны түрі үшін қосылатынын ескере отыра, локализация қателерін болдырмау үшін белгінің орнына параметрлердің бүтін сан мәнін пайдаланыңыз.

Ескерту : Егер белгішені анықтау үшін деректерді алу қажет болса, Бірыңғай интерфейс логикалық шешімге ие JavaScript Promise нысанын қайтаруды қолдайды (таспа ережелеріне ұқсас). Синхронды XMLHttpRequest (XHR) функциясын пайдаланушы функциясында пайдаланбаңыз.

Мына код үлгісі opportunityratingcode (Бағалау) төлсипатындағы үш мәндердің біреуі (1: Ыстық, 2: Жылы, 3: Суық) негізінде белгішелер мен сөзкөмектерді көрсетеді. Код үлгісі әрі локализацияланған кеңес мәтінін көрсету әдісін көрсетеді. Осы үлгі жұмыс істеуі үшін 16x16 кескіндері бар атаулары келесідей үш кескін веб-ресурсын жасау керек: new_Hot, new_Warm және new_Cold.

Маңызды

Бұл үлгі Dynamics 365 Sales бағдарламасымен қолжетімді мүмкіндік кестесін қажет етеді.

function displayIconTooltip(rowData, userLCID) {      
    var str = JSON.parse(rowData);  
    var coldata = str.opportunityratingcode_Value;  
    var imgName = "";  
    var tooltip = "";  
    switch (parseInt(coldata,10)) { 
        case 1:  
            imgName = "new_Hot";  
            switch (userLCID) {  
                case 1036:  
                    tooltip = "French: Opportunity is Hot";  
                    break;  
                default:  
                    tooltip = "Opportunity is Hot";  
                    break;  
            }  
            break;  
        case 2:  
            imgName = "new_Warm";  
            switch (userLCID) {  
                case 1036:  
                    tooltip = "French: Opportunity is Warm";  
                    break;  
                default:  
                    tooltip = "Opportunity is Warm";  
                    break;  
            }  
            break;  
        case 3:  
            imgName = "new_Cold";  
            switch (userLCID) {  
                case 1036:  
                    tooltip = "French: Opportunity is Cold";  
                    break;  
                default:  
                    tooltip = "Opportunity is Cold";  
                    break;  
            }  
            break;  
        default:  
            imgName = "";  
            tooltip = "";  
            break;  
    }  
    var resultarray = [imgName, tooltip];  
    return resultarray;  
}

Реттелетін белгіше көрінісінің көрсетілу әрекеті

Негізгі бағандар

Торлар тізімі көрінісінде кестенің бастапқы бағанына қолданылатын теңшелетін белгішелер жүйенің әдепкі белгішесін ауыстырады.

Басқа бағандар

Торлар тізімі көрінісінде кестенің бастапқы бағанына жатпайтын бағанға қолданылатын теңшелетін белгішелер жүйенің әдепкі белгішесінен басқа қосымша белгіше ретінде көрінеді.

Кестенің бастапқы бағанының теңшелетін белгішесінің көрінісі емес.

Карта пішіндері

Көрініс карта пішінін пайдалану үшін конфигурацияланған кезде, реттелетін белгішелер жүйемен жасалған әдепкі белгішелерді ауыстырады.

Сондай-ақ, келесіні қараңыз

Модельге негізделген бағдарлама көріністерін түсіну

Ескерім

Сіз құжат тіліңіздің артықшылықтары туралы айта аласыз ба? Қысқа сауалнамаға қатысыңыз. (бұл сауалнама ағылшын тілінде екеніне назар аударыңыз)

Сауалнама шамамен жеті минут уақытыңызды алады. Жеке деректер жиналмайды (құпиялылық туралы мәлімдеме).

Бөлісу құралы: