Merge pull request #526 from ggailey777/zumo_weekly

Issue #525: added final iOS tutorials for after BUILD

DevCenter/Mobile/Tutorials/mobile-services-paging-data-dotnet.md

@@ -14,6 +14,7 @@
 	<a href="/en-us/develop/mobile/tutorials/add-paging-to-data-dotnet" title="Windows Store C#" class="current">Windows Store C#</a>
 	<a href="/en-us/develop/mobile/tutorials/add-paging-to-data-js" title="Windows Store JavaScript">Windows Store JavaScript</a>
 	<a href="/en-us/develop/mobile/tutorials/add-paging-to-data-wp8" title="Windows Phone 8">Windows Phone 8</a> 
+    <a href="/en-us/develop/mobile/tutorials/add-paging-to-data-ios" title="iOS">iOS</a> 
 </div>
 
 

DevCenter/Mobile/Tutorials/mobile-services-paging-data-ios.md

@@ -0,0 +1,110 @@
+<properties linkid="mobile-services-paging-data-dotnet" urldisplayname="Mobile Services" headerexpose="" pagetitle="Refine Mobile Services queries with paging" metakeywords="access and change data, Windows Azure Mobile Services, mobile devices, Windows Azure, mobile, iOS, iPad, iPhone" footerexpose="" metadescription="Validate and modify data sent to the Windows Azure Mobile Services from an iOS app." umbraconavihide="0" disquscomments="1"></properties>
+
+<div class="umbMacroHolder" title="This is rendered content from macro" onresizestart="return false;" umbpageid="14809" ismacro="true" umb_chunkname="MobileArticleLeft" umb_chunkpath="devcenter/Menu" umb_macroalias="AzureChunkDisplayer" umb_hide="0" umb_modaltrigger="" umb_chunkurl="" umb_modalpopup="0"><!-- startUmbMacro --><span><strong>Azure Chunk Displayer</strong><br />No macro content available for WYSIWYG editing</span><!-- endUmbMacro --></div>
+
+# Refine Mobile Services queries with paging
+<div class="dev-center-tutorial-selector"> 
+	<a href="/en-us/develop/mobile/tutorials/add-paging-to-data-dotnet" title="Windows Store C#">Windows Store C#</a>
+	<a href="/en-us/develop/mobile/tutorials/add-paging-to-data-js" title="Windows Store JavaScript">Windows Store JavaScript</a>
+	<a href="/en-us/develop/mobile/tutorials/add-paging-to-data-wp8" title="Windows Phone 8">Windows Phone 8</a> 
+    <a href="/en-us/develop/mobile/tutorials/add-paging-to-data-ios" title="iOS" class="current">iOS</a>
+</div>
+
+This topic shows you how to use paging to manage the amount of data returned to your iOS app from Windows Azure Mobile Services. In this tutorial, you will use the **Take** and **Skip** query methods on the client to request specific "pages" of data.
+
+<div class="dev-callout"><b>Note</b>
+<p>To prevent data overflow in mobile device clients, Mobile Services implements an automatic page limit, which defaults to a maximum of 50 items in a response. By specifying the page size, you can explicitly request up to 1,000 items in the response.</p>
+</div>
+
+This tutorial builds on the steps and the sample app from the previous tutorial [Get started with data]. Before you begin this tutorial, you must complete at least the first tutorial in the working with data series&#151;[Get started with data]. 
+
+1. In Xcode, open the project that you modified when you completed the tutorial [Get started with data].
+
+2. Press the **Run** button (Command + R) to build the project and start the app, then enter text into the textbox and click the  plus (**+**) icon.
+
+3. Repeat the previous step at least three times, so that you have more than three items stored in the TodoItem table. 
+
+4. Open the TodoService.m file, and locate the following method:
+
+        - (void) refreshDataOnSuccess:(CompletionBlock)completion
+
+   Replace the body of the entire method with the following code. 
+
+        // Create a predicate that finds active items in which complete is false
+        NSPredicate * predicate = [NSPredicate predicateWithFormat:@"complete == NO"];
+
+        // Retrieve the MSTable's MSQuery instance with the predicate you just created.
+        MSQuery * query = [self.table queryWhere:predicate];
+        
+        query.includeTotalCount = TRUE; // Request the total item count
+
+        // Start with the first item, and retrieve only three items
+        query.fetchOffset = 0;
+        query.fetchLimit = 3;
+
+        // Invoke the MSQuery instance directly, rather than using the MSTable helper methods.
+        [query readWithCompletion:^(NSArray *results, NSInteger totalCount, NSError *error) {
+            
+            [self logErrorIfNotNil:error];
+               if (!error)
+            {
+                // Log total count.
+                NSLog(@"Total item count: %@",[NSString stringWithFormat:@"%zd", (ssize_t) totalCount]);            
+            }
+        
+            items = [results mutableCopy];
+        
+            // Let the caller know that we finished
+            completion();
+        }];
+
+   This query returns the top three items that are not marked as completed. 
+
+5. Rebuild and start the app. 
+
+    Notice that only the first three results from the TodoItem table are displayed. 
+
+6. (Optional) View the URI of the request sent to the mobile service by using message inspection software, such as browser developer tools or a Mac OSX Fiddler equivalent. 
+
+   Notice that the **fetchLimit = 3** property assignment was translated into the query option **$top=3** in the query URI.
+
+7. Update the **refreshDataOnSuccess** method once more by locating the following line of code:
+
+        query.fetchOffset = 0;
+
+   This time, set the **query.fetchOffset** value to 3. 
+
+   This query skips the first three results and returns the next three after that. This is effectively the second "page" of data, where the page size is three items.
+
+8. (Optional) Again view the URI of the request sent to the mobile service. Notice that the **query.fetchOffset** value was translated into the query option **$skip=3** in the query URI.
+
+    <div class="dev-callout"><b>Note</b>
+    <p>This tutorial uses a simplified scenario by setting hard-coded paging values for the <strong>fetchOffset</strong> and <strong>fetchLimit</strong> properties. In a real-world app, you can use queries similar to the above with a pager control or comparable UI to let users navigate to previous and next pages. You can also set  **query.includeTotalCount = TRUE** to get the total count of all rows returned, along with the paged data.</p>
+    </div>
+
+## <a name="next-steps"> </a>Next Steps
+
+This concludes the set of tutorials that demonstrate the basics of working with data in Mobile Services. Consider finding out more about the following Mobile Services topic:
+
+* [Get started with authentication]
+  <br/>Learn how to authenticate users of your app with Windows Account.
+
+<!--
+* [Get started with push notifications] 
+  <br/>Learn how to send a very basic push notification to your app.
+-->
+
+<!-- Anchors. -->
+
+[Next Steps]:#next-steps
+
+<!-- Images. -->
+
+
+<!-- URLs. -->
+[Get started with Mobile Services]: ./mobile-services-get-started-ios.md
+[Get started with data]: ./mobile-services-get-started-with-data-ios.md
+[Get started with authentication]: ./mobile-services-get-started-with-users-ios.md
+[Get started with push notifications]: ./mobile-services-get-started-with-push-ios.md
+[WindowsAzure.com]: http://www.windowsazure.com/
+[Management Portal]: https://manage.windowsazure.com/

