{"id":5248,"date":"2020-09-02T12:12:18","date_gmt":"2020-09-02T19:12:18","guid":{"rendered":"https:\/\/officedevblogs.wpengine.com\/?p=5248"},"modified":"2021-12-06T13:37:14","modified_gmt":"2021-12-06T21:37:14","slug":"retirement-of-certain-sharepoint-online-webpartpageswebservice-methods","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/retirement-of-certain-sharepoint-online-webpartpageswebservice-methods\/","title":{"rendered":"Retirement of certain SharePoint Online WebPartPagesWebService methods"},"content":{"rendered":"<p>We\u2019ve identified an issue with five methods belonging to the deprecated <a href=\"https:\/\/docs.microsoft.com\/en-us\/dotnet\/api\/microsoft.sharepoint.soapserver.webpartpageswebservice?view=sharepoint-server\">WebPartPageWebService<\/a> API (https:\/\/&lt;Site&gt;\/_vti_bin\/WebPartPages.asmx) that could cause impact to data integrity.<\/p>\n<p>These methods are:<\/p>\n<ul>\n<li><a href=\"https:\/\/docs.microsoft.com\/en-us\/dotnet\/api\/microsoft.sharepoint.soapserver.webpartpageswebservice.addwebpart?view=sharepoint-server\">AddWebPart<\/a><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/en-us\/dotnet\/api\/microsoft.sharepoint.soapserver.webpartpageswebservice.addwebparttozone?view=sharepoint-server\">AddWebPartToZone<\/a><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/en-us\/dotnet\/api\/microsoft.sharepoint.soapserver.webpartpageswebservice.savewebpart?view=sharepoint-server\">SaveWebPart<\/a><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/en-us\/dotnet\/api\/microsoft.sharepoint.soapserver.webpartpageswebservice.savewebpart2?view=sharepoint-server\">SaveWebPart2<\/a><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/en-us\/dotnet\/api\/microsoft.sharepoint.soapserver.webpartpageswebservice.getwebpartpageconnectioninfo?view=sharepoint-server\">GetWebPartPageConnectionInfo<\/a><\/li>\n<\/ul>\n<p>As a result, <strong>we are retiring these methods and they will stop returning data after October 12, 2020<\/strong>.<\/p>\n<h2>Transition from SOAP to CSOM<\/h2>\n<p>Developers should update any existing processes or integrations that use the previously mentioned methods in the WebPartPageWebService to call methods in the <em><a href=\"https:\/\/docs.microsoft.com\/en-us\/previous-versions\/office\/sharepoint-csom\/ee545315(v=office.15)\">LimitedWebPartManager<\/a> class<\/em> of the <a href=\"https:\/\/www.nuget.org\/packages\/Microsoft.SharePointOnline.CSOM\/\">SharePoint Client-Side Object Model<\/a> (version 16.1.20324.12000, or newer). For more information on how to use CSOM, check out the documentation.<\/p>\n<p>Please use Microsoft Graph APIs where possible, but as the related web part APIs are not yet exposed within Microsoft Graph, CSOM is the answer here.<\/p>\n<h2>Setting Web Part Object Properties<\/h2>\n<p>To assign an object property to a web part using CSOM:<\/p>\n<ul>\n<li>Import the web part using <em>LimitedWebPartManager.ImportWebPart<\/em><\/li>\n<li>Add the web part using <em>LimitedWebPartManager.AddWebPart<\/em><\/li>\n<\/ul>\n<h2>Getting Web Part Connection Info<\/h2>\n<p>The <strong>LimitedWebPartManager<\/strong> class includes a new <strong>HasWebPartConnections<\/strong> property that allows you to determine whether a web part page connection exists.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Retirement of certain SharePoint Online WebPartPagesWebService (WebPartPages.asmx) methods<\/p>\n","protected":false},"author":69078,"featured_media":25159,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[9],"tags":[],"class_list":["post-5248","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-sharepoint-framework"],"acf":[],"blog_post_summary":"<p>Retirement of certain SharePoint Online WebPartPagesWebService (WebPartPages.asmx) methods<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/5248","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/69078"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=5248"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/5248\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/25159"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=5248"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=5248"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=5248"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}