imskorea_logo_1 IMS 학습 도구 상호운용성 콘텐츠 아이템 메시지
발행일 2016년 5월 24일 (한국어 번역 2016년 12월 30일)
최신버전 1.0 버전 최종 표준
이전버전 http//www.imsglobal.org/specs/lticiv1p0

지적재산권 및 배포 관련 공지

이 표준의 사용자는 표준을 실행하면서 알게 되는 관련 특허 혹은 지적재산권 침해 가능성, 코멘트와 함께 문서로 제공해야 합니다. IMS는 이 문서에 서술된 기술의 적용 혹은 사용과 관련 있을 수 있는 지적재산권이나 기타 권리의 유효성, 범위 혹은 그러한 권리 아래에서 유효 또는 무효할 수 있는 라이선스의 한도 범위에 대하여 어떤 관점도 취하지 않으며, 그러한 권리를 파악하려고 노력했다는 사실 또한 표현하지 않습니다. IMS 표준 상의 권리에 대한 IMS의 절차 관련 정보는 IMS 지적재산권 웹 페이지에 나와 있습니다: /imsipr_policyFinal.pdf.

Copyright © 2016 by IMS Global Learning consortium, Inc. All Rights Reserved.

이 표준을 제품 혹은 서비스 개발에 이용하려면 IMS 웹사이트: /license.html상의 IMS 라이선스 규정에 따라야 합니다. 제안요청서(RFP, Request For Proposals) 제작 시누구나 필요에 따라 이 문서의 일부를 발췌하여 사용할 수 있습니다. 위의 제한적 사용 허가는 영구적이며 IMS나 그 상속인 혹은 양수인 등에 의해 취소되지 않습니다.

본 표준은 어떠한 보증도 하지 않으며, 특히 침해행위 없음에 대한 그 어떤 명시적 보증도 하지 않습니다. 이 표준의 사용은 전적으로 실행자 자신의 책임으로 이루어져야 하며, 컨소시엄 및 그 회원이나 제출자 등은 실행자 또는 제 3자가 이 설명서 사용으로 인해 직접 혹은 간접적으로 받는 그 어떤 성격의 피해에 대해서도 책임지지 않습니다.

© 2016 IMS Global Learning Consortium, Inc.

All Rights Reserved.

상표 정보: /copyright.html

문서 명: IMS Global 학습 도구 상호운용성 콘텐츠 아이템 메시지 v1.0

배포일: 2016년 5월 24일

1 서론

1.1 범위

콘텐츠-아이템 메시지는 도구 소비자의 참가를 위한 하나 이상의 아이템 선택의 과정에서 도구 제공자(TP)와 상호작용으로 사용자를 위한 메커니즘을 제공하기 위해 사용됩니다. 일반적인 유즈케이스는 iframe 내에서 TP를 여는 텍스트 상자 편집기의 도구 모음에 버튼을 클릭하는 도구 소비자 (TC) 내에서 사용자를 허용하는 (또는 팝업 창)에 제공되는 인터페이스를 사용합니다. 하나 이상의 항목을 선택하고, 상기 선택된 아이템(들) TC로 복귀하고 텍스트 상자에 삽입할 수 있습니다. 이 콘텐츠 페이지에 교사를 추가하는 내용 일 수도 있고, 과제의 목적으로 제출하는 첨부 파일을 선택하는 학생이 될 수 있습니다.

콘텐츠 아이템의 종류는 이 메시지를 사용하여 선택을 위해 지원됩니다:

  • TP 의 사용자 별 출시;
  • 고정 HTML 하이퍼링크;
  • 포함된 이미지 또는 다른 미디어 타입;
  • 포함된 HTML;
  • Iframe;
  • 파일 (TC내에 저장).

이 메시지는 LTI 시작 링크가 생성될 경우, TP와 상호작용할 수 있으므로, 이것은 또한 출시에 포함되는 사용자 요구 파라미터를 LTI 링크에 더한 흐름도를 개선하는 데에 사용됩니다. 링크가 사용자에 의해 선택된 콘텐츠 아이템에 기초하여 생성되는 경우 이러한 사용자 정의 파라미터가 지정될 수 있습니다.

1.2 참조

[HTTP, 14] Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content, R. Fielding et al. Retrieved 24 May 2016 from http://tools.ietf.org/html/rfc7231

