From ca5466438ea2c8d97272407ffd01318dfca75ef2 Mon Sep 17 00:00:00 2001 From: Will Hoyt Date: Fri, 28 Oct 2022 14:32:07 -0400 Subject: [PATCH 1/3] Delete Issue template remove issue template --- ISSUE_TEMPLATE.md | 9 --------- 1 file changed, 9 deletions(-) delete mode 100644 ISSUE_TEMPLATE.md diff --git a/ISSUE_TEMPLATE.md b/ISSUE_TEMPLATE.md deleted file mode 100644 index 850ca52..0000000 --- a/ISSUE_TEMPLATE.md +++ /dev/null @@ -1,9 +0,0 @@ -Filing an issue about the **xAPI Profiles** specification? Please include the following - -- [ ] Which part/parts of the specification are at issue? - -- [ ] What is your understanding of what the spec means in these parts? - -- [ ] Related to your implementation, what's the use case you're trying to achieve? What are the user stories you're trying to support? - -- [ ] How you would like the specification to be improved? From 3b73356e75377d66396372c9fd6c10ac5c6add61 Mon Sep 17 00:00:00 2001 From: Ivan Martinez-Ortiz Date: Mon, 27 Feb 2023 18:19:32 +0100 Subject: [PATCH 2/3] Align timestamp data type to XSD 1.1 dateTimeStamp data type. Fix #7 --- xapi-profiles-about.md | 3 +++ xapi-profiles-communication.md | 5 +++++ xapi-profiles-structure.md | 2 +- 3 files changed, 9 insertions(+), 1 deletion(-) diff --git a/xapi-profiles-about.md b/xapi-profiles-about.md index fbf3bf2..cb7b80f 100644 --- a/xapi-profiles-about.md +++ b/xapi-profiles-about.md @@ -210,6 +210,7 @@ even if there no requirement in a given area. * [Statement Template](#statementtemplate) * [StatementRef](#statementref) * [Subregistration](#subregistration) +* [Timestamp](#timestamp) * [Verb](#verb) * [xAPI Profile Processor Library](#library) @@ -281,6 +282,8 @@ even if there no requirement in a given area. **Subregistration**: When multiple Patterns are being followed within a registration, subregistration is an extension specific to this specification to distinguish between them. +**Timestamp**: An instant of time (date and time) that also includes the time zone. This data type adheres to the [XSD 1.1 dateTimeStamp](https://www.w3.org/TR/xmlschema11-2/#dateTimeStamp) type definition. That is, a timestamp is either represented in Universal Coordinated Time (UTC) and uses the UTC timezone identifier 'Z' or includes a time offset from UTC. + **Verb**: An [Experience API Verb](https://github.com/adlnet/xAPI-Spec/blob/master/xAPI-Data.md#verb). This specification helps Profile Authors provide additional metadata about verbs they control. **xAPI Profile Processor Library**: A programming library implementing the algorithms described in this specification. diff --git a/xapi-profiles-communication.md b/xapi-profiles-communication.md index 9d68a63..1ad0b7b 100644 --- a/xapi-profiles-communication.md +++ b/xapi-profiles-communication.md @@ -405,6 +405,11 @@ order insofar as that can be determined. If Statements are received in the same are being checked upon receipt, within the batch Statements MUST be ordered first by timestamp, and if timestamps are the same, by order within the Statement array, with lower indices earlier. + +**Note:** As stated in section [Part One: About xAPI Profiles, section 3](./xapi-profiles-about.md#timestamp) +timestamps adheres to the `xsd:dateTimeStamp` data type defined in XSD 1.1 which is either represented in +Universal Coordinated Time (UTC) and uses the UTC timezone identifier 'Z' or includes a time offset from UTC. + ## 3.0 Libraries diff --git a/xapi-profiles-structure.md b/xapi-profiles-structure.md index 91275c8..528fdc9 100644 --- a/xapi-profiles-structure.md +++ b/xapi-profiles-structure.md @@ -117,7 +117,7 @@ Property | Type | Description | Required -------- | ---- | ----------- | -------- `id` | IRI | The IRI of the version ID | Required `wasRevisionOf` | Array | An array, usually of length one, of IRIs of all Profile versions this version was written as a revision of | Optional -`generatedAtTime` | Timestamp | The date this version was created on | Required +`generatedAtTime` | [Timestamp](./xapi-profiles-about.md#timestamp) | The date this version was created on | Required `wasRevisionOf` MUST be used with all versions that succeed other Profile versions. From 89f6f640d0da62807393d1200f761dd240ddfdb9 Mon Sep 17 00:00:00 2001 From: Ivan Martinez-Ortiz Date: Mon, 27 Feb 2023 18:20:11 +0100 Subject: [PATCH 3/3] Adapt profile context to the timestamp data type clarification --- context/profile-context.jsonld | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/context/profile-context.jsonld b/context/profile-context.jsonld index 57ba2d0..c213bf3 100644 --- a/context/profile-context.jsonld +++ b/context/profile-context.jsonld @@ -66,7 +66,7 @@ }, "generatedAtTime": { "@id": "prov:generatedAtTime", - "@type": "http://www.w3.org/2001/XMLSchema#dateTime" + "@type": "https://www.w3.org/TR/xmlschema11-2/#dateTimeStamp" }, "name": { "@id": "schemaorg:name"