学生情報システム

統合プロファイルのユーザータイプを設定します。SIS同期を手動で実行および監視します。

Translatable
学生情報システム(SIS)プロファイルを設定するには、次の役職が必要です。
  • 統括システム管理者

Almaは、学生情報システム(SIS)との間でユーザーをエクスポート/インポートできます。

ユーザーをインポートするには、SISはXMLファイルを含むzipファイルをすべてのユーザーとともに定義済みのS/FTPロケーションに配置する必要があります。Almaは、SIS統合プロファイルで定義されたパラメータに従って、ファイルを取得し、情報を解析し、ユーザー(外部タイプ)をアップロードします。

  • すべてのプライマリ識別子と追加の識別子は、同じユーザーを含め、ユーザーに対して一意である必要があります。
  • User data must be included in a zip file for import and synchronization purposes.
  • 「ファイルを解析できませんでした」というエラーが発生した場合は、スキーマに従って XMLファイルを圧縮してみてください。

ユーザーをSISにエクスポートしたい場合があります。たとえば、図書館への債務があるユーザーや特定のブロックを持っているユーザーなどです。これにより、SISは、これらのユーザーが図書館に対する未払いの債務を解消するまで、特定のアクティビティをブロックできます。

背景情報

For a detailed overview of user management in Alma, see https://developers.exlibrisgroup.com/alma/integrations/user-management.Almaの実装を開始する前に、外部認証システムが稼働している必要があることに注意してください。

For details on SIS integration, see https://developers.exlibrisgroup.com/alma/integrations/user-management/sis

For overview on user management and SIS integration, watch Creating and Updating User Records(5:06).

Configuring an Integration Profile

