Skip to content
Snippets Groups Projects
Commit df24a79e authored by Rebecca Wheeler's avatar Rebecca Wheeler
Browse files

Update 5 files

- /docs/tutorials/API_Related/SupOrg_and_CostCenter/CostCenter.md
- /images/RestV2.png
- /images/ReqOptions.png
- /images/pagination.png
- /images/FieldMapping.png
parent 32134005
No related branches found
No related tags found
1 merge request!79Update 12 files
......@@ -16,7 +16,6 @@ Cost Centers represent accounting groups and subgroups used to track accounting
![JsonResponse](images/jsonResponse.png)
2) Next, head to Informatica. You'll want to be in the Administrator section, then click "Swagger Files" in the left column.
3) Click "New" in the upper right and fill in the fields as seen in the two screenshots below.
- Create a name.
- Select a runtime environment (the same Secure Agent you typically work from).
......@@ -36,9 +35,50 @@ Cost Centers represent accounting groups and subgroups used to track accounting
4) Click "Save" in the upper right, then find the Swagger File you just created and download it.
5) You will need to host this file publicly. If you don't have your own repository to do this, you can use the EI Integration Team's [Swagger Repository](https://git.doit.wisc.edu/interop/iics/iics-swagger-file-public-repository). Please be mindful of our [organizational strategy](https://git.doit.wisc.edu/interop/iics/iics-swagger-file-public-repository/-/blob/main/file-organization-guidelines.md).
# Rest V2 connection to the API
# Rest V2 connection
1) Click into the "Connections" section of Administrator.
2) Click "New Connection" in the upper right.
3) Fill the settings in as seen in the screenshot below.
- Name your connection according to [Best Practices](~/docs/best-practices/naming.md).
- Type: REST V2
- Select a runtime environment (the same Secure Agent you typically work from).
- Authentication: OAuth 2.0-Client Credentials
- Access Token URL: https://api.wisc.edu/oauth/token
- Client ID: Your ID from the Developer Portal for your registered app
- Client Secret: Your Secret from the Developer Portal for your registered app
- Client Authentication: Send Client Credentials In Body
- Access Token: Click the button for "Generate Access Token"
- Swagger File Path: If you host with the EI Integration Team's Repository, this file path will be the raw URL, obtained by clicking the "Open raw" button on the gitlab page of your Swagger File.
4) Test your connection and if it's successful, click "Save".
![RestV2](images/RestV2.png)
# The Mapping
This part you'll notice is quite straightforward. The only special attention we need to take is to the pagination settings in the Source.
1) Create a Mapping in the Data Integration section of Informatica.
2) In the Source tile, select the REST V2 connection you created in the previous section.
3) There should be only one option for Operation, which you named while creating the Swagger File in the Swagger section of this tutorial.
4) Expand the "Request Options" section and click "Configure...".
5) Adjust the "page[number]" to equal 1 and press "OK".
![ReqOptions](images/ReqOptions.png)
6) Expand the "Advanced" section in Source and adjust the settings to be like the screenshot below.
- Paging Type: Page
- Page Parameter: page[number]
- Start Page: 1
- End Page: 1000 (there are approximately 53 pages in this endpoint, setting this number is a stop-gap if other settings fail)
- Page Increment Factor: 1
- End Of Response Expression: \[\] (this is what will stop the pagination at the page AFTER the last page that contains data. It is referencing an empty array to successfully search for.)
- The rest of the settings remain at their default.
![Pagination](images/pagination.png)
7) Click "Field Mapping" in the Source tile and select any data elements you'd like to pull out of the API.
# Pagination
![FieldMapping](images/FieldMapping.png)
~/docs/tutorials/API_Related/PersonAPI/PersonAPIwRESTv2.md#creating-your-own-swagger-files
\ No newline at end of file
8) In the Target tile, select any target you have set up that can receive a .csv file. You can select "Create New at Runtime" if you don't have headers set up yet if you prefer. You can also choose to further format this data as you wish before delivery to your target connection.
\ No newline at end of file
images/FieldMapping.png

87 KiB

images/ReqOptions.png

93 KiB

images/RestV2.png

95.7 KiB

images/pagination.png

53.7 KiB

0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment