Apple School Manager CSV のデータエラーへのパッチの適用

SIS から Apple School Manager にデータをインポートする場合、CSV ファイルにエラーが含まれている場合があります。Claris Connect を使用してエラーのある CSV ファイルを Apple School Manager にアップロードする場合、フローの実行は正常に終了する可能性がありますが、Apple School Manager への同期は失敗し、SIS データは同期されません。エラーを引き起こすデータを変更することで、こうしたエラーを回避できる場合があります。これを行うには、Apple School Manager コネクタが提供する Patch Apple School Manager CSV data アクションを使用できます。

メモ 

  • Patch Apple School Manager CSV data アクションは SIS からインポートされた後にデータを変更します。SIS のデータを直接変更することはありません。

  • このアクションを使用してデータにパッチを適用することは一時的な解決策です。このアクションで変更されるデータは Apple School Manager にデータを同期する後続のフロー実行の前に SIS で適切に修正する必要があります。そうでない場合、不完全なデータの同期が続行されます。

Patch Apple School Manager CSV data

Patch Apple School Manager CSV data アクションは Apple School Manager の ZIP ファイルの検証ステップで検出された検証エラーを探します。Apple School Manager 形式の CSV ファイルのデータを変更してエラーを一時的に修正することで Apple School Manager への同期が正常に完了しやすくなります。

検証エラーのシナリオ

  • Classes テーブル (classes.csv) の教師 ID (instructor_id) は Staff テーブル (staff.csv) のスタッフ ID (person_id) と一致しません。

  • Rosters テーブル (rosters.csv) のレコードには Classes テーブル (classes.csv) のどのクラス (class_id) とも一致しないクラス (class_id) があります。

これらのシナリオに基づいて、次のパッチオプションの 1 つ以上をオンにしてエラーに対処できます:

オン 目的
Patch instructor errors in the Classes table staff.csv のいずれの person_id とも一致しない場合は、class.csv から instructor_id を取り除く
Patch Roster class record errors

classes.csv のいずれの class_id とも一致しない class_id を持つ rosters.csv のレコードを取り除く
Patch Roster student record errors students.csv のいずれの person_id とも一致しない student_id を持つ rosters.csv のレコードを取り除く
Prevent duplicate Apple School Manager records

インポートするユーザレコードの選択されたフィールドが Apple School Manager の既存のユーザのフィールドと一致する場合、インポートするユーザデータは異なる Person ID を持っていても新しいレコードを作成する代わりに既存のユーザデータを更新します。

一致するフィールド:

  • First name

  • Middle name

  • Last name

  • Location ID

  • Person number

  • Email address

  • SIS username

  • Grade level

Patch Apple School Manager CSV data アクションはこれらのシナリオで 1 つ以上の CSV データをスキャンし、それに応じてデータを変更します。このアクションでデータが変更された後、変更された CSV を含む新しい ZIP ファイル、および変更を記載したレポートをこのステップの [History] タブで使用できます。次の「ダウンロードできるファイル」を参照してください。

ダウンロードできるファイル

Patch Apple School Manager CSV data アクションによって 2 つのファイルが生成されます:

  • Modified CSV data (.zip) - 変更された CSV データを含む新しい ZIP ファイルが含まれています。

    メモ  データセキュリティのため、新しい ZIP ファイルは 72 時間のみ使用できます。

  • Report (.txt) - データに加えられた変更が記載されています。レコードの変更は関連付けられているテーブルごとにグループ化されます。たとえば、Rosters テーブルから取り除かれた classes はグループ化されます。

これらのファイルをダウンロードするには:

  1. フローの [History] タブに移動します。

  2. 表示するフロー実行をクリックします。

  3. 「Patch CSV data」行で、[View report] をクリックします。

  4. 次のいずれかの操作を行います:

    • [Modified CSV data (.zip)] をクリックして変更された CSV データを含む新しい ZIP ファイルをダウンロードします。

    • [Report (.txt)] をクリックしてレポートをダウンロードします。

レポートの例

この例では、次のオプションをオンにしてレポートが生成されました:

  • Patch instructor errors in the Classes table

  • Patch Roster record errors

'Start patching CSV data...',
'[classes.csv] Start patching Classes...',
'[classes.csv] Finished patching Classes.',
'[rosters.csv] Start patching Rosters...',
'[rosters.csv] Line 2: Found field class_id [133] that is not in file: classes.csv',
'[rosters.csv] Removing record',
'[rosters.csv] Line 4: Found field class_id [11] that is not in file: classes.csv',
'[rosters.csv] Removing record',
'[rosters.csv] Line 6: Found field class_id [133] that is not in file: classes.csv',
'[rosters.csv] Removing record',
'[rosters.csv] Line 7: Found field class_id [133] that is not in file: classes.csv',
'[rosters.csv] Removing record',
'[rosters.csv] Line 8: Found field class_id [133] that is not in file: classes.csv',
'[rosters.csv] Removing record',
'[rosters.csv] Updated Rosters',
'[rosters.csv] Finished patching Rosters',
'Finished patching CSV data'

このレポートでは、classs.csv のレコードには instructor_id のエラーがなかったため、レコードは変更されませんでした。ただし、rosters.csv の 5 つのレコードに classs.csv の class_id と一致しないクラス ID があったため、rosters.csv から取り除かれました。

関連項目