[MS-PWEDPS]: PowerPoint Web Editor Data Protocol. Intellectual Property Rights Notice for Open Specifications Documentation

Transcription

1 [MS-PWEDPS]: Intellectual Property Rights Notice for Open Specifications Documentation Technical Documentation. Microsoft publishes Open Specifications documentation ( this documentation ) for protocols, file formats, data portability, computer languages, and standards support. Additionally, overview documents cover inter-protocol relationships and interactions. Copyrights. This documentation is covered by Microsoft copyrights. Regardless of any other terms that are contained in the terms of use for the Microsoft website that hosts this documentation, you can make copies of it in order to develop implementations of the technologies that are described in this documentation and can distribute portions of it in your implementations that use these technologies or in your documentation as necessary to properly document the implementation. You can also distribute in your implementation, with or without modification, any schemas, IDLs, or code samples that are included in the documentation. This permission also applies to any documents that are referenced in the Open Specifications documentation. No Trade Secrets. Microsoft does not claim any trade secret rights in this documentation. Patents. Microsoft has patents that might cover your implementations of the technologies described in the Open Specifications documentation. Neither this notice nor Microsoft's delivery of this documentation grants any licenses under those patents or any other Microsoft patents. However, a given Open Specifications document might be covered by the Microsoft Open Specifications Promise or the Microsoft Community Promise. If you would prefer a written license, or if the technologies described in this documentation are not covered by the Open Specifications Promise or Community Promise, as applicable, patent licenses are available by contacting iplg@microsoft.com. License Programs. To see all of the protocols in scope under a specific license program and the associated patents, visit the Patent Map. Trademarks. The names of companies and products contained in this documentation might be covered by trademarks or similar intellectual property rights. This notice does not grant any licenses under those rights. For a list of Microsoft trademarks, visit Fictitious Names. The example companies, organizations, products, domain names, addresses, logos, people, places, and events that are depicted in this documentation are fictitious. No association with any real company, organization, product, domain name, address, logo, person, place, or event is intended or should be inferred. Reservation of Rights. All other rights are reserved, and this notice does not grant any rights other than as specifically described above, whether by implication, estoppel, or otherwise. Tools. The Open Specifications documentation does not require the use of Microsoft programming tools or programming environments in order for you to develop an implementation. If you have access to Microsoft programming tools and environments, you are free to take advantage of them. Certain Open Specifications documents are intended for use in conjunction with publicly available standards specifications and network programming art and, as such, assume that the reader either is familiar with the aforementioned material or has immediate access to it. Support. For questions and support, please contact dochelp@microsoft.com. 1 / 297

2 Revision Summary Date Revision History Revision Class Comments 7/13/ Major Initial Availability 8/28/ Editorial Revised and edited the technical content 11/6/ Editorial Revised and edited the technical content 2/19/ Major Updated and revised the technical content 3/31/ Editorial Revised and edited the technical content 4/30/ Editorial Revised and edited the technical content 6/7/ Editorial Revised and edited the technical content 6/29/ Editorial Changed language and formatting in the technical content. 7/23/ Minor Clarified the meaning of the technical content. 9/27/ None No changes to the meaning, language, or formatting of the technical content. 11/15/ Minor Clarified the meaning of the technical content. 12/17/ None 3/18/ None No changes to the meaning, language, or formatting of the technical content. No changes to the meaning, language, or formatting of the technical content. 6/10/ Major Significantly changed the technical content. 1/20/ Major Significantly changed the technical content. 4/11/ None 7/16/ None No changes to the meaning, language, or formatting of the technical content. No changes to the meaning, language, or formatting of the technical content. 10/8/ Major Significantly changed the technical content. 2/11/ Major Significantly changed the technical content. 7/30/ Major Significantly changed the technical content. 11/18/ None 2/10/ None No changes to the meaning, language, or formatting of the technical content. No changes to the meaning, language, or formatting of the technical content. 4/30/ Minor Clarified the meaning of the technical content. 7/31/ None 10/30/ None No changes to the meaning, language, or formatting of the technical content. No changes to the meaning, language, or formatting of the technical content. 3/16/ Major Significantly changed the technical content. 2 / 297

