Κοινή χρήση μέσω


Προσθήκη της τοπικής γλώσσας στην απεικόνιση Power BI

Το Power BI υποστηρίζει μια σειρά τοπικών γλωσσών. Μπορείτε να ανακτήσετε τη γλώσσα τοπικών ρυθμίσεων Power BI και να τη χρησιμοποιήσετε για να εμφανίσετε περιεχόμενο στην απεικόνισή σας.

Οι ακόλουθες καρτέλες εμφανίζουν παραδείγματα της ίδιας απεικόνισης δείγματος γραφήματος ράβδων που εμφανίζει περιεχόμενο σε διαφορετικές γλώσσες. Καθένα από αυτά τα γραφήματα ράβδων δημιουργήθηκε χρησιμοποιώντας μια διαφορετική γλώσσα τοπικών ρυθμίσεων (Αγγλικά, Βασκικά και Χίντι), η οποία εμφανίζεται στη συμβουλή εργαλείου.

Σημείωμα

  • Η διαχείριση τοπικής προσαρμογής στον κώδικα απεικόνισης υποστηρίζεται από την έκδοση API 1.10.0 και νεότερες εκδόσεις.
  • Η τοπική προσαρμογή δεν υποστηρίζεται για τον εντοπισμό σφαλμάτων στην απεικόνιση κατά την ανάπτυξη.

Πώς μπορείτε να προσθέσετε την τοπική γλώσσα Power BI στην απεικόνισή σας

Για να προσθέσετε την τοπική γλώσσα power BI στην απεικόνισή σας, ακολουθήστε τα εξής βήματα:

  1. Ρυθμίστε το περιβάλλον σας για να εμφανίζει μια γλώσσα που δεν είναι τα Αγγλικά.

  2. Λάβετε την τοπική γλώσσα του Power BI.

  3. Ορισμός εμφανιζόμενων ονομάτων απεικόνισης

  4. Δημιουργήστε έναν φάκελο γλώσσας.

  5. Προσθέστε ένα αρχείο πόρων για κάθε γλώσσα.

  6. Δημιουργήστε μια νέα παρουσία localizationManager.

  7. Καλέστε τη συνάρτηση getDisplayName.

Βήμα 1 - Ρυθμίστε το περιβάλλον σας για να εμφανίσετε μια γλώσσα που δεν είναι αγγλικά

Για να δοκιμάσετε την απεικόνισή σας, ορίστε το Power BI σε μια γλώσσα που δεν είναι τα Αγγλικά. Αυτή η ενότητα δείχνει πώς μπορείτε να αλλάξετε τις ρυθμίσεις των Power BI Desktop και Υπηρεσία Power BI, έτσι ώστε να χρησιμοποιούν μια τοπική γλώσσα που δεν είναι τα Αγγλικά.

  • Power BI Desktop - Κάντε λήψη της μεταφρασμένου έκδοσης του Power BI Desktop από το https://powerbi.microsoft.com

  • Υπηρεσία Power BI - Εάν χρησιμοποιείτε Υπηρεσία Power BI (πύλη Web), αλλάξτε τη γλώσσα σας στις ρυθμίσεις:

    1. Εισέλθετε στο PowerBI.com.

    2. Μεταβείτε στη Ρυθμίσεις> Ρυθμίσεις> Ρυθμίσεις.

      Screenshot of the settings, settings, settings, menu option in Power B I service.

    3. Από την καρτέλα Γενικά , επιλέξτε Γλώσσα. Στο Ρυθμίσεις Γλώσσα, επιλέξτε τη γλώσσα που θέλετε να χρησιμοποιεί το Power BI και, στη συνέχεια, επιλέξτε Εφαρμογή.

      A screenshot showing the language settings in Power BI service.

Βήμα 2 - Λήψη των τοπικών ρυθμίσεων της γλώσσας Power BI

Η τοπική γλώσσα του Power BI διαβιβάζεται ως συμβολοσειρά που καλείται locale κατά τη διάρκεια της προετοιμασίας της απεικόνισης. Εάν αλλάξει μια γλώσσα τοπικών ρυθμίσεων στο Power BI, η απεικόνιση δημιουργείται ξανά στη νέα γλώσσα.

private locale: string;
...
this.locale = options.host.locale;

Σημείωμα