[LTI, 12] G.McFall, L.Neumann, S.Vickers, IMS Global Basic Learning Tools Interoperability v1.1.1, IMS Global Learning Consortium, September 2012. http://www.imsglobal.org/lti/.

[LTI, 14 OM] S.Vickers, Outcomes Management v2.0, IMS Global Learning Consortium, December 2014. http://www.imsglobal.org/lti/.

[CIa, 15] S Vickers, Content-Item Message, IMS Global Learning Consortium, May 2016. http://www.imsglobal.org/lti/.

[CIb, 15] S Vickers, Content Items in the application/vnd.ims.lti.v1.contentitems+json format, IMS Global Learning Consortium, May 2016. http://www.imsglobal.org/lti/.

[OAuth, 10] The OAuth 1.0 Protocol, E. Hammer-Lahav. Retrieved 24 May 2016 from http://tools.ietf.org/html/rfc5849

 

2 행동 모델

콘텐츠 아이템 메시지는 시스템 간에 콘텐츠를 전달하는 방법을 제공합니다. URL을 통해 접속하는 것이면 어떤 것이든 콘텐츠 아이템이 될 수 있으며, 또는 미디어 형태 내에서 획득한 정적인 콘텐츠가 될 수도 있습니다. 일반 교실과 함께, 두 개의 특정 유형의 콘텐츠 아이템이 있는데, 하나는 파일형태이며, 다른 형태는 LTI실행 링크 형태입니다. 각각의 콘텐츠 아이템은 고객에게 가장 잘 표시될 수 있는 방법에 대한 조언도 함께 제공합니다. 이러한 요소는 수신 시스템이 해당 콘텐츠를 소비를 위해 단순히 전달만 하고 예를 들어 과제 파일과 같은 콘텐츠 페이지에 삽입하지 않을 때는 생략이 가능합니다.

imskr1012-3.2-1

그림 2.1 콘텐츠 아이템 모델

 

3 정보 모델

콘텐츠 아이템 메시지를 사용하는 것과 관련된 작업흐름은 3단계로 이루어집니다:

  1. 사용자의 브라우저가 TP로 지정됨.
  2. TP는 사용자가 TC에서 실행 링크와 연결할 수 있는 아이템을 발견하고 선택하도록 인터페이스를 제공.
  3. 사용자 브라우저는 선택한 아이템에 관한 상세설명과 함께 TC로 재전송됨.

TP로의 초기 재전송은 LTI실행 요구와 동일한 방식으로 이루어집니다. 즉, HTML형식은 HTTP POST를 활용하여 TP내 동일한 엔드포인트로 자동 제출됩니다. 동일한 매개 변수는 LTI메시지 형태가 ContentItemSelectionRequest의 의미를 가지는 경우를 제외하고 실행 요청을 위해 전달됩니다. 또한, 동일한 컨슈머 키 및 암호를 활용하여 OAuth와 계약을 체결합니다. [OAuth,10]. 이 메시지 형태의 이질적인 특징을 감안할 때, TP는 iframe이나 또는 팝업 창 내에서 열려, 사용자가 TP에서 반환한 후에도 언제든지 TC내의 현재 페이지를 볼 수 있도록 합니다. 그러나, 이것이 필수요건은 아니며, 이 메시지 형태를 활용하는 다른 작업흐름은 TC와 동일한 페이지를 재사용할 수도 있습니다.

콘텐츠 아이템을 발견하고 선택하는 인터페이스는 전적으로 TP와 관련이 있습니다. TC에서 수신한 요청은 실행 요청과 동일한 방식으로 검증을 거칩니다. (예를 들어, 타임스탬프 및 임시가치를 확인하고 서명을 인가해 줍니다). 전달된 매개 변수들은 TP가 사용자에게 전달된 문맥, 사용자 신원 및 역할을 확인할 수 있도록 충분한 데이터를 제공해야 합니다. 적절한 경우, 이 데이터는 사용자가 새로운 아이템을 선택하거나 만들어 낼 수 있는 적절한 아이템을 선택하도록 사용될 수 있습니다. 후자의 경우, TP는 선택된 아이템에 연결된 링크가 실질적으로 사용자가 반환했을 때 TC에서 만들어진 것이라는 사실을 보장하지 않는다는 사실을 주지해야 합니다. 이는 전적으로 예를 들어, 선택을 취소할 수도 있는 TC인터페이스에 대한 통제하에 있는 것입니다.

