特定のコースの特定の orgUnit ID を見つけるための API 呼び出しは何ですか? API から成績とクラス リストを取得しようとしていますが、orgUnitID がないとできません。
1 に答える
ユースケースの種類に応じて、いくつかの方法が考えられます。まず、組織構造をたどって、探しているコース オファリングの詳細を見つけることができます。組織のノード (ルート組織) から開始し、ルートを使用して組織の子孫を取得し、下に向かって作業します。この呼び出しをコース提供タイプのノード (デフォルトでは組織ユニット タイプ ID '3') のみに制限する必要があります。 )。このプロセスでは、ほぼ確実に、大量のデータを取得してから解析する必要があります。
コース オファリングのコード(組織がコース オファリングを定義するために使用する一意の識別子) または名前がわかっている場合は、それらの値と照合することにより、子孫のリストでオファリングを見つけることができます。
この検索は、さまざまな方法でより狭い範囲で行うこともできます。
コース オファリングに関連する構造内のノード (たとえば、コース オファリングの親である部門または学期) の組織単位 ID が既にわかっている場合は、そのノードから検索を開始できます。解析するノードがはるかに少なくなります。
呼び出し元のユーザー コンテキスト (または、既知で認証可能なユーザー コンテキスト) がコース オファリングまたは既知の親組織 (部門など) に登録されている場合、そのユーザーのすべての登録のリストを取得できます。それらを解析して、探している単一のコース オファリングを見つけます。(この登録ルートは、単純な JSON 配列としてではなく、ページ化された結果セットとしてデータを返すことに注意してください。そのため、必要なデータ ページを見つける前に、いくつかのデータ ページを処理するために複数の呼び出しを行う必要がある場合があります。)
これらすべてのシナリオで、プロセスは最終的に、組織単位 ID を含む JSON 構造を取得することになります。この構造は、後で保持して直接使用できます。