Στο Power BI Desktop, η locale ιδιότητα περιέχει τη γλώσσα του εγκατεστημένου Power BI Desktop.

Βήμα 3 - Ορίστε τα εμφανιζόμενα ονόματα της απεικόνισης

Κάθε απεικόνιση εμφανίζει πληροφορίες στο τμήμα παραθύρου ιδιοτήτων. Για παράδειγμα, μια μη εκχωρημένη προσαρμοσμένη απεικόνιση που δημιουργήθηκε χρησιμοποιώντας την pbiviz new εντολή, θα εμφανίσει τα πεδία Δεδομένα κατηγορίας και Δεδομένα μέτρησης στο τμήμα παραθύρου ιδιοτήτων.

A screenshot showing the category data and measure data fields in a newly created Power BI visual.

Το παράθυρο ιδιοτήτων που εμφανίζει πεδία έχει οριστεί στο αρχείο capabilities.json . Κάθε πεδίο εμφάνισης ορίζεται χρησιμοποιώντας μια displayName ιδιότητα. Προσθέστε ένα displayNameKey σε κάθε εμφανιζόμενο όνομα που θέλετε να τοπικοποιήσετε.

{
    "dataRoles": [
        {
            "displayName": "Category Data",
            "displayNameKey": "VisualCategoryDataNameKey1",
            "name": "category",
            "kind": "Grouping"
        },
        {
            "displayName": "Measure Data",
            "displayNameKey": "VisualMeasureDataNameKey2",
            "name": "measure",
            "kind": "Measure"
        }
    ]
}

Βήμα 4 - Δημιουργία φακέλου γλώσσας

Για να δημιουργήσετε μεταφρασμένες απεικονίσεις, το έργο σας πρέπει να έχει έναν φάκελο γλώσσας. Στο έργο σας, δημιουργήστε έναν φάκελο με την ονομασία stringResources. Ο φάκελος περιέχει έναν υπο φάκελο για κάθε τοπική γλώσσα που θέλετε να υποστηρίζει η απεικόνισή σας. Για παράδειγμα, για να υποστηρίξετε Αραβικά και Εβραϊκά, προσθέστε δύο φακέλους ως εξής:

A VS code screenshot of a visual project folder.The string resources folder has two sub folders, one for Arabic and one for Hebrew.

Βήμα 5 - Προσθήκη ενός αρχείου πόρων για κάθε γλώσσα

Για κάθε γλώσσα που θέλετε να υποστηρίζεται η απεικόνισή σας, προσθέστε ένα αρχείο json resources.resjson στον κατάλληλο υποφάκελο stringResources . Αυτά τα αρχεία περιέχουν τις πληροφορίες γλώσσας τοπικών ρυθμίσεων και τις μεταφρασμένες τιμές συμβολοσειράς για κάθε displayNameKey που θέλετε να αντικαταστήσετε.

A VS code screenshot of a visual project folder. Each sub-folder in the string resources folder has a resources dot resjson file.

Κάθε αρχείο JSON ορίζει μία μόνο υποστηριζόμενη γλώσσα τοπικών ρυθμίσεων. Προσθέστε όλες τις συμβολοσειρές τοπικής προσαρμογής που πρόκειται να χρησιμοποιήσετε σε κάθε αρχείο resources.resjson .

Παραδείγματα

  • αρχείο resources.resjson με ρωσικές συμβολοσειρές για κάθε displayNameKey.

    {
        ...
        "Role_Legend": "Обозначения",
        "Role_task": "Задача",
        "Role_StartDate": "Дата начала",
        "Role_Duration": "Длительность"
        ...
    }
    
  • αρχείο resources.resjson με εβραϊκές συμβολοσειρές για κάθε displayNameKey.

    {
        ...
        "Role_Legend": "מקרא",
        "Role_task": "משימה",
        "Role_StartDate": "תאריך התחלה",
        "Role_Duration": "משך זמן"
        ...
    }
    

Βήμα 6 - Δημιουργία νέας παρουσίας localizationManager

Δημιουργήστε μια νέα localizationManager παρουσία στον κώδικα της απεικόνισής σας.

private localizationManager: ILocalizationManager;

constructor(options: VisualConstructorOptions) {
    this.localizationManager = options.host.createLocalizationManager();
}

