You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
*Step 1*: Input `sysparm_offset={offset}` either in **Base URL** or **Relative URL** as shown in the following screenshots:
549
549
550
-
:::image type="content" source="media/connector-rest/pagination-example-1-rest-linked-service-base-url.png" alt-text="Screenshot showing the configuration step 1 to send multiple requests whose variables are in QueryParameters.":::
550
+
:::image type="content" source="media/connector-rest/pagination-rule-example-1-rest-linked-service-base-url.png" alt-text="Screenshot showing one configuration to send multiple requests whose variables are in QueryParameters.":::
551
551
552
552
or
553
553
554
-
:::image type="content" source="media/connector-rest/pagination-example-1-rest-linked-service-relative-url.png" alt-text="Screenshot showing the configuration step 2 to send multiple requests whose variables are in QueryParameters.":::
554
+
:::image type="content" source="media/connector-rest/pagination-rule-example-1-rest-linked-service-relative-url.png" alt-text="Screenshot showing another configuration to send multiple requests whose variables are in QueryParameters.":::
555
555
556
556
*Step 2*: Set **Pagination rules** as either option 1 or option 2:
557
557
@@ -574,8 +574,13 @@ BaseUrl/api/now/table/t100
574
574
575
575
*Step 1*: Input `{id}` either in **Base URL** in the linked service configuration page or **Relative URL** in the dataset connection pane.
576
576
577
-
*Step 2*: Set **Pagination rules** as **"AbsoluteUrl.{id}" :"RANGE:1:100:1"**.
577
+
:::image type="content" source="media/connector-rest/pagination-rule-example-2-rest-linked-service-base-url.png" alt-text="Screenshot showing one configuration to send multiple requests whose variables are in AbsoluteUrl.":::
578
+
579
+
or
578
580
581
+
:::image type="content" source="media/connector-rest/pagination-rule-example-2-rest-linked-service-relative-url.png" alt-text="Screenshot showing another configuration to send multiple requests whose variables are in AbsoluteUrl.":::
582
+
583
+
*Step 2*: Set **Pagination rules** as **"AbsoluteUrl.{id}" :"RANGE:1:100:1"**.
*Step 2*: Set **Pagination rules** as **"Headers.{id}" : "RARNGE:0:100:10"**.
594
599
595
-
:::image type="content" source="media/connector-rest/pagination-example-3.png" alt-text="Screenshot showing the configuration steps to send multiple requests whose variables are in Headers.":::
600
+
:::image type="content" source="media/connector-rest/pagination-rule-example-3.png" alt-text="Screenshot showing the pagination rule to send multiple requests whose variables are in Headers.":::
596
601
597
602
#### Example 4:Variables are in AbsoluteUrl/QueryParameters/Headers, the end variable is not pre-defined and the end condition is based on the response
598
603
@@ -650,7 +655,7 @@ Response 2:
650
655
```
651
656
Set the end condition rule as **"EndCondition:$.data": "Empty"** to end the pagination when the value of the specific node in response is empty.
652
657
653
-
:::image type="content" source="media/connector-rest/pagination-example-4-1.png" alt-text="Screenshot showing the EndCondition setting for Example 4.1.":::
658
+
:::image type="content" source="media/connector-rest/pagination-rule-example-4-1.png" alt-text="Screenshot showing the EndCondition setting for Example 4.1.":::
654
659
655
660
- **Example 4.2: The pagination ends when the value of the specific node in response dose not exist**
656
661
@@ -662,7 +667,7 @@ Response 2:
662
667
```
663
668
Set the end condition rule as **"EndCondition:$.data": "NonExist"** to end the pagination when the value of the specific node in response dose not exist.
664
669
665
-
:::image type="content" source="media/connector-rest/pagination-example-4-2.png" alt-text="Screenshot showing the EndCondition setting for Example 4.2.":::
670
+
:::image type="content" source="media/connector-rest/pagination-rule-example-4-2.png" alt-text="Screenshot showing the EndCondition setting for Example 4.2.":::
666
671
667
672
- **Example 4.3: The pagination ends when the value of the specific node in response exists**
668
673
@@ -681,7 +686,7 @@ Response 2:
681
686
```
682
687
Set the end condition rule as **"EndCondition:$.Complete": "Exist"** to end the pagination when the value of the specific node in response exists.
683
688
684
-
:::image type="content" source="media/connector-rest/pagination-example-4-3.png" alt-text="Screenshot showing the EndCondition setting for Example 4.3.":::
689
+
:::image type="content" source="media/connector-rest/pagination-rule-example-4-3.png" alt-text="Screenshot showing the EndCondition setting for Example 4.3.":::
685
690
686
691
- **Example 4.4: The pagination ends when the value of the specific node in response is a user-defined const value**
687
692
@@ -714,7 +719,7 @@ Response 2:
714
719
```
715
720
Set the end condition rule as **"EndCondition:$.Complete": "Const:true"** to end the pagination when the value of the specific node in response is a user-defined const value.
716
721
717
-
:::image type="content" source="media/connector-rest/pagination-example-4-4.png" alt-text="Screenshot showing the EndCondition setting for Example 4.4.":::
722
+
:::image type="content" source="media/connector-rest/pagination-rule-example-4-4.png" alt-text="Screenshot showing the EndCondition setting for Example 4.4.":::
718
723
719
724
- **Example 4.5: The pagination ends when the value of the header key in response equals to user-defined const value**
720
725
@@ -726,7 +731,7 @@ Response 2:
726
731
727
732
Set the end condition rule as **"EndCondition:headers.Complete": "Const:1"** to end the pagination when the value of the header key in response is equal to user-defined const value.
728
733
729
-
:::image type="content" source="media/connector-rest/pagination-example-4-5.png" alt-text="Screenshot showing the EndCondition setting for Example 4.5.":::
734
+
:::image type="content" source="media/connector-rest/pagination-rule-example-4-5.png" alt-text="Screenshot showing the EndCondition setting for Example 4.5.":::
730
735
731
736
- **Example 4.6: The pagination ends when the key exists in the response header**
732
737
@@ -738,7 +743,7 @@ Response 2:
738
743
739
744
Set the end condition rule as **"EndCondition:headers.CompleteTime": "Exist"** to end the pagination when the key exists in the response header.
740
745
741
-
:::image type="content" source="media/connector-rest/pagination-example-4-6.png" alt-text="Screenshot showing the EndCondition setting for Example 4.6.":::
746
+
:::image type="content" source="media/connector-rest/pagination-rule-example-4-6.png" alt-text="Screenshot showing the EndCondition setting for Example 4.6.":::
742
747
743
748
#### Example 5:Set end condition to avoid endless requests when range rule is not defined
744
749
@@ -798,58 +803,58 @@ The last response is:
798
803
799
804
Set **MaxRequestNumber** to avoid endless request as shown in the following screenshot:
800
805
801
-
:::image type="content" source="media/connector-rest/pagination-example-6.png" alt-text="Screenshot showing the MaxRequestNumber setting for Example 6.":::
806
+
:::image type="content" source="media/connector-rest/pagination-rule-example-6.png" alt-text="Screenshot showing the MaxRequestNumber setting for Example 6.":::
802
807
803
808
#### Example 7:The RFC 5988 pagination rule is supported by default
804
809
805
810
The backend will automatically get the next URL based on the RFC 5988 style links in the header.
806
811
807
-
:::image type="content" source="media/connector-rest/pagination-example-7-1.png" alt-text="Screenshot showing the MaxRequestNumber setting for Example 7.":::
812
+
:::image type="content" source="media/connector-rest/pagination-rule-example-7-http-header.png" alt-text="Screenshot showing the sample http header for Example 7.":::
808
813
809
814
> [!TIP]
810
815
> If you don't want to enable this default pagination rule, you can set `supportRFC5988` to `false` or just delete it in the script.
811
816
>
812
-
> :::image type="content" source="media/connector-rest/pagination-example-7-2.png" alt-text="Screenshot showing how to disable RFC 5988 setting for Example 7.":::
817
+
> :::image type="content" source="media/connector-rest/pagination-rule-example-7-disable-rfc5988.png" alt-text="Screenshot showing how to disable RFC 5988 setting for Example 7.":::
813
818
814
819
#### Example 8: The next request URL is from the response body when use pagination in mapping data flows
815
820
816
821
This example states how to set the pagination rule and the end condition rule in mapping data flows when the next request URL is from the response body.
817
822
818
823
The response schema is shown below:
819
824
820
-
:::image type="content" source="media/connector-rest/pagination-example-8-response-schema.png" alt-text="Screenshot showing the response schema of Example 8.":::
825
+
:::image type="content" source="media/connector-rest/pagination-rule-example-8-response-schema.png" alt-text="Screenshot showing the response schema of Example 8.":::
821
826
822
827
The pagination rules should be set as the following screenshot:
823
828
824
-
:::image type="content" source="media/connector-rest/pagination-example-8-pagination-rule.png" alt-text="Screenshot showing how to set the pagination rule for Example 8.":::
829
+
:::image type="content" source="media/connector-rest/pagination-rule-example-8.png" alt-text="Screenshot showing how to set the pagination rule for Example 8.":::
825
830
826
831
By default, the pagination will stop when body **.{@odata.nextLink}** is null or empty.
827
832
828
833
But if the value of **@odata.nextLink** in the last response body is equal to the last request URL, then it will lead to the endless loop. To avoid this condition, define end condition rules.
829
834
830
835
- If **Value** in the last response is **Empty**, then the end condition rule can be set as below:
831
836
832
-
:::image type="content" source="media/connector-rest/pagination-example-8-end-condition-1.png" alt-text="Screenshot showing setting the end condition rule when the last response is empty.":::
837
+
:::image type="content" source="media/connector-rest/pagination-rule-example-8-end-condition-1.png" alt-text="Screenshot showing setting the end condition rule when the last response is empty.":::
833
838
834
839
- If the value of the complete key in the response header equals to true indicates the end of pagination, then the end condition rule can be set as below:
835
840
836
-
:::image type="content" source="media/connector-rest/pagination-example-8-end-condition-2.png" alt-text="Screenshot showing setting the end condition rule when the complete key in the response header equals to true indicates the end of pagination.":::
841
+
:::image type="content" source="media/connector-rest/pagination-rule-example-8-end-condition-2.png" alt-text="Screenshot showing setting the end condition rule when the complete key in the response header equals to true indicates the end of pagination.":::
837
842
838
843
#### Example 9: The response format is XML and the next request URL is from the response body when use pagination in mapping data flows
839
844
840
845
This example states how to set the pagination rule in mapping data flows when the response format is XML and the next request URL is from the response body. As shown in the following screenshot, the first URL is *https://\<user\>.dfs.core.windows.net/bugfix/test/movie_1.xml*
841
846
842
847
843
-
:::image type="content" source="media/connector-rest/pagination-example-9-situation.png" alt-text="Screenshot showing the response format is XML and the next request URL is from the response body.":::
848
+
:::image type="content" source="media/connector-rest/pagination-rule-example-9-situation.png" alt-text="Screenshot showing the response format is XML and the next request URL is from the response body.":::
844
849
845
850
846
851
The response schema is shown below:
847
852
848
-
:::image type="content" source="media/connector-rest/pagination-example-9-response-schema.png" alt-text="Screenshot showing the response schema of Example 9.":::
853
+
:::image type="content" source="media/connector-rest/pagination-rule-example-9-response-schema.png" alt-text="Screenshot showing the response schema of Example 9.":::
849
854
850
855
The pagination rule sytax is the same as in Example 8 and should be set as below in this example:
851
856
852
-
:::image type="content" source="media/connector-rest/pagination-example-9-pagination-rule.png" alt-text="Screenshot showing setting the pagination rule for Example 9.":::
857
+
:::image type="content" source="media/connector-rest/pagination-rule-example-9.png" alt-text="Screenshot showing setting the pagination rule for Example 9.":::
0 commit comments