사용자가 TP로 연결되었을 때 제공된 매개 변수 중 하나는 TC로 반환하기 위한 URL이 됩니다. (콘텐츠 아이템 반환 url매개 변수 참조). TP는 항상 심지어 특정 아이템을 선택하지 않은 경우에도 TC로 반환돼야 합니다. 이를 통해 TC는 초기 재전송 기간 동안 iframe이나 창을 닫고, 사용자는 프로세스를 시작했던 초기 페이지로 돌아가게 됩니다. 선택된 아이템에 대한 상세사항은 JSON배열의TC로 전달됩니다. 아이템이 선택되어 있지 않은 경우에는, 이 배열이 비어있습니다. 사용자는 자동 제출 양식을 HTTP POST 요청으로 사용하여 TC로 항상 반환해야 합니다. 이 반송 메시지에는 서명이 될 수도 있고 되지 않을 수도 있습니다 (아래 참조).

imskr1012-3.3-1

3.1 요청 예시

다음 HTML 양식은 사용자가 콘텐츠 아이템 선택 프로세스를 시작하기 위해 TP로 재전송한 예입니다. (일부 매개 변수 값은 편의상 “…“로 대체되었습니다).

이 양식은 사용자의 브라우저로 반환한 페이지에 포함되며 JavaScript를 사용하여 자동 제출되므로 지정된 매개 변수가 있는 POST 요청은 TP의 LTI 엔드포인트로 전송됩니다. (일반 LTI 실행 요청이 처리되는 것과 동일한 방식으로 이루어 집니다).

3.2 응답 예시

사용자는 요청과 비슷한 방식으로 TP에 의해 TC로 반환합니다 (위 참조). 양식은 사용자의 브라우저로 반환한 페이지에 포함되며 자바 스크립트를 사용하여 TC의 content_item_return_url 매개 변수에 제공된 URL로 자동 제출됩니다. 예를 들어 선택한 콘텐츠 아이템의 JSON 표현이 다음과 같다고 가정해 봅시다.

imskr1012-3.3-2

다음 TP 양식은 TC에 더해진 이 아이템으로 리턴 할 수 있습니다. (일부 매개 변수 값은 편의상 “…“로 대체되었습니다).

imskr1012-3.3-2-1

콘텐츠 아이템 매개 변수의 JSON 값은 해당 페이지의 HTML이 유효하도록 삽입 되어야 합니다. 최소한 속성 값을 구분하는 데 사용되는 인용 문자의 모든 예를 삽입해야 합니다. 큰 따옴표는 “(또는”)로 삽입될 수 있으며 작은 따옴표는 ‘로 삽입될 수 있습니다. 자세한 정보는 양식이 삽입되는 페이지에서 사용하는 HTML 버전에 대한 사양을 참조합니다.

3.3 툴 제공자에 대한 요청

3.3.1 양식 필드

TC는 자동 제출 양식의 HTTP POST 요청을 활용하여 TP로 사용자를 재지정합니다. 양식에는 다음의 분야가 포함될 수 있습니다.

lti_message_type=ContentItemSelectionRequest (필수적)

이것은 이러한 요청이 콘텐츠 아이템 선택 메시지를 표현하고 있음을 암시합니다.

lti_version=LTI-1p0 (필수적) 이것은 특정 메시지에 사용된 특정 버전을 암시합니다. 예를 들어, LTI-1p0 or LTI-2p0.