3 Date Revision History Revision Class Comments 6/23/ None 9/14/ None No changes to the meaning, language, or formatting of the technical content. No changes to the meaning, language, or formatting of the technical content. 6/20/ Minor Clarified the meaning of the technical content. 3 / 297

4 Table of Contents 1 Introduction Glossary References Normative References Informative References Protocol Overview (Synopsis) Relationship to Other Protocols Prerequisites/Preconditions Applicability Statement Versioning and Capability Negotiation Vendor-Extensible Fields Standards Assignments Messages Transport Common Message Syntax Namespaces Messages Elements Complex Types ArrayOfComment ArrayOfContentMasterFe ArrayOfEditAnimInfo ArrayOfEditorInfo ArrayOfEditShape ArrayOfEditSlide ArrayOfEditSlideChanges ArrayOfEditSlideInfoFe ArrayOfMainMasterFe ArrayOfMainMasterResourcesFe ArrayOfSlideUpdateInfo ArrayOfStyleGalleryItem ArrayOfunsignedInt ArrayOfViewElement BoundingRegion ClippingInfo CoauthState CoauthUpdate Comment ContentMasterFe ContentUpdateInfo EditAnimInfo EditCommandResponse EditorInfo EditPresentationChanges EditPresentationInfo EditPresentationResources EditShape EditSlide EditSlideChanges EditSlideInfoFe EditTransitionInfo FontSizeMapping Html MainMasterFe / 297

5 MainMasterResourcesFe Notes Point PptViewingService.PrintResult PresetSchemeColorMapping Rectangle ServiceError ServiceResult SlideID SlideIdList SlideUpdateInfo SmartArtInfo StyleGalleryItem Theme ThemeColor ViewElement Simple Types char ClientActions duration ErrorCode guid ServiceErrorType Attributes Groups Attribute Groups Protocol Details Server Details Abstract Data Model Timers Initialization Message Processing Events and Sequencing Rules AddComment Messages IPptEdit_AddComment_InputMessage IPptEdit_AddComment_OutputMessage Elements AddComment AddCommentResponse Complex Types Simple Types Attributes Groups Attribute Groups ApplyShapeFill Messages IPptEdit_ApplyShapeFill_InputMessage IPptEdit_ApplyShapeFill_OutputMessage Elements ApplyShapeFill ApplyShapeFillResponse Complex Types Simple Types Attributes Groups Attribute Groups ApplyShapeOutlineColor / 297

6 Messages IPptEdit_ApplyShapeOutlineColor_InputMessage IPptEdit_ApplyShapeOutlineColor_OutputMessage Elements ApplyShapeOutlineColor ApplyShapeOutlineColorResponse Complex Types Simple Types Attributes Groups Attribute Groups ApplyShapeOutlineDashStyle Messages IPptEdit_ApplyShapeOutlineDashStyle_InputMessage IPptEdit_ApplyShapeOutlineDashStyle_OutputMessage Elements ApplyShapeOutlineDashStyle ApplyShapeOutlineDashStyleResponse Complex Types Simple Types Attributes Groups Attribute Groups ApplyShapeOutlineEndStyle Messages IPptEdit_ApplyShapeOutlineEndStyle_InputMessage IPptEdit_ApplyShapeOutlineEndStyle_OutputMessage Elements ApplyShapeOutlineEndStyle ApplyShapeOutlineEndStyleResponse Complex Types Simple Types Attributes Groups Attribute Groups ApplyShapeOutlineWidth Messages IPptEdit_ApplyShapeOutlineWidth_InputMessage IPptEdit_ApplyShapeOutlineWidth_OutputMessage Elements ApplyShapeOutlineWidth ApplyShapeOutlineWidthResponse Complex Types Simple Types Attributes Groups Attribute Groups ApplyShapeStyle Messages IPptEdit_ApplyShapeStyle_InputMessage IPptEdit_ApplyShapeStyle_OutputMessage Elements ApplyShapeStyle ApplyShapeStyleResponse Complex Types Simple Types Attributes Groups / 297

