{"action":"created","issue":{"url":"https://api.github.com/repos/schemaorg/schemaorg/issues/1149","repository_url":"https://api.github.com/repos/schemaorg/schemaorg","labels_url":"https://api.github.com/repos/schemaorg/schemaorg/issues/1149/labels{/name}","comments_url":"https://api.github.com/repos/schemaorg/schemaorg/issues/1149/comments","events_url":"https://api.github.com/repos/schemaorg/schemaorg/issues/1149/events","html_url":"https://github.com/schemaorg/schemaorg/issues/1149","id":153577359,"number":1149,"title":"How to use schema.org's actions to describe typical forms on websites?","user":{"login":"maxboehm","id":8388836,"avatar_url":"https://avatars.githubusercontent.com/u/8388836?v=3","gravatar_id":"","url":"https://api.github.com/users/maxboehm","html_url":"https://github.com/maxboehm","followers_url":"https://api.github.com/users/maxboehm/followers","following_url":"https://api.github.com/users/maxboehm/following{/other_user}","gists_url":"https://api.github.com/users/maxboehm/gists{/gist_id}","starred_url":"https://api.github.com/users/maxboehm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/maxboehm/subscriptions","organizations_url":"https://api.github.com/users/maxboehm/orgs","repos_url":"https://api.github.com/users/maxboehm/repos","events_url":"https://api.github.com/users/maxboehm/events{/privacy}","received_events_url":"https://api.github.com/users/maxboehm/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2016-05-07T06:28:09Z","updated_at":"2016-05-14T17:17:37Z","closed_at":null,"body":"I recently stumbled upon actions within the schema.org vocabulary. As far as I understood them, they can be used to label forms and signalize their type of action.\r\n\r\nAs I want to label the actions on websites I manage, I am not sure how to label typical use cases I have found.\r\n\r\nThis are the cases I have currently deployed. Some are quite clear, others are rather fuzzy and for some of them I did not find any correspondent class at all.\r\n\r\nWould you keep this labelling?\r\n\r\n- search=SearchAction\r\n- contact=CommunicateAction\r\n- login=CheckInAction\r\n- register=RegisterAction\r\n- newsletter=SubscribeAction\r\n- feedback=InformAction\r\n- comment=CommentAction\r\n\r\nAnd, how would you label this cases?\r\n\r\n- upload_file(s)=?\r\n- reset_pw=?\r\n- filter=?\r\n- abuse=?\r\n- poll=?\r\n- add2cart=?\r\n- orderby=?\r\n\r\n'filter' is the typical limitation of a resultset and 'orderby' is to change the order of a resultset by some criteria. 'reset_pw' is the typical form where you enter your email address and you get a mail to reset your password.\r\n\r\nThank you!\r\nMax\r\n\r\nPS.: [Cross posting](http://stackoverflow.com/questions/36982781/how-to-use-schema-orgs-actions-to-describe-typical-forms-on-websites). "},"comment":{"url":"https://api.github.com/repos/schemaorg/schemaorg/issues/comments/219232170","html_url":"https://github.com/schemaorg/schemaorg/issues/1149#issuecomment-219232170","issue_url":"https://api.github.com/repos/schemaorg/schemaorg/issues/1149","id":219232170,"user":{"login":"grgarside","id":191085,"avatar_url":"https://avatars.githubusercontent.com/u/191085?v=3","gravatar_id":"","url":"https://api.github.com/users/grgarside","html_url":"https://github.com/grgarside","followers_url":"https://api.github.com/users/grgarside/followers","following_url":"https://api.github.com/users/grgarside/following{/other_user}","gists_url":"https://api.github.com/users/grgarside/gists{/gist_id}","starred_url":"https://api.github.com/users/grgarside/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/grgarside/subscriptions","organizations_url":"https://api.github.com/users/grgarside/orgs","repos_url":"https://api.github.com/users/grgarside/repos","events_url":"https://api.github.com/users/grgarside/events{/privacy}","received_events_url":"https://api.github.com/users/grgarside/received_events","type":"User","site_admin":false},"created_at":"2016-05-14T17:17:37Z","updated_at":"2016-05-14T17:17:37Z","body":"I agree with all the actions you labelled, apart from matching login to CheckInAction. CheckInAction is a child of CommunicateAction, which would strongly imply some sort of communication taking place as part of the 'check in'. I'm not sure I'd use this action in this way, but it does seem to be the closest one to fit.\r\n\r\nFor the others, here's my opinion:\r\n\r\n- > upload_files\r\n\r\n  [SendAction](http://schema.org/SendAction) seems most appropriate here, as it's for \"electronically dispatching an object for transfer from an origin to a destination\" which is essentially what uploading is.\r\n\r\n- > reset_pw\r\n\r\n  Possibly [UpdateAction](http://schema.org/UpdateAction) but similar to login there doesn't seem to be a really good fit for this kind of operation.\r\n\r\n- > filter\r\n\r\n  I'd use [SearchAction](http://schema.org/SearchAction) again. Filtering is essentially searching with a defined [query](http://schema.org/query).\r\n\r\n- > abuse\r\n\r\n  I'm not sure this is entirely enough information to choose an action for, but if this is essentially a 'report' feature, I'm not sure there's an action which fits this. All the actions such as [SuspendAction](http://schema.org/SuspendAction) suggest an immediate effect which wouldn't be the case with a user report.\r\n\r\n- > poll\r\n\r\n  Again, this is unclear exactly what this does, but if you're creating a poll with this action then I suggest [AskAction](http://schema.org/AskAction) as you're essentially asking a multiple choice question.\r\n\r\n- > add2cart\r\n\r\n  [BuyAction](http://schema.org/BuyAction) may fit but is a bit more absolute than just adding an item to the cart. More generally, adding a product to a cart is essentially adding an item to a list, which means you can use [AddAction](http://schema.org/AddAction) to add the item and [DeleteAction](http://schema.org/DeleteAction) to remove it.\r\n\r\n- > orderby\r\n\r\n  This is too similar to filtering that I'd use the same as filter: [SearchAction](http://schema.org/SearchAction)."}}