DevCenter/Mobile/Tutorials/mobile-services-paging-data-js.md

@@ -13,6 +13,7 @@
 	<a href="/en-us/develop/mobile/tutorials/add-paging-to-data-dotnet" title="Windows Store C#">Windows Store C#</a>
 	<a href="/en-us/develop/mobile/tutorials/add-paging-to-data-js" title="Windows Store JavaScript" class="current">Windows Store JavaScript</a>
 	<a href="/en-us/develop/mobile/tutorials/add-paging-to-data-wp8" title="Windows Phone 8">Windows Phone 8</a> 
+    <a href="/en-us/develop/mobile/tutorials/add-paging-to-data-ios" title="iOS">iOS</a>
 </div>
 
 

DevCenter/Mobile/Tutorials/mobile-services-paging-data-wp8.md

@@ -14,6 +14,7 @@
 	<a href="/en-us/develop/mobile/tutorials/add-paging-to-data-dotnet" title="Windows Store C#">Windows Store C#</a>
 	<a href="/en-us/develop/mobile/tutorials/add-paging-to-data-js" title="Windows Store JavaScript">Windows Store JavaScript</a>
 	<a href="/en-us/develop/mobile/tutorials/add-paging-to-data-wp8" title="Windows Phone 8" class="current">Windows Phone 8</a> 
+    <a href="/en-us/develop/mobile/tutorials/add-paging-to-data-ios" title="iOS">iOS</a>
 </div>
 
 

DevCenter/Mobile/Tutorials/mobile-services-validate-and-modify-data-dotnet.md

@@ -13,7 +13,7 @@
 	<a href="/en-us/develop/mobile/tutorials/validate-modify-and-augment-data-dotnet" title="Windows Store C#" class="current">Windows Store C#</a>
 	<a href="/en-us/develop/mobile/tutorials/validate-modify-and-augment-data-js" title="Windows Store JavaScript">Windows Store JavaScript</a>
 	<a href="/en-us/develop/mobile/tutorials/validate-modify-and-augment-data-wp8" title="Windows Phone 8">Windows Phone 8</a> 
-	<!--<a href="/en-us/develop/mobile/tutorials/validate-modify-and-augment-data-ios" title="iOS">iOS</a> -->
+	<a href="/en-us/develop/mobile/tutorials/validate-modify-and-augment-data-ios" title="iOS">iOS</a>
 </div>