ローカリゼーション管理者

PowerPortalsProは LocalizationAdmin コンポーネントを付属しており、実行時に文字列ローカリゼーションパイプラインを操作するためのターンキーのSystemAdminゲートパネルです。ロールゲートされたページに落 <LocalizationAdmin /> すると、管理者はローカリゼーションキャッシュの設定や構築方法を確認し、ホストを再起動せずに再構築し、ローカリゼーションファイルを機械翻訳し、マージした文化ごとのスナップショットをダウンロードできます。フレームワークの要素が重労働を担います。ポータルはページ、ロールゲート、ナビリンクを提供します。これはサイト管理者ページと同じ分割です。

パネルが示すもの

LocalizationAdmin フレームワークのローカライゼーションサービスによって支えられた複数のセクションを表示します:

  • 構成 — ウォームアップの配線方法を読み取り専用でまとめます。利用可能なすべてのテーブルがローカライズされているのか、それとも設定されたセットのみなのか、ローカライズすべきテーブル、ウェブリソースパスのパターン、登録済みローカリゼーションディレクトリとファイル、そしてデフォルトの文化などです。これらはホストがレジスターする LocalizationOptions をミラーリングします。
  • ファイルを翻訳する — ローカリゼーションファイルを別の文化に機械翻訳する埋め込み LocalizationTranslator です。利用可能性に対して自己ゲートを設け、翻訳プロバイダーが設定されていない場合は何も表示せず、管理されたソリューションが欠けている場合はインストールプロンプトが表示されます。翻訳ドキュメントのページで全文が説明されています。
  • 統合キーを検査してダウンロードする — キャッシュに鍵がある文化ごとに2つのアクションがあります。 Inspect は、マージされたすべてのキーとその解決値とそれを提供したソースを一覧にするダイアログを開きます。これはキー、値、ソースごとにフィルタリングできるソート可能でサイズ調整可能なグリッドで、文字列の出所や他のソースが上書きされていることを正確に特定できます。 ダウンロード はその文化の統合されたローカライゼーションJSON(すべてのソース(Dataverseメタデータ、ウェブリソース、フォルダファイル)を1つのファイルに統合したものを保存し、検査ダイアログ内からも利用可能です。
  • 出典 — 最新のウォームアップからのソースごとの負荷記録をロード順にグリッド化し、各ソースが貢献したキーの数と、そのうちのキーが以前の値を上書きした数を含みます。文字列がなぜそのように解消されたのかを知る最も速い方法です。
  • リロード — ホストを再起動せずに、設定済みのすべてのソースから文字列ローカリゼーションキャッシュを再構築します。再構築は原子的で、新しい辞書が準備できるまで読者は以前の値を繰り返し見続けます。

配線

サイト管理者ページと同様に、 LocalizationAdmin ポータル管理者チェック( [AuthorizeSystemAdmin] と <SystemAdminView>で、Dataverseの役割のいずれかを持つ内部ユーザーのみが閲覧 SystemAdminClaimsTransformer 許可されます。サイト管理者のドキュメントページでは、その主張の設定方法が説明されています。コンポーネントをロールゲートされたページ内に置いてください:

ナビに浮かべてください

ナビエントリーを <SystemAdminView> でラップし、管理者以外の人がたどれられないリンクを見ないようにしましょう:

局所化されるものを制御すること

設定パネルはホストレジスタの LocalizationOptions を反映しています。テーブルやパブリッシャープレフィックスはDataverseメタデータからローカライズされたものを一覧にしています。ディレクトリ、ファイル、ウェブリソースの設定は、ウォームアップにフォルダベースやウェブリソースのローカリゼーションソースの場所を教えます。全ノブセットは以下のAPIリファレンスに記載されています。

関連:翻訳ページ

ここに埋め込まれたファイルの翻訳パネルは、翻訳ページに記載されているのと同じ LocalizationTranslator もので、翻訳プロバイダー(例:Azure AI Translator)の設定とそれを支えるマネージドソリューションのインストール方法を説明しています。

API参照

LocalizationOptions 構成パネルが何を表示し、ウォームアップが何を引き出すかを駆動します。そのメンバーは以下にまとめられています。

LocalizationOptions クラス

性質

名称
種類
デフォルト
概要
DefaultCultureCultureInfo
特定の文化が求められない場合に使われるデフォルトの文化。
LocalizationDirectoriesIReadOnlyList<string>
ローカリゼーションファイルをスキャンするためのディレクトリパスのリスト。
LocalizationFilesIReadOnlyList<string>
ローカリゼーション文字列を読み込むための個々のファイルパスのリスト。
TablePublisherPrefixesToLocalizeIReadOnlyList<string>
パブリッシャーは(例えば new_)接頭辞を付け、そのテーブルはさらにローカライズされています。 LocalizationOptions.TablesToLocalize。各文字列は、局所化された文字列が ロードされるため、後で環境に追加されたテーブルはキャッシュが再ロードされたときにピックアップされます。
TablesToLocalizeIReadOnlyList<string>
Dataverseのテーブルは、メタデータ(ラベル、選択、ビュー)をローカライズされた文字列としてエクスポートすべきものとして名前を付けます。 常にフレームワーク内のページに表示される Tables.PowerPortalsProTablesを含みます。登録 UIにラベルが表示される他のすべてのテーブル(グリッド、フォーム、サブグリッド、チャート)は、表示されたテーブルです ローカライズされていない場合は、ラベルの代わりに生のキーをレンダリングします。 Options.Tables は既成のリストを保持しています。 よく使われる表。
UrlCultureStrategyUrlCultureStrategy
PathPrefix
アクティブな文化がリクエストURLに反映されるかどうか(およびどのように)を制御します。 デフォルトは UrlCultureStrategy.PathPrefix (デフォルト文化は裸、 その他の文化は /{culture} 接頭辞で表記されています。参照 Options.UrlCultureStrategy 利用可能なモードについて。多文化サイトにのみ影響します。
名称: DefaultCulture
種類: CultureInfo
概要: 特定の文化が求められない場合に使われるデフォルトの文化。
名称: LocalizationDirectories
種類: IReadOnlyList<string>
概要: ローカリゼーションファイルをスキャンするためのディレクトリパスのリスト。
名称: LocalizationFiles
種類: IReadOnlyList<string>
概要: ローカリゼーション文字列を読み込むための個々のファイルパスのリスト。
名称: TablePublisherPrefixesToLocalize
種類: IReadOnlyList<string>
概要: パブリッシャーは(例えば new_)接頭辞を付け、そのテーブルはさらにローカライズされています。 LocalizationOptions.TablesToLocalize。各文字列は、局所化された文字列が ロードされるため、後で環境に追加されたテーブルはキャッシュが再ロードされたときにピックアップされます。
名称: TablesToLocalize
種類: IReadOnlyList<string>
概要: Dataverseのテーブルは、メタデータ(ラベル、選択、ビュー)をローカライズされた文字列としてエクスポートすべきものとして名前を付けます。 常にフレームワーク内のページに表示される Tables.PowerPortalsProTablesを含みます。登録 UIにラベルが表示される他のすべてのテーブル(グリッド、フォーム、サブグリッド、チャート)は、表示されたテーブルです ローカライズされていない場合は、ラベルの代わりに生のキーをレンダリングします。 Options.Tables は既成のリストを保持しています。 よく使われる表。
名称: UrlCultureStrategy
種類: UrlCultureStrategy
デフォルト: PathPrefix
概要: アクティブな文化がリクエストURLに反映されるかどうか(およびどのように)を制御します。 デフォルトは UrlCultureStrategy.PathPrefix (デフォルト文化は裸、 その他の文化は /{culture} 接頭辞で表記されています。参照 Options.UrlCultureStrategy 利用可能なモードについて。多文化サイトにのみ影響します。

方法

名称
パラメータ
種類
概要
AddLocalizationDirectorystring relativeDirectoryPath
void
ローカライズファイルをスキャンするためのディレクトリパスを追加します。
AddLocalizationFilestring relativeFilePath
void
リストに単一のローカライゼーションファイルパスを追加します。
AddTablesToLocalizeIEnumerable<string> tables
void
Dataverseのテーブル名の集合を追加し、 Options.Tablesのリストの一つをローカライズします。
AddTablesToLocalizeByPublisherPrefixstring publisherPrefix
void
論理名が指定されたパブリッシャープレフィックスで始まるすべてのDataverseテーブルをローカライズします — 通常 自分のテーブルを作成するパブリッシャーのプレフィックスです。
AddTableToLocalizestring tableName
void
ローカライズ用の単一のDataverseテーブル名を追加します。
名称: 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テーブル名を追加します。