7 Attribute Groups ApplyTheme Messages IPptEdit_ApplyTheme_InputMessage IPptEdit_ApplyTheme_OutputMessage Elements ApplyTheme ApplyThemeResponse Complex Types Simple Types Attributes Groups Attribute Groups ArrangeShape Messages IPptEdit_ArrangeShape_InputMessage IPptEdit_ArrangeShape_OutputMessage Elements ArrangeShape ArrangeShapeResponse Complex Types Simple Types Attributes Groups Attribute Groups ChangeLayout Messages IPptEdit_ChangeLayout_InputMessage IPptEdit_ChangeLayout_OutputMessage Elements ChangeLayout ChangeLayoutResponse Complex Types Simple Types Attributes Groups Attribute Groups ChangePictureStyle Messages IPptEdit_ChangePictureStyle_InputMessage IPptEdit_ChangePictureStyle_OutputMessage Elements ChangePictureStyle ChangePictureStyleResponse Complex Types Simple Types Attributes Groups Attribute Groups ChangeSmartArtColor Messages IPptEdit_ChangeSmartArtColor_InputMessage IPptEdit_ChangeSmartArtColor_OutputMessage Elements ChangeSmartArtColor ChangeSmartArtColorResponse Complex Types Simple Types / 297

8 Attributes Groups Attribute Groups ChangeSmartArtLayout Messages IPptEdit_ChangeSmartArtLayout_InputMessage IPptEdit_ChangeSmartArtLayout_OutputMessage Elements ChangeSmartArtLayout ChangeSmartArtLayoutResponse Complex Types Simple Types Attributes Groups Attribute Groups ChangeSmartArtStyle Messages IPptEdit_ChangeSmartArtStyle_InputMessage IPptEdit_ChangeSmartArtStyle_OutputMessage Elements ChangeSmartArtStyle ChangeSmartArtStyleResponse Complex Types Simple Types Attributes Groups Attribute Groups ClearPlaceholder Messages IPptEdit_ClearPlaceholder_InputMessage IPptEdit_ClearPlaceholder_OutputMessage Elements ClearPlaceholder ClearPlaceholderResponse Complex Types Simple Types Attributes Groups Attribute Groups DeleteComment Messages IPptEdit_DeleteComment_InputMessage IPptEdit_DeleteComment_OutputMessage Elements DeleteComment DeleteCommentResponse Complex Types Simple Types Attributes Groups Attribute Groups DeleteSlide Messages IPptEdit_DeleteSlide_InputMessage IPptEdit_DeleteSlide_OutputMessage Elements DeleteSlide DeleteSlideResponse / 297

9 Complex Types Simple Types Attributes Groups Attribute Groups DuplicateShape Messages IPptEdit_DuplicateShape_InputMessage IPptEdit_DuplicateShape_OutputMessage Elements DuplicateShape DuplicateShapeResponse Complex Types Simple Types Attributes Groups Attribute Groups DuplicateSlide Messages IPptEdit_DuplicateSlide_InputMessage IPptEdit_DuplicateSlide_OutputMessage Elements DuplicateSlide DuplicateSlideResponse Complex Types Simple Types Attributes Groups Attribute Groups EditComment Messages IPptEdit_EditComment_InputMessage IPptEdit_EditComment_OutputMessage Elements EditComment EditCommentResponse Complex Types Simple Types Attributes Groups Attribute Groups FlipShape Messages IPptEdit_FlipShape_InputMessage IPptEdit_FlipShape_OutputMessage Elements FlipShape FlipShapeResponse Complex Types Simple Types Attributes Groups Attribute Groups GetCoauthUpdates Messages IPptEdit_GetCoauthUpdates_InputMessage IPptEdit_GetCoauthUpdates_OutputMessage Elements / 297

