レターラベルとは

実際のXSLテンプレートを編集することなく、ラベルを使用してレターを簡単に編集できます。たとえば、レターに「説明」だけでなく「アイテムの説明」を記載したい場合は、ラベルで変更できます: 

レター内のラベル

ラベルは、 XSL における @@ コードに影響を及ぼし、ラベルのいかなる変更もプレビューにすぐに反映されます。ただし、letterName ラベルをカスタマイズする場合は、プレビューで更新されたレター名を確認するには、 関連するビジネス フローを使用して、レターを再度生成する必要があります。次に、「レター設定」ページで（設定 > レター設定 > レターの例 > システムレターから追加)、XML を選択します (/notification_data/general_data/letter_name にカスタマイズされたレター名が含まれています)。

レターラベルの設定方法

以下の説明のようにして、特定のレターラベルを設定できます。 

1. レターの行のアクションリストで編集を選択します。
    
   
2. ページ上部にある ラベルボタンを選択します。
    
   
3. 行のアクションメニューからカスタマイズを選択します。以下の更新が可能です。
   • 有効  — このトグルを使用して、レター内で使用するラベルをアクティブまたは非アクティブにします。
   • 説明  — レターに表示されるラベルの説明を更新します。
     ただし、ラベルの説明フィールドでのHTMLタグの使用はサポートされていません。
   • 翻訳 — Almaで別の言語が有効になっており、それがフィルタドロップダウンで選択されている場合、翻訳を編集できます。
      
     
      
   • 復元  - その行が変更された場合、有効および説明のフィールドはデフォルトに復元されます。
   • 翻訳を復元  - 他の言語が設定されており、 翻訳ラベルが変更された場合、フィールドはデフォルトに復元されます。
4. すべての行を編集するには、すべてカスタマイズを選択します。
5. すべての行をデフォルトに戻すには、すべて復元を選択します。
6. すべての翻訳を復元するには、デフォルトの翻訳を復元を選択します。
7. 完了したら、保存を選択します。 ラベルリストに加えた変更は、メインのXSLプレビューページで選択された保存/キャンセルアクションにかかわらず、保存されます。
8. レタープレビューペインで変更を確認できます。
    
   
9. ラベルを無効にするには、ナレッジベースの記事 AlmaのEメールレターの行を無効にする方法を参照してください。

件名ラベルにリクエスト ID を含める

一部のレターでは、件名ラベルの説明列（ユーザーに送付される電子メールの件名）%reqId%に文字列を含めることができます。この文字列は、レターが生成される際にリクエストのIDに置き換えられます。このオプションを含むレターは下記の通りです：

• 借用者延滞Eメールレター
• 外部から取得されたEメールレター
• キャンセルEメールレター (全文)
• 発信Eメールレター (全文)
• 更新Eメールレター (全文)
• 貸出リコールEメールレター
• ユーザーへのクエリ レター

レターテンプレートのカスタマイズ

Ex Librisサポートは、カスタマイズされたXSLスタイルシートに関連する問題へのサポートのために利用できます。しかし、Ex Librisサポートの トラブルシューティングは実用限界内です。スタイルシートが大幅にカスタマイズされている場合、特定のエラーを識別するために時間のかかる分析が必要になる場合があります。このような検証は、カスタマイズされたすべてのスタイルシートのサポートでは提供できません。これらの状況でのベストプラクティスは、一度に1つの条件、テスト、またはセクションを削除して、何が 問題を発生させているのかを決定することです。

条件文

条件文の使用方法については、 if 条件を使用して、特定の状況下では手紙が送信されないように設定する方法.pptxを参照してください。

XSL カスタマイズの一般的な例

ユーザーへのクエリレターのカスタマイズの例

借用アクティビティレターのカスタマイズの例

この例では、取寄せアクティビティレターのEメールに下記のカスタマイズを行う方法を示します。  XSL を使用してレターの出力をカスタマイズできる一般的な例については、XSL カスタマイズの一般的な例を参照してください。

1. ユーザー識別ページで (ユーザーサービスの管理参照)、ユーザーIDのスキャンまたはユーザーの検索フィールドでユーザーの名前を入力し、進むを選択します。ユーザーサービスページが表示されます。

