SharePoint Saturday Baltimore 7/25/09 - Introduction To Developing Custom Actions Within SharePoint
3 likes463 views
The document provides an introduction to developing custom actions in SharePoint, explaining their definition, functionality, and implementation. It includes demonstrations on creating custom actions, modifying them, and how to group or hide them. Resources and tools needed for development, along with a brief overview of custom action anatomy, are also discussed.
SharePoint Saturday Baltimore 7/25/09 - Introduction To Developing Custom Actions Within SharePoint
- 1. Introduction to Developing Custom Actions within SharePointGeoff Varosky
- 2. About MeGeoff Varosky MCP, MCTSSenior Solutions Developer for Grace-Hunt, LLC.Blog: http://www.geoffvarosky.comEmail: gvarosky@grace-hunt.comTwitter: @gvaro
- 3. About Grace-HuntFounded in 2004Based in Hudson, MAPresence in North East, Mid Atlantic, and South East RegionsSenior Level StaffMicrosoft Gold PartnerSpecializing in SharePoint and Dynamics (CRM, SL, GP, NAV)Web: http://www.grace-hunt.com
- 4. AgendaWhat are Custom Actions?DemonstrationsCreating a Simple Custom ActionAnatomy of a Custom ActionCreating a Slightly More Complex Custom ActionHiding Custom ActionsCustom Action GroupsReferencesQ&A
- 5. Just What Are Custom Actions?Per Microsoft –“A custom action represents a link, toolbar button, menu item, or any control that can be added to a toolbar or menu that a user sees. Custom actions can be bound to list type, content type, file type, or programmatic identifier (ProgID).”Source: http://snipurl.com/d8y70
- 6. Just What Are Custom Actions?What does that mean?Custom Actions can be bound to List TypesA Custom Action can be bound to a Document Library, but, may not be bound to a Task ListExample: Check In/Check Out
- 7. Just What Are Custom Actions?What does that mean?Custom Actions can be bound to File TypesExample: ‘Edit in Microsoft Word’ bound to Word (.doc, .docx, etc.) document types
- 8. Just What Are Custom Actions?What does that mean?Custom Actions can be bound to Content TypesExample: Folders, Document Content Types, List Content Types, etc.Programmatic IdentifiersExample: Task List Identifier (107)
- 9. What Can Custom Actions Do?Examples of Custom ActionsEdit Control Block (ECB Menu)ToolbarsSite Actions MenuSite Settings PageCentral Administration PagesOperations, Application ManagementShared Service Provider PagesYou get the idea…(hopefully?)
- 10. ExamplesToolbars
- 13. ExamplesSite Settings (Custom Action Group)
- 14. ExamplesEdit Control Block (ECB)
- 16. What Can Custom Actions Do?But wait, there’s more!Create links to pages that really should be there…Example: There is a link to the Site Collection Recycle Bin on the Site Settings page, however, there is no link to the current site Recycle Bin. (Why? Who knows…) Never fear though – you can add one easily (Demo #1)Custom Actions can pass along information to act uponExample: Add a “Complete Task” action to an Edit Control Block, which calls an ASPX page, taking the parameters of the List ID and Item ID, and updating the task item within a list. (Demo #2)
- 17. What Can Custom Actions Do?…and moreCustom Actions can also be hiddenExample: You do not want site administrators to be able to delete their sites by using the Delete This Site link on the Site Settings page – so, we can remove it by using HideCustomAction (Demo #3)Create Groupings of Custom Actions by using CustomActionGroupExample: Create a grouping of your Custom Actions on the Site Settings page for all of your Custom Actions… (Demo #4)
- 18. What Tools Are Needed?Notepad!What do I use?Visual StudioAndrew Connell’s SharePoint Project Utility for Visual Studiohttp://snipurl.com/d8yv9Requires DevExpress DX Core to be installed (free)WSPBuilder (CodePlex)http://snipurl.com/d8yxvSharePoint Solution Installer (CodePlex)http://snipurl.com/nt6ux
- 19. DemoCreating a Simple Custom Action
- 20. Anatomy of a Custom ActionFeature Definition (feature.xml)
- 21. Anatomy of a Custom ActionScope Web
- 22. A “sub-site”
- 23. Only activates the feature on the specific web
- 24. Site
- 25. Site Collection
- 26. Applies to all webs within the site collection
- 27. Web Application
- 28. Applies to all site collections and webs within a web application
- 29. Farm
- 30. Applies to all web applications, site collections, etc.....Anatomy of a Custom ActionElement Manifest (manifest.xml)
- 31. Anatomy of a Custom Action<CustomActionContentTypeId = "Text" ControlAssembly = "Text" ControlClass = "Text" ControlSrc = "Text" Description = "Text" GroupId = "Text" Id = "Text" ImageUrl = "Text" Location = "Text" RegistrationId = "Text" RegistrationType = "Text" RequireSiteAdministrator = "TRUE" | "FALSE" Rights = "Text" Sequence = "Integer" ShowInLists = "TRUE" | "FALSE" ShowInReadOnlyContentTypes = "TRUE" | "FALSE" ShowInSealedContentTypes = "TRUE" | "FALSE" Title = "Text"> </CustomAction>
- 32. Anatomy of a Custom ActionId (optional)Specifies a unique identifier for custom action
- 33. May be a GUID or a unique term
- 34. Example:DeleteWebGroupID(optional)Identifies the unique group that this element is contained in
- 35. Example:SiteAdministrationAnatomy of a Custom ActionLocation (optional)Specifies the location for this custom action
- 36. Example:Microsoft.SharePoint.SiteSettingsRegistrationType(optional)Specifies the list, item content type, file type, or programmatic identifier that this action is associated with
- 37. Example: ListAnatomy of a Custom ActionRegistrationId(optional)Specifies the registration attachment for a per-item action
- 38. Example (List Identifier – Task List): 107 (http://snipurl.com/ntd5g)Title (required)Specifies the name of your action
- 39. Example: DeleteWebDescription (optional)Longer description for action which is shown as a tooltip or sub-description (where applicable) for the actionAnatomy of a Custom ActionSequence (optional)The order in which your action will appear.
- 40. If not specified, displayed in the order it is read by SharePoint by Feature and by order in element listing (XML).Anatomy of a Custom ActionPermissionsRequireSiteAdministrator (optional)
- 41. Boolean (True or False)
- 42. Cannot be used on ECB menu list items
- 43. Rights
- 44. Specify rights needed for this Custom Action to be visible
- 46. Possible Values http://snipurl.com/ntcz5Anatomy of a Custom ActionUrlAction Tokens~site
- 47. References the current SPWeb context
- 48. ~sitecollection
- 49. References the current SPSite context
- 50. {ItemId}
- 51. GUID of the item action is called from
- 52. {ItemUrl}
- 53. URL of the item the action is called fromAnatomy of a Custom ActionUrlAction Tokens{ListId}
- 54. GUID representation of the list
- 55. {SiteUrl}
- 56. References the URL of the SPWeb context the action is called from
- 57. {RecurrenceId}
- 58. Unsupported in context menus (http://snipurl.com/ntcjc)
- 59. Source URL
- 60. This token is not available, but there is a way to get it via JavaScript, which we will see in Demo #2
- 61. http://snipurl.com/d8zb6DemoCreating a Slightly More Complex Custom Action
- 64. ResourcesMy Bloghttp://www.geoffvarosky.comClick on SharePoint Saturday category on left side of pageGraceHunt.SharePointCodePlex Projectshttp://codeplex.com/GraceHuntJohn Holliday’s Custom Action ResourcesHiding Custom Actions, and a Utility to get all custom action identifiers http://snipurl.com/d8zea
- 65. ResourcesMSDNCustom Action Definitions http://snipurl.com/d8zi7Default Custom Action Locations and IDs http://snipurl.com/d8zkaHow to: Add Custom Actions to the User Interfacehttp://snipurl.com/d8zq2CustomAction Element http://snipurl.com/d9jd4CustomActionGroup Element http://snipurl.com/d9jfxHideCustomAction Elementhttp://snipurl.com/d9jhs
- 66. Q&A
- 67. About MeGeoff Varosky MCP, MCTSSenior Solutions Developer for Grace-Hunt, LLC.Company: http://www.grace-hunt.comBlog: http://www.geoffvarosky.comEmail: gvarosky@grace-hunt.comTwitter: @gvaro
Editor's Notes
- #2: Thank you for your time today.<Introductions>
- #33: Hidden=trueActivate and deactivate via CMD line – why? You do not want site admins, who you are hiding this from, to be able to deactivate the feature to delete the site!stsadm -o activatefeature -name SPS.HideCustomAction -url http://spsaturday.litwareinc.com
- #37: Record questions – post answers on my blog following SharePoint Saturday