Βήμα 7 - Κλήση της συνάρτησης getDisplayName

Μετά τη δημιουργία μιας νέας localizationManager παρουσίας, μπορείτε να καλέσετε τη συνάρτηση της getDisplayName διαχείρισης τοπικής προσαρμογής με το όρισμα κλειδιού συμβολοσειράς που ορίσατε στο resources.resjson.

Για παράδειγμα, ο παρακάτω κώδικας επιστρέφει το Υπόμνημα για en-US και Обозначения για ru-RU.

let legend: string = this.localization.getDisplayName("Role_Legend");

Τοπική προσαρμογή τμήματος παραθύρου μορφοποίησης και τμήματος παραθύρου ανάλυσης

Σημείωμα

Σχετικό με την έκδοση API 5.1+

Για να υποστηρίξετε την τοπική προσαρμογή στο τμήμα παραθύρου μορφοποίησης και τα στοιχεία του τμήματος παραθύρου ανάλυσης, ορίστε τη μεταφρασμένο συμβολοσειρά ως εξής:

displayName: this.localization.getDisplayName("Font_Color_DisplayNameKey");
description: this.localization.getDisplayName("Font_Color_DescriptionKey");

Για το μοντέλο μορφοποίησης τοπικής προσαρμογής, ανατρέξτε στο θέμα Τοπική προσαρμογή παραθύρου μορφοποίησης.
Για την τοπική προσαρμογή βοηθητικών προγραμμάτων μοντέλου μορφοποίησης , ανατρέξτε στο θέμα βοηθητικά προγράμματα μοντέλου μορφοποίησης - τοπική προσαρμογή.

Υποστηριζόμενες γλώσσες

Ο παρακάτω πίνακας περιέχει μια λίστα με όλες τις γλώσσες που υποστηρίζονται στο Power BI και τη συμβολοσειρά που επιστρέφει η locale μεταβλητή για καθεμία.

Συμβολοσειρά τοπικών ρυθμίσεων Γλώσσα
ar-SA العربية (Αραβικά)
bg-BG български (Βουλγαρικά)
ca-ES català (Καταλανικά)
cs-CZ čeština (Τσεχικά)
da-DK dansk (Δανικά)
de-DE Deutsche (Γερμανικά)
el-GR ελληνικά (Ελληνικά)
el-GR Αγγλικά (Αγγλικά)
es-ES español service (Ισπανικά)
et-EE eesti (Εσθονικά)
eU-ES Euskal (Βασκικά)
fi-FI suomi (Φινλανδικά)
fr-FR français (Γαλλικά)
gl-ES Γαλινικικά
he-IL עברית (Εβραϊκά)
hi-IN हिन्दी (Χίντι)
hr-HR hrvatski (Κροατικά)
hu-HU magyar (Ουγγρικά)
id-ID Bahasa Indonesia (Ινδονησιακά)
it-IT italiano (Ιταλικά)
ja-JP 日本の (Ιαπωνικά)
kk-KZ Қазақ (Καζαχστανικά)
ko-KR 한국의 (Κορεατικά)
lt-LT Lietuvos (Λιθουανικά)
lv-LV Latvijas (Λετονικά)
ms-MY Bahasa Melayu (Μαλαϊκά)
nb-NO norsk (Νορβηγικά)
nl-NL Nederlands (Ολλανδικά)
pl-PL polski (Πολωνικά)
pt-BR português (Πορτογαλικά)
pt-PT português (Πορτογαλικά)
ro-RO românesc (Ρουμανικά)
ru-RU русский (Ρωσικά)
sk-SK slovenský (Σλοβακικά)
sl-SI slovenski (Σλοβενικά)
sr-Cyrl-RS српски (Σερβικά)
sr-Latn-RS srpski (Σερβικά)
sv-SE svenska (Σουηδικά)
th-TH ไทย (Ταϊλανδικά)
tr-TR Türk (Τουρκικά)
uk-UA український (Ουκρανικά)
vi-VN tiếng Việt (Βιετναμικά)
zh-CN 中国 (Κινεζικά-Απλοποιημένα)
zh-TW 中國 (Κινεζικά-Παραδοσιακά)

Βοηθητικά προγράμματα μορφοποίησης

Ερωτήσεις; Ρωτήστε την κοινότητα του Power BI