{"action":"created","comment":{"url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/pulls/comments/76603993","id":76603993,"diff_hunk":"@@ -183,6 +183,31 @@ to a command update to the device.\n \n ![General ](https://raw.github.com/dmoranj/iotagent-node-lib/develop/img/iotAgentLib.png \"Architecture Overview\")\n \n+### The TimeInstant attribute\n+\n+The IoT Agent manages the existence of a special timestamp attribute in the device to entity mapping: **TimeInstant**. This\n+attribute appears in two different parts of the entity:\n+\n+* As a metadata of an attribute **TimeInstant** indicates the real timestamp where the value for that measure was registered.\n+This timestamp will be provided to the IoTAgent in a protocol-specific way (check your particular IoTAgent for the details).\n+\n+* As an attribute of the entity, **TimeInstant** indicates the timestamp of the last measure received from the device.\n+\n+If no information about the measure timestamp is received by the IoTAgent, it will use the arrival time of the measure to\n+generate a `TimeInstant` for both the entity and the attribute's metadata.\n+\n+Take into account that:\n+* the timestamp of different attributes of the same measure may not be equal.\n+* the arrival time and the measure timestamp will not be the same in the general case.","path":"README.md","position":null,"original_position":19,"commit_id":"4a4e75477683ef8dbf0c7b5ca9828719930a9777","original_commit_id":"a72ec45801368930fc8d138d3a6f6afcbc3e281c","user":{"login":"dmoranj","id":1152892,"avatar_url":"https://avatars.githubusercontent.com/u/1152892?v=3","gravatar_id":"","url":"https://api.github.com/users/dmoranj","html_url":"https://github.com/dmoranj","followers_url":"https://api.github.com/users/dmoranj/followers","following_url":"https://api.github.com/users/dmoranj/following{/other_user}","gists_url":"https://api.github.com/users/dmoranj/gists{/gist_id}","starred_url":"https://api.github.com/users/dmoranj/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dmoranj/subscriptions","organizations_url":"https://api.github.com/users/dmoranj/orgs","repos_url":"https://api.github.com/users/dmoranj/repos","events_url":"https://api.github.com/users/dmoranj/events{/privacy}","received_events_url":"https://api.github.com/users/dmoranj/received_events","type":"User","site_admin":false},"body":"I don't know if it will be clear with that expression (although it is also unclear with the current one). What I meant with \"arrival time\" is the time when the measure arrives to the IoT Platorm, as opposed to the time when the measure is read from the sensors in the device (that would be the one I defined as \"measure timestamp\").","created_at":"2016-08-29T13:14:00Z","updated_at":"2016-08-29T13:14:00Z","html_url":"https://github.com/telefonicaid/iotagent-node-lib/pull/436#discussion_r76603993","pull_request_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/pulls/436","_links":{"self":{"href":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/pulls/comments/76603993"},"html":{"href":"https://github.com/telefonicaid/iotagent-node-lib/pull/436#discussion_r76603993"},"pull_request":{"href":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/pulls/436"}}},"pull_request":{"url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/pulls/436","id":82353285,"html_url":"https://github.com/telefonicaid/iotagent-node-lib/pull/436","diff_url":"https://github.com/telefonicaid/iotagent-node-lib/pull/436.diff","patch_url":"https://github.com/telefonicaid/iotagent-node-lib/pull/436.patch","issue_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/issues/436","number":436,"state":"open","locked":false,"title":"ADD Documentation for the TimeInstant attribute semantics","user":{"login":"dmoranj","id":1152892,"avatar_url":"https://avatars.githubusercontent.com/u/1152892?v=3","gravatar_id":"","url":"https://api.github.com/users/dmoranj","html_url":"https://github.com/dmoranj","followers_url":"https://api.github.com/users/dmoranj/followers","following_url":"https://api.github.com/users/dmoranj/following{/other_user}","gists_url":"https://api.github.com/users/dmoranj/gists{/gist_id}","starred_url":"https://api.github.com/users/dmoranj/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dmoranj/subscriptions","organizations_url":"https://api.github.com/users/dmoranj/orgs","repos_url":"https://api.github.com/users/dmoranj/repos","events_url":"https://api.github.com/users/dmoranj/events{/privacy}","received_events_url":"https://api.github.com/users/dmoranj/received_events","type":"User","site_admin":false},"body":"Fixes #435","created_at":"2016-08-23T12:14:26Z","updated_at":"2016-08-29T13:14:00Z","closed_at":null,"merged_at":null,"merge_commit_sha":"d6ce2fda97a884d24e279e029521b5ef13801f1c","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/pulls/436/commits","review_comments_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/pulls/436/comments","review_comment_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/pulls/comments{/number}","comments_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/issues/436/comments","statuses_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/statuses/4a4e75477683ef8dbf0c7b5ca9828719930a9777","head":{"label":"telefonicaid:task/documentTimeInstantBehavior","ref":"task/documentTimeInstantBehavior","sha":"4a4e75477683ef8dbf0c7b5ca9828719930a9777","user":{"login":"telefonicaid","id":968363,"avatar_url":"https://avatars.githubusercontent.com/u/968363?v=3","gravatar_id":"","url":"https://api.github.com/users/telefonicaid","html_url":"https://github.com/telefonicaid","followers_url":"https://api.github.com/users/telefonicaid/followers","following_url":"https://api.github.com/users/telefonicaid/following{/other_user}","gists_url":"https://api.github.com/users/telefonicaid/gists{/gist_id}","starred_url":"https://api.github.com/users/telefonicaid/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/telefonicaid/subscriptions","organizations_url":"https://api.github.com/users/telefonicaid/orgs","repos_url":"https://api.github.com/users/telefonicaid/repos","events_url":"https://api.github.com/users/telefonicaid/events{/privacy}","received_events_url":"https://api.github.com/users/telefonicaid/received_events","type":"Organization","site_admin":false},"repo":{"id":25203883,"name":"iotagent-node-lib","full_name":"telefonicaid/iotagent-node-lib","owner":{"login":"telefonicaid","id":968363,"avatar_url":"https://avatars.githubusercontent.com/u/968363?v=3","gravatar_id":"","url":"https://api.github.com/users/telefonicaid","html_url":"https://github.com/telefonicaid","followers_url":"https://api.github.com/users/telefonicaid/followers","following_url":"https://api.github.com/users/telefonicaid/following{/other_user}","gists_url":"https://api.github.com/users/telefonicaid/gists{/gist_id}","starred_url":"https://api.github.com/users/telefonicaid/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/telefonicaid/subscriptions","organizations_url":"https://api.github.com/users/telefonicaid/orgs","repos_url":"https://api.github.com/users/telefonicaid/repos","events_url":"https://api.github.com/users/telefonicaid/events{/privacy}","received_events_url":"https://api.github.com/users/telefonicaid/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/telefonicaid/iotagent-node-lib","description":"IoT Agent library to interface with NGSI Context Broker","fork":false,"url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib","forks_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/forks","keys_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/keys{/key_id}","collaborators_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/teams","hooks_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/hooks","issue_events_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/issues/events{/number}","events_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/events","assignees_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/assignees{/user}","branches_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/branches{/branch}","tags_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/tags","blobs_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/git/refs{/sha}","trees_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/git/trees{/sha}","statuses_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/statuses/{sha}","languages_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/languages","stargazers_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/stargazers","contributors_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/contributors","subscribers_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/subscribers","subscription_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/subscription","commits_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/commits{/sha}","git_commits_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/git/commits{/sha}","comments_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/comments{/number}","issue_comment_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/issues/comments{/number}","contents_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/contents/{+path}","compare_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/compare/{base}...{head}","merges_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/merges","archive_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/downloads","issues_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/issues{/number}","pulls_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/pulls{/number}","milestones_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/milestones{/number}","notifications_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/labels{/name}","releases_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/releases{/id}","deployments_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/deployments","created_at":"2014-10-14T11:48:27Z","updated_at":"2016-07-27T04:34:20Z","pushed_at":"2016-08-29T13:10:55Z","git_url":"git://github.com/telefonicaid/iotagent-node-lib.git","ssh_url":"git@github.com:telefonicaid/iotagent-node-lib.git","clone_url":"https://github.com/telefonicaid/iotagent-node-lib.git","svn_url":"https://github.com/telefonicaid/iotagent-node-lib","homepage":null,"size":1460,"stargazers_count":19,"watchers_count":19,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":8,"mirror_url":null,"open_issues_count":17,"forks":8,"open_issues":17,"watchers":19,"default_branch":"master"}},"base":{"label":"telefonicaid:develop","ref":"develop","sha":"4da4efed6eaf1d565edf09848e1420c8242f29b2","user":{"login":"telefonicaid","id":968363,"avatar_url":"https://avatars.githubusercontent.com/u/968363?v=3","gravatar_id":"","url":"https://api.github.com/users/telefonicaid","html_url":"https://github.com/telefonicaid","followers_url":"https://api.github.com/users/telefonicaid/followers","following_url":"https://api.github.com/users/telefonicaid/following{/other_user}","gists_url":"https://api.github.com/users/telefonicaid/gists{/gist_id}","starred_url":"https://api.github.com/users/telefonicaid/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/telefonicaid/subscriptions","organizations_url":"https://api.github.com/users/telefonicaid/orgs","repos_url":"https://api.github.com/users/telefonicaid/repos","events_url":"https://api.github.com/users/telefonicaid/events{/privacy}","received_events_url":"https://api.github.com/users/telefonicaid/received_events","type":"Organization","site_admin":false},"repo":{"id":25203883,"name":"iotagent-node-lib","full_name":"telefonicaid/iotagent-node-lib","owner":{"login":"telefonicaid","id":968363,"avatar_url":"https://avatars.githubusercontent.com/u/968363?v=3","gravatar_id":"","url":"https://api.github.com/users/telefonicaid","html_url":"https://github.com/telefonicaid","followers_url":"https://api.github.com/users/telefonicaid/followers","following_url":"https://api.github.com/users/telefonicaid/following{/other_user}","gists_url":"https://api.github.com/users/telefonicaid/gists{/gist_id}","starred_url":"https://api.github.com/users/telefonicaid/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/telefonicaid/subscriptions","organizations_url":"https://api.github.com/users/telefonicaid/orgs","repos_url":"https://api.github.com/users/telefonicaid/repos","events_url":"https://api.github.com/users/telefonicaid/events{/privacy}","received_events_url":"https://api.github.com/users/telefonicaid/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/telefonicaid/iotagent-node-lib","description":"IoT Agent library to interface with NGSI Context Broker","fork":false,"url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib","forks_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/forks","keys_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/keys{/key_id}","collaborators_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/teams","hooks_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/hooks","issue_events_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/issues/events{/number}","events_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/events","assignees_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/assignees{/user}","branches_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/branches{/branch}","tags_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/tags","blobs_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/git/refs{/sha}","trees_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/git/trees{/sha}","statuses_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/statuses/{sha}","languages_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/languages","stargazers_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/stargazers","contributors_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/contributors","subscribers_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/subscribers","subscription_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/subscription","commits_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/commits{/sha}","git_commits_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/git/commits{/sha}","comments_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/comments{/number}","issue_comment_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/issues/comments{/number}","contents_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/contents/{+path}","compare_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/compare/{base}...{head}","merges_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/merges","archive_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/downloads","issues_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/issues{/number}","pulls_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/pulls{/number}","milestones_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/milestones{/number}","notifications_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/labels{/name}","releases_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/releases{/id}","deployments_url":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/deployments","created_at":"2014-10-14T11:48:27Z","updated_at":"2016-07-27T04:34:20Z","pushed_at":"2016-08-29T13:10:55Z","git_url":"git://github.com/telefonicaid/iotagent-node-lib.git","ssh_url":"git@github.com:telefonicaid/iotagent-node-lib.git","clone_url":"https://github.com/telefonicaid/iotagent-node-lib.git","svn_url":"https://github.com/telefonicaid/iotagent-node-lib","homepage":null,"size":1460,"stargazers_count":19,"watchers_count":19,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":8,"mirror_url":null,"open_issues_count":17,"forks":8,"open_issues":17,"watchers":19,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/pulls/436"},"html":{"href":"https://github.com/telefonicaid/iotagent-node-lib/pull/436"},"issue":{"href":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/issues/436"},"comments":{"href":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/issues/436/comments"},"review_comments":{"href":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/pulls/436/comments"},"review_comment":{"href":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/pulls/436/commits"},"statuses":{"href":"https://api.github.com/repos/telefonicaid/iotagent-node-lib/statuses/4a4e75477683ef8dbf0c7b5ca9828719930a9777"}}}}
{"actor":{"display_login":"dmoranj"}}