[sharepoint korea conference 2013 / 강율구] sharepoint 스마트하게 개발하기
DESCRIPTION
TRANSCRIPT
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
SMART 한 SHAREPOINT 개발
강율구
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
Server APIs
Remote / Client APIs
SharePoint Standard APIs
REST APIs SOAP APIsCSOM
Data Platform
Farm Site List DataExternal
Lists
Server OM LINQ to SharePoint
Server-side
Client-side
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
AGENDA
1. REST/OData
2. Client-Side Object Model
3. SOAP Web Service
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
REST/OData 란 ?
• REpresentational State Transfer
• Web Service 기반의 Open Data Protocol(Odata) 를 사용• 네트워크 시스템을 위한 비표준 아키텍쳐 스타일• 모든 Resource 는 유일한 URI 로 데이터와 서비스
• http://<site url>/_api/web/lists
• http://<site url>/_api/web/lists/getByTitle('ListTitle')
• Resource 는 일반적 인터페이스 (HTTP GET, POST, PUT, DELETE) 로 접근
• 결과 값은 ATOM or JSON 을 사용
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
SharePoint REST Service Architecture
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
REST Operations
HTTP POST• Create Data In Data Source
HTTP GET• Read Data from Data Source
HTTP PUT• Update Data In Data Source
HTTP DELETE• Delete Data In data Source
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
• URI 와 HTTP Method 만으로도 쉽게 의미 전달이 가능하다 .
• JavaScript , jQuery 를 사용하여 높은 개발 생산성• Web Developers 개발하기 익숙하다 .
• SOAP 보단 개발하기 단순하다 .
• 결과 값은 ATOM or JSON 을 사용한다 .
SharePoint REST API 장점
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
http://<Server>/_api/web/lists/getByTitle(‘Customer')/getItemByStringId(‘1’)?$select=Title, ID
SharePoint Host
ServiceResource Path Query Options
Structure
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
OData Query Operators
Operators Descriptions Examples
Lt Less than http://<server>/_api/web/lists/getByTitle('test')/items?&$filter=Id lt 1
Le Less equal http://<server>/_api/web/lists/getByTitle('test')/items?&$filter=Id le 1
Gt Greater than http://<server>/_api/web/lists/getByTitle('test')/items?&$filter=Id gt 1
Ge Greater equal http://<server>/_api/web/lists/getByTitle('test')/items?&$filter=Id ge 1
Eq Equal http://<server>/_api/web/lists/getByTitle('test')/items?&$filter=Id eq 1
startsWith startswith(GUID,‘11’)
http://<server>/_api/web/lists/getByTitle('test')/items?$filter=startswith(GUID, ‘11')
Substringof substringof('Cr',Title)
http://<server>/_api/web/lists/getByTitle('test')/items?$filter=substringof(GUID, ‘11')
Eq Equal http://<server>/_api/web/lists/getByTitle('test')/items?&$filter=Title eq ‘1’
Ne Not equal http://<server>/_api/web/lists/getByTitle('test')/items?&$filter=Title lt ‘1’
Day() Day http://<server>/_api/web/lists/getByTitle('test')/items?&$filter=Id lt 1
Month() Month http://<server>/_api/web/lists/getByTitle('test')/items?&$filter=Id lt 1
Year() Year http://<server>/_api/web/lists/getByTitle('test')/items?&$filter=Id lt 1
Minute() Minute http://<server>/_api/web/lists/getByTitle('test')/items?&$filter=Id lt 1
Second() Second http://<server>/_api/web/lists/getByTitle('test')/items?&$filter=Id lt 1
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
REST Code Demo• Site 생성 예제
$.ajax( { url: "/_api/web/webinfos/add", type: "POST", async: false, data: JSON.stringify({ 'parameters': { '__metadata': { 'type': 'SP.WebInfoCreationInformation' }, 'Url': "Conference", 'Title': “SharePoint 2013 Conference", 'Description': " 컨퍼런스 팀사이트입니다 .", 'Language': "1042", 'WebTemplate': "STS#0", 'UseUniquePermissions': "True" } }),
headers: { "accept": "application/json;odata=verbose", "content-type": "application/json;odata=verbose", "X-RequestDigest": $("#__REQUESTDIGEST").val() }, success: function (data) { location.href = data.d.ServerRelativeUrl; }, error: function (err) { alert("Fail"); } });
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
AGENDA
1. REST/OData
2. Client-Side Object Model
3. SOAP Web Service
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
Client-Side Object Model 란 ?
• Microsoft SharePoint Client API
• SharePoint Server Object Model 과 유사• Site, Web, ContextType, List, Folder, Navigation…
• .NET Managed, Silverlight, ECMAScript 사용 가능• SharePoint 2010 버전 부터 사용 가능
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
SharePoint CSOM Architecture
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
• SharePoint Developers 개발하기 익숙하다 .
• Client Application 개발에 용이하다 .
• LINQ, CAML Query 사용이 가능하다 .
• RPC Batch Processing
• clientContext.Load(Web);
clientContext.ExecuteQueryAsync(succeedcallback, failcallback);
SharePoint CSOM 장점
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
Server(Microsoft.SharePoint)
.NET Managed(Microsoft.SharePoint.Client)
Silverlight(Microsoft.SharePoint.Client.Sil-
verlight)
JavaScript(SP.js)
SPContext ClientContext ClientContext ClientContext
SPSite Site Site Site
SPWeb Web Web Web
SPList List List List
SPListItem ListItem ListItem ListItem
SPFiled Field Field Field
Client Object Modal - Objects
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
Object OM Location Names
Managed ISAPI folder Microsoft.SharePoint.Client.dllMicrosoft.SharePoint.Client.Runtime.dll
Silverlight Layouts\ClientBin Microsoft.SharePoint.Client.Silverlight.dllMicrosoft.SharePoint.Client.Silverlight.Runtime.dll
JavaScript Layouts SP.js
Client Library
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
CSOM(ECMAScript) Code Demo• 그룹 권한 추가
var currentCTX = new SP.ClientContext("/Conference"); var currentWeb = currentCTX.get_web(); // Create Group information for Group var membersFC = new SP.GroupCreationInformation(); membersFC.set_title(" 컨퍼런스 읽기 그룹 "); membersFC.set_description('SharePoint 컨퍼런스 방문자 그룹입니다 .'); //add group oMembersFC = currentWeb.get_siteGroups().add(membersFC);
//return SP.RoleDefinition object /Full Control, Contribute, Read var rdFC = currentWeb.get_roleDefinitions().getByName(' 읽기 ');
// Create a new RoleDefinitionBindingCollection. var bindingFC = SP.RoleDefinitionBindingCollection.newObject(currentCTX);
// Add the role to the collection. bindingFC.add(rdFC);
// Get the RoleAssignmentCollection for the target web. var assignments = currentWeb.get_roleAssignments();
// assign the group to the new RoleDefinitionBindingCollection. var roleAssignmentFullControl = assignments.add(oMembersFC, bindingFC);
currentCTX.load(oMembersFC);
//Execute Query currentCTX.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceeded), Function.createDelegate(this, this.onQueryFailed));
function onQuerySucceeded() { alert("Created Group."); } function onQueryFailed(sender, args) { alert('Request failed. ' + args.get_message() + '\n' + args.get_stackTrace()); }
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
AGENDA
1. REST/OData
2. Client-Side Object Model
3. SOAP Web Service
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
SOAP 란 ?
• Simple Object Access Protocol(SOAP)
• Created By Microsoft in 1998 /W3C Standard
• RPC Model 을 사용• 표준화된 XML 메시징을 사용• 하드웨어 , 소프트웨어 , 프로그래밍 언어에 독립적• 프록시와 방화벽에 구애 받지 않고 쉽게 통신 가능
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
SOAP 구성도
Register(WSDL)
Find(WSDL)
SOAP
܊ۿ
UDDI
Service Requester
Service Provider
Service Broker
UDDI(Universal Description, Discovery, and Integration)• 프로그래밍이 가능한 공개된 레지스트리의 역할WSDL(Web Services Description Language)• 웹서비스가 제공하는 서비스에 어떤 파라미터를 가지고 있어야 하는지 , 어떤 값을 리턴하는지 설명하는 XML 파일
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
• SharePoint All Versions 지원
SharePoint SOAP 장점
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
SharePoint 2007 and 2010 Web Service
SharePoint 2007 SharePoint 2010
Web Service WSS 3.0 MOSS Foundation SP2010
Alerts V V V V
Authentication V V V V
Copy V V V V
Forms V V V V
Lists V V V V
Meetings V V V V
People V V V V
Permissions V V V V
SiteData V V V V
Sites V V V V
SpellChecker V V V V
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
SharePoint 2007 and 2010 Web Service
SharePoint 2007 SharePoint 2010
Web Service WSS 3.0 MOSS Foundation SP2010
User and Groups V V V V
Versions V V V V
Views V V V V
WebPartPages V V V V
Webs V V V V
PublishedLinksService V V
Search V V
UserProfielService V V
Workflow V V
Diagnostics V V
SocialDataService V
TaxonomyClientService V
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
Web Service URL
Class Name
Operations
Namespace
Visual Studio Service Reference
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
Reference• Get started with the SharePoint 2013 REST service
• http://msdn.microsoft.com/en-us/library/fp142380.aspx
• Choose the right API set in SharePoint 2013
• http://msdn.microsoft.com/en-us/library/jj164060.aspx
• Get Some REST : SharePoint 2013 REST API's
• http://www.slideshare.net/eshupps/taking-advantage-of-the-sharepoint-2013-rest-api
• Use OData query operations in SharePoint REST requests
• http://msdn.microsoft.com/en-us/library/fp142385.aspx#bk_architecture
• Add a SOAP service as a data source
• http://
office.microsoft.com/en-us/sharepoint-designer-help/add-a-soap-service-as-a-data-sou
rce-HA010355752.aspx
• jQuery Library for SharePoint Web Services
• http
://spservices.codeplex.com/wikipage?title=%24%28%29.SPServices&referringTitle=%
24%28%29.SPServices&ANCHOR#GeneralSyntax
• 기본 XML Web Services
• http://msdn.microsoft.com/ko-kr/library/ms996507.aspx
SharePoint Korea Conference 2013 Smart 한 SharePoint 개발
감사합니다 .E-MAIL : [email protected]