Learn365では、 Learn365 API を通じて、ユーザーに認定証を付与することができます。

ここでは、Learn365 API を通じて、ユーザーに認定証を付与する方法について説明します。

この方法、たとえば、受講者が既に完了しているトレーニングに、認定証の設定が追加された場合、などに有効です。

Learn365 API を通じた認定証の付与は、以下の手順に沿って行います。

1．https://api.365.systems/  にアクセスし、API キーで認証します。

2．Certificates セクションに移動し、POST /odata/v2/Certificates Create a Certificate  を選択し、右上の「Try it out」をクリックします。

3．パラメータを設定します。

「Edit Value」フィールドで、以下を入力します。

• "Id": "guid"：IDは、認定証が付与された後に取得されるため、このパラメータはフィールドから削除します。
• "CourseId": "guid"＊：「guid」 を認定証に関連するコースの ID に置き換えます。このパラメータは必須です。
• "ContentUrl": "string"：ContentUrl は、認定証が付与された後に、Learn365によって生成されるため、このパラメータはフィールドから削除します。
• "IsGenerated": "boolean"：IsGenerated は、テンプレートから認定証が生成された後に、Learn365 によって値が入力されるため、このパラメータはフィールドから削除します。
• "Status": "integer"：認定証のステータスを設定するには、「integer」を次のいずれかに置き換えます。このパラメータは任意です。
  • 0：有効
  • 1：期限切間近
  • 2：期限切れ
• "Issued": "2023-07-31T05:32:05Z"＊：認定証の発行日です。既定では、現在の日付と時刻が自動的に入力されています。手動で任意の日時に変更できます。このパラメータは必須です。
• "Expiry": "2023-07-31T05:32:05Z"：認定証の有効期限です。既定では、現在の日付と時刻が自動的に入力されています。手動で任意の日時に変更できます。
• "TemplateId": "guid"：認定証用のPDFファイルを生成する場合＊、このパラメータは必須です。「guid」を、認定証の生成に使用する認定証テンプレートの ID に置き換えます。 生成しない場合は省略できます。
• "UserId": "guid"＊：「guid」 を認定証を付与するユーザーの ID に置き換えます。 このパラメータは必須です。
• "UserLoginName": "string"：このパラメータは任意です。「string」をユーザーのログイン名に置き換えます。ユーザーのログイン名は、UserId の取得時に同じResponse body で見つけることができます。

4．「Execute」を選択してリクエストを実行します。

5．Responses ブロックで結果を確認します。

• Code の下の2xx（202など）は、リクエストが正しく動作したことを示します。
• Response body では、設定されたパラメータを持った認定証が付与されたことが確認できます。 ”value” パラメータの値は、付与された認定証のユニークな ID です。
  この認定証は、Learn365 管理センターでユーザーの受講履歴や、進捗で確認することができます。
• Downloadオプションを使用して、APIリクエストの結果を JSON フォーマットでローカルデバイスに保存できます。