accept_media_types=application/vnd.ims.lti.v1.ltilink,image/*,text/html (필수적) 반환 URL에서 허용 할 수 있는 쉼표로 구분 된 MIME 유형 목록입니다. 애플리케이션/ vnd.ims.lti.v1.ltilink의 MIME 유형은 TP에 대한 LTI 실행 요청을 나타내는 데 사용됩니다. 이 매개 변수는 HTTP 요청 [HTTP, 14]에서 Accept 헤더와 동일한 형식을 사용합니다. 예를 들어, “image / *; q = 0.5, image / png” 값은 PNG 이미지가 선호됨을 나타내지만 사용할 수 있는 이미지가 없으면 모든 유형의 이미지가 허용됩니다. LTI 링크를 제외한 모든 미디어 유형을 허용하기 위해, “애플리케이션/ vnd.ims.lti.v1.ltilink; q = 0, * / * “헤더를 사용할 수 있습니다.

accept_presentation_document_targets=embed,frame,iframe,window,popup,overlay (필수적) 선택한 콘텐츠 아이템을 반환하도록 요청할 수 있는 쉼표로 구분된 목록입니다. (반환된 콘텐츠 아이템의 프레젠테이션 다큐멘트 타켓 요소를 통합니다). 이 매개 변수에 사용할 수 있는 값은 다음과 같습니다:

  • 삽입- 현재의 삽입 점에 아이템을 삽입 (예를 들어, 이미지 태그 또는 사물 태그 사용). • Frame - 링크와 동일한 프레임에서 아이템을 엶. • iframe - 링크와 동일한 페이지/프레임 내의 iframe에서 아이템을 엶. • window - 새 창 (또는 탭)에서 아이템을 엶. • 팝업 - 팝업 창에서 아이템을 엶 (제공된 치수를 사용). • 오버레이 – 링크가 있는 페이지 상단에 아이템을 엶 (예를 들어, 라이트 박스 사용). • 없음 - 아이템은 표시 용이 아닌 저장 또는 처리 (예를 들어, 과제 제출은 코스에 추가되는 링크 없이 저장 가능).

content_item_return_url=http://lmsng.school.edu/portal/123/page/988/item/261 (필수적) TP가 사용자를 TC 인터페이스로 재지정하는 정규 URL. 이 URL은 TP가 완료되거나 TP를 시작할 수 없거나 또는 기술적인 문제가 존재할 때 사용할 수 있습니다.

accept_unsigned=false | true (선택적) 이것은 TC는 서명되지 않은 반환 메시지를 수락할지 여부를 보여줍니다. 서명된 메시지는 사용자와의 추가 상호작용 없이 툴 소비자 내에서 콘텐츠 아이템을 자동으로 생성할 때 필요합니다. 이 매개 변수는 선택적입니다. 생략할 경우 허위 값을 가정해야 합니다 (즉, 반환 메시지에 서명해야 합니다).

accept_multiple=false | true (선택적) 이것은 사용자가 한 개 이상의 아이템을 선택할 수 있는지 여부를 보여줍니다. 이 매개 변수는 선택적입니다. 생략할 경우 허위 값을 가정해야 합니다. (즉, 하나의 아이템만 반환할 수 있습니다)

accept_copy_advice=false true (선택적) 이것은 TC가 콘텐츠 아이템의 로컬 복사본을 만들 수 있는지 여부를 보여줍니다. 반환 메시지에는 제공된 URL이 만료되었는지 여부를 보여주기 위해 expiresAt 매개 변수가 포함될 수 있으며, 따라서 만료 시간이 경과하기 전에 콘텐츠 아이템의 사본을 로컬 저장해야 합니다. TC에 콘텐츠 아이템의 로컬 복사본을 저장할 수 있는 용량이 없음을 보여주기 위해서는 허위 값(기본값)을 사용합니다.

auto_create=false | true (선택적) 이것은 사용자가 작업을 취소 할 수 있는 옵션 없이 TP에 의해 반환 된 콘텐츠 아이템이 자동으로 지속되는지 여부를 보여줍니다. 이 매개 변수는 선택적입니다. 생략할 경우 허위 값을 가정해야 합니다. (즉, 반환된 아이템은 TC 끝에서 유지되지 못할 수 있습니다).

title=… (선택적) TP가 반환한 콘텐츠 아이템의 제목 또는 대체 텍스트로 사용될 기본 텍스트. 이 값은 일반적으로 길이가 짧습니다. 예를 들어. 제목으로 사용하기에 적합합니다.

text=… (선택적) TP가 반환한 콘텐츠 아이템의 가시적 텍스트로 사용될 기본 텍스트. TP가 텍스트를 반환하지 않을 경우, TC는 대신 제목의 매개 변수의 값을 사용할 수 있습니다 (해당되는 경우). 이 값은 콘텐츠 아이템을 길게 설명해 줄 수도 있습니다.

data=… (선택적) TP가 반환해야 하는 불투명 한 값입니다.

추가 부문

TC는 또한 실행 요청에 포함되는 도구, 소비자, 사용자, 문맥 및 사용자의 역할에 관한 다른 매개 변수도 전달해야 합니다 ([LTI, 11, 기본 실행 데이터] 참조). 다음의 매개 변수는 전달할 수 없다:

  • 리소스_link_id
  • 리소스_link_title
  • 리소스_link_description
  • launch_presentation_return_url
  • lis_result_sourcedid

TP에 실행하기 위해 특정 사용자 지정 매개 변수를 지정하는 경우, 이 매개 변수도 메시지 유형에 포함되어야 합니다. 모든 관련 사용자 지정 대체 매개 변수도 지원을 받게 됩니다. 예를 들어, 이 메시지는 리소스 링크가 생성되기 전에 발생하기 때문에, 생성된다 하더라도 리소스 링크 또는 결과와 관련된 것들은 아무런 관련이 없습니다.

3.4 툴 컨슈머에 대한 응답

3.4.1 양식 필드

TP는 자동 제출 양식을 사용하여 HTTP POST 요청으로 사용자를 TC로 반환 시켜야 합니다. 다음 분야가 포함될 수 있습니다:

lti_message_type=ContentItemSelection (필수적) 이것은 콘텐츠 아이템 배열을 포함한 메시지라는 것을 보여줍니다.

lti_version=LTI-1p0 (필수적) 이 특정 메시지에 사용된 사양 버전을 보여준다. 툴 소비자에서 요청 받은 값과 동일한 값을 사용합니다.

content_items=… (선택적) 이 매개 변수의 값은 선택된 각 아이템의 상세사항을 포함하는 JSON 배열이어야 합니다 (아래 예 참조). 선택된 아이템이 없는 경우, 이 매개 변수에는 빈 배열이 포함되거나 또는 생략 될 수 있습니다. 함께 제공되는 HTML 문서는 이 매개 변수에서 사용되는 응용/ vnd.ims.lti.v1.contentitems + json 미디어 유형에 대해 정의하고 있습니다. 예를 들어, 콘텐츠 아이템 매개 변수는 다음의 값을 가집니다:

imskr1012-3.3-4-1

배열 내 각 요소의 구조는 각 유형의 콘텐츠 아이템 마다 다를 수 있지만 (아래 참조), TC가 처리하게 될 순서대로 나타나야 합니다. 콘텐츠 아이템이 선택되지 않는 경우 매개 변수는 다음의 값을 가집니다:

imskr1012-3.3-4-1-1

또는 반환 매개 변수에서 모두 생략 될 수 있습니다.

data=… (선택적) 데이터 매개 변수가 접수한 원본 콘텐츠 아이템 메시지와 함께 전달되면, 해당 값은 이 매개 변수로 반환 되야 합니다. 이 값은 TP에 명확하지 않기 때문에 변경 없이 반환됩니다. 원래 요청에 매개 변수가 포함되지 않는 경우, 이 매개 변수는 생략됩니다.

lti_msg=… (선택적) TP가 정상적으로 반환되고 사용자에게 메시지를 표시하고자 할 경우, 이 매개 변수에 일반 텍스트 [1] 값으로 포함시킬 수 있습니다.

lti_log=… (선택적) 이 매개 변수는 TP가 정상적으로 반환할 때 TP가 TC에게 일반 텍스트 메시지를 기록하도록 합니다.

lti_errormsg=… (선택적) 오류가 발생하는 경우, TP는이 매개 변수를 사용하여 사용자에게 오류의 특성에 관하여 일반 텍스트로 세부 사항을 제공 할 수 있습니다. TC는 이 메시지가 표시되도록 해야 합니다. TP가 이미 사용자에게 오류 표시를 제공 한 경우, 이 매개 변수를 사용할 필요가 없다.

lti_errorlog=… (선택적) 이 매개 변수에는 TC가 기록하는 일반 텍스트 오류 메시지가 포함될 수 있습니다. 초기 요청에 참 값을 가진 accept_unsigned 매개 변수가 포함되어 있지 않은 경우 응답 메시지에 서명해야 합니다. 그렇지 않을 경우 TP는 응답 메시지에 서명할지 여부를 선택할 수 있습니다. 메시지는 LTI 실행 요청 메시지 ([LTI, 12])와 동일한 방식으로 OAuth ([OAuth, 10]) 서명됩니다.

3.4.2 콘텐츠 아이템 요소

선택된 콘텐츠 아이템의 위치를 설명하는 요소는 다음과 같습니다:

@id (선택적) 아이템에 사용할 고유 식별자로써 이 요소의 값은 동일한 실제 아이템 또는 자원을 참조하더라도 다른 메시지에서 변경 될 수 있습니다. 콘텐츠 아이템은 아이템의 메타데이터에 불과하며 아이템 자체는 아닙니다.

mediaType (필수적) 이 요소는 콘텐츠 아이템의 유형을 설명합니다. 이것은 콘텐츠 아이템의 MIME 유형 값을 가져야 합니다.

url (선택적) 해당 아이템에 사용할 정규 URL. 응용/ vnd.ims.lti.v1.ltilink 유형의 콘텐츠 아이템에 지정되지 않을 경우 동일한 TP에 사용되는 기본 실행 URL을 가정해야 합니다.

copyAdvice=false | true (선택적) 이 매개 변수는 콘텐츠 아이템의 복사본을 가져와 사용자가 접속할 수 있도록 로컬 복사본을 사용할 것인지 여부를 TC에 표시해 줍니다. true 값인 경우, TP는 expiresAt 매개 변수를 사용하여 사본을 불러오는데 소요되는 시간을 표시해 줄 수도 있습니다. 기본값은 false입니다.

expiresAt (선택적) 이 매개 변수가 있으면 콘텐츠 URL은 제한된 시간 동안만 사용할 수 있으므로 장기간 접속해야 하는 경우 콘텐츠의 복사본을 로컬에 저장해야 합니다. 매개 변수 값은 ISO 8601 형식으로 날짜 / 시간이 기재됩니다 (예: 2014-03-05T12 : 34 : 56Z). 이 매개 변수는 응용/ vnd.ims.lti.v1.ltilink 유형의 콘텐츠 아이템에는 적용 할 수 없습니다.

presentationDocumentTarget (선택적) 이 매개 변수는 추가되는 콘텐츠 아이템이 열리는 위치를 결정하기 위해 사용됩니다. accept_presentation_document_targets 요청 매개 변수에 포함된 값 중 하나입니다. (위 참조). 매개 변수가 요청에 포함되지 않은 경우, 이 매개 변수는 응답에서 생략됩니다.

windowTarget (선택적) 콘텐츠 아이템을 여는데 사용되는 하이퍼링크에 사용할 windowTarget 매개 변수는 이 매개 변수를 사용하여 지정할 수 있습니다. 이 매개 변수는 콘텐츠 아이템의 여는 방법을 결정하기 위해 사용되는 presentationDocumentTarget 요소 (위 참조)와는 구별됩니다. 이 매개 변수는 window의 presentationDocumentTarget이 지정된 경우에 가장 유용합니다.

title (선택적) 콘텐츠 아이템 용 제목 또는 표제로 사용할 텍스트입니다.

text (선택적) 콘텐츠 아이템을 나타내기 위해 표시하는 텍스트로써 TP는 요청에서 TC가 제공한 모든 텍스트를 초기 기본값으로 사용해야 하나, 이는 선택 과정의 일부로 변경 될 수 있습니다. TC가 제공되지 않으면 TC는 대신 제목 매개 변수의 값을 사용할 수 있습니다.

icon (선택적) 콘텐츠 아이템과 함께 비치될 아이콘 이미지의 완전한 URL을 제공하는 @id 요소를 포함한 물체로써 넓이 및/또는 높이 요소 또한 제공 될 수 있습니다. 지정이 된 경우, 넓이 및 높이 값은 픽셀 수를 나타내는 양의 정수여야 합니다. 50x50크기의 아이콘을 권장합니다. 툴 소비자는 아이콘 표시를 지원하지 않을 수 있습니다. 다만, 그것이 있는 곳에서는 제공된 URL에 연결하는 것보다는 아이콘의 로컬 복사본 사용을 선택할 수 있습니다. (이미지의 크기를 필요에 맞게 조정할 수 있습니다).

thumbnail (선택적) 하이퍼링크로 사용될 간단한 이미지의 정규 URL을 제공하는 @id 요소를 포함 하는 물체로 이를 통해 하이퍼링크는 TC 내에서 텍스트 또는 이미지 또는 둘 다에서 열릴 수 있습니다. 넓이 및/또는 높이 요소가 포함될 수도 있습니다. 지정이 된 경우, 넓이 및 높이 값은 픽셀 수를 나타내는 양의 정수여야 합니다.

displayWidth (선택적) 콘텐츠 아이템을 참조하기 위해 TC가 만들게 될 HTML 요소의 넓이 특성에 맞는 값으로 이것은 이 문서 대상이 요청 될 때 팝업 창의 크기를 조정하기 위해 사용할 수도 있습니다. 일반적으로 픽셀 수를 나타내는 양의 정수 값입니다.

displayHeight (선택적) 콘텐츠 아이템을 참조하기 위해 TC가 만들게 될 HTML 요소의 높이 특성에 맞는 값으로써 이것은 이 문서의 대상이 요청 될 때 팝업 창의 크기를 조정하기 위해 사용할 수도 있습니다. 일반적으로 픽셀 수를 나타내는 양의 정수 값입니다.

custom (선택적) 작성중인 링크에서 LTI 실행 요청에 포함될 사용자 지정 매개 변수 세트 (이름 및 값)로써 이 매개 변수는 응용/ vnd.ims.lti.v1.ltilink 유형의 콘텐츠 아이템에만 적용됩니다.

상세 정보는 [CIa, 14] and [CIb, 14] 참조합니다.

3.4.3 응답 예시

다음은 다양한 콘텐츠 아이템 유형에 관한 예입니다. 응답에 서명 할 때 가정 할 수 있는 신뢰도가 존재하지만TC의 콘텐츠 페이지에 추가되는 모든 매개 변수 값이 잠재적으로 유해한 콘텐츠 (JavaScript 등)인지 확인해야 합니다.

LTI 실행 링크

다음 예에서는 두 개의 사용자 지정 매개 변수가 전달되는 TP에 대한 실행 요청하는 하이퍼 링크로 설정되는 TC의 현재 삽입 지점에 이미지와 텍스트 “LTI 실행”을 추가해야 합니다.

imskr1012-3.3-4-3

하이퍼링크와 썸네일

다음 예에서는 새로운 창에서 제공되는URL을 열기 위해 하이퍼 링크로 설정되는, TC의 현재 삽입 지점에 이미지와 “인증 제품의 IMS 카탈로그”텍스트를 추가해야 합니다.

imskr1012-3.3-4-3-1

TC는 위의 콘텐츠 아이템을 수신하는 경우 다음과 같이 HTML을 삽입합니다. 정확한 레이아웃과 형식은 여기에 설명하고 있지 않으나 이미지와 텍스트를 표시하고 두 URL을 제공된 URL에 하이퍼 링크로 연결해야 합니다.

imskr1012-3.3-4-3-2

포함된 이미지

다음 예에서는 현재 삽입 지점의 TC에 이미지를 삽입해야 합니다.

imskr1012-3.3-4-3-3

이미지를 표시하는 데 사용되는 HTML은 다음과 같다.

imskr1012-3.3-4-3-4

포함된 HTML

다음 예는 HTML 조각을 현재 삽입 지점의 TC에 삽입하는 방법을 보여준다.

imskr1012-3.3-4-3-5

 

파일의 로컬 복사를 위한 하이퍼링크

다음 예에서는 TC에 XML 파일의 로컬 복사본에 대한 링크를 삽입해야 합니다.

imskr1012-3.3-4-3-6

copyAdvice 요소는 TC가 이 아이템의 로컬 복사본을 만들어야 함을 보여준다. expiresAt 요소는 콘텐츠 URL을 제한된 기간 동안만 사용할 수 있으므로, 사본은 해당 시간 내에 불러와야 함을 보여준다. 일반적으로 링크가 만들어지면 사본을 만들 수 있을 것으로 예상됩니다. 파일의 로컬 사본에 대한 링크는 TC에 삽입됩니다.

imskr1012-3.3-4-3-7

다른 컨텍스트로부터 요소 포함한 (. 메타데이터)

추가 요소는 그것이 그려지는 문맥을 참조하여 JSON 응답에 포함될 수 있습니다. 다음 예는 LRMI의 요소를 포함하고 있습니다.

imskr1012-3.3-4-3-8

LTI 출시 링크와 결과 지원

LtiLinkItem 요소 내에 있는 개별 아이템에 대한 설명을 포함하여 기록부의 개별 아이템과 연결되도록 요청하는 LTI 실행 링크를 반환 할 수 있습니다. 결과관리사양[LTI, 14 OM]에서 개별 아이템 유형을 다시 사용하기 위해 이전의 예에서 사용된 것과 동일한 기술을 사용합니다. 이 콘텐츠 아이템을 지속할 때, 툴 컨슈머는 결과 서비스를 지원하는 LTI 1 도구를 수동으로 추가 할 때와 동일한 최종 결과를 얻기 위해 기록부에 하나의 칸을 만들게 됩니다.

imskr1012-3.3-4-3-9

3.5 콘텐츠 아이템 기능

TC는 프로파일의 capability_offered 부분에 기능 이름을 포함시킴으로써 콘텐츠 아이템 메시지 및 관련 매개 변수에 대한 지원을 표현할 수 있습니다. 메시지 매개 변수와 기능 이름 간 매핑은 다음 표에 나와 있습니다.

표 3.1 – 콘텐츠 아이템 기능 이름 매핑

파라미터 이름 기능 이름
lti_message_type ContentItemSelectionRequest
accept_media_types ContentItem.acceptTypes
accept_presentation_document_targets ContentItem.acceptTargets
content_item_return_url ContentItem.returnUrl
accept_unsigned ContentItem.acceptUnsigned
accept_multiple ContentItem.acceptMultiple
auto_create ContentItem.autocreate
data ContentItem.data

일반 텍스트는 TC가 매개 변수 값을 text / html가 아닌 텍스트/일반으로 처리하는 것을 의미합니다. TP에 일반 텍스트 필드보다 작거나 큰 문자가 포함되어 있는 경우, 해당 문자는 삭제되거나 표시되어야 합니다. 특히, TP는 HTML이 브라우저에 직접 전달될 것으로 예상하여 일반 텍스트 필드에 HTML 태그를 포함해서는 안 됩니다. 예를 들어, 일반 텍스트가 'Mode : <strong> security'라는 문자열을 포함하고 있는 경우, TC는 데이터를 이스케이프 처리하여 굵은 글씨로 “보안”이라는 단어로 변환하기 보다는 사용자가 '~보다 작은', '~보다 큰' 및 문자 그래도 그들 간의 텍스트를 볼 수 있도록 해야 합니다.

문서 정보

  • Title: IMS Global LTI Content-Item Message
  • Editors: Stephen Vickers (IMS Global)
  • Version: 1.0
  • Version Date: 24 May 2016
  • Status: Final
  • Purpose: This document is made available for adoption by the public community at large.
  • Document Location: http://www.imsglobal.org/specs/lticiv1p0

기고자 목록

이름 기관
Viktor Haag, D2L
Brad Humphrey Instructure
Greg McFall Pearson
Nathan Mills Instructure
Bracken Mosbacker, Instructure
Claude Vervoort, Cengage Learning
Stephen Vickers, IMS Global
Brian Whitmer, Instructure

변경 이력

버전 번호 발표 일자 설명
공공 초안 1.0 2015년 2월 3일
후보 최종 초안 1.0 2016년 5월 2일
2016년 5월 4일 지속성을 확인하기 위한 옵션이 제거되었으므로 향후 배포 예정.
최종 v1.0 2016년 5월 24일
2016년 11월 10일 activityId 요소의 철자 수정 (was activity_id).

IMS Global Learning Consortium, Inc. ("IMS Global") 은 과학적이고 실험적이며 학구적인 협력의 목적 만을 위해서 이 IMS Global 공통 카트리지 프로파일: 실행 (“표준”) 에 포함된 정보를 발표하고 있습니다. IMS Global 은 표준의 정확성이나 완성도에 대해 보증이나 발언을 하지 않습니다. 이것은 ‘있는 그대로’ 그리고 ‘사용 가능한 그대로’의 형식으로 제공됩니다.

표준은 늘 통지 없이 변화와 개정이 될 수 있습니다. 표준이 당신에게 관련이 있는 이상, 그 유용성, 정확도, 그리고 완성도를 평가하는 것은 당신의 단독 의무입니다. IMS Global 은 당신의 논평과 제안을 수령하기 원합니다. 우리의 웹 사이트, http://www.imsglobal.org를 통해서 IMS Global 에 연락하십시오. 서류 번호를 참조하십시오. : IMS Global 학습 도구 상호운용성 콘텐츠 아이템 메시지 v1.0

개정: 2016년 5월 24일