התאמה אישית של כותרות העמודות ברשת התחזית

ניתן להתאים אישית את כותרות העמודות ברשת התחזית באמצעות רכיבי קוד של Power Apps. לדוגמה, אפשר לתרגם את שם העמודה או להוסיף הסבר קצר להקשר נוסף.

כיצד להתאים אישית את הכותרת

נבין את ההתאמות האישית באמצעות דוגמה. נוסיף את התרגום לצרפתית עבור שמות העמודות תחזית וזכייה ברשת התחזית.

1. ניצור רכיב קוד עם השם ColumnHeader
2. ניצור קובץ משאבים ונוסיף תרגומים
3. נטמיע את המניפסט
4. נטמיע את לוגיקת הרכיב
5. נבנה את החבילה ונפרוס אותה

ניצור קובץ משאבים ונוסיף תרגומים

לאחר יצירת רכיב הקוד, התיקיה ColumnHeader נוצרת בנתיב שצוין. ניצור קובץ משאבים ונוסיף את התרגומים לצרפתית בקובץ המשאבים.

1. ניצור תיקייה בשם strings תחת התיקיה ColumnHeader .

2. נוסיף את הקוד הבא לקובץ זה, ColumnHeader.1036.resx.

   הערה

   המספר 1036 בשם הקובץ הוא קוד השפה לצרפתית. לרשימה של קודי שפה, יש לעיין במאמר זה.

   <?xml version="1.0" encoding="utf-8"?>
   <root>
   
     <xsd:schema id="root" xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
       <xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
       <xsd:element name="root" msdata:IsDataSet="true">
         <xsd:complexType>
           <xsd:choice maxOccurs="unbounded">
             <xsd:element name="metadata">
               <xsd:complexType>
                 <xsd:sequence>
                   <xsd:element name="value" type="xsd:string" minOccurs="0" />
                 </xsd:sequence>
                 <xsd:attribute name="name" use="required" type="xsd:string" />
                 <xsd:attribute name="type" type="xsd:string" />
                 <xsd:attribute name="mimetype" type="xsd:string" />
                 <xsd:attribute ref="xml:space" />
               </xsd:complexType>
             </xsd:element>
             <xsd:element name="assembly">
               <xsd:complexType>
                 <xsd:attribute name="alias" type="xsd:string" />
                 <xsd:attribute name="name" type="xsd:string" />
               </xsd:complexType>
             </xsd:element>
             <xsd:element name="data">
               <xsd:complexType>
                 <xsd:sequence>
                   <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
                   <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
                 </xsd:sequence>
                 <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
                 <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
                 <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
                 <xsd:attribute ref="xml:space" />
               </xsd:complexType>
             </xsd:element>
             <xsd:element name="resheader">
               <xsd:complexType>
                 <xsd:sequence>
                   <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
                 </xsd:sequence>
                 <xsd:attribute name="name" type="xsd:string" use="required" />
               </xsd:complexType>
             </xsd:element>
           </xsd:choice>
         </xsd:complexType>
       </xsd:element>
     </xsd:schema>
     <resheader name="resmimetype">
       <value>text/microsoft-resx</value>
     </resheader>
     <resheader name="version">
       <value>2.0</value>
     </resheader>
     <resheader name="reader">
       <value>System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
     </resheader>
     <resheader name="writer">
       <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
     </resheader>
     <data name="Forecast" xml:space="preserve">
       <value>Prévision</value>
     </data>
     <data name="Won" xml:space="preserve">
       <value>Gagné</value>
     </data>
   </root>
   

   בדוגמת הקוד שלמעלה, שמות העמודות עבור תחזית וזכייה מוחלפים בתרגומים לצרפתית Prévision ו- Gagné בהתאמה ב<data>צומת.

   הערה

   בפרמטר name יש לציין את שם העמודה המדויק שהגדרת בשלב הפריסה של התחזית.

   

   כדי לתרגם את שם העמודה לשפות נוספות, יש ליצור קובץ משאבים עבור כל שפה שאליה יש לתרגם. יש לוודא ששם קובץ המשאב משתמש במוסכמות השמות הבאות:

   filename.languagecode.resx  
   **Example file name for German:** ColumnHeader.1031.resx
   

נטמיע את המניפסט

לאחר מכן, יש לשנות את קובץ המניפסט כדי לציין את המאפיין שאנו עוקפים. בדוגמה זו, אנו עוקפים את המאפיין ColumnName. כמו כן, נציין את הנתיב לקובץ המשאבים המכיל את הטקסט המתורגם.

1. נפתח את קובץ התבנית ב- ControlManifest.Input.XML.

2. נחפש את הצומת property ונחליף אותה בקוד הבא כפי שהוא.

   <property name="columnName" display-name-key="Property_Display_Key" description-key="Property_Desc_Key" of-type="SingleLine.Text" usage="bound" required="true" />

3. נעדכן את הצומת <resources> כדי לציין את הנתיב לקובץ המשאב הכולל את התרגומים לצרפתית:

   <resources>
     <code path="index.ts" order="1"/>
     <!-- UNCOMMENT TO ADD MORE RESOURCES
     <css path="css/ColumnHeader.css" order="1" />
     -->
     <resx path="strings/ColumnHeader.1036.resx" version="1.0.0" />
   </resources>
   

   הצומת <resx path> מכיל את נתיב קובץ המשאב. בדוגמת הקוד הקודמת, הוספנו את קובץ המשאבים עבור השפה הצרפתית. אם יש תרגומים לשפות אחרות, יש להוסיף גם את נתיב קובץ המשאבים עבור שפות אלו.

נטמיע את לוגיקת הרכיב

נוסיף את הקוד כדי להטמיע את הלוגיקה של הרכיבים בקובץ index.ts .

1. נפתח את קובץ התבנית ב- index.ts.

2. נוסיף את השורות הבאות בשיטת updateView:

   public updateView(context: ComponentFramework.Context<IInputs>): void
       {
           // Add code to update control view
           const colName = (context.parameters.columnName && context.parameters.columnName.raw) || "";
           this._container.innerHTML = context.resources.getString(colName);
       }
   

‏‫השלבים הבאים‬

• נבנה את רכיב הקוד
• נארוז את רכיב הקוד
• עוקף כותרות עמודות (Preview)