2. アイテムのバーコードをスキャンフィールドで、アイテムのバーコードを入力し、OKを選択します。アイテムのリストは貸出タブに表示されます。

3. XML 出力をEメールで送信するには、 アクティビティの送信を選択します。

4. XML出力をEメールからXMLファイル (BorrowingActivityLetter.xmlなど) にコピーして貼り付けます。

1.  借用アクティビティレターのレター設定ページで、(XML ペイン内の) XSL ファイルを編集します。

2. 以前作成したXMLファイルを使用して、図書館名を含むフィールドのパス名全体を決定します。

   
   XML出力における図書館名フィールド
   上の図に組み込まれた要素に基づく図書館名へのパス全体は次の通りです：
   /notification_data/overdue_loans_by_library/library_loans_for_display/item_loans/overdue_and_lost_loan_notification_display/item_loan/library_name
3. XSLファイルで@@loans@@プレースホルダを検索し、下記に太字で示すxsl:if節を追加します：
   を選択します。を選択します。を選択します。
   <xsl:if test="notification_data/item_loans/item_loan">
   <xsl:if test="notification_data/item_loans/item_loan/library_name='Main Library'">
   <center>
   <span style="font-family:Arial; font-weight:bold">
   <FONT COLOR="#FF0000">
   <br></br><b> 貸出期限を確認するには、所属する図書館にログインしてください。</b>
   </FONT>
   </span>
   </center>
   </xsl:if>
   <tr>
   <td>
   <b> @@loans@@ </b>
   </td>
   </tr>
   .を選択します。を選択します。
   Almaは、プレースホルダーを、関連するレターのコードテーブルで定義されているラベル/翻訳に置き換えます。

4. XSLファイルを編集している最中に、貸出一覧にタイプ列を追加します。 XSLファイルの@@loans@@プレースホルダーの下に、次の図に示すように太字のテキストを追加します。

5. 保存を選択します。
6. 前に作成したXMLファイルをアップロードすることで、XSLファイルへの変更をテストします (テスト用のサンプルレターの更新とプレビューを参照) 。

システム通知とレターにおけるユーザーの好みの名前の使用の扱い

名前の情報を組み込んだシステム通知とレターには、ユーザーの好みの名前を使用するようにアップデートできるものがあります。通知理由レターのXSLなど、名前の情報を組み込んだシステム通知およびレターの場合、preferred_first_name、preferred_middle_name、preferred_last_nameを使用して好みの名前を指定できます。下記の例を参照してください：

コンポーネントの設定ページへのアクセス

「コンポーネントの設定」ページで、レター間で共有されるテンプレートとその他のコンポーネントをカスタマイズできます (設定メニュー > 一般 > レター > コンポーネント設定)。レターと同様に、コンポーネントはラベル (静的テキストの文字列) とテンプレート (フォーマットおよび動的データ用のXSL スタイル シート) で構成されます。 

コンポーネントの ラベルの設定

コンポーネントテンプレートのカスタマイズ

コンポーネントリスト

レターテンプレートの概要

テスト用のサンプルレターの使用 

1. [設定] > [一般] > [レター] > [レター設定]に移動します。

2. 関連するレターの行アクション メニューで編集を選択します 。
3. レターサンプルボタンを選択します。
    
   
    
4. 必ずデフォルトレターが 1 つ表示されますが、以下で説明するようにさらに例を追加できます。

1. レターサンプルのページで、 システムレターから追加 ボタンを選択します。このレターがAlmaフローの一部として過去に送信されたことがない場合、システムレターから追加ボタンは表示されません。 
    
   
2. [送信済みレター] ページが表示され、過去7日間の最新のXMLが最大 10 件表示されます。
3. 追加するレターを選択します。
   
4. 選択したレターが「レターサンプル」ページに表示されます。
   
5. 保存を選択します。この文字は、XMLペインに表示される文字になります。 
6. ドロップダウンリストで関連する文字を選択することで、XMLペイン内の文字を切り替えることができます。
   
    

