Ennusteruudukon sarakeotsikoiden mukauttaminen

Artikkeli
03/23/2023

Voit mukauttaa ennusteruudukon sarakeotsikkoja Power Apps -koodikomponenttien avulla. Voit esimerkiksi kääntää sarakkeen nimen tai lisätä työkaluvihjeen lisäkontekstia varten.

Lisenssi- ja roolivaatimukset

Vaatimustyyppi	Tarvitaan
Käyttöoikeus	Dynamics 365 Sales Premium tai Dynamics 365 Sales Enterprise Lisätietoja: Dynamics 365 Salesin hinnoittelu
Käyttöoikeusroolit	Järjestelmänvalvoja tai -mukauttaja Lisätietoja: Salesin esimääritetyt käyttöoikeusroolit

Otsikon mukauttaminen

Tarkastellaanpa mukautuksia esimerkin avulla. Lisäämme ranskankielisen käännöksen sarakenimille Ennuste ja Voitetut ennusteruudukkoon.

Luo koodikomponentti nimellä ColumnHeader
Luo resurssitiedosto ja lisää käännökset
Ota luettelotiedosto käyttöön
Ota komponenttilogiikka käyttöön
Luo ja paketoi komponentti

Luo resurssitiedosto ja lisää käännökset

Kun koodikomponentti on luotu, ColumnHeader-kansio luodaan määrittämässäsi polussa. Luodaanpa resurssitiedosto ja lisätään resurssitiedostoon ranskankieliset käännökset.

Luo kansio nimellä strings kansion ColumnHeader sisälle.

Kopioi seuraava koodi uuteen tiedostoon: ColumnHeader.1036.resx.

Muistiinpano

Tiedostonimen numero 1036 on ranskan kielikoodi. Luettelon kielikoodista löydät tästä artikkelista.

<?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>

Edellä esitetyssä koodiesimerkissä, sarakenimet Ennuste ja Voittanut korvataan ranskankielisillä käännöksillä Prévision ja Gagné solmussa <data>.

Muistiinpano

Määritä parametrissa name tarkasti sarakkeen nimi, jonka olet määrittänyt ennusteen Asettelu-vaiheessa.

Näyttökuva ennustemäärityksen **Asettelu**-vaiheen sarakkeiden nimistä

Jos haluat kääntää sarakkeen nimen muille kielille, luo resurssitiedosto kullekin käännettävälle kielelle. Varmista, että resurssitiedoston nimessä käytetään seuraavaa nimeämiskäytäntöä:

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

Ota luettelotiedosto käyttöön

Seuraavaksi muokkaamme luettelotiedostoa määrittääksemme ominaisuuden, jonka ohitamme. Tässä esimerkissä ohitetaan ominaisuus ColumnName. Määritämme myös polun resurssitiedostoon, joka sisältää käännetyn tekstin.

Avaa ControlManifest.Input.XML-tiedosto.
Etsi property-solmu ja korvaa se seuraavalla koodilla sellaisenaan:

<property name="columnName" display-name-key="Property_Display_Key" description-key="Property_Desc_Key" of-type="SingleLine.Text" usage="bound" required="true" />
Päivitä <resources>-solmu ja määritä polku resurssitiedostoon, joka sisältää ranskankieliset käännökset:
```
<resources>
  <code path="index.ts" order="1"/>
  
  <resx path="strings/ColumnHeader.1036.resx" version="1.0.0" />
</resources>
```
Solmu <resx path> sisältää resurssitiedoston polun. Edellisessä koodinäytteessä lisäsimme ranskan kielen resurssitiedoston. Jos sinulla on käännöksiä muille kielille, lisää resurssitiedoston polku myös kyseisille kielille.

Ota komponenttilogiikka käyttöön

Lisätäänpä index.ts-tiedostoon koodi, jolla komponenttilogiikka otetaan käyttöön.

Avaa index.ts-tiedosto.

Lisää seuraavat rivit updateView-menetelmään:

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);
    }

Jaa