To configure an integration profile to a Student Information Systems (SIS):
  1. 統合プロファイルリストページ(設定メニュー > 一般 > 外部システム > 統合プロファイル)で、統合プロファイルを追加を選択します。統合プロファイルウィザードの最初のページが表示されます。

    users_integration_profile_1_ux_newUI.png

    ユーザー統合プロファイルウィザード-ページ1
  2. ウィザードの最初のページで、次の情報を入力します。
    1. 定義するプロファイルのコードと名前を入力します。
    2. 統合タイプドロップダウンリストから、ユーザーを選択します。
    3. S/FTP接続タイプドロップダウンリストから、過去に定義したFTP接続の名前を選択します。
    4. Indicate the type of SIS with which you are integrating (for Ex Libris' informational purposes).これは必須です。
    5. 任意で、設定しようとしている統合の説明を入力します。
    6. 次へを選択します。ウィザードの2ページ目が表示されます。

      Integration Profile page_newUI.png

  3. ウィザードの2ページ目で、次の情報を入力します。
    ユーザー統合プロファイルのフィールド
    セクションフィールド説明
    Import (used for the initial import of users.一致するレコードが見つかった場合、レコードはインポートされません。これを1回、または1年に1回手動で実行します。その後、 同期セクション/ジョブを使用します。)有効ジョブがアクティブな場合、選択したスケジュールオプションに従ってジョブが実行されます。非アクティブの場合、実行されません。

    このジョブはユーザーが<integration profile name>を使用してインポートと呼ばれます。

    レコード種別

    The type of user record to create in Alma:Contact,Public, or Staff.

    各SISプロファイルは、1つのタイプのユーザー(スタッフまたは公開)をロードします。別のユーザータイプを処理するには、別のSISプロファイルを定義する必要があります。If your institution has more than one type of user in a single SIS, it is recommended that you define the Record type in the profile as Public.これは、すべてのユーザーが公開ユーザーとしてAlmaで作成されることを意味します。その後、ユーザー役職を使用して、ユーザーとスタッフを区別できます。

    For more information on selecting the record type, see https://developers.exlibrisgroup.com/alma/integrations/user-management/sis/synch.

    入力ファイルパスセキュアFTP接続の作成時に指定されたパスのサブディレクトリ(必須)。For example, if you enter Alma in the Sub-directory field during secure FTP connection configuration (note that it is mandatory to specify a value in this field) and you enter SIS_import in the Input file path field, the SIS files are imported from the Alma/SIS_import directory (under the root FTP directory).
    ユーザーXSD版バージョン1または2を選択します。2を使用する必要があることに注意してください。For detailed information about these versions, see https://developers.exlibrisgroup.com/alma/integrations/user-management/sis/synch.
    XSLコンバータSelect an XSL converter to process the Integration Profile XML files with XSL before placing them in the output location.コンバータの管理を選択し、コンバータを表示および編集します。For details, see Integration XSL Converters.
    Create Sample File (available when editing an existing profile)既存のユーザーを選択し、サンプルファイルを作成を選択して、既存のユーザーから新しいユーザーXMLファイルを作成します。これにより、ユーザーXMLファイルの構成方法をプレビューできます。
    You can also view a sample XML file on https://developers.exlibrisgroup.com/alma/apis/xsd/external_sys_user.xsd.Note that XML attributes are case-sensitive.
    Synchronize Used for ongoing synchronization of existing Alma users.一致するレコードが見つかった場合、Almaは情報を統合しようとします。Note that the mandatory fields in the User Registration Form also apply when creating new user accounts via this job, but not when updating existing accounts- see Managing Patron Services.有効ジョブがアクティブかどうか。ジョブがアクティブな場合、選択したスケジュールオプションに従ってジョブが実行されます。非アクティブの場合、実行されません。

    このジョブの名前はユーザーが<integration profile name>を使用して同期です。

    レコード種別

    The type of user record to create in Alma:Contact,Public, or Staff.

    各SISプロファイルは、1つのタイプのユーザー(スタッフまたは公開)をロードします。別のユーザータイプを処理するには、別のSISプロファイルを定義する必要があります。If your institution has more than one type of user in a single SIS, it is recommended that you define the Record type in the profile as Public.これは、すべてのユーザーが公開ユーザーとしてAlmaで作成されることを意味します。その後、ユーザー役職を使用して、ユーザーとスタッフを区別できます。

    For more information on selecting the record type, see https://developers.exlibrisgroup.com/alma/integrations/user-management/sis/synch.

    IDタイプの照合既存のAlmaユーザーと照合する識別子として使用する、Almaで事前定義された一意の識別子タイプ。For detailed information on match IDs, see https://developers.exlibrisgroup.com/alma/integrations/user-management/sis/synch.
    同期タイプすべてを交換 、これは、既存のすべてのユーザーレコードが、一致する着信ユーザーレコードに置き換えられることを意味します。For detailed information on the synchronization workflow, see https://developers.exlibrisgroup.com/alma/integrations/user-management/sis/synch.
    一致しないレコード一致するレコードが見つからなかった場合にAlmaが新しいユーザーレコードを追加するか、または一致するレコードが見つからなかった場合に着信レコードを拒否するか。デフォルトでは、レコードが追加されます。
    入力ファイルパスセキュアFTP接続の作成時に指定されたパスのサブディレクトリ(必須)。たとえば、セキュアFTP接続設定中にサブディレクトリフィールドにAlmaを指定し(このフィールドの値を指定することが必須であることに注意してください)、入力ファイルパスフィールドにSIS_importと入力した場合、SISファイルはAlma/SIS_importディレクトリ(ルートFTPディレクトリの下)にインポートされます。
    スケジュール未スケジュールを選択した場合、ジョブは、手動で実行した場合にのみ実行されます。For details, see the following sections Manually Importing/Exporting SIS Information and Manually Synchronizing SIS Information.

    利用可能なスケジューリングオプションは、データセンターによって異なります。

    ユーザーXSD版バージョン1または2。バージョン2を使用する必要があることに注意してください。For detailed information about these versions, see https://developers.exlibrisgroup.com/alma/integrations/user-management/sis/synch.
    XSLコンバータSelect an XSL converter to process the Integration Profile XML files with XSL before placing them in the output location.コンバータの管理を選択し、コンバータを表示および編集します。For details, see Integration XSL Converters.
    以下に使用される統合プロファイル(Esploroのみ)Esploroが機関で有効になっている場合にのみ表示されます。

    以下のうちの一つを選択してください:

    • ユーザーと研究者–ファイルにユーザーと研究者の両方の情報を含める場合。
    • ユーザーのみ–ファイルにユーザー情報のみ(研究者フィールドなし)を含める場合。
    • Researchers only – If you wish to add or update only the researcher information of the user.各ユーザーは既存のAlmaユーザーのプライマリ識別子を含める必要があり、ファイルに含まれる他のユーザー情報はローダーによって追加またはアップデートされないことに注意してください。You can load researcher identifiers as part of the Researchers Only option.For more information, see Adding Researchers.

    The synchronization is performed in swap all mode, which means that all of the existing information is replaced.入力ファイルにフィールドが存在しない場合は、既存のユーザーまたは研究者から削除されます。Therefore, the input file must always include all of the external information for the user or researcher, not only the updated fields.

    ユーザーへの研究者フィールドの選択(Esploroのみ)Esploroが機関で有効になっている場合にのみ表示されます。

    以下のうちの一つを選択してください:

    • すべての研究者フィールド
    • 選択した研究者フィールド–これを選択すると、表示されるクイックピックリストから更新する1つ以上のフィールドを選択します。
    Export User By Conditions (used to export users that should be blocked due to unpaid fines)

    エクスポートされるユーザーには、閾値を超える罰金を持つユーザー、および、設定されたブロックタイプまたは設定されていない場合はすべてのブロックに基づき、ブロックがあるユーザーが含まれます。ユーザーの罰金が閾値ORを超えている場合、またはユーザーにブロックがある場合、ユーザーはエクスポートされます。

    アクティブジョブがアクティブかどうか。ジョブがアクティブである場合、選択したスケジュールオプションに従って実行されます。非アクティブの場合、実行されません。

    このジョブはユーザーが<integration profile name>を使用してエクスポートと呼ばれます。

    ユーザーIDタイプ上記のIDタイプの照合の説明を参照してください。
    ユーザーグループエクスポートするユーザーが属するユーザーグループ。値が指定されていない場合、構成されたユーザーグループのいずれかに属するユーザーがエクスポートされます。
    ブロックタイプThe previously defined block types (see Configuring Block Preferences) whose associated users you want to export.値が指定されていない場合、設定されたブロックタイプのいずれかに一致するユーザーがエクスポートされます。
    罰金/手数料年齢(日数)罰金/手数料の日数が指定された日数よりも古い(選択したグループおよび選択したブロックタイプの)ユーザーがエクスポートされます。デフォルトでは、この数は0です。
    閾値金額罰金/手数料が指定された閾値を超える(選択したグループおよび選択したブロックタイプの)ユーザーがエクスポートされます。デフォルトでは、閾値は0です。
    アクティブな貸出の存在するユーザーアクティブな貸出を持つユーザーのみを含めるには、このチェックボックスをオンにします。
    アクティブな貸出タイプアクティブな貸出を持つユーザーを選択すると、このフィールドが表示されます。貸出タイプが選択した貸出タイプと一致する場合、アクティブな貸出のあるユーザーがエクスポートに含まれます。
    出力ファイルパスS/FTP接続の作成時に指定されたパスのサブディレクトリ。たとえば、S/FTP接続設定中に サブディレクトリフィールドにAlmaと指定し、出力ファイルパス にSIS_expoortと入力すると、このSISファイルは Alma/SIS_export ディレクトリ(ルートFTPディレクトリの下)にエクスポートされます。
    スケジュール未スケジュールを選択した場合、ジョブは、手動で実行した場合にのみ実行されます。For details, see the following sections Manually Importing/Exporting SIS Information and Manually Synchronizing SIS Information.

    利用可能なスケジューリングオプションは、データセンターによって異なります。

    Export Users (used to export old, inactive, or deleted users, or recently updated/created users - not for an ongoing full export of users)有効ジョブがアクティブかどうか。ジョブがアクティブである場合、選択したスケジュールオプションに従って実行されます。非アクティブの場合、実行されません。

    このジョブはユーザーが<integration profile name>を使用してEXPORT_USERSと呼ばれます。

    ユーザーグループ1つ以上のユーザーグループを選択して、エクスポートの対象となるユーザーレコードを識別します。
    作成からの日数エクスポートにユーザーレコードを含めるタイミングを識別する条件を日数で設定します。このパラメータは、ユーザーレコードがAlmaで作成されてからの日数を示します。この基準を満たすユーザーレコードをエクスポートするには、エクスポートするユーザーレコードが、ユーザーグループパラメータで選択されたユーザーグループの1つのメンバーである必要もあります。

    たとえば、ここで10を指定すると、過去10日間に作成されたユーザーレコードがエクスポートに含まれます。

    更新からの日数エクスポートにユーザーレコードを含めるタイミングを識別する条件を日数で設定します。このパラメータは、ユーザーレコードがAlmaで更新されてからの日数を示します(作成からの日数の例を参照)。この基準を満たすユーザーレコードをエクスポートするには、エクスポートするユーザーレコードが、ユーザーグループパラメータで選択されたユーザーグループの1つのメンバーである必要もあります。
    削除からの日数エクスポートにユーザーレコードを含めるタイミングを識別する条件を日数で設定します。このパラメータは、ユーザーレコードがAlmaで削除されてからの日数を示します(作成からの日数の例を参照)。この基準を満たすユーザーレコードをエクスポートするには、エクスポートするユーザーレコードが、ユーザーグループパラメータで選択されたユーザーグループの1つのメンバーである必要もあります。
    出力ファイルパスセキュアFTP接続の作成時に指定されたパスのサブディレクトリ。たとえば、セキュアFTP接続の設定中にサブディレクトリフィールドでAlmaを指定し、出力ファイルパスフィールドにSIS_Exportと入力すると、ファイルはAlma/SIS_Exportディレクトリ(ルートFTPディレクトリの下)にエクスポートされます。
    スケジュール未スケジュールを選択した場合、ジョブは、手動で実行した場合にのみ実行されます。For details, see the following sections Manually Importing/Exporting SIS Information and Manually Synchronizing SIS Information.

    利用可能なスケジューリングオプションは、データセンターによって異なります。

    ユーザーXSD版バージョン1または2。バージョン2を使用する必要があることに注意してください。For detailed information about these versions, see https://developers.exlibrisgroup.com/alma/integrations/user-management/sis/synch.
    Online Import(Used to import users from a student management system)

    Not in use!

    有効機能がアクティブかどうか。機能がアクティブな場合、プロセスは学生管理システムにアクセスして、ユーザーの情報があればそれを取得します。機能がアクティブでない場合、プロセスは実行されません。デフォルトは非アクティブです。
    基本URLユーザーの変更に関するAPIコールの送信先であるホスト/ポート。オンラインインポートアクションがアクティブの場合は必須です。Note that this should be a REST API which has user information in the format described on the Developer Network.
    ユーザー名HTTP基本認証資格情報のユーザー名。任意。空欄のままにすると、要求は資格情報なしで送信されます。
    パスワードHTTP基本認証資格情報のパスワード。任意。空欄のままにすると、要求は資格情報なしで送信されます。
  4. 保存を選択します。プロファイルが保存されます。
  5. プロファイルを編集するとき、連絡先情報タブが表示されます。Note that the contact details entered on this tab are for information purposes only (see Adding User Contact Information).Users can also be configured to receive email notifications that are sent after a scheduled job runs.Almaユーザーや手動で入力したEメールアドレスに送信される通知を設定できます。For information, see Configuring Email Notifications for Scheduled Jobs.
作成した統合プロファイルに基づいてユーザーのエクスポートジョブが実行されると、エクスポートプロセスにより、インポートアクションと同期アクションで使用されるフォーマットでXMLファイルが作成されます(保存した統合プロファイルのアクションタブのアクションセクションで定義されている、インポートセクションと同期セクションを参照)。XSLファイルを使用して、フォーマットを変更できます。The XSL file is available and customizable in Customize Letters (see Configuring Alma Letters).

SIS情報の手動インポート/エクスポート

SISインポート/エクスポートを手動で実行および監視するには:

プロファイルを編集する際、 アクションタブのインポート/エクスポートセクションで、アクティブラジオボタンが選択されていることを確認し、実行を選択します。

ジョブは、Almaがそれを受け入れることができるとすぐに実行されます。インポートされたファイルは、再度実行されないようにマークされます。AlmaでEメール通知が有効になっている場合、インポートのEメール通知を受信し、Almaは通知をエクスポートのSISに送信します。

ジョブのステータス、処理されたファイルの数、およびその他のデータを表示するには、統合プロファイルリストページで、適切なユーザー・プロファイルの行のアクションリストでジョブ履歴を選択します。

ステータス正常に完了は、すべてのファイルが正常にインポートまたはエクスポートされたことを意味するものではありません。そうではなく、単にジョブがエラーなしで完了したということを意味します。

プライマリ識別子が既存のユーザーの一人のプライマリ識別子と一致するユーザーをインポートする場合は、識別子に基づきユーザーを拒否イベントが生成されます。

ユーザー同期では、Almaは5%の失敗率でのみアラートを出します。拒否されたユーザーの数が処理されたユーザーの総数の5%未満の場合、ジョブは「正常に完了しました」としてマークされます。

SIS情報の手動同期

SIS同期を手動で実行および監視するには:

プロファイルを編集するには、アクションタブの同期セクションで、実行を選択します。

同期ジョブは、Almaがそれを受け入れることができるとすぐに実行されます。同期されたファイルは、再度実行されないようにマークされます。AlmaでEメール通知を有効にしている場合、Eメールで通知を受け取ります。

ジョブのステータス、処理されたファイルの数、およびその他のデータを表示するには、統合プロファイルリストページで、適切なユーザー・プロファイルの行のアクションリストでジョブ履歴を選択します。

ステータス正常に完了は、すべてのファイルが正常に同期されたことを意味するものではありません。そうではなく、単にジョブがエラーなしで完了したということを意味します。

同期のためにAlmaにインポートするファイルが複数ある場合、ファイルはzipファイルに保存されている順序で読み取られます。ユーザーがファイルに複数回表示された場合、ユーザーの最初のインスタンスが処理されます。ユーザーの残りの重複レコードはすべてエラーになります。

For more information on the synchronization process, see https://developers.exlibrisgroup.com/alma/integrations/user-management/sis/synch.