add dhis2 paging examples

adaptors/library/jobs/fetch-all-events-with-pagination.js

@@ -0,0 +1,28 @@
+// Fetching all events with pagination
+// Requires DHIS2 server v2.41+
+
+// First call fetches page 1 (up to 10,000 records) and, via totalPages: true,
+// returns pagination details (state.data.pager) describing how many pages remain.
+tracker.export('events', { totalPages: true, pageSize: 1e4 });
+
+fn(state => {
+  state.results = state.data.events;
+  const { page, pageSize, pageCount, total } = state.data.pager;
+  const remainingPages = pageCount - page;
+
+  state.pages = Array.from({ length: remainingPages }, (_, i) => page + i + 1);
+  state.pageSize = pageSize;
+  return state;
+});
+
+// Second call uses the remaining page numbers computed above to fetch the
+// rest of the records in batches, one tracker.export per page.
+each(
+  $.pages,
+  tracker
+    .export('events', { pageSize: $.pageSize, page: $.data })
+    .then(state => {
+      state.results = state.results.concat(state.data.events);
+      return state;
+    })
+);

adaptors/library/jobs/fetch-all-events.js

@@ -0,0 +1,4 @@
+// Fetching all events without pagination
+// Be cautious: This can degrade performance if you have a lot of events, use with caution
+// Requires DHIS2 server v2.41+, for older version `skipPaging: true`
+tracker.export('events', { paging: false });

adaptors/library/jobs/fetch-default-events.js

@@ -0,0 +1,3 @@
+// DHIS2 Defaults: pageSize: 50
+// Requires DHIS2 server v2.41+,
+tracker.export('events');

adaptors/library/staticExamples.json

@@ -1,4 +1,22 @@
 [
+  {
+    "expressionPath": "jobs/fetch-all-events",
+    "adaptor": "dhis2",
+    "adaptor_version": "v8.1.1",
+    "name": "Fetch all events without pagination"
+  },
+  {
+    "expressionPath": "jobs/fetch-default-events",
+    "adaptor": "dhis2",
+    "adaptor_version": "v8.1.1",
+    "name": "Fetch default events"
+  },
+  {
+    "expressionPath": "jobs/fetch-all-events-with-pagination",
+    "adaptor": "dhis2",
+    "adaptor_version": "v8.1.1",
+    "name": "Fetch all events with pagination"
+  },
   {
     "expressionPath": "jobs/commcare-asri-bulk-upload",
     "adaptor": "commcare",
@@ -166,4 +184,4 @@
     "adaptor": "kobotoolbox",
     "name": "Extract submissions from KoboToolbox"
   }
-]
+]