1. [レター設定] ページで、該当するレターについて、行アクションメニューの編集を選択します。
2. XML ペインで、ダウンロードボタンを選択します。
3. 関連する変更があれば、XML エディターでファイルを編集します。
    
   
   レターを XML ファイルとしてダウンロードする
     XML エディタの上にドロップダウンが導入され、利用可能な文字例 XML ファイルが全て表示されます。ユーザーは、このドロップダウンからオプションを選択することでファイルを切り替えることができます。選択すると、XML エディタの内容が選択したファイルの情報に置き換えられ、レターのプレビューが自動的に更新されます。

1. [レターサンプル] ページで、 レターサンプル (XML) をアップロードボタンを選択します。
    
   
    
2. XM ファイルを参照して選択し、 アップロードを選択します。
3. 追加された文字は、デフォルトプレビュー列で選択しない限り 、デフォルトプレビューーとしてマークされません。 

送信元アドレスの設定

以下で説明するように、送信元アドレスは、addressFromラベルまたは組織単位ページから設定できます。

統合プロファイルを使用したEnvelopeFromアドレスの設定

1. 統合プロファイルリストページ（設定メニュー > 一般 > 外部システム > 統合プロファイル）で、統合プロファイルを追加を選択します。Almaで定義できるメール処理用の統合プロファイルは1つだけです。メール処理用の統合プロファイルがすでに存在する場合にプロファイルを編集するには、その行のアクションリストで編集を選択します。
   
2. そのプロファイルの独自のコードと名称を入力します。
3. 統合タイプのフィールドでメール処理を選択します。
4. 次を選択します。ウィザードの2ページ目が表示されます。デフォルトではアクティブが選択されています。
   
   
5. Almaのメールサーバーを継続して使用するには：
   1. Ex Librisから直接送信を選択します (デフォルトで選択されています)。
   2. SMTP  EnvelopeFrom アドレスに有効な電子メールアドレスを入力します。
6. 貴機関のメール中継サーバーを使用するには：
   1. 機関のメール中継を使って送信を選択します。いくつかの追加フィールドが表示されます。
   2. 機関のドメイン名を入力してください。入力すると、ドメイン名がSMTP EnvelopeFromアドレスフィールドの後に@<ドメイン名>として表示されます。ドメイン名には、最大63文字の英数字 (小文字)、ダッシュ (-)、およびピリオドを含めることができ、その後にはピリオドと2〜6文字の英字 (小文字) のトップレベルドメインを含めることができます。
   3. 機関のSMTPメール中継ホスト名を入力します。ホスト名には、英数字 (小文字) に加えて、文字も含めることができます - !# $ % & ' * + / = ?^ _ ` { | } ~ および、ピリオドを含めることができます。
   4. デフォルトでは、カスタムSMTP EnvelopeFromアドレスが選択されています。このオプションの下のラベルのないフィールドにアドレスのユーザー名を入力します。これにより、EnvelopeFromが<username>@<domain name>に設定されます。ユーザー名には、SMTPメール中継ホスト名と同じ文字を含めることができます。
   5. メール中継でEx LibrisからのEメールを受け入れるためにユーザー名とパスワードが必要な場合は、ユーザー名とパスワードを入力します。これらは、任意のASCII文字にすることができます。
   6. メール中継に暗号化が必要な場合は、暗号化を使用を選択します。
      暗号化ポートは587に設定されています。
7. MS Graph APIを使用してメールを送信するには、[MS Graph APIを使用して送信] を選択し、 表示される追加のフィールドに入力します：
   • テナントID - 組織に定義された Azure ID
   • クライアントID- 電子メールを送信するために Alma に与えられた Azure ID  
   • クライアント シークレット - ユーザーを認証するために Azure によって生成されたパスワード
   • ユーザーID - 電子メールの送信用に定義された Azure ユーザー
     
     詳細については、[ Microsoft ID プラットフォーム にアプリケーションを登録する]を参照してください。
8. [保存]を選択します。

メールリレーとサポートドメインキー識別メール（DKIM）に関するAlmaの推奨事項 

