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

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

パネルが示すもの

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

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

配線

サイト管理者ページと同様に、LocalizationAdminSystemAdminClaimsTransformerによって刻印された合成SystemAdmin役割の主張の背後にゲートされています。サイト管理者のドキュメントページでは、その主張がどのように設定されているかが説明されています。コンポーネントをロールゲートされたページ内に置きます:

ナビに浮かべてください

ナビエントリーを非管理者がフォローできないリンクを見ないように、 <AuthorizeView Roles="SystemAdmin"> で囲みましょう:

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

構成パネルはホストがレジスタする LocalizationOptions を反映します。 LocalizeAllAvailableTables すべてのテーブルをローカライズしたり、 AddTableToLocalizeで明示的に追加されたセットのみを切り替えたり、ディレクトリ、ファイル、ウェブリソースの設定がウォームアップにフォルダベースやウェブリソースのローカライズソースの場所を教えます。ノブの全セットは以下のAPIリファレンスに記載されています。

関連:翻訳ページ

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

API参照

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

LocalizationOptions クラス

性質

名称
種類
デフォルト
概要
DefaultCultureCultureInfo
特定の文化が求められない場合に使われるデフォルトの文化。
LocalizationDirectoriesIReadOnlyList<string>
ローカリゼーションファイルをスキャンするためのディレクトリパスのリスト。
LocalizationFilesIReadOnlyList<string>
ローカリゼーション文字列を読み込むための個々のファイルパスのリスト。
LocalizeAllAvailableTablesbool
True
true(デフォルト)の場合、ローカライズされた文字列は Dataverse環境やLocalizationOptions.TablesToLocalizeは無視されています。制限のためにfalseに設定 AddTableToLocalize(System.String)/IEnumerable{System.String})を通じて登録されたテーブルへのローカライズ。 複数言語をサポートするポータルに推奨します:これをfalseに設定し、 ポータルが実際に現れたテーブルだけを登録してください。すべてのテーブルのメタデータを読み込むことで、 ローカライゼーションのウォームアップは明らかに遅くなり、ラベル、選択肢、ビューの文字列キャッシュが増えてしまいます 表示されることのない名前であり、そのコストはインストールされた言語ごとに支払われます。サブセットにオプト参加したら、登録してください UIにラベルが表示されるすべてのテーブル(グリッド、フォーム、サブグリッド、チャート)は、表示されている ローカライズされていないテーブルはラベルの代わりに生のキーをレンダリングします。アカウント連絡先、そして adx_externalidentityはデフォルトでリストにシードされています。
TablesToLocalizeIReadOnlyList<string>
Dataverseのテーブルは、メタデータ(ラベル、選択、ビュー)をローカライズされた文字列としてエクスポートすべきものとして名前を付けます。 真実の時は無視LocalizationOptions.LocalizeAllAvailableTables
UrlCultureStrategyUrlCultureStrategy
PathPrefix
アクティブな文化がリクエストURLに反映されるかどうか(およびどのように)を制御します。 デフォルトは UrlCultureStrategy.PathPrefix (デフォルト文化は裸、 その他の文化は /{culture} 接頭辞で表記されています。参照 Options.UrlCultureStrategy 利用可能なモードについて。多文化サイトにのみ影響します。
名称: DefaultCulture
種類: CultureInfo
概要: 特定の文化が求められない場合に使われるデフォルトの文化。
名称: LocalizationDirectories
種類: IReadOnlyList<string>
概要: ローカリゼーションファイルをスキャンするためのディレクトリパスのリスト。
名称: LocalizationFiles
種類: IReadOnlyList<string>
概要: ローカリゼーション文字列を読み込むための個々のファイルパスのリスト。
名称: LocalizeAllAvailableTables
種類: bool
デフォルト: True
概要: true(デフォルト)の場合、ローカライズされた文字列は Dataverse環境やLocalizationOptions.TablesToLocalizeは無視されています。制限のためにfalseに設定 AddTableToLocalize(System.String)/IEnumerable{System.String})を通じて登録されたテーブルへのローカライズ。 複数言語をサポートするポータルに推奨します:これをfalseに設定し、 ポータルが実際に現れたテーブルだけを登録してください。すべてのテーブルのメタデータを読み込むことで、 ローカライゼーションのウォームアップは明らかに遅くなり、ラベル、選択肢、ビューの文字列キャッシュが増えてしまいます 表示されることのない名前であり、そのコストはインストールされた言語ごとに支払われます。サブセットにオプト参加したら、登録してください UIにラベルが表示されるすべてのテーブル(グリッド、フォーム、サブグリッド、チャート)は、表示されている ローカライズされていないテーブルはラベルの代わりに生のキーをレンダリングします。アカウント連絡先、そして adx_externalidentityはデフォルトでリストにシードされています。
名称: TablesToLocalize
種類: IReadOnlyList<string>
概要: Dataverseのテーブルは、メタデータ(ラベル、選択、ビュー)をローカライズされた文字列としてエクスポートすべきものとして名前を付けます。 真実の時は無視LocalizationOptions.LocalizeAllAvailableTables
名称: UrlCultureStrategy
種類: UrlCultureStrategy
デフォルト: PathPrefix
概要: アクティブな文化がリクエストURLに反映されるかどうか(およびどのように)を制御します。 デフォルトは UrlCultureStrategy.PathPrefix (デフォルト文化は裸、 その他の文化は /{culture} 接頭辞で表記されています。参照 Options.UrlCultureStrategy 利用可能なモードについて。多文化サイトにのみ影響します。

方法

名称
パラメータ
種類
概要
AddLocalizationDirectorystring relativeDirectoryPath
void
ローカライズファイルをスキャンするためのディレクトリパスを追加します。
AddLocalizationFilestring relativeFilePath
void
リストに単一のローカライゼーションファイルパスを追加します。
AddTablesToLocalizeIEnumerable<string> tables
void
Dataverseのテーブル名の集合を追加してローカライズします。
AddTableToLocalizestring tableName
void
ローカライズ用の単一のDataverseテーブル名を追加します。
名称: AddLocalizationDirectory
パラメータ: string relativeDirectoryPath
種類: void
概要: ローカライズファイルをスキャンするためのディレクトリパスを追加します。
名称: AddLocalizationFile
パラメータ: string relativeFilePath
種類: void
概要: リストに単一のローカライゼーションファイルパスを追加します。
名称: AddTablesToLocalize
パラメータ: IEnumerable<string> tables
種類: void
概要: Dataverseのテーブル名の集合を追加してローカライズします。
名称: AddTableToLocalize
パラメータ: string tableName
種類: void
概要: ローカライズ用の単一のDataverseテーブル名を追加します。