カスタマイズの問題

ローカル開発インスタンスでアプリケーション提供ポートレットをカスタマイズする際に発生する一般的な問題

問題点

アプリケーションが提供するポートレットを拡張する場合、ローカルの開発環境では、カスタマイズしたポートレットで次のような問題に直面する可能性があります。

• 拡張ポートレットは空白で表示されます。
• 追加したカスタムバンドルラベルが正しく表示されません。
• アプリケーションが提供したバンドルラベルと以前に追加されたバンドルラベルが正しく表示されません。

アプリケーション提供ポートレットの変更で提供されているカスタマイズ手順を部分的または誤って実装した場合、これらの問題が発生します。

解決方法

• 拡張ポートレットが空白で表示される問題については、以下の手順を実行してください：
  1. ポートレットコンポーネントのクラス名が、それぞれのポートレットの component.ts ファイルで更新され、portletname 変数と componentName 変数に渡されているかどうかをチェックします。 詳細については、 「アプリケーション提供ポートレットの変更」 のステップ2を参照してください。
     次のサンプルコードでは、Pack order ポートレットを拡張する方法を説明します：

     export class PackOrderPortletExtnComponent implements OnInit, OnDestroy {
     public static portletname = 'PackOrderPortletExtnComponent';
     public static componentName = 'PackOrderPortletExtnComponent'; }
     

  2. 更新されたポートレットコンポーネントのクラス名を app.module.ts ファイルにインポートします。 詳細については、 「アプリケーション提供ポートレットの変更」 のステップ3を参照してください。
     次のサンプルコードでは、更新されたポートレットクラス名をインポートする方法を説明します：

     import { PackOrderPortletExtnComponent } from './components/pack-order-portlet/pack-order-portlet.component' 
     export const customComponentDeclarations = [PackOrderPortletExtnComponent];

  3. extensionType:CODEをisf-persona-config.jsonファイルに追加して、ポートレットに入力します。 そうでない場合、拡張ポートレットは空白で表示されます。 詳細については、 「アプリケーション提供ポートレットの変更」 のステップ4を参照してください。
• 追加したカスタムバンドルラベルが正しく表示されません。

  対応するjsonファイルに追加されるラベルバンドルのエントリーを考えてみましょう。 詳細については、 「アプリケーション提供ポートレットの変更」 の 「次に実行する操作」 を参照してください。

  /extensions/features/override-component/src/assets/override-component/i18n/en.jsonのサンプル・スニペットは以下の通りです。

  {
                  "packPortletExtn":{
                  "LABEL_Select":"Select"
                    }
   }

  対応するエントリがポートレットコンポーネントの HTML に追加されます。 実際のラベルの代わりに、packPortletExtn.LABEL_Selectがアプリケーションに表示されます。
  サンプルのコード・スニペットは以下の通り。

  <span class="mx-2" >packPortletExtn.LABEL_Select</span>

  この問題を解決するには、図のようにポートレットコンポーネントのHTMLタグにtranslate属性を追加します。

  <span class="mx-2" translate>packPortletExtn.LABEL_Select</span>

• アプリケーションが提供するバンドルラベルと以前に追加されたバンドルラベルが正しく表示されない。
  app.module.ts の静的変数 bundles に、ホームアプリケーションからロードされるアセットが含まれていることを確認してください。 詳細については、 「アプリケーション提供ポートレットの変更」 の 「次に実行する操作」 を参照してください。 以下のサンプル・エントリーを追加する：

  {
         prefix: './assets/home/i18n/',
         suffix: '.json'
  }