SMTP サーバーが電子メールを受信すると、その電子メールが正当なものか疑わしいものかを判断するためにいくつかのセキュリティチェックが行われます。電子メールが不審としてマークされると、SMTP サーバーは電子メールの配信を遅らせたり、電子メールを「スパム」としてマークしたり、電子メールをまったく配信しなかったりする可能性があります。この記事では、Ex Libris クラウドからのメールが疑わしいものとしてマークされないようにする方法について説明します。

電子メールは、次の2つの方法のいずれかでEx Libris製品から送信できます。

1. 「差出人アドレス」ドメインが @exlibrisgroup.com の場合

2. ブランド化された「差出人アドレス」 (例: @institution.edu)

DKIM は現在、上記の両方の方法でサポートされています。@exlibrisgroup.com の「差出人アドレス」ドメインを使用してクラウドから送信された電子メールは、DKIM を使用して署名されており、Ex Libris には DMARC ポリシーがあるため、不審としてマークされるべきではありません。SMTP エンベロープの「From アドレス」と「header.from アドレス」の両方で同じドメインを使用する必要があることに注意してください。SMTP エンベロープの送信元アドレスはメール処理統合プロファイルで構成され、header.from アドレスは送信される個々のレターで構成されます。送信メールの構成の詳細については、こちらをご覧ください。

カスタムドメインを使用して DKIM 準拠のセットアップを行う場合、推奨される方法は、Alma メール統合プロファイルを「機関メールリレーを使用して送信」オプションで設定し、機関メールリレーにDKIM を実装 する方法です。 

Ex Libris から送信され、その機関のドメインでブランド化された電子メールは、次の2つの方法で安全に実装できます。

1. Ex Librisアプリケーションを設定して、電子メールを機関のSMTPサーバーに直接渡し、機関のポリシー (DKIM + DMARC) に従って認証されるようにします。

   電子メールを外部 SMTP サーバーに渡すように Alma プラットフォームを設定するには、こちらのドキュメントの「メール処理統合プロファイルの設定」を参照してください。教育機関のファイアウォールポリシーによっては、IT部門が Ex Libris クラウドから関連するポートの SMTP サーバーへのアクセスを開く必要がある場合があります。Alma、Primo VE、およびPrimo Classic の送信IP範囲はこちらで 確認できます。

2. Ex Libris クラウドから電子メールが送信され、「送信者ポリシーネットワーク」(SPF) と DKIM を使用して認証されるように電子メールを設定します。

   SPF は、Ex Libris クラウドが教育機関に代わって電子メールを送信できるようにする方法です。SMTP サーバーが電子メールを受信すると、電子メールを送信したIPが「送信元アドレス」ドメインのDNSレコードにリストされているIPと比較されるセキュリティチェックが実行されます。SPFを構成するには、教育機関のDNS管理者がEx Libris メールリレー IP をTXT レコード内の教育機関のドメインに追加する必要があります。Ex Libris メールリレー IP は顧客の地域により異なるため、関連する「SPF インクルードエントリ」を選択する必要があります。さまざまな地域の異なる「SPFインクルードエントリ」はこちらで見つけることができます。

   DKIM (DomainKeys Identified Mail) は、電子メール内の不正な送信者アドレスを特定するために特別に設計された電子メール認証方法として機能し、電子メールのなりすましの問題に対処します。DKIM 機能が教育機関で有効になると、メール処理統合プロファイルに送信電子メールの DKIM デジタル署名のサポートが含まれるようになります。  設定手順はこちらでご確認ください。

詳細については、 送信メールの設定を参照してください。 

1. マークDKIM 設定 チェックボックス。これによりキーが作成されます 公開鍵をEx Libris DNSにアップロードします。あ  CNAME の詳細を示すポップアップ ウィンドウが表示されます。

2. ダイアログ ウィンドウから CNAME をコピーし、IT 部門に渡して DNS に追加してもらいます。

3. IT部門がDNSに追加したら、 DKIM DNS設定のテスト それをテストするオプション。 テストに合格すると、成功メッセージが表示されます。何らかの理由でテストが失敗した場合は、失敗の詳細を示すメッセージが表示されます。 

4. テストが成功したら、 DKIM アクティブ チェックボックス。この時点から、送信メールには DKIM 署名が含まれるようになります。