HTMLポートレットの設定

HTMLポートレットは、HTMLタグを記述して作成するポートレットです。
HTMLポートレットにタグを記述して、Garoon以外のシステムやWebサイトなどを表示します。

注意事項

  • 弊社では、カスタマイズにより発生する、性能への影響やいかなる結果についても責任を負いません。
    HTMLによるカスタマイズは、お客様の判断と責任の下に実行してください。
    また、カスタマイズされた機能に関しては、サポート対象外とさせていただくことをご了承ください。
    詳細については、Garoon 5 サービスライセンス規約を確認してください。
  • 弊社では、有償無償にかかわらず、カスタマイズサービスを承っておりません。ご了承ください。
  • HTMLによるカスタマイズの結果、Garoonに著しい負荷や障害等が発生し、Garoonを使用できない状態になることがあります。
    カスタマイズ時の注意点をよくご理解の上、万全の準備をしてから作業してください。
  • DOM操作の処理をしていた場合や、Garoonが利用しているJavaScriptライブラリーを利用していた場合などにおいて、Garoonが更新されると、読み込んでいたJavaScriptおよびCSSがエラーになる場合があります。
    Garoonの更新後は動作を確認し、必要に応じて修正したJavaScriptファイルやCSSファイルを読み込んでください。
  • サイボウズ製品の著作権は弊社に帰属します。

HTMLタグに関する注意点

HTMLポートレットが正常に動作するように、次の点に注意してタグを正しく記述します。

小文字の使用

HTMLタグは小文字で記述します。

終了タグの使用

開始タグと終了タグは必ずセットで記述します。HTMLタグが完結していないポートレットをポータルに配置すると、ポータルの編集画面が正しく表示されない、ポートレットを移動できないなどの問題が発生する場合があります。
ネスト構造のHTMLタグは、開始タグと終了タグが交差しないように記述します。

例:

ネスト構造のHTMLタグの記述例

記述不要のタグ

html、head、bodyタグは、HTMLポートレットに記述する必要はありません。

セキュアコーディングガイドラインの確認

JavaScriptを記載する場合は、セキュアコーディングガイドラインを確認してください。
クロスサイトスクリプティングやCSSインジェクションを防ぐ

HTMLポートレットを追加する

HTMLポートレットを作成します。システム管理者の設定によって、Myポータルの使用権限が許可されている場合は、ユーザーがMyポータルで使用することもできます。

