統合について

DataCampはSFTPを介したLMSとの統合をサポートしています。この統合では、DataCampのコンテンツカタログと学習イベントが、顧客のLMSが提供するSFTPサーバーに平坦なCSVファイルの形式で定期的に送信されます。LMSはこれらのファイルを使用して、内部カタログや進捗・完了記録を更新します。

コンテンツおよびイベントの同期プロセス

DataCampはLMSに対して完全なカタログを同期できます。これには、コース、プロジェクト、練習問題、評価、認定、スキルおよびキャリアトラック、カスタムトラックが含まれます。コース、プロジェクト、練習問題、評価、認定については、コンテンツの完了情報を同期できます。さらに、コースについては開始イベントも同期可能です。

同期間隔はカスタマイズ可能で、毎時、毎日、毎週、毎月の同期をサポートしています。さらに、同期が行われるタイムスタンプもニーズに合わせてカスタマイズできます。最初の同期を事前に計画することも可能です。

CSVファイル構造

LMSの多様性に対応するため、DataCampが送信するCSVファイルの内容は完全にカスタマイズ可能です。CSVファイルの構造はテンプレートで定義されており、Handlebars構文が使用されています。DataCampチームは、以下の利用可能なフィールドセクションにあるフィールドを基に、適切なテンプレートの設定をお手伝いします。

利用可能なフィールド

以下の表は、コンテンツCSVファイルで使用できるフィールドをまとめたものです。

名前	説明
一般	一般
contentType	アイテムのコンテンツタイプ、例：COURSE
id	DataCamp内のコンテンツアイテムの一意の識別子
xapiId	xApi統合で使用されるアイテムのIRI
title	コンテンツアイテムのタイトル。タイトルは「[title] - [contentType]」の形式で、例：「Wrangling and Visualizing Musical Data - Project」
description	コンテンツアイテムの説明
url	コンテンツアイテムへのURL
imageUrl	サムネイルのURI。技術（R、SQLなど）に基づくものが利用可能であればそれを使用し、なければDataCampのロゴ。svg、jpg、pngから選択可能
live	アクティブなコンテンツの場合は「true」、アーカイブされたコンテンツの場合は「false」に設定
technology	利用可能な場合、コンテンツアイテムの技術
updatedAt	アイテムが最後に更新されたタイムスタンプ
コース	コース
topic	コースのトピック。名前と説明で構成される
instructors	アイテムの講師リスト。各講師のfullNameで構成される
timeNeededInHours	アイテムの完了に必要な時間（時間単位）
includedInLicenses	コンテンツアイテムが含まれる製品
infoUrl	コンテンツアイテムの内部説明ページのURL
publicInfoUrl	コンテンツアイテムの外部ランディングページのURL
プロジェクト	プロジェクト
isGuided	ガイド付きプロジェクトか非ガイド付きか
topics	アイテムのトピックリスト。各トピックは名前と説明で構成される
instructors	アイテムの講師リスト。各講師のfullNameで構成される
timeNeededInHours	アイテムの完了に必要な時間（時間単位）
publicInfoUrl	コンテンツアイテムの外部ランディングページのURL
評価	評価
infoUrl	コンテンツアイテムの内部説明ページのURL
publicInfoUrl	コンテンツアイテムの外部ランディングページのURL
練習問題	練習問題
infoUrl	コンテンツアイテムの内部説明ページのURL
スキルおよびキャリアトラック	スキルおよびキャリアトラック
category	スキルトラックの場合は「Skill」、キャリアトラックの場合は「career」
content	トラックに含まれるコンテンツアイテムのリスト。各アイテムはcontentType、contentId、positionで構成される
includedInLicenses	コンテンツアイテムが含まれる製品
カスタムトラック	カスタムトラック
category	「custom」に設定
content	トラックに含まれるコンテンツアイテムのリスト。各アイテムはcontentType、contentId、positionで構成される
認定	認定
category	「career」、「technology」または「fundamentals」

以下の表は、学習イベントCSVファイルで利用可能なフィールドをまとめたものです。

名前	説明
contentId	イベントに関連するアイテムのDataCamp ID
contentType	完了または開始したアイテムのコンテンツタイプ
email	アイテムを完了または開始したユーザーのメールアドレス
nameid	利用可能な場合、アイテムを完了または開始したユーザーのnameid（IDPから送信）
timestamp	イベントが生成されたタイムスタンプ
eventType	イベントの種類（可能な値は「completion」または「started」）

