ローカリゼーション管理者
PowerPortalsProは LocalizationAdmin コンポーネントを付属しており、実行時に文字列ローカリゼーションパイプラインを操作するためのターンキーのSystemAdminゲートパネルです。ロールゲートされたページに落 <LocalizationAdmin /> すると、管理者はローカリゼーションキャッシュの設定や構築方法を確認し、ホストを再起動せずに再構築し、ローカリゼーションファイルを機械翻訳し、マージした文化ごとのスナップショットをダウンロードできます。フレームワークの要素が重労働を担います。ポータルはページ、ロールゲート、ナビリンクを提供します。これはサイト管理者ページと同じ分割です。
パネルが示すもの
LocalizationAdmin フレームワークのローカライゼーションサービスによって支えられた複数のセクションを表示します:
- 構成 — ウォームアップの配線方法を読み取り専用でまとめます。利用可能なすべてのテーブルがローカライズされているのか、それとも設定されたセットのみなのか、ローカライズすべきテーブル、ウェブリソースパスのパターン、登録済みローカリゼーションディレクトリとファイル、そしてデフォルトの文化などです。これらはホストがレジスターする
LocalizationOptionsをミラーリングします。 - ファイルを翻訳する — ローカリゼーションファイルを別の文化に機械翻訳する埋め込み
LocalizationTranslatorです。利用可能性に対して自己ゲートを設け、翻訳プロバイダーが設定されていない場合は何も表示せず、管理されたソリューションが欠けている場合はインストールプロンプトが表示されます。翻訳ドキュメントのページで全文が説明されています。 - 統合キーを検査してダウンロードする — キャッシュに鍵がある文化ごとに2つのアクションがあります。 Inspect は、マージされたすべてのキーとその解決値とそれを提供したソースを一覧にするダイアログを開きます。これはキー、値、ソースごとにフィルタリングできるソート可能でサイズ調整可能なグリッドで、文字列の出所や他のソースが上書きされていることを正確に特定できます。 ダウンロード はその文化の統合されたローカライゼーションJSON(すべてのソース(Dataverseメタデータ、ウェブリソース、フォルダファイル)を1つのファイルに統合したものを保存し、検査ダイアログ内からも利用可能です。
- 出典 — 最新のウォームアップからのソースごとの負荷記録をロード順にグリッド化し、各ソースが貢献したキーの数と、そのうちのキーが以前の値を上書きした数を含みます。文字列がなぜそのように解消されたのかを知る最も速い方法です。
- リロード — ホストを再起動せずに、設定済みのすべてのソースから文字列ローカリゼーションキャッシュを再構築します。再構築は原子的で、新しい辞書が準備できるまで読者は以前の値を繰り返し見続けます。
配線
サイト管理者ページと同様に、 LocalizationAdmin ポータル管理者チェック( [AuthorizeSystemAdmin] と <SystemAdminView>で、Dataverseの役割のいずれかを持つ内部ユーザーのみが閲覧 SystemAdminClaimsTransformer 許可されます。サイト管理者のドキュメントページでは、その主張の設定方法が説明されています。コンポーネントをロールゲートされたページ内に置いてください:
@attribute [Route("admin/localization")]
@attribute [AuthorizeSystemAdmin]
@using PowerPortalsPro.Web.Blazor.FluentUI.Components
<SystemAdminView>
<Authorized>
<LocalizationAdmin />
</Authorized>
</SystemAdminView>
ナビに浮かべてください
ナビエントリーを <SystemAdminView> でラップし、管理者以外の人がたどれられないリンクを見ないようにしましょう:
<SystemAdminView>
<Authorized>
<FluentNavCategory Title="管理" IconRest="@(new Size20.WrenchSettings())">
<FluentNavItem Href="admin/localization">
<FluentIcon Value="@(new Size20.LocalLanguage())" />
局所化
</FluentNavItem>
</FluentNavCategory>
</Authorized>
</SystemAdminView>
局所化されるものを制御すること
設定パネルはホストレジスタの LocalizationOptions を反映しています。テーブルやパブリッシャープレフィックスはDataverseメタデータからローカライズされたものを一覧にしています。ディレクトリ、ファイル、ウェブリソースの設定は、ウォームアップにフォルダベースやウェブリソースのローカリゼーションソースの場所を教えます。全ノブセットは以下のAPIリファレンスに記載されています。
関連:翻訳ページ
ここに埋め込まれたファイルの翻訳パネルは、翻訳ページに記載されているのと同じ
LocalizationTranslatorもので、翻訳プロバイダー(例:Azure AI Translator)の設定とそれを支えるマネージドソリューションのインストール方法を説明しています。
API参照
LocalizationOptions 構成パネルが何を表示し、ウォームアップが何を引き出すかを駆動します。そのメンバーは以下にまとめられています。
LocalizationOptions クラス
性質
名称 | 種類 | デフォルト | 概要 |
|---|---|---|---|
DefaultCulture | CultureInfo | 特定の文化が求められない場合に使われるデフォルトの文化。 | |
LocalizationDirectories | IReadOnlyList<string> | ローカリゼーションファイルをスキャンするためのディレクトリパスのリスト。 | |
LocalizationFiles | IReadOnlyList<string> | ローカリゼーション文字列を読み込むための個々のファイルパスのリスト。 | |
TablePublisherPrefixesToLocalize | IReadOnlyList<string> | パブリッシャーは(例えば LocalizationOptions.TablesToLocalize。各文字列は、局所化された文字列が ロードされるため、後で環境に追加されたテーブルはキャッシュが再ロードされたときにピックアップされます。 | |
TablesToLocalize | IReadOnlyList<string> | Dataverseのテーブルは、メタデータ(ラベル、選択、ビュー)をローカライズされた文字列としてエクスポートすべきものとして名前を付けます。 常にフレームワーク内のページに表示される Tables.PowerPortalsProTablesを含みます。登録 UIにラベルが表示される他のすべてのテーブル(グリッド、フォーム、サブグリッド、チャート)は、表示されたテーブルです ローカライズされていない場合は、ラベルの代わりに生のキーをレンダリングします。 Options.Tables は既成のリストを保持しています。 よく使われる表。 | |
UrlCultureStrategy | UrlCultureStrategy | PathPrefix | アクティブな文化がリクエストURLに反映されるかどうか(およびどのように)を制御します。 デフォルトは UrlCultureStrategy.PathPrefix (デフォルト文化は裸、 その他の文化は Options.UrlCultureStrategy 利用可能なモードについて。多文化サイトにのみ影響します。 |
DefaultCultureLocalizationDirectoriesLocalizationFilesTablePublisherPrefixesToLocalizeLocalizationOptions.TablesToLocalize。各文字列は、局所化された文字列が ロードされるため、後で環境に追加されたテーブルはキャッシュが再ロードされたときにピックアップされます。TablesToLocalizeTables.PowerPortalsProTablesを含みます。登録 UIにラベルが表示される他のすべてのテーブル(グリッド、フォーム、サブグリッド、チャート)は、表示されたテーブルです ローカライズされていない場合は、ラベルの代わりに生のキーをレンダリングします。 Options.Tables は既成のリストを保持しています。 よく使われる表。UrlCultureStrategyUrlCultureStrategy.PathPrefix (デフォルト文化は裸、 その他の文化は Options.UrlCultureStrategy 利用可能なモードについて。多文化サイトにのみ影響します。方法
名称 | パラメータ | 種類 | 概要 |
|---|---|---|---|
AddLocalizationDirectory | string relativeDirectoryPath | void | ローカライズファイルをスキャンするためのディレクトリパスを追加します。 |
AddLocalizationFile | string relativeFilePath | void | リストに単一のローカライゼーションファイルパスを追加します。 |
AddTablesToLocalize | IEnumerable<string> tables | void | Dataverseのテーブル名の集合を追加し、 Options.Tablesのリストの一つをローカライズします。 |
AddTablesToLocalizeByPublisherPrefix | string publisherPrefix | void | 論理名が指定されたパブリッシャープレフィックスで始まるすべてのDataverseテーブルをローカライズします — 通常 自分のテーブルを作成するパブリッシャーのプレフィックスです。 |
AddTableToLocalize | string tableName | void | ローカライズ用の単一のDataverseテーブル名を追加します。 |
AddLocalizationDirectoryAddLocalizationFileAddTablesToLocalizeOptions.Tablesのリストの一つをローカライズします。AddTablesToLocalizeByPublisherPrefixAddTableToLocalize