操作手順:
  1. へッダーの歯車の形をした管理者メニューアイコンをクリックします。

  2. [システム設定]をクリックします。

  3. 「各アプリケーションの管理」タブを選択します。

  4. [ポータル]をクリックします。

  5. [HTMLポートレット]をクリックします。

  6. 「HTMLポートレット」画面で、[HTMLポートレットを追加する]をクリックします。

    HTMLポートレットを追加するの操作リンクが赤枠で囲まれている画像

  7. 「HTMLポートレットの追加」画面で、「ポートレット名」項目を入力します。

    標準のポートレット名は必ず設定します。
    [言語ごとに表示名を設定する]をクリックすると、複数の言語でポートレット名を設定できます。
    ユーザーが設定している言語のポートレット名を設定していない場合、標準のポートレット名が表示されます。
    設定できる言語は、次のとおりです。

    • 日本語
    • English
    • 中文(简体
    • 中文(繁體
      繁体字で表示されます。
    ポートレット名を入力している画像

  8. 「グループ」項目を設定します。

    ポートレットを分類するポートレットグループを選択します。
    グループ項目を設定している画像

  9. 「Myポータル」項目を設定します。

    追加したHTMLポートレットをユーザーがMyポータルで利用できるようにする場合は、「Myポータルでの利用を許可する」のチェックボックスを選択します。
    Myポータルでの利用を許可している画像

  10. 「ポートレットの内容」項目を設定します。

    HTMLタグや書式編集を使用して、ポートレットの内容を記述します。
    スクリーンショット:HTMLタグを使ったポートレットの設定例

    ポートレットの内容に次の機能を利用して、HTMLポートレットをカスタマイズすることもできます。

    • キーワードの記述:
      使用できるキーワードを記述すると、ポートレットを使用するユーザーの情報を表示できます。

  11. 設定内容を確認し、[追加する]をクリックします。

使用できるキーワード

キーワードを使用すると、ポートレットを使用するユーザーのユーザー情報を、HTMLポートレットに表示できます。
キーワードは、ポートレットを使用するユーザーのユーザー情報に置き換わります。
使用できるキーワードは、次のとおりです。

キーワード 意味
%Name% ユーザー名
%ID% Garoonのシステム内で使用されているユーザーID
%Account% ログイン名
%Mail% ユーザー情報に登録されているE-mail
%Password% パスワード
%session_password% ログインユーザーが使用し、セッションに保存されているパスワード
%Tel% ユーザー情報に登録されている連絡先
%URL% ユーザー情報に登録されているURL

HTMLポートレットを変更する

HTMLポートレットを変更します。

操作手順:
  1. へッダーの歯車の形をした管理者メニューアイコンをクリックします。

  2. [システム設定]をクリックします。

  3. 「各アプリケーションの管理」タブを選択します。

  4. [ポータル]をクリックします。

  5. [HTMLポートレット]をクリックします。

  6. 「HTMLポートレット」画面で、変更するHTMLポートレットのポートレット名を選択します。

  7. 「HTMLポートレットの詳細」画面で、[変更する]をクリックします。

    変更するの操作リンクが赤枠で囲まれている画像

  8. 「HTMLポートレットの変更」画面で、必要に応じて設定内容を変更します。

  9. 設定内容を確認し、[変更する]をクリックします。

HTMLポートレットをJavaScript / CSSでカスタマイズする

JavaScriptファイルやCSSファイルを使って、HTMLポートレットの画面をカスタマイズできます。
詳細は、ポータルのカスタマイズを参照してください。

HTMLポートレットの表示を確認する

HTMLポートレットを公開する前に、ユーザー画面でどのようにポートレットが表示されるかプレビューできます。

操作手順:
  1. へッダーの歯車の形をした管理者メニューアイコンをクリックします。

  2. [システム設定]をクリックします。

  3. 「各アプリケーションの管理」タブを選択します。

  4. [ポータル]をクリックします。

  5. [HTMLポートレット]をクリックします。

  6. 「HTMLポートレット」画面で、プレビューするHTMLポートレットを選択します。

  7. 「HTMLポートレットの詳細」画面で、[表示を確認する]をクリックします。

    表示を確認する操作リンクが赤枠で囲まれている画像

HTMLポートレットを削除する

HTMLポートレットを削除します。

1件ずつHTMLポートレットを削除する

HTMLポートレットを1件ずつ削除します。

操作手順:
  1. へッダーの歯車の形をした管理者メニューアイコンをクリックします。

  2. [システム設定]をクリックします。

  3. 「各アプリケーションの管理」タブを選択します。

  4. [ポータル]をクリックします。

  5. [HTMLポートレット]をクリックします。

  6. 「HTMLポートレット」画面で、削除するポートレットのHTMLポートレットのポートレット名を選択します。

  7. 「HTMLポートレットの詳細」画面で、[削除する]をクリックします。

    削除するの操作リンクが赤枠で囲まれている画像

  8. 「HTMLポートレットの削除」画面で、[はい]をクリックします。

複数のHTMLポートレットをまとめて削除する

複数のHTMLポートレットをまとめて削除します。

操作手順:
  1. へッダーの歯車の形をした管理者メニューアイコンをクリックします。

  2. [システム設定]をクリックします。

  3. 「各アプリケーションの管理」タブを選択します。

  4. [ポータル]をクリックします。

  5. [HTMLポートレット]をクリックします。

  6. 「HTMLポートレット」画面で、削除するポートレットのチェックボックスを選択し、[削除する]をクリックします。

    削除するHTMLポートレットが選択されている画像

  7. 「HTMLポートレットの一括削除」画面で、[はい]をクリックします。