SharePoint 클라이언트 개체 모델(1) ECMA Script_javascript 기술

所谓的客户端对象模型就是调用了背后的WCF服务来提供数据，为了减轻数据的访问量数据包使用JSON，我们还可以看到对象模型的设计也加入了诸多对于减轻数据访问量的考量。技术上没有什么新意，你要愿意，在SharePoint2007里面也可以实现类似的功能，当然在使用上方便了我们不少

 
三种使用客户端模型的.NET托管、ECMA脚本，SilverLightClient.

本文讲阐述如何使用.NET托管代码来访问SharePoint对象模型。

ECMAScript Client OM需要注意的几个点

• ECMAScript仅能够在SharePoint站点里面使用，不能够在其他的Asp.NET站点里使用ECMAScript来访问SharePoint站点资源，也不能够跨SharePoint站点访问资源；
• JQuery和ECMAScript使用起来不会有冲突；
• 为了安全的更新内容，在使用ECMAScript的画面里添加
• 在随后你将会看到的代码里为了减轻加载的数据量，可以指定需要加载的内容，例如client.Context.load(this.web,'Title','Id','Created')， 这里的属性值名称使用和CAML一样的体系，对大小写敏感；
• 为确保你的代码执行在SP.JS加载完之后再被调用，可以使用ExecuteOrDelayUntilScriptLoaded(myjsFunction, “sp.js”)。

我们看看SharePoint OM和客户端OM的一个简单的匹配关系：

服务器端OM	客户端OM
SPContext	ClientContext
SPSite	Site
SPWeb	Web
SPList	List
SPListItem	ListItem
SPField	Field

최종 효과를 보세요. 다음 그림은 주로 목록의 생성, 쿼리 및 관리를 설계하는 예비 계획입니다. 중요한 파일이 있으면 점차적으로 업로드됩니다. 앞으로 추가됩니다.

내부 링크는 UI Javascript 인터페이스를 호출하여 SharePoint2010 스타일 팝업 창을 생성합니다. 팝업 창의 배경 페이지는 SitePage 문서 라이브러리에 있는 경우에만 적용됩니다. WebPart 페이지가 열려 있지 않으면 "ID가 "Ribbon.Read"인 리본 탭이 이 페이지에 사용할 수 없거나 존재하지 않습니다." 오류가 보고됩니다.

(이 페이지는 앞으로는 사용하지 않을 예정이며, 리본 사용법에 대한 설명만 남깁니다.)

목록 만들기:

먼저 Designer를 통해 다음 두 스크립트 링크를 추가합니다.

ECMAScriptOM과 .NET Managed ClientOM(나중에 설명)은 동일한 목적을 가지고 있지만 몇 가지 참고할 사항이 있습니다.

서버측 URL은 ClientContext에서 사용할 수 없습니다.
1. LINQ는 지원되지 않습니다.
2. 기본적으로 ECMAScript OM은 비동기식입니다

코드가 매우 간단하고 이해하기 쉽습니다. SP.UI.Notify.addNotification 이 클래스를 통해 바로 SharePoint에 메시지를 표시할 수 있습니다.

시연 결과는 다음과 같습니다.

텍스트 상자에 목록 이름을 입력한 후 "목록 만들기" 버튼을 클릭하면 목록이 생성된 후 오른쪽 상단에 "목록 test1이 생성되었습니다"라는 메시지가 표시됩니다. 목록 유형.

소스코드는 다음과 같습니다.

코드 복사 코드는 다음과 같습니다.

모든 목록 가져오기:

마찬가지로 먼저 효과를 살펴보세요. 현재 사이트 아래의 모든 목록을 읽고 해당 하이퍼링크 속성을 설정하려면 "목록 숨기기" 버튼을 클릭하세요(실제로는 목록 숨기기). a Div)

코드는 매우 간단하며 getEnumerator() 및 moveNexst(), get_current()와 같은 JavaScript 함수를 사용하면 컬렉션을 탐색하는 좋은 방법을 제공합니다.

소스 코드:

코드 복사 코드는 다음과 같습니다.