10 GetCoauthUpdates GetCoauthUpdatesResponse Complex Types Simple Types Attributes Groups Attribute Groups GetEditPresInfo Messages IPptEdit_GetEditPresInfo_InputMessage IPptEdit_GetEditPresInfo_OutputMessage Elements GetEditPresInfo GetEditPresInfoResponse Complex Types Simple Types Attributes Groups Attribute Groups GetEditPresInfoGetEditSlideById Messages IPptEdit_GetEditPresInfoGetEditSlideById_InputMessage IPptEdit_GetEditPresInfoGetEditSlideById_OutputMessage Elements GetEditPresInfoGetEditSlideById GetEditPresInfoGetEditSlideByIdResponse Complex Types Simple Types Attributes Groups Attribute Groups GetEditPresResources Messages IPptEdit_GetEditPresResources_InputMessage IPptEdit_GetEditPresResources_OutputMessage Elements GetEditPresResources GetEditPresResourcesResponse Complex Types Simple Types Attributes Groups Attribute Groups GetEditSlide Messages IPptEdit_GetEditSlide_InputMessage IPptEdit_GetEditSlide_OutputMessage Elements GetEditSlide GetEditSlideResponse Complex Types Simple Types Attributes Groups Attribute Groups GetPresentationId Messages IPptEdit_GetPresentationId_InputMessage / 297

11 IPptEdit_GetPresentationId_OutputMessage Elements GetPresentationId GetPresentationIdResponse Complex Types Simple Types Attributes Groups Attribute Groups InsertClipart Messages IPptEdit_InsertClipart_InputMessage IPptEdit_InsertClipart_OutputMessage Elements InsertClipart InsertClipartResponse Complex Types Simple Types Attributes Groups Attribute Groups InsertShape Messages IPptEdit_InsertShape_InputMessage IPptEdit_InsertShape_OutputMessage Elements InsertShape InsertShapeResponse Complex Types Simple Types Attributes Groups Attribute Groups InsertSlide Messages IPptEdit_InsertSlide_InputMessage IPptEdit_InsertSlide_OutputMessage Elements InsertSlide InsertSlideResponse Complex Types Simple Types Attributes Groups Attribute Groups InsertSmartArt Messages IPptEdit_InsertSmartArt_InputMessage IPptEdit_InsertSmartArt_OutputMessage Elements InsertSmartArt InsertSmartArtResponse Complex Types Simple Types Attributes Groups Attribute Groups LogULS / 297

12 Messages IPptEdit_LogULS_InputMessage IPptEdit_LogULS_OutputMessage Elements LogULS LogULSResponse Complex Types Simple Types Attributes Groups Attribute Groups MoveComment Messages IPptEdit_MoveComment_InputMessage IPptEdit_MoveComment_OutputMessage Elements MoveComment MoveCommentResponse Complex Types Simple Types Attributes Groups Attribute Groups MoveShape Messages IPptEdit_MoveShape_InputMessage IPptEdit_MoveShape_OutputMessage Elements MoveShape MoveShapeResponse Complex Types Simple Types Attributes Groups Attribute Groups MoveSlide Messages IPptEdit_MoveSlide_InputMessage IPptEdit_MoveSlide_OutputMessage Elements MoveSlide MoveSlideResponse Complex Types Simple Types Attributes Groups Attribute Groups PastePicture Messages IPptEdit_PastePicture_InputMessage IPptEdit_PastePicture_OutputMessage Elements PastePicture PastePictureResponse Complex Types Simple Types Attributes Groups / 297

13 Attribute Groups Print Messages IPptEdit_Print_InputMessage IPptEdit_Print_OutputMessage Elements Print PrintResponse Complex Types Simple Types Attributes Groups Attribute Groups Redo Messages IPptEdit_Redo_InputMessage IPptEdit_Redo_OutputMessage Elements Redo RedoResponse Complex Types Simple Types Attributes Groups Attribute Groups RemoveShapeFill Messages IPptEdit_RemoveShapeFill_InputMessage IPptEdit_RemoveShapeFill_OutputMessage Elements RemoveShapeFill RemoveShapeFillResponse Complex Types Simple Types Attributes Groups Attribute Groups RemoveShapeOutline Messages IPptEdit_RemoveShapeOutline_InputMessage IPptEdit_RemoveShapeOutline_OutputMessage Elements RemoveShapeOutline RemoveShapeOutlineResponse Complex Types Simple Types Attributes Groups Attribute Groups ReorderAnimation Messages IPptEdit_ReorderAnimation_InputMessage IPptEdit_ReorderAnimation_OutputMessage Elements ReorderAnimation ReorderAnimationResponse Complex Types Simple Types / 297

14 Attributes Groups Attribute Groups ReplaceNotes Messages IPptEdit_ReplaceNotes_InputMessage IPptEdit_ReplaceNotes_OutputMessage Elements ReplaceNotes ReplaceNotesResponse Complex Types Simple Types Attributes Groups Attribute Groups ReplaceText Messages IPptEdit_ReplaceText_InputMessage IPptEdit_ReplaceText_OutputMessage Elements ReplaceText ReplaceTextResponse Complex Types Simple Types Attributes Groups Attribute Groups ResetPicture Messages IPptEdit_ResetPicture_InputMessage IPptEdit_ResetPicture_OutputMessage Elements ResetPicture ResetPictureResponse Complex Types Simple Types Attributes Groups Attribute Groups ResetSmartArt Messages IPptEdit_ResetSmartArt_InputMessage IPptEdit_ResetSmartArt_OutputMessage Elements ResetSmartArt ResetSmartArtResponse Complex Types Simple Types Attributes Groups Attribute Groups ResizeShape Messages IPptEdit_ResizeShape_InputMessage IPptEdit_ResizeShape_OutputMessage Elements ResizeShape ResizeShapeResponse / 297

15 Complex Types Simple Types Attributes Groups Attribute Groups ReverseSmartArt Messages IPptEdit_ReverseSmartArt_InputMessage IPptEdit_ReverseSmartArt_OutputMessage Elements ReverseSmartArt ReverseSmartArtResponse Complex Types Simple Types Attributes Groups Attribute Groups RotateShape Messages IPptEdit_RotateShape_InputMessage IPptEdit_RotateShape_OutputMessage Elements RotateShape RotateShapeResponse Complex Types Simple Types Attributes Groups Attribute Groups SaveAndClose Messages IPptEdit_SaveAndClose_InputMessage IPptEdit_SaveAndClose_OutputMessage Elements SaveAndClose SaveAndCloseResponse Complex Types Simple Types Attributes Groups Attribute Groups SetAnimation Messages IPptEdit_SetAnimation_InputMessage IPptEdit_SetAnimation_OutputMessage Elements SetAnimation SetAnimationResponse Complex Types Simple Types Attributes Groups Attribute Groups SetShapeAlignment Messages IPptEdit_SetShapeAlignment_InputMessage IPptEdit_SetShapeAlignment_OutputMessage Elements / 297

16 SetShapeAlignment SetShapeAlignmentResponse Complex Types Simple Types Attributes Groups Attribute Groups SetShapeBold Messages IPptEdit_SetShapeBold_InputMessage IPptEdit_SetShapeBold_OutputMessage Elements SetShapeBold SetShapeBoldResponse Complex Types Simple Types Attributes Groups Attribute Groups SetShapeBullet Messages IPptEdit_SetShapeBullet_InputMessage IPptEdit_SetShapeBullet_OutputMessage Elements SetShapeBullet SetShapeBulletResponse Complex Types Simple Types Attributes Groups Attribute Groups SetShapeFontColor Messages IPptEdit_SetShapeFontColor_InputMessage IPptEdit_SetShapeFontColor_OutputMessage Elements SetShapeFontColor SetShapeFontColorResponse Complex Types Simple Types Attributes Groups Attribute Groups SetShapeFontName Messages IPptEdit_SetShapeFontName_InputMessage IPptEdit_SetShapeFontName_OutputMessage Elements SetShapeFontName SetShapeFontNameResponse Complex Types Simple Types Attributes Groups Attribute Groups SetShapeFontSize Messages IPptEdit_SetShapeFontSize_InputMessage / 297

