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