# Import Social Registry Data into PBMS

This document provides instructions to import data from the Social Registry (SR) into Program Beneficiary Management Systems' (PBMS) individual/group registries.

## Prerequisites

* A user must have an Administrator role to access the OpenG2P systems.

## Procedure

You must follow the procedures listed below to import data from the SR into the PBMS.

* [Configure SR into PBMS](#configure-sr-into-pbms)
* [Import data from the SR into PBMS](#import-data-from-sr-into-pbms)

### Configure SR into PBMS

1. Click the main icon ![](https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-04035215d78b73c4cc8238ae5303c552b094ec15%2Fmenu-icon.png?alt=media) and select ***Settings***.

<figure><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-611d791a93064404ef9cdb0239732dd08c304ccb%2Fpbms-settings%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

***Settings*** screen is displayed.

<figure><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-6a02ced30633b7ae6ceda8abf789868c009a40e8%2Fpbms-datasource.png?alt=media" alt=""><figcaption></figcaption></figure>

2. Click the ***Data Source*** tab.

***Data Source*** screen is displayed.

3. Click the ***New*** button.

***Data Source New*** screen is displayed.

<figure><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-0416ae54b850e8e8045dce36282b483dfc622882%2Fpbms-datasourcenew.png?alt=media" alt=""><figcaption></figcaption></figure>

The fields and their descriptions are given below.

**Table 1: New data source**

<table><thead><tr><th width="189">Field</th><th>Description</th></tr></thead><tbody><tr><td>Data Source Name</td><td>Enter the source name from where the data is imported.</td></tr><tr><td>Target URL</td><td>Enter the URL for the API request from where the data is retrieved.</td></tr><tr><td>Auth Type</td><td><p>Select the type of authentication from the drop-down. It is used to verify the legitimacy of the user. The valid values are:</p><ul><li>Basic Authentication</li><li>Bearer Authentication</li><li>API Key</li></ul></td></tr></tbody></table>

4. Click the ***URL Paths*** tab.
5. Click the ***Add a line*** link.
6. Enter the ***Data Source Path Name*** and the associated ***URL Path***.

**Table 2: Icons and their functions**

| Icon                                                                                                                                                                                                                                                   | Click to                                                                                                                                                                                                                                    |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-b6f0b2a4064d79d04550e0b271d00575206f0b10%2FActions.png?alt=media" alt="" data-size="original">              | <p>Select the appropriate value. The available values are:</p><ul><li>Archive</li><li>Duplicate</li><li>Change Password</li><li>Disable two-factor authentication</li><li>Send Password Reset Instructions</li><li>Privacy Lookup</li></ul> |
| <img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-843f8175332ed2465f83d2585eae57031142fb1f%2Ficon-save-manually.png?alt=media" alt="" data-size="original">   | Save manually the individual data and exit from the screen.                                                                                                                                                                                 |
| <img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-eaa9f395650b513ffba668e9638c701bce29630f%2Fdiscard-changes-icon.png?alt=media" alt="" data-size="original"> | Discard changes and exit from the screen.                                                                                                                                                                                                   |

**Sample data source screen**

<figure><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-f91e063a0795abaffd32a28f15da0738d60fd860%2Fsample-data-source.png?alt=media" alt=""><figcaption></figcaption></figure>

You can find the newly created data source listed in the ***Data Source*** screen.

<figure><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-9bba3da2a71c894f3b2e114093037052e8d41cc6%2Fpbms-datasource-list.png?alt=media" alt=""><figcaption></figcaption></figure>

### Import data from SR into PBMS

After configuring SR into PBMS, follow the below procedure.

7. Click the main icon ![](https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-04035215d78b73c4cc8238ae5303c552b094ec15%2Fmenu-icon.png?alt=media) and select ***Programs***.

***Programs*** screen is displayed.

8. Click the ***Import From Registry*** from the menu bar.

<figure><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-3940b4ca72f9fb6dea80a453cc1c02de0a799b77%2Fprogram-importregistry.png?alt=media" alt=""><figcaption></figcaption></figure>

***Previous Search Criterias*** screen is displayed.

9. Click the ***New*** button.

***Previous Search Criterias New*** screen is displayed.

<figure><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-ff3dd37398bc235b40db857d010fa0068099e717%2Fpbms-importregistrynew.png?alt=media" alt=""><figcaption></figcaption></figure>

The fields and their description are given below.

<table><thead><tr><th width="275">Field</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Enter the name of the new search criterias.</td></tr><tr><td>Data Source</td><td>Enter the name of the data source name as mentioned in Table 1 in the preceding section.</td></tr><tr><td>Import Registrant without ID</td><td>Check the box to import registrant without ID, if required.</td></tr><tr><td>Target Registry</td><td><p>Select the target registry from the drop-down. The valid values are:</p><ul><li>Group</li><li>Individual</li></ul></td></tr><tr><td>Target Program</td><td><p>Select the target program from the drop-down.</p><p>Note:</p><p>You can also use the <em><strong>Search More</strong></em> or <em><strong>Start typing</strong></em> options from the drop-down, to select the desired program.</p></td></tr><tr><td>Query</td><td>Enter the GraphQL query to import only the required data from the SR.</td></tr><tr><td>Last synced on</td><td><p>Enter the previous date of SR's PBMS synchronization to import data.</p><p>Note:</p><p>You can also use the calendar widget feature to select the date.</p></td></tr><tr><td>Imported Registrants</td><td><p>Shows the imported registrants' information.</p><p>Registrant - Displays the name of the group/individual</p><p>Is Group - Shows if the registrant belongs to a group</p><p>Created - Shows</p><p>Updated - Shows if the registrant is updated.</p></td></tr></tbody></table>

10. Click the ***Fetch*** button to import the data from SR into relevant individual/group registries of PBMS based on the GraphQL.

| Icon                                                                                                                                                                                                                                                   | Click to                                                                                                                                                                                                                                    |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-b6f0b2a4064d79d04550e0b271d00575206f0b10%2FActions.png?alt=media" alt="" data-size="original">              | <p>Select the appropriate value. The available values are:</p><ul><li>Archive</li><li>Duplicate</li><li>Change Password</li><li>Disable two-factor authentication</li><li>Send Password Reset Instructions</li><li>Privacy Lookup</li></ul> |
| <img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-843f8175332ed2465f83d2585eae57031142fb1f%2Ficon-save-manually.png?alt=media" alt="" data-size="original">   | Save manually the entered data and exit from the screen.                                                                                                                                                                                    |
| <img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-eaa9f395650b513ffba668e9638c701bce29630f%2Fdiscard-changes-icon.png?alt=media" alt="" data-size="original"> | Discard changes and exit from the screen.                                                                                                                                                                                                   |

**Sample previous search criterias screen**

<figure><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-9cecf4caa749881d0e27f403af34d63cfd0c0d1d%2Fsample-importregistryscreen.png?alt=media" alt=""><figcaption></figcaption></figure>

You can find the newly created one listed in the previous search criterias screen.

<figure><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-14cf033411c7cb3abea5a31cf60a23331d92ade5%2Fimportregistrylistscreen.png?alt=media" alt=""><figcaption></figcaption></figure>