17 IPptEdit_SetShapeFontSize_OutputMessage Elements SetShapeFontSize SetShapeFontSizeResponse Complex Types Simple Types Attributes Groups Attribute Groups SetShapeItalic Messages IPptEdit_SetShapeItalic_InputMessage IPptEdit_SetShapeItalic_OutputMessage Elements SetShapeItalic SetShapeItalicResponse Complex Types Simple Types Attributes Groups Attribute Groups SetShapeTextDirection Messages IPptEdit_SetShapeTextDirection_InputMessage IPptEdit_SetShapeTextDirection_OutputMessage Elements SetShapeTextDirection SetShapeTextDirectionResponse Complex Types Simple Types Attributes Groups Attribute Groups SetShapeUnderline Messages IPptEdit_SetShapeUnderline_InputMessage IPptEdit_SetShapeUnderline_OutputMessage Elements SetShapeUnderline SetShapeUnderlineResponse Complex Types Simple Types Attributes Groups Attribute Groups SetTransition Messages IPptEdit_SetTransition_InputMessage IPptEdit_SetTransition_OutputMessage Elements SetTransition SetTransitionResponse Complex Types Simple Types Attributes Groups Attribute Groups SetTransitionApplyAll / 297

18 Messages IPptEdit_SetTransitionApplyAll_InputMessage IPptEdit_SetTransitionApplyAll_OutputMessage Elements SetTransitionApplyAll SetTransitionApplyAllResponse Complex Types Simple Types Attributes Groups Attribute Groups SetWordArt Messages IPptEdit_SetWordArt_InputMessage IPptEdit_SetWordArt_OutputMessage Elements SetWordArt SetWordArtResponse Complex Types Simple Types Attributes Groups Attribute Groups ShapeFormatPainting Messages IPptEdit_ShapeFormatPainting_InputMessage IPptEdit_ShapeFormatPainting_OutputMessage Elements ShapeFormatPainting ShapeFormatPaintingResponse Complex Types Simple Types Attributes Groups Attribute Groups ShowHideSlide Messages IPptEdit_ShowHideSlide_InputMessage IPptEdit_ShowHideSlide_OutputMessage Elements ShowHideSlide ShowHideSlideResponse Complex Types Simple Types Attributes Groups Attribute Groups Undo Messages IPptEdit_Undo_InputMessage IPptEdit_Undo_OutputMessage Elements Undo UndoResponse Complex Types Simple Types Attributes Groups / 297

19 Attribute Groups UngroupShape Messages IPptEdit_UngroupShape_InputMessage IPptEdit_UngroupShape_OutputMessage Elements UngroupShape UngroupShapeResponse Complex Types Simple Types Attributes Groups Attribute Groups UpdateCanary Messages IPptEdit_UpdateCanary_InputMessage IPptEdit_UpdateCanary_OutputMessage Elements UpdateCanary UpdateCanaryResponse Complex Types Simple Types Attributes Groups Attribute Groups Timer Events Other Local Events Protocol Examples Sample Protocol Interaction Security Security Considerations for Implementers Index of Security Parameters Appendix A: Full WSDL Appendix B: Full XML Schema Shared Schema face Schema Schema Schema Schema rverinternalservice/ Schema Appendix C: Product Behavior Change Tracking Index / 297

20 1 Introduction The enables a protocol client to obtain information about and modify slide collection content on a protocol server. Sections 1.5, 1.8, 1.9, 2, and 3 of this specification are normative. All other sections and examples in this specification are informative. 1.1 Glossary This document uses the following terms: absolute URL: The full Internet address of a page or other World Wide Web resource. The absolute URL includes a protocol, such as "http," a network location, and an optional path and file name for example, ActiveX control: A reusable software control, such as a check box or button, that uses ActiveX technology and provides options to users or runs macros or scripts that automate a task. See also ActiveX object. build identifier: An integer that identifies a build. canary: A token that stores data about an application or user session. Typically it is used by web services to help authenticate an application or user. comment: An annotation that is associated with a cell, text, or other object to provide contextspecific information or reviewer feedback. cookie: A small data file that is stored on a user's computer and carries state information between participating protocol servers and protocol clients. cross-site request forgery: A type of security vulnerability that enables malicious users to send unauthorized commands to a website or application by assuming the identity of an authorized user and running script under that assumed identity. Also referred to as one-click attack and session riding. cross-site scripting: A type of security vulnerability that enables malicious users to insert clientside script into webpages and to run that script when those pages are viewed by other users. The script might then gain access to user-specific data, such as cookies, cached objects, and application settings. Also referred to as XSS. Hypertext Markup Language (HTML): An application of the Standard Generalized Markup Language (SGML) that uses tags to mark elements in a document, as described in [HTML]. ink: A process of entering text in handwritten form. Instead of converting handwritten text to typed text, ink is converted to an object and displayed exactly as it was written. language code identifier (LCID): A 32-bit number that identifies the user interface human language dialect or variation that is supported by an application or a client computer. main master slide: A slide that defines the formatting and content that can be used by presentation slides. If a slide uses formatting and content from a main master slide, it is referred to as following a main master slide. OLE object: An object that supports the Object Linking and Embedding (OLE) protocol. placeholder: A character or symbol that is used in place of an actual value, text, or object. The actual value that the placeholder represents is unknown or unavailable at the current time, or is not displayed for security reasons. 20 / 297

