{"id":31815,"date":"2018-03-12T12:26:25","date_gmt":"2018-03-12T20:26:25","guid":{"rendered":"https:\/\/ephesoft.com\/docs\/2019-1-2\/moduleplugin-configuration\/extraction-module\/custom-rest-api-lookup\/"},"modified":"2020-11-24T09:52:34","modified_gmt":"2020-11-24T16:52:34","slug":"custom-rest-api-lookup","status":"publish","type":"docs","link":"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/extraction-module\/custom-rest-api-lookup\/","title":{"rendered":"REST API Lookup Plugin"},"content":{"rendered":"<h4>Skip to:<\/h4>\n<ul>\n<li><a href=\"#post-13886-_Toc505943122\">Introduction <\/a><\/li>\n<li><a href=\"#post-13886-_Toc505943123\">Prerequisites<\/a><\/li>\n<li><a href=\"#post-13886-_Toc505943124\">Configuration of REST API Lookup using the Web Service URL<\/a><\/li>\n<li><a href=\"#post-13886-_Toc505943125\">Configuration of REST API Lookup using the custom JAR file <\/a><\/li>\n<li><a href=\"#post-13886-_Toc505943126\">REST API Lookup on the Validation screen<\/a><\/li>\n<li><a href=\"#post-13886-_Toc505943127\">Configuration of XPath\/JSONPath<\/a><\/li>\n<\/ul>\n<h2><a id=\"post-13886-_Toc481500958\"><\/a><a id=\"post-13886-_Toc505943122\"><\/a>Introduction<\/h2>\n<p>Ephesoft Transact 4.5.0.0 now supports REST API Lookup. It is used to extract the document level fields of a document on basis of the Web Service response. With REST API Lookup, there is no need to provide direct access to the databases or create special scripts for REST API based extraction. Now, all configurations can be done directly from the UI.<\/p>\n<p>This feature has been implemented as a separate extraction plugin at the Batch Class level, configuration section at the Document Type level and a lookup functionality on the Validation screen. It provides the same user experience as the Fuzzy DB Lookup. However, rather than extracting the Index Fields directly from the database, it is passing configured values to a REST Web Service in the customer environment, and the Web Service returns XML\/JSON response back to Ephesoft Transact. The application parses the response and extracts the required information according to the mapped XPath\/JSONPath strings. The extracted values are then mapped to the Index Fields created for the Document Types.<\/p>\n<p>REST API Lookup can be configured in two ways:<\/p>\n<ul>\n<li><strong>REST URL based lookup<\/strong>, where the user provides REST URL, parameter and field mappings, as well as authentication details (username and password required to access the Web Service). The returned XML\/JSON response will then be used to extract values on basis of the XPath or JSONPath.<\/li>\n<li><strong>JAR based lookup<\/strong>, where the user provides their own custom implementation for authentication and API invocation. The Web Service should return API response (XML\/JSON) back to Ephesoft Transact using this custom JAR. The response will then be used to extract values based on a specified XPath or JSONPath.<\/li>\n<\/ul>\n<p>REST API Lookup has been implemented as a group based lookup much like the Fuzzy DB extraction. The user can create multiple groups for a Document Type with each group having different URL\/JAR and a different set of mapped columns. Each group can be assigned a specific weight, which will be used to select the primary value out of results from separate groups. If no weights are specified, the first result from the first group will be selected as a primary value.<\/p>\n<p>If REST API Lookup is used along with Key-Value Extraction Rules, the system will first extract the values based on the configured KV Extraction and then will use this data to map and lookup remaining values using the Web Service.<\/p>\n<h2><a id=\"post-13886-_Toc505943123\"><\/a>Prerequisites<\/h2>\n<p>1. In the Extraction module, drag and drop the <strong>REST_API_LOOKUP Plugin<\/strong> into the <strong>Selected Plugins <\/strong>field. Note that it should always be placed <em>after<\/em> the <strong>KEY_VALUE_EXTRACTION<\/strong> plugin.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13888\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-94.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word1.png\" width=\"702\" height=\"376\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-94.png 1392w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-94-300x160.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-94-768x410.png 768w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-94-1024x547.png 1024w\" sizes=\"(max-width: 702px) 100vw, 702px\" \/><\/p>\n<p>2. On the <strong>REST_API_LOOKUP Plugin<\/strong> <strong>Configuration<\/strong> screen, make sure that the <strong>Rest API Lookup Plugin Switch<\/strong> is ON.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13889\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-95.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word2.png\" width=\"701\" height=\"356\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-95.png 1198w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-95-300x152.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-95-1024x518.png 1024w\" sizes=\"(max-width: 701px) 100vw, 701px\" \/><\/p>\n<h2><a id=\"post-13886-_Toc505943124\"><\/a>Configure REST API Lookup using the Web Service URL<\/h2>\n<p>1. Navigate to the <strong>REST API Lookup<\/strong> tab which is available for each Document Type.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13890\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-96.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word14.png\" width=\"701\" height=\"235\" \/><\/p>\n<p>2. Click <strong>Add<\/strong> to add a new group. The left-side menu will be disabled, and the following screen will be displayed:<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13891\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-97.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word4.png\" width=\"701\" height=\"323\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-97.png 1908w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-97-300x138.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-97-768x353.png 768w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-97-1024x470.png 1024w\" sizes=\"(max-width: 701px) 100vw, 701px\" \/><\/p>\n<p>3. On the <strong>REST API Lookup Configuration<\/strong> screen, provide the <strong>Group Name,<\/strong> and select the <strong>REST URL Lookup<\/strong> option.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13892\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-98.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word15.png\" width=\"704\" height=\"118\" \/><\/p>\n<p>4. Fill in the <strong>Connection Details<\/strong> section.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13893\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-25.png\" width=\"700\" height=\"247\" \/><\/p>\n<table border=\"1\">\n<tbody>\n<tr>\n<td style=\"padding: 5px\" width=\"160\"><strong>Field<\/strong><\/td>\n<td style=\"padding: 5px\"><strong>Description<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Response Type<\/strong><\/td>\n<td style=\"padding: 5px\">Drop-down field to indicate whether REST API will return an XML or JSON type of response. Required for parsing the response from the Web Service.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Request Method<\/strong><\/td>\n<td style=\"padding: 5px\">Drop-down field to indicate GET or POST type of request.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Authentication Type<\/strong><\/td>\n<td style=\"padding: 5px\">Drop-down field with two authentication options:<\/p>\n<ul>\n<li>NONE<\/li>\n<li>BASIC AUTHENTICATION (requires username and password)<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Username<\/strong><\/td>\n<td style=\"padding: 5px\">Username used to access the Web Service. Mandatory if BASIC AUTHENTICATION type is selected.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Password<\/strong><\/td>\n<td style=\"padding: 5px\">Password used to access the Web Service. Mandatory if BASIC AUTHENTICATION type is selected.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Connection URL<\/strong><\/td>\n<td style=\"padding: 5px\">URL used to connect to the Web Service. Connection URL has auto-suggestion functionality to suggest path-parameters like BatchClassID, BatchInstanceID, DocumentID and Index Field names in the following format: <em>http:\/\/www.dummy.com\/rest\/${BatchClassID}\/<\/em><\/p>\n<p><em>${DocumentID}\/${InvoiceNo}.<\/em><\/p>\n<p>The URL can have both dynamic and static path-parameters. You can press\u00a0$\u00a0to see the dropdown list of available dynamic parameters.<\/p>\n<p>When you select an item from the dropdown, it will be enclosed in ${} to denote its special behavior.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>5. Fill in the <strong>Parameters Mappings<\/strong> section. To add a parameter, click <strong>+<\/strong>, to delete a parameter, click <strong>\u2013.<\/strong><\/p>\n<p><img decoding=\"async\" class=\"wp-image-13894\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-26.png\" width=\"700\" height=\"358\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-26.png 1191w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-26-300x153.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-26-1024x522.png 1024w\" sizes=\"(max-width: 700px) 100vw, 700px\" \/><\/p>\n<table border=\"1\">\n<tbody>\n<tr>\n<td style=\"padding: 5px\" width=\"160\"><strong>Field<\/strong><\/td>\n<td style=\"padding: 5px\"><strong>Description<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Parameter Name<\/strong><\/td>\n<td style=\"padding: 5px\">Name of parameter to be used as query parameter if request type is GET method, or body parameter if request type is POST method. Parameter name <em>must<\/em> match with the parameter name configured in the Web Service. All parameter names should be unique.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Parameter Value<\/strong><\/td>\n<td style=\"padding: 5px\">The value of a parameter can be selected from the drop-down list which includes default values like ${BATCH_CLASS_ID}, {BATCH_CLASS_NAME}, ${BATCH_INSTANCE_ID}, ${DOCUMENT_TYPE} as well as the names of all Index Fields configured for the Document Type. You can press\u00a0$\u00a0to see the dropdown list of available dynamic parameters. You can also directly type any static parameter in this field as required.<\/p>\n<p>Note: The combination of static and dynamic parameters in this field is not supported.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><strong>Note<\/strong>: Parameters mapped against configured Index Fields and containing dynamic values will be displayed on the Validation screen with the REST API Lookup icon <img decoding=\"async\" width=\"31\" height=\"22\" class=\"wp-image-13895\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-27.png\" \/>, which will allow the user to lookup available values using the Web Service.<\/p>\n<p>Let\u2019s consider an example. Suppose, the configured parameters are:<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13896\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-99.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word7.png\" width=\"467\" height=\"157\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-99-300x100.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-99-768x256.png 768w\" sizes=\"(max-width: 467px) 100vw, 467px\" \/><\/p>\n<p>Traditionally, if GET method is used, the Web Service URL will be:<\/p>\n<p><em>http:\/\/www.dummy.com?BatchID=${BATCH_CLASS_ID}&amp;DocIType=${DOCUMENT_TYPE}&amp;InvNo=${Invoice No}<\/em><\/p>\n<p>If POST method is used, the Web Service URL will be <em>http:\/\/www.dummy.com<\/em> and the above mentioned parameters will be included in the body of the request:<\/p>\n<pre>BatchID=${BATCH_CLASS_ID}\r\nDocID=${DOCUMENT_TYPE}\r\nInvNo=${Invoice No}<\/pre>\n<p>However, you can include query parameters in the URL or use them in the body for both methods.<\/p>\n<p>6. Finally, fill in the <strong>Index Field Mappings<\/strong> section. To add an Index Field, click <strong>+<\/strong>, to delete an Index Field, click <strong>\u2013.<\/strong><\/p>\n<p><img decoding=\"async\" class=\"wp-image-13897\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-28.png\" width=\"701\" height=\"518\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-28.png 1191w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-28-300x221.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-28-768x566.png 768w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-28-1024x755.png 1024w\" sizes=\"(max-width: 701px) 100vw, 701px\" \/><\/p>\n<table border=\"1\">\n<tbody>\n<tr>\n<td style=\"padding: 5px\" width=\"160\"><strong>Field<\/strong><\/td>\n<td style=\"padding: 5px\"><strong>Description<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Index Field<\/strong><\/td>\n<td style=\"padding: 5px\">Index Field to be mapped against Web Service metadata. The drop-down list includes all Index Fields configured for the Document Type. Each Index Field should be unique.<\/p>\n<p>If an Index Field is renamed or updated, the corresponding mapping will be deleted and the parameters have to be mapped again using updated Index Field.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Value (XPath\/JSON path)<\/strong><\/td>\n<td style=\"padding: 5px\">XPath mapped to the Index Field if the selected response type is XML or JSON path if selected response type is JSON. It is recommended to test the configured XPath\/JSONPath using online evaluation\/testing tools. Use the <strong>Help<\/strong> icon ( <img decoding=\"async\" width=\"20\" height=\"19\" class=\"wp-image-13898\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-29.png\" \/> ) to get detailed information about XPath\/JSONPath configuration and testing, or check the information <a href=\"#post-13886-Paths\">below<\/a>.<\/p>\n<p>Sample XPath: <em>\/List\/item\/invoiceNumber<\/em><\/p>\n<p>Sample JSONPath: <em>$.[0].invoiceNumber<\/em><\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Confidence (XPath\/JSON path)<\/strong><\/td>\n<td style=\"padding: 5px\">Similar to the Value field, this confidence field takes XPath\/JSONPath as input. XPath\/JSONPath string provided in this field will be used to extract confidence value for extracted fields.<\/p>\n<p>The value for Confidence in an Index Field mapping is optional. Following are some important points regarding the Confidence field.<\/p>\n<ul>\n<li>In case no value is provided, 100 will be taken as the confidence of the extracted value.<\/li>\n<li>If confidence path is incorrectly defined, then 0% confidence will be returned.<\/li>\n<li>In case the confidence value for all fields comes out to be between 0 and 1, it will be normalized by multiplying the confidence value by 100.<\/li>\n<\/ul>\n<p>The confidence range can be defined from 1 to 100 or from 0 to 1. It is assumed that the user selects 1-100 range. However, if the system detects that the user has selected 0-1 confidence range, it will multiply the confidence value by 100. This is done to ensure the overall consistency and uniform approach in both cases.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><strong>Note<\/strong>: The confidence for any field will be the product of confidence value from the XPath\/JSONPath mapping and the weight of REST API lookup group:<\/p>\n<p>If the REST API Lookup groups are configured as:<\/p>\n<p>Group 1: Weight = 0.5<\/p>\n<table border=\"1\">\n<tbody>\n<tr>\n<td style=\"padding: 5px\" width=\"150\"><strong>Index Field<\/strong><\/td>\n<td style=\"padding: 5px\" width=\"150\"><strong>Field Value<\/strong><\/td>\n<td style=\"padding: 5px\" width=\"150\"><strong>Confidence<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">Invoice No<\/td>\n<td style=\"padding: 5px\">ABC-123<\/td>\n<td style=\"padding: 5px\">80%<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">Company Name<\/td>\n<td style=\"padding: 5px\">XYZ Inc.<\/td>\n<td style=\"padding: 5px\">20%<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Group 2: Weight = 0.75<\/p>\n<table border=\"1\">\n<tbody>\n<tr>\n<td style=\"padding: 5px\" width=\"150\"><strong>Index Field<\/strong><\/td>\n<td style=\"padding: 5px\" width=\"150\"><strong>Field Value<\/strong><\/td>\n<td style=\"padding: 5px\" width=\"150\"><strong>Confidence<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">Invoice No<\/td>\n<td style=\"padding: 5px\">DLF-456<\/td>\n<td style=\"padding: 5px\">50%<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">Company Name<\/td>\n<td style=\"padding: 5px\">ABC Enterprises<\/td>\n<td style=\"padding: 5px\">&#8211;<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Then, the calculation will be as follows:<\/p>\n<p><strong>Invoice No: <\/strong><\/p>\n<p>Field value = MAX (0.5*80, 0.75*50) = MAX (40, 37.5) = \u201cABC-123\u201d with confidence of 40%<\/p>\n<p><strong>Company Name:<\/strong><\/p>\n<p>Field Value = MAX (0.5*20, 0.75*100) = MAX (10, 75) = \u201cABC Enterprises\u201d with confidence of 75%<\/p>\n<p>In Group 2, no confidence value extracted from XML\/JSON response for Company Name field and that is why its confidence is assumed to be 100%.\u00a0 The highest confidence field value will be set as the Document Level Field.<\/p>\n<p>7. Now, test your configuration by clicking <strong>Test Connection<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13899\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-100.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word11-1.png\" width=\"572\" height=\"99\" \/><\/p>\n<p><strong>Note<\/strong>: If any of the fields are left empty or include invalid values, the error message will be displayed and missing\/invalid field(s) will be highlighted.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13900\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-101.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word23.png\" width=\"699\" height=\"389\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-101.png 1229w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-101-300x166.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-101-768x426.png 768w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-101-1024x568.png 1024w\" sizes=\"(max-width: 699px) 100vw, 699px\" \/><\/p>\n<p>8. If all the fields are properly configured, a dialogue window is displayed with the list of all configured parameters. To test the connection, provide sample values for the parameters, and click <strong>Test<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13901\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-102.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word24.png\" width=\"367\" height=\"167\" \/><\/p>\n<p>If you configure two, three or more parameters in your Web Service, all of them will be displayed in this window. You can provide the value for any or all of them to test the connection.<\/p>\n<p><strong>Note<\/strong>: Depending on your Web Service, you might be able to test the connection even if there are no parameters provided. In that case, the dialogue window with Parameter Values and Sample Values will be empty, and you can proceed by simply clicking <strong>Test<\/strong> to ensure that the application can establish connection with the Web Service.<\/p>\n<p>9. Confirm the Web Service response that will appear in a new popup window.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13902\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-103.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word26.png\" width=\"467\" height=\"331\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-103.png 710w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-103-300x212.png 300w\" sizes=\"(max-width: 467px) 100vw, 467px\" \/><\/p>\n<p><strong>Note<\/strong>: In case the REST API returns an error due to authentication failure, server not responding etc., the relevant message and error code will be displayed in the response popup.<\/p>\n<p>10. Click <strong>Apply Mappings<\/strong> to save your configuration.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13903\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-104.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word11-2.png\" width=\"528\" height=\"86\" \/><\/p>\n<p>11. Click <strong>Apply<\/strong> on the <strong>REST API Lookup<\/strong> screen to save the group.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13904\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-30.png\" width=\"703\" height=\"201\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-30-300x85.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-30-768x218.png 768w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-30-1024x291.png 1024w\" sizes=\"(max-width: 703px) 100vw, 703px\" \/><\/p>\n<p>The <strong>REST API Lookup<\/strong> screen will contain a list of all configured REST API Lookup groups with the following columns:<\/p>\n<table border=\"1\">\n<tbody>\n<tr>\n<td style=\"padding: 5px\" width=\"160\"><strong>Field<\/strong><\/td>\n<td style=\"padding: 5px\"><strong>Description<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Group Name<\/strong><\/td>\n<td style=\"padding: 5px\">Name of the REST API lookup group. Group Name will be saved after you click <strong>Apply<\/strong> on the REST API Lookup screen. Once saved, the group name cannot be edited.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Connection URL\/JAR Name<\/strong><\/td>\n<td style=\"padding: 5px\">URL used to connect to the Web Service or the name of the uploaded JAR file.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Field Mappings<\/strong><\/td>\n<td style=\"padding: 5px\">List of mapped Index Fields separated by semi-colon.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Weight<\/strong><\/td>\n<td style=\"padding: 5px\">Weight is used to select the primary value out of results from separate groups. If no weight is specified or all the groups are assigned the same weight, the first result from the first group will be selected as a primary value. The weight can range from 0.1 to 1.0 with 0.1 being the lowest weight and 1.0 \u2013 the highest. By default, this parameter value is 0.5.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Enabled<\/strong><\/td>\n<td style=\"padding: 5px\">This switch is used to enable\/disable the REST API group mappings. If the group is disabled, it will not be used when performing the REST API Lookup.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Here, you can <strong>Add <\/strong>new groups as well as <strong>Edit<\/strong> or <strong>Delete<\/strong> already configured groups.<\/p>\n<p><strong>Limitations of the REST URL-based Lookup:<\/strong><\/p>\n<p>1. The use of HTTP headers and cookies in the request body is not supported.<\/p>\n<p>2. The only supported authentication method is Basic Authentication.<\/p>\n<p>3. Only GET\/POST requests are supported.<\/p>\n<p>All these limitations can be handled through the REST API Custom Jar Lookup described below.<\/p>\n<h2><a id=\"post-13886-_Toc505943125\"><\/a>Configure REST API Lookup using the custom JAR file<\/h2>\n<p>1. Create the custom JAR for REST API Lookup.<\/p>\n<p>Implement the following interface and upload the class via JAR.<\/p>\n<pre><code><span style=\"color: #800080\">import<\/span> java.util.List;\r\n<span style=\"color: #800080\">import<\/span> java.util.Map;\r\n\r\n<span style=\"color: #800080\">import<\/span> com.ephesoft.dcma.batch.schema.Batch;\r\n\r\n<span style=\"color: #3366ff\">The interface should be implemented for \"Custom Lookup\" functionality for REST API lookup based extraction. The implementation class should handle the authentication and WebService lookup in the implementation.\r\n\r\n @author Ephesoft\r\n @since 4.5.0.0<\/span>\r\n\r\n<span style=\"color: #800080\">public interface<\/span> CustomLookup {\r\n\r\n<span style=\"color: #3366ff\">The following method will be used for lookup for a particular \"Group Name\" and \"Document Type\". The method should handle the invocation of their web-service and provide a response in XML\/JSON format to be parsed by the REST Lookup\r\n<span style=\"color: #00ccff\">@param<\/span> groupName name of the group currently getting executed\r\n<span style=\"color: #00ccff\">@param<\/span> documentType name of the document type for which extraction is being done\r\n<span style=\"color: #00ccff\">@param<\/span> batch batch.xml to fetch any parameters\/variables required during lookup\r\n<span style=\"color: #00ccff\">@return<\/span> XML\/JSON response<\/span>\r\n\r\n<span style=\"color: #800080\">public<\/span> String executeLookup(final String groupName, final String documentType, final Batch batch);\r\n\r\n<span style=\"color: #3366ff\">The following method will be used during \"Test Connection\" functionality to fetch any parameters\/variables which are required during custom lookup.\r\n<span style=\"color: #00ccff\">@return<\/span> list of parameters\/variables to be used during the lookup<\/span>\r\n\r\n<span style=\"color: #800080\">public<\/span> List&lt;String&gt; getTestParameters();\r\n\r\n<span style=\"color: #3366ff\">The following method will be used during \"Test Connection\" functionality after the sample values are provided for parameters required for custom lookup. The method should test the lookup functionality based on the map of parameters and sample values from test connection grid. It should provide the XML\/JSON response to be shown in the test connection response.\r\nThis map will be created based on list of parameters as:: key in the map will be the parameter name and value will be the sample value provided by user in Test Connection grid.\r\n<span style=\"color: #00ccff\">@param<\/span> parameters map of parameter name and their sample value provided from test connection grid\r\n<span style=\"color: #00ccff\">@return<\/span> XML\/JSON response corresponding to the map of parameters in input and lookup response<\/span>\r\n\r\n<span style=\"color: #800080\">public<\/span> String testConnection(final Map&lt;String, String&gt; parameters);\r\n\r\n}\r\n<\/code><\/pre>\n<p>The Web Service implementation has to include the Web Service URL, return type, GET\/POST method reference and authentication details (if required).<\/p>\n<p>To use the Test Connection feature:<\/p>\n<ul>\n<li>in the <em>testConnection<\/em> method, you need to provide the URL, which will be used to connect to the Web Service;<\/li>\n<li>in the <em>getTestParameters<\/em> method, you need to specify parameters, which will be used to fetch the response.<\/li>\n<\/ul>\n<p>All three above-mentioned methods have to be implemented in the JAR. However, in case you do not want to use the Test Connection functionality, you can simply leave <em>getTestParameters<\/em> and <em>testConnection<\/em> methods empty.<\/p>\n<p>2. In Ephesoft Transact, navigate to the <strong>REST API Lookup<\/strong> tab which is available for each Document Type.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13905\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-105.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word14.png\" width=\"701\" height=\"235\" \/><\/p>\n<p>3. Click <strong>Add<\/strong> to add a new group. The left-side menu will be disabled, and the following screen will be displayed:<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13906\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-106.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word4.png\" width=\"701\" height=\"323\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-106.png 1908w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-106-300x138.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-106-768x353.png 768w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-106-1024x470.png 1024w\" sizes=\"(max-width: 701px) 100vw, 701px\" \/><\/p>\n<p>4. On the <strong>REST API Lookup Configuration<\/strong> screen, provide the <strong>Group Name,<\/strong> and select the <strong>Custom Lookup<\/strong> option.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13907\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-107.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word15-1.png\" width=\"573\" height=\"96\" \/><\/p>\n<p>5. Fill in the <strong>Connection Details<\/strong> section and upload the Custom JAR file.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13908\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-108.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word39.png\" width=\"694\" height=\"184\" \/><\/p>\n<table border=\"1\">\n<tbody>\n<tr>\n<td style=\"padding: 5px\" width=\"160\"><strong>Field<\/strong><\/td>\n<td style=\"padding: 5px\"><strong>Description<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Response Type<\/strong><\/td>\n<td style=\"padding: 5px\">Drop-down field to indicate whether REST API will return XML or JSON type of response. Required for parsing the response from the Web Service.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Fully-Qualified Class Name<\/strong><\/td>\n<td style=\"padding: 5px\">Package name + class name, e.g. if package name is <em>com.ephesoft.rest<\/em> and class name is <em>RestCustomLookup<\/em>, the fully-qualified class name will be <em>com.ephesoft.rest.RestCustomLookup.<\/em><\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Upload JAR File<\/strong><\/td>\n<td style=\"padding: 5px\">File upload browser to select the custom JAR for REST API lookup, which includes details about authentication method and parameters.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>6. Fill in the <strong>Index Field Mappings<\/strong> section. To add an Index Field, click <strong>+<\/strong>, to delete an Index Field, click <strong>\u2013.<\/strong><\/p>\n<p><img decoding=\"async\" class=\"wp-image-13909\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-109.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word40.png\" width=\"700\" height=\"357\" \/><\/p>\n<table border=\"1\">\n<tbody>\n<tr>\n<td style=\"padding: 5px\" width=\"160\"><strong>Field<\/strong><\/td>\n<td style=\"padding: 5px\"><strong>Description<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Index Field<\/strong><\/td>\n<td style=\"padding: 5px\">Index Field to be mapped against Web Service metadata. The drop-down list includes all Index Fields configured for the Document Type. Each Index Field should be unique.<\/p>\n<p>If an Index Field is renamed or updated, the corresponding mapping will be deleted and the parameters have to be mapped again using updated Index Field.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Value (XPath\/JSON path)<\/strong><\/td>\n<td style=\"padding: 5px\">XPath mapped to the Index Field if selected response type is XML or JSON path if selected response type is JSON. It is recommended to test the configured XPath\/JSONPath using online evaluation\/testing tools. Use the <strong>Help<\/strong> icon ( <img decoding=\"async\" width=\"20\" height=\"19\" class=\"wp-image-13910\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-31.png\" \/> ) to get detailed information about XPath\/JSONPath configuration and testing, or check the information <a href=\"#post-13886-Paths\">below<\/a>.<\/p>\n<p>Sample XPath: <em>\/List\/item\/invoiceNumber<\/em><\/p>\n<p>Sample JSONPath: <em>$.[0].invoiceNumber<\/em><\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Confidence (XPath\/JSON path)<\/strong><\/td>\n<td style=\"padding: 5px\">Similar to the Value field, this confidence field takes XPath\/JSONPath as input. XPath\/JSONPath string provided in this field will be used to extract confidence value for extracted fields.<\/p>\n<p>The value for Confidence in an Index Field Mapping is optional. Following are some important points regarding the Confidence field.<\/p>\n<ul>\n<li>In case no value is provided, 100 will be taken as the confidence of the extracted value.<\/li>\n<li>In case the confidence value for all fields comes out to be between 0 and 1, it will be normalized by multiplying the confidence value by 100.<\/li>\n<\/ul>\n<p>The confidence range can be defined from 1 to 100 or from 0 to 1. It is assumed that the user selects 1-100 range. However, if the system detects that the user has selected 0-1 confidence range, it will multiply the confidence value by 100. This is done to ensure the overall consistency and uniform approach in both cases.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><strong>Note<\/strong>: The confidence for any field will be the product of confidence value from the XPath\/JSONPath mapping and the weight of REST API lookup group:<\/p>\n<p>If the REST API Lookup groups are configured as:<\/p>\n<p>Group 1: Weight = 0.5<\/p>\n<table border=\"1\">\n<tbody>\n<tr>\n<td style=\"padding: 5px\" width=\"150\">Index Field<\/td>\n<td style=\"padding: 5px\" width=\"150\">Field Value<\/td>\n<td style=\"padding: 5px\" width=\"150\">Confidence<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">Invoice No<\/td>\n<td style=\"padding: 5px\">ABC-123<\/td>\n<td style=\"padding: 5px\">80%<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">Company Name<\/td>\n<td style=\"padding: 5px\">XYZ, Inc.<\/td>\n<td style=\"padding: 5px\">20%<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Group 2: Weight = 0.75<\/p>\n<table border=\"1\">\n<tbody>\n<tr>\n<td style=\"padding: 5px\" width=\"150\">Index Field<\/td>\n<td style=\"padding: 5px\" width=\"150\">Field Value<\/td>\n<td style=\"padding: 5px\" width=\"150\">Confidence<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">Invoice No<\/td>\n<td style=\"padding: 5px\">DLF-456<\/td>\n<td style=\"padding: 5px\">50%<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">Company Name<\/td>\n<td style=\"padding: 5px\">ABC Enterprises<\/td>\n<td style=\"padding: 5px\">&#8211;<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Then, the calculation will be as follows:<\/p>\n<p><strong>Invoice No:<\/strong><\/p>\n<p>Field value = MAX (0.5*80, 0.75*50) = MAX (40, 37.5) = \u201cABC-123\u201d with confidence of 40%<\/p>\n<p><strong>Company Name:<\/strong><\/p>\n<p>Field Value = MAX (0.5*20, 0.75*100) = MAX (10, 75) = \u201cABC Enterprises\u201d with confidence of 75%<\/p>\n<p>In Group 2 no confidence value extracted from XML\/JSON response for Company Name field, that\u2019s why its confidence is assumed as 100%.<\/p>\n<p>7. Now, test your configuration by clicking <strong>Test Connection<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13911\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-110.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word41.png\" width=\"478\" height=\"73\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-110.png 808w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-110-300x45.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-110-768x115.png 768w\" sizes=\"(max-width: 478px) 100vw, 478px\" \/><\/p>\n<p><strong>Note<\/strong>: If any of the UI fields are left empty or include invalid values, the error message will be displayed and missing\/invalid field(s) will be highlighted.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13912\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-111.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word42.png\" width=\"698\" height=\"296\" \/><\/p>\n<p>8. If everything is properly configured, the system will hit the URL provided in the <strong>testConnection<\/strong> method, and you will see a dialogue window with the list of all parameters included in the <strong>getTestParameters<\/strong> method.<\/p>\n<p>Suppose, you have configured the <strong>testConnection<\/strong> method as follows:<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13913\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-32.png\" width=\"699\" height=\"191\" \/><\/p>\n<p>And included the \u201cPONumber\u201d parameter in the <strong>getTestParameters<\/strong> method.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13914\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-33.png\" width=\"406\" height=\"85\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-33.png 626w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-33-300x62.png 300w\" sizes=\"(max-width: 406px) 100vw, 406px\" \/><\/p>\n<p>So, when you click <strong>Test Connection<\/strong>, the system connects to the specified URL, and the following pop-up window is displayed:<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13915\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-34.png\" width=\"400\" height=\"183\" \/><\/p>\n<p>To test the connection, provide a sample value for the parameter that you used in your Web Service, and click <strong>Test<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13916\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-35.png\" width=\"400\" height=\"183\" \/><\/p>\n<p><strong>Notes<\/strong>:<\/p>\n<ul>\n<li>When defining parameters in the <strong>getTestParameters<\/strong> method, make sure to provide the exact parameter name as configured in your Web Service to successfully use the Test Connection functionality.<\/li>\n<li>Depending on your Web Service, you can test the connection even if there are no parameters provided. In that case, the dialogue window with Parameter Values and Sample Values will be empty and you can proceed by simply clicking <strong>Test<\/strong> to ensure that the application can establish connection with the Web Service.<\/li>\n<\/ul>\n<p>9. Confirm the Web Service response that will appear in a new popup window. Depending on the configuration, the response field will or will not contain data.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13917\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-112.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word26.png\" width=\"414\" height=\"293\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-112.png 710w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-112-300x212.png 300w\" sizes=\"(max-width: 414px) 100vw, 414px\" \/><\/p>\n<p><strong>Note<\/strong>: In case the REST API returns error due to authentication failure, server not responding etc., the relevant message and error code will be displayed in the response popup.<\/p>\n<p>10. Click <strong>Apply Mappings<\/strong> to save your configuration.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13918\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-113.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word43.png\" width=\"462\" height=\"76\" \/><\/p>\n<p>11. Click <strong>Apply<\/strong> on the <strong>REST API Lookup<\/strong> screen to save the group.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13919\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-114.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word44.png\" width=\"700\" height=\"215\" \/><\/p>\n<p>The <strong>REST API Lookup<\/strong> screen will contain a list of all configured REST API Lookup groups with the following columns:<\/p>\n<table border=\"1\">\n<tbody>\n<tr>\n<td style=\"padding: 5px\" width=\"160\"><strong>Field<\/strong><\/td>\n<td style=\"padding: 5px\"><strong>Description<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Group Name<\/strong><\/td>\n<td style=\"padding: 5px\">Name of the REST API lookup group. Group Name will be saved after you click <strong>Apply<\/strong> on the REST API Lookup screen. Once saved, the group name cannot be edited.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Connection URL\/JAR Name<\/strong><\/td>\n<td style=\"padding: 5px\">URL used to connect to the Web Service or the name of the uploaded JAR file.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Field Mappings<\/strong><\/td>\n<td style=\"padding: 5px\">List of mapped Index Fields separated by semi-colon.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Weight<\/strong><\/td>\n<td style=\"padding: 5px\">Weight is used to select the primary value out of results from different groups. If no weight is specified or all the groups are assigned the same weight, the first result from the first group will be selected as a primary value. The weight can range from 0.1 to 1.0 with 0.1 being the lowest weight and 1.0 \u2013 the highest. By default, this parameter value is 0.5.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\"><strong>Enabled<\/strong><\/td>\n<td style=\"padding: 5px\">This switch is used to enable\/disable the REST API group mappings. If the group is disabled, it will not be used when performing the REST API Lookup.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Here, you can <strong>Add <\/strong>new groups as well as <strong>Edit<\/strong> or <strong>Delete<\/strong> already configured groups.<\/p>\n<h2><a id=\"post-13886-_Toc505943126\"><\/a>REST API Lookup on the Validation screen<\/h2>\n<p>Now, when your batch reaches the Validation stage, you can perform the lookup using the configured Web Service. On the Validation screen, you will see a Lookup icon &#8211; <em><img decoding=\"async\" width=\"31\" height=\"22\" class=\"wp-image-13920\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-36.png\" \/><\/em> against the Index Fields which have been used as parameters in your REST API Lookup configuration. On clicking the icon for the REST API Lookup, a pop-up window will be displayed with search functionality on the looked-up Index Field.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13921\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-115.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word27.png\" width=\"707\" height=\"291\" \/><\/p>\n<p>1. Perform REST API Lookup.<\/p>\n<p>You can type the required value directly into the text field in the middle pane and then click the Lookup icon to perform lookup.<\/p>\n<table>\n<tbody>\n<tr>\n<td><img decoding=\"async\" class=\"wp-image-13922 alignnone\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-116.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word29.png\" width=\"420\" height=\"372\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-116.png 595w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-116-300x266.png 300w\" sizes=\"(max-width: 420px) 100vw, 420px\" \/><\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/arrow.png\"><img decoding=\"async\" class=\" wp-image-13952 alignleft\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/arrow.png\" alt=\"\" width=\"89\" height=\"73\" \/><\/a><\/td>\n<\/tr>\n<tr>\n<td><img decoding=\"async\" class=\"wp-image-13923\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-117.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word30.png\" width=\"602\" height=\"215\" \/><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Or click the icon to open the Lookup dialogue window, provide the value in the search field and then click the <strong>Search<\/strong> icon.<\/p>\n<table>\n<tbody>\n<tr>\n<td><img decoding=\"async\" class=\"wp-image-13924\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-118.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word31.png\" width=\"419\" height=\"371\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-118.png 595w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-118-300x266.png 300w\" sizes=\"(max-width: 419px) 100vw, 419px\" \/><\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/arrow.png\"><img decoding=\"async\" class=\" wp-image-13952 alignleft\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/arrow.png\" alt=\"\" width=\"89\" height=\"73\" \/><\/a><\/td>\n<\/tr>\n<tr>\n<td><img decoding=\"async\" class=\"wp-image-13925\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-119.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word32.png\" width=\"598\" height=\"205\" \/><\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/arrow.png\"><img decoding=\"async\" class=\" wp-image-13952 alignleft\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/arrow.png\" alt=\"\" width=\"89\" height=\"73\" \/><\/a><\/td>\n<\/tr>\n<tr>\n<td><img decoding=\"async\" class=\"wp-image-13926\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-120.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word33.png\" width=\"599\" height=\"214\" \/><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>The percentage in brackets indicates the level of confidence for extracted values.<\/p>\n<p>The Lookup dialogue window will contain results from all the configured and enabled REST API Lookup groups.<\/p>\n<p>2. Select the required row(s) and click <strong>OK<\/strong> to populate the results on the Validation screen.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13927\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-121.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word34.png\" width=\"598\" height=\"203\" \/><\/p>\n<p><strong>Note<\/strong>: You will be able to select one or more groups in the pop-up window. On clicking OK, the Index Field confidence for the selected groups will be calculated as a product of group weight and field value confidence.<\/p>\n<ul>\n<li>The maximum resultant confidence from all selected groups will be used to select the ultimate Index Field value.<\/li>\n<li>If two groups have same resultant confidence, then first group will be selected and Index Field value will be populated.<\/li>\n<\/ul>\n<p>The selected REST API Lookup results are populated on the Validation screen.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13928\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-122.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word35.png\" width=\"435\" height=\"315\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-122.png 598w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-122-300x217.png 300w\" sizes=\"(max-width: 435px) 100vw, 435px\" \/><\/p>\n<p>3. Click <strong>Validate<\/strong> to confirm extraction results and proceed with the batch processing flow.<\/p>\n<p><strong>Note<\/strong>: If your Web Service is configured to fetch all values, no parameters are specified for the REST API Lookup and no KV Extraction rules are defined, the values on the Validation screen will be automatically populated with the first extracted result.<\/p>\n<p>Suppose, the REST API Lookup is configured the following way:<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13929\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-37.png\" width=\"699\" height=\"507\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-37.png 1157w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-37-300x218.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-37-768x557.png 768w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-37-1024x743.png 1024w\" sizes=\"(max-width: 699px) 100vw, 699px\" \/><\/p>\n<p>The Web Service is configured to return the following result:<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13930\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-38.png\" width=\"697\" height=\"481\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-38.png 943w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-38-300x207.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/word-image-38-768x529.png 768w\" sizes=\"(max-width: 697px) 100vw, 697px\" \/><\/p>\n<p>In this case, the REST API Lookup will fetch the data with the first \u201cid\u201d and populate the results on the Validation screen automatically. Since no parameters are configured, the REST API Lookup icon will not be displayed.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-13931\" style=\"border: 2px solid #A9A9A9;padding: 2px;margin: 2px\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-123.png\" alt=\"C:UsersEphesoftAppDataLocalMicrosoftWindowsINetCacheContent.Word38.png\" width=\"699\" height=\"294\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-123.png 1651w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-123-300x126.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-123-768x322.png 768w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-123-1024x429.png 1024w\" sizes=\"(max-width: 699px) 100vw, 699px\" \/><\/p>\n<p>You can \u201cfine-tune\u201d the extraction results by defining the Key-Value Extraction Rules or by using operators\/wildcards for the XPath\/JSONPath found in <a href=\"#post-13886-_Configuring_XPath\/JSONPath\">Configuring XPath\/JSONPath<\/a>.<\/p>\n<h2><a id=\"post-13886-_Configuring_XPath\/JSONPath\"><\/a><a id=\"post-13886-_Toc505943127\"><\/a><a id=\"post-13886-Paths\"><\/a>Configuring XPath\/JSONPath<\/h2>\n<p><strong>XPath<\/strong>: XPath (XML Path Language) is a query language for selecting nodes from an XML document. In addition, XPath may be used to compute values (e.g. strings, numbers, or Boolean values) from the content of an XML document.<\/p>\n<p><strong>JSONPath<\/strong>: JSONPath is a query language, similar to XPath, for selecting nodes from a JSON object. JSONPath expressions refer to a JSON structure in the same way as XPath expression are used in combination with an XML document. It is used to compute values from JSON objects.<\/p>\n<p>JSONPath uses special notation to represent nodes and their connections to adjacent nodes in a JSONPath path. There are two styles of notation, namely dot and bracket.<\/p>\n<p>Both of the following paths refer to the same node, which is the third element within the location field of creator node, that is a child of JSONPath object belonging to the tool under the root node.<\/p>\n<ul>\n<li>With dot notation:\u00a0$.tool.JSONPath.creator.location[2]<\/li>\n<li>With bracket notation:\u00a0$[&#8216;tool&#8217;][&#8216;JSONPath&#8217;][&#8216;creator&#8217;][&#8216;location&#8217;][2]<\/li>\n<\/ul>\n<p>We have several helpful operators in JSONPath:<\/p>\n<ol>\n<li>Root node ($): This symbol denotes the root member of a JSON structure no matter whether it is an object or array. Its usage examples have been showed above.<\/li>\n<li>Current node (@): Represents the node that is being processed, mostly used as part of input expressions for predicates. Suppose we are dealing with book array in the above JSON document, so the expression book[?(@.price == 49.99)] would refer to the first book in that array.<\/li>\n<li>Wildcard (*): Expresses all elements within the specified scope. For instance, book[*] indicates all nodes inside a book array.<\/li>\n<\/ol>\n<p>The XPath language is based on a tree representation of the XML document, and provides the ability to navigate around the tree, selecting nodes by a variety of criteria. In popular use (though not in the official specification), an XPath expression is often referred to simply as &#8220;an XPath&#8221;.<\/p>\n<p>Below is the list of operators which can be used to compute values in XPath and JSONPath.<\/p>\n<table border=\"1\">\n<tbody>\n<tr>\n<td style=\"padding: 5px\" width=\"70\"><strong>XPath<\/strong><\/td>\n<td style=\"padding: 5px\" width=\"120\"><strong>JSONPath<\/strong><\/td>\n<td style=\"padding: 5px\"><strong>Description<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">\/<\/td>\n<td style=\"padding: 5px\">$<\/td>\n<td style=\"padding: 5px\">the root object\/element<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">.<\/td>\n<td style=\"padding: 5px\">@<\/td>\n<td style=\"padding: 5px\">the current object\/element<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">\/<\/td>\n<td style=\"padding: 5px\">. or []<\/td>\n<td style=\"padding: 5px\">child operator<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">..<\/td>\n<td style=\"padding: 5px\">n\/a<\/td>\n<td style=\"padding: 5px\">parent operator<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">\/\/<\/td>\n<td style=\"padding: 5px\">..<\/td>\n<td style=\"padding: 5px\">recursive descent. JSONPath borrows this syntax from E4X.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">*<\/td>\n<td style=\"padding: 5px\">*<\/td>\n<td style=\"padding: 5px\">wildcard. All objects\/elements regardless their names.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">@<\/td>\n<td style=\"padding: 5px\">n\/a<\/td>\n<td style=\"padding: 5px\">attribute access. JSON structures don&#8217;t have attributes.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">[]<\/td>\n<td style=\"padding: 5px\">[]<\/td>\n<td style=\"padding: 5px\">subscript operator. XPath uses it to iterate over element collections and for predicates. In JavaScript and JSON, it is the native array operator.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">|<\/td>\n<td style=\"padding: 5px\">[,]<\/td>\n<td style=\"padding: 5px\">union operator in XPath results in a combination of node sets. JSONPath allows alternate names or array indices as a set.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">n\/a<\/td>\n<td style=\"padding: 5px\">[start:end:step]<\/td>\n<td style=\"padding: 5px\">array slice operator borrowed from ES4.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">[]<\/td>\n<td style=\"padding: 5px\">?()<\/td>\n<td style=\"padding: 5px\">applies a filter (script) expression.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">n\/a<\/td>\n<td style=\"padding: 5px\">()<\/td>\n<td style=\"padding: 5px\">script expression, using the underlying script engine.<\/td>\n<\/tr>\n<tr>\n<td style=\"padding: 5px\">()<\/td>\n<td style=\"padding: 5px\">n\/a<\/td>\n<td style=\"padding: 5px\">grouping in XPath<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n","protected":false},"featured_media":0,"parent":31802,"menu_order":9,"comment_status":"closed","ping_status":"open","template":"","doc_tag":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v19.0 (Yoast SEO v22.1) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>REST API Lookup Plugin | Ephesoft Docs<\/title>\n<meta name=\"robots\" content=\"noindex, follow\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"REST API Lookup Plugin\" \/>\n<meta property=\"og:description\" content=\"Skip to: Introduction Prerequisites Configuration of REST API Lookup using the Web Service URL Configuration of REST API Lookup using [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/extraction-module\/custom-rest-api-lookup\/\" \/>\n<meta property=\"og:site_name\" content=\"Ephesoft Docs\" \/>\n<meta property=\"article:modified_time\" content=\"2020-11-24T16:52:34+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-94.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"21 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/extraction-module\/custom-rest-api-lookup\/\",\"url\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/extraction-module\/custom-rest-api-lookup\/\",\"name\":\"REST API Lookup Plugin | Ephesoft Docs\",\"isPartOf\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/#website\"},\"datePublished\":\"2018-03-12T20:26:25+00:00\",\"dateModified\":\"2020-11-24T16:52:34+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/extraction-module\/custom-rest-api-lookup\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/extraction-module\/custom-rest-api-lookup\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/extraction-module\/custom-rest-api-lookup\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/ephesoft.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Transact\",\"item\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Features and Functions\",\"item\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Administrator Role and Features\",\"item\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Modules and Plugins\",\"item\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/\"},{\"@type\":\"ListItem\",\"position\":6,\"name\":\"Extraction Module\",\"item\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/extraction-module\/\"},{\"@type\":\"ListItem\",\"position\":7,\"name\":\"REST API Lookup Plugin\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/ephesoft.com\/docs\/#website\",\"url\":\"https:\/\/ephesoft.com\/docs\/\",\"name\":\"Ephesoft Docs\",\"description\":\"Intelligent Document Processing Made Easy\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/ephesoft.com\/docs\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"REST API Lookup Plugin | Ephesoft Docs","robots":{"index":"noindex","follow":"follow"},"og_locale":"en_US","og_type":"article","og_title":"REST API Lookup Plugin","og_description":"Skip to: Introduction Prerequisites Configuration of REST API Lookup using the Web Service URL Configuration of REST API Lookup using [&hellip;]","og_url":"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/extraction-module\/custom-rest-api-lookup\/","og_site_name":"Ephesoft Docs","article_modified_time":"2020-11-24T16:52:34+00:00","og_image":[{"url":"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2018\/03\/c-users-ephesoft-appdata-local-microsoft-windows-1-94.png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"21 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/extraction-module\/custom-rest-api-lookup\/","url":"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/extraction-module\/custom-rest-api-lookup\/","name":"REST API Lookup Plugin | Ephesoft Docs","isPartOf":{"@id":"https:\/\/ephesoft.com\/docs\/#website"},"datePublished":"2018-03-12T20:26:25+00:00","dateModified":"2020-11-24T16:52:34+00:00","breadcrumb":{"@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/extraction-module\/custom-rest-api-lookup\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/extraction-module\/custom-rest-api-lookup\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/extraction-module\/custom-rest-api-lookup\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/ephesoft.com\/docs\/"},{"@type":"ListItem","position":2,"name":"Transact","item":"https:\/\/ephesoft.com\/docs\/products\/transact\/"},{"@type":"ListItem","position":3,"name":"Features and Functions","item":"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/"},{"@type":"ListItem","position":4,"name":"Administrator Role and Features","item":"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/"},{"@type":"ListItem","position":5,"name":"Modules and Plugins","item":"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/"},{"@type":"ListItem","position":6,"name":"Extraction Module","item":"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/extraction-module\/"},{"@type":"ListItem","position":7,"name":"REST API Lookup Plugin"}]},{"@type":"WebSite","@id":"https:\/\/ephesoft.com\/docs\/#website","url":"https:\/\/ephesoft.com\/docs\/","name":"Ephesoft Docs","description":"Intelligent Document Processing Made Easy","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/ephesoft.com\/docs\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"}]}},"comment_count":0,"_links":{"self":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/31815"}],"collection":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/comments?post=31815"}],"version-history":[{"count":0,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/31815\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/31802"}],"next":[{"title":"Scripting Plugin","link":"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/extraction-module\/scripting-plugin-2\/","href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/31838"}],"prev":[{"title":"Regular Regex Extraction Plugin","link":"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/extraction-module\/regular-regex-extraction-plugin-3\/","href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/31817"}],"wp:attachment":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/media?parent=31815"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/doc_tag?post=31815"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}