SSOおよびディープリンク

DataCampから送信されるすべてのコンテンツアイテムにはURLがあり、これはいわゆるディープリンクです。シングルサインオンが有効で、DataCamp側で組織に対して必須に設定されている場合、これらのリンクは学習者を実際のDataCampコンテンツにリダイレクトする前に、IDプロバイダーへリダイレクトします。

同じIDプロバイダーでLMS側にもシングルサインオンが設定されている場合、LMSとDataCamp間でシームレスな体験が可能になります。学習者がすでにLMSにログインしていれば、DataCampのコンテンツアイテムを起動しても再度サインインする必要はありません。

フルファイルとデルタファイル

DataCampはSFTPを介してカタログとイベントを2つの方法で同期できます：フルファイルとデルタファイルです。

フルファイルを使用する場合、各同期で送信されるCSVファイルにはDataCampカタログのすべてのアイテムと組織のすべてのイベントが含まれます。この場合、LMSはまだ保存していないもののみを挿入し、保存済みのものがファイルに基づいて最新であることを確認する責任があります。

デルタファイルを使用する場合、この責任はDataCampにあります。コンテンツと学習イベントの最初のファイルは上記のフルファイルとなります。続く同期で送信されるファイルは前回の同期との差分（デルタ）となります。つまり、以下のみを含みます：

前回の同期以降に開始された新しいコンテンツアイテム；
前回の同期以降に更新された既存のコンテンツアイテム；
前回の同期以降に発生したイベント。

これらのファイルのいずれか一方を利用することもできますし、両方を毎回の同期に含めることも可能です。

ファイル命名

統合はファイル名を柔軟に設定できます。ファイルに固定名を付ける場合、同期中にアップロードされたファイルは前回の同期の既存ファイルを上書きします。柔軟な名前の場合は、ファイル名にタイムスタンプを含めることができます。このタイムスタンプはファイルが生成された日時です。現在、すべての一般的な日付・時刻形式をサポートしています。

ファイル暗号化

DataCampはPGP暗号化を使用してCSVファイルを暗号化して送信することをサポートしています。有効にすると、ファイルはSFTPサーバーにアップロードされる前にお客様の公開鍵で暗号化されます。対応する秘密鍵は、LMSにインポートする際にファイルを復号するためにお客様側で必要となります。

サーバー認証

DataCampはSFTPに対してパスワード認証および公開鍵認証をサポートしています。前者の場合、DataCampにユーザー名とパスワードを提供できます。後者の場合、DataCampは公開鍵を提供し、お客様のサーバーでホワイトリストに登録できます。

前提条件

SFTPによる統合を設定する前に、以下の要件を満たしている必要があります：

以下のいずれかを備えたSFTPサーバーが利用可能であること：
- DataCampがファイルをアップロードできるアカウントが作成されていること
- 信頼できる公開鍵を追加できる機能があること
CSVファイルを介してコンテンツのインポートをサポートするLMSがあること

設定

SFTPによる統合を設定するには、まずLMSを設定してSFTPサーバーからCSVファイルをダウンロードし処理できるようにします。

次に、DataCampに以下の情報を提供してください：

フルファイルを使用するかデルタファイルを使用するか；
同期するコンテンツタイプ（コース、プロジェクトなど）；
学習イベントを同期する場合、ファイルに含めるイベントタイプ（完了および/または開始）；
SFTPサーバーの認証情報：
- ホスト名、
- ポート、
- パスワードベースのSFTP認証の場合のユーザー名/パスワード、
- ファイルをアップロードするパス（提供されたユーザーに十分な権限があること）
ファイル形式（csv、txtなど）；
CSV区切り文字（「,」、「;」など）；
ファイルを暗号化する場合はPGP公開鍵；
ファイルの命名方法；
同期の頻度と最初の同期のタイムスタンプ。

DataCampチームが統合を設定します。

FAQ

コースをスキップした場合、ユーザーの完了情報はSFTP同期に含まれますか？

スキップされたコースの完了情報は、学習イベントファイルを含むSFTPファイルには含まれません。（コースはトラックの一部として、"test-out"評価に合格した場合にスキップされることがあります。）

一般的なSFTP統合