21 presentation: A collection of slides that are intended to be viewed by an audience. presentation slide: A slide that contains the content that can be displayed during a slide show. A presentation slide can derive formatting and content from a main master slide or a title master slide. right-to-left: A reading and display order that is optimized for right-to-left languages. shape: A collection of qualifiers, such as names, and quantifiers, such as coordinates, that is used to represent a geometric object. A shape can be contained in a document, file structure, runtime structure, or other medium. slide: A frame that contains text, shapes, pictures, or other content. A slide is a digital equivalent to a traditional film slide. slide layout: An organizational scheme, such as Title Only or Comparison, for content on a presentation slide. SmartArt: A type of graphical element, such as a diagram or image, that automatically positions and combines images with text to produce a well-formatted and well-designed graphic. SOAP action: The HTTP request header field used to indicate the intent of the SOAP request, using a URI value. See [SOAP1.1] section for more information. SOAP body: A container for the payload data being delivered by a SOAP message to its recipient. See [SOAP1.2-1/2007] section 5.3 for more information. SOAP fault: A container for error and status information within a SOAP message. See [SOAP1.2-1/2007] section 5.4 for more information. SOAP message: An XML document consisting of a mandatory SOAP envelope, an optional SOAP header, and a mandatory SOAP body. See [SOAP1.2-1/2007] section 5 for more information. theme: A set of unified design elements, such as colors, fonts, graphics, and styles, that define the appearance of a website, document, or data visualization. title master slide: A slide that defines the formatting and content that can be used by presentation slides that have a title slide layout. If a slide uses formatting and content from a title master slide, it is referred to as following a title master slide. Uniform Resource Locator (URL): A string of characters in a standardized format that identifies a document or resource on the World Wide Web. The format is as specified in [RFC1738]. Web Services Language (WSDL): An XML format for describing network services as a set of endpoints that operate on messages that contain either document-oriented or procedure-oriented information. The operations and messages are described abstractly and are bound to a concrete network protocol and message format in order to define an endpoint. Related concrete endpoints are combined into abstract endpoints, which describe a network service. WSDL is extensible, which allows the description of endpoints and their messages regardless of the message formats or network protocols that are used. website: A group of related webpages that is hosted by a server on the World Wide Web or an intranet. Each website has its own entry points, metadata, administration settings, and workflows. Also referred to as site. WSDL message: An abstract, typed definition of the data that is communicated during a WSDL operation [WSDL]. Also, an element that describes the data being exchanged between web service providers and clients. 21 / 297