function getLists( ){
var clientContext = new SP.ClientContext()
var oWebSite = clientContext.get_web()
listCollection = oWebSite.get_lists()
clientContext.load(listCollection); >clientContext.executeQueryAsync(Function.createDelegate(this, this.onGetListsSucceeded), Function.createDelegate(this, this.onGetListsFailed));
}
function onGetListsSucceeded(){
var str = ""; 🎜>var listedEnumerator = listCollection.getEnumerator();
while(listsEnumerator.moveNext()){
var objList = listEnumerator.get_current()
str = "" objList.get_title() "" "
";
}
문서. getElementById(" 목록").innerHTML = str;
}
function onGetListsFailed(sender, args){
alert('요청이 실패했습니다. ' args.get_message() 'n' args.get_stackTrace()) ;
}

CAML 쿼리:

쿼리 방법에는 DueDate별과 제목별 두 가지가 있습니다. 물론 기능을 보다 사용자 친화적으로 설계할 수 있으며 데모에서는 과도한 렌더링이 발생하지 않습니다. 검색을 클릭하여 데이터를 쿼리합니다. 컨트롤을 사용할 때 날짜를 선택하면 페이지가 포스트백됩니다.

캘린더 컨트롤을 별도의 페이지에 배치하고 다음 코드를 추가합니다.

1. 
   
   SharePoint 달력 컨트롤 사용

컨트롤 표시를 제어하는 ​​섹션을 만들었습니다. 날짜를 입력하는 컨트롤이 나타납니다. 제목을 입력하는 컨트롤이 나타납니다. 원래는 JQuery 방식을 사용하려고 했으나 갑자기 그렇게 되지 않았습니다. JQuery의 Selector를 작성하는 방법이 기억나지 않습니다. 외국에서는 제어를 결합하기 위해 다음 방법을 사용합니다.

코드 복사 코드는 다음과 같습니다.

functionchangeQueryMethod(){
var method = $("select[id='selectQueryMethod ']").val();
if(method == 'Title'){
document.getElementById('querybytitle').style.display = "inline";
document.getElementById(' querybyDate').style.display = "none";
}
else{
document.getElementById('querybytitle').style.display = "none"
document.getElementById('querybyDate ').style.display = "인라인";
}
}

CAML 쿼리 자체에 대한 자세한 설명은 많지 않습니다. 관심이 있으시면 제 글(http://www.cnblogs.com/johnsonwong/archive/2011/02/27/1966008.html)을 참고해주세요. )입니다. 이 기사는 CAML 2007 버전에 대한 것입니다. 2010년에는 교차 목록 조인트 쿼리 등 많은 개선이 이루어졌습니다. 해당 2010 버전은 추후 출시될 예정입니다.

주의해야 할 사항은 다음과 같습니다.

필드 쿼리를 사용하고 관련 API 호출에 주의하세요.
ClientContext는 여러 결과 집합에서 작동하지만 Load를 호출해야 합니다. 다른 결과 세트를 로드하려면: clientContext.load(fieldCollection); clientContext.load(listItemCollection)
읽어야 하는 필드 값이 있는 경우 설명이 CAML 쿼리 XML에 표시되어야 합니다. 이 역시 성능상의 이유로

코드 복사 코드는 다음과 같습니다.

function search(){
var clientContext = new SP.ClientContext();
var oWebSite = clientContext.get_web()
var list = oWebSite.get_lists().getByTitle( "작업");
fieldCollection = list .get_fields();
var camlQuery = new SP.CamlQuery()
camlQuery.set_viewXml( " ;Gt>"
""
"2008-01-1T00:00:00Z"
""
"" 🎜>""
"")
listItemCollection = list.getItems(camlQuery)
clientContext.load (fieldCollection);
clientContext.load( listItemCollection);
clientContext.executeQueryAsync(Function.createDelegate(this, this.onSearchListSucceeded), Function.createDelegate(this, this.onSearchListFailed))
function onSearchListSucceeded(){
var str = "";
var listItemEnumerator = listItemCollection.getEnumerator();
var fieldsEnumerator = fieldCollection.getEnumerator()
while(listItemEnumerator.moveNext()) {
var oListItem = listItemEnumerator.get_current( );
str = "항목 " oListItem.get_id() ":"
while(fieldsEnumerator.moveNext()){
var oField = fieldsEnumerator.get_current ();
str = oField.get_staticName () "
"
}
str = "
"
document.getElementById ("lists").innerHTML = str;
}

function onSearchListFailed(sender, args){
alert('요청이 실패했습니다. ' args.get_message() 'n' args.get_stackTrace( ));


파일 작업:

안타깝게도 SP.File 개체가 있지만 대부분의 작업은 파일을 업로드할 수 없습니다. SP.File 객체를 얻었습니다.