22 WSDL operation: A single action or function of a web service. The execution of a WSDL operation typically requires the exchange of messages between the service requestor and the service provider. XML namespace: A collection of names that is used to identify elements, types, and attributes in XML documents identified in a URI reference [RFC3986]. A combination of XML namespace and local name allows XML documents to use elements, types, and attributes that have the same names but come from different sources. For more information, see [XMLNS-2ED]. XML namespace prefix: An abbreviated form of an XML namespace, as described in [XML]. XML schema: A description of a type of XML document that is typically expressed in terms of constraints on the structure and content of documents of that type, in addition to the basic syntax constraints that are imposed by XML itself. An XML schema provides a view of a document type at a relatively high level of abstraction. z-order: The rendering order of an object on a z axis. MAY, SHOULD, MUST, SHOULD NOT, MUST NOT: These terms (in all caps) are used as defined in [RFC2119]. All statements of optional behavior use either MAY, SHOULD, or SHOULD NOT. 1.2 References Links to a document in the Microsoft Open Specifications library point to the correct section in the most recently published version of the referenced document. However, because individual documents in the library are not updated at the same time, the section numbers in the documents may not match. You can confirm the correct section numbering by checking the Errata Normative References We conduct frequent surveys of the normative references to assure their continued availability. If you have any issue with finding a normative reference, please contact dochelp@microsoft.com. We will assist you in finding the relevant information. [ISO/IEC :2011] ISO/IEC, "Information Technology -- Document description and processing languages -- Office Open XML File Formats -- Part 1: Fundamentals and Markup Language Reference", ISO/IEC :2011, 2011, [MS-LCID] Microsoft Corporation, "Windows Language Code Identifier (LCID) Reference". [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997, [RFC2616] Fielding, R., Gettys, J., Mogul, J., et al., "Hypertext Transfer Protocol -- HTTP/1.1", RFC 2616, June 1999, [RFC4627] Crockford, D., "The application/json Media Type for JavaScript Object Notation (JSON)", RFC 4627, July 2006, [SOAP1.1] Box, D., Ehnebuske, D., Kakivaya, G., et al., "Simple Object Access Protocol (SOAP) 1.1", W3C Note, May 2000, [SOAP1.2/1] Gudgin, M., Hadley, M., Mendelsohn, N., Moreau, J., and Nielsen, H.F., "SOAP Version 1.2 Part 1: Messaging Framework", W3C Recommendation, June 2003, [WSDL] Christensen, E., Curbera, F., Meredith, G., and Weerawarana, S., "Web Services Language (WSDL) 1.1", W3C Note, March 2001, 22 / 297

23 [XMLNS] Bray, T., Hollander, D., Layman, A., et al., Eds., "Namespaces in XML 1.0 (Third Edition)", W3C Recommendation, December 2009, [XMLSCHEMA1] Thompson, H., Beech, D., Maloney, M., and Mendelsohn, N., Eds., "XML Schema Part 1: Structures", W3C Recommendation, May 2001, [XMLSCHEMA2] Biron, P.V., Ed. and Malhotra, A., Ed., "XML Schema Part 2: Datatypes", W3C Recommendation, May 2001, Informative References [HTML] World Wide Web Consortium, "HTML 4.01 Specification", W3C Recommendation 24 December 1999, [RFC2822] Resnick, P., Ed., "Internet Message Format", RFC 2822, April 2001, Protocol Overview (Synopsis) This protocol enables a protocol client to send a request to modify presentation content to the protocol server and then receive from the protocol server information about the result of the modification. To facilitate this, the protocol allows the protocol client to send a request to the protocol server and then receive from the protocol server information about the existence of presentation slides, main master slides, and slide layouts. The protocol client can also send a request to the protocol server and then receive from the protocol server images of slide content. 1.4 Relationship to Other Protocols This protocol uses the SOAP message protocol for formatting request and response messages, as described in [SOAP1.1], [SOAP1.2/1] and [SOAP1.2/2]. It transmits those messages by using HTTP, as described in [RFC2616], or Hypertext Transfer Protocol over Secure Sockets Layer (HTTPS), as described in [RFC2818]. The following diagram shows the underlying messaging and transport stack used by the protocol: Figure 1: This protocol in relation to other protocols 1.5 Prerequisites/Preconditions This protocol operates against a set of Web sites that is identified by a set of URLs that are known by protocol clients. 23 / 297

24 The protocol server endpoint to which the client sends requests to modify presentation content is formed by appending "/p/ppt/edit.svc" to the URL of the Web site, for example The protocol server endpoint to which the client sends requests to modify image content is formed by appending "/p/pptinsertpicture.ashx" to the URL of the Web site, for example This protocol assumes that authentication has been performed by the underlying protocols. 1.6 Applicability Statement This protocol is designed to retrieve information about and to modify presentations that are stored on the protocol server. 1.7 Versioning and Capability Negotiation This document covers versioning issues in the following area: Supported Transports: This protocol uses multiple transports with SOAP as described in section Vendor-Extensible Fields 1.9 Standards Assignments 24 / 297