pict-section-recordset 1.0.43 → 1.0.44

package/source/services/RecordsSet-MetaController.js

@@ -96,6 +96,8 @@ class RecordSetMetacontroller extends libFableServiceProviderBase
 	 */
 
 	/**
+	 * @param {string} pRecordSet - The RecordSet name to get the configuration for.
+	 *
 	 * @return {Record<string, any>} - The registered configuration for the RecordSet
 	 */
 	getRecordSetConfiguration(pRecordSet)
@@ -103,6 +105,9 @@ class RecordSetMetacontroller extends libFableServiceProviderBase
 		return this.recordSetProviderConfigurations[pRecordSet];
 	}
 
+	/**
+	 * @param {Record<string, any>} pRecordSetConfiguration - The RecordSet configuration to load.
+	 */
 	loadRecordSetConfiguration(pRecordSetConfiguration)
 	{
 		if (typeof pRecordSetConfiguration !== 'object')
@@ -208,6 +213,9 @@ class RecordSetMetacontroller extends libFableServiceProviderBase
 		return tmpProvider;
 	}
 
+	/**
+	 * @param {Array<Record<string, any>>} pRecordSetConfigurationArray - An array of RecordSet configurations to load.
+	 */
 	loadRecordSetConfigurationArray(pRecordSetConfigurationArray)
 	{
 		if (!Array.isArray(pRecordSetConfigurationArray))
@@ -229,6 +237,11 @@ class RecordSetMetacontroller extends libFableServiceProviderBase
 		}
 	}
 
+	/**
+	 * @param {Record<string, any> | string} pRecordSet - The RecordSet configuration or hash to load dynamically.
+	 * @param {string} [pEntity] - (optional) The Entity type to use (defaults to the RecordSet name if not provided).
+	 * @param {string} [pDefaultFilter] - (optional) The default filter to use.
+	 */
 	loadRecordSetDynamically(pRecordSet, pEntity, pDefaultFilter)
 	{
 		if (typeof(pRecordSet) === 'object')
@@ -238,6 +251,11 @@ class RecordSetMetacontroller extends libFableServiceProviderBase
 
 			return this.fable.providers[tmpRecordSetProviderHash].initializeAsync((pError) =>
 				{
+					if (pError)
+					{
+						this.log.error(`RecordSet [${pRecordSet.RecordSet}] dynamically loaded with error: ${pError.message || pError}`, { Stack: pError.stack });
+						return;
+					}
 					this.log.trace(`RecordSet [${pRecordSet.RecordSet} dynamically loaded.`);
 				})
 		}
@@ -264,6 +282,11 @@ class RecordSetMetacontroller extends libFableServiceProviderBase
 			return this.fable.providers[tmpRecordSetProviderHash].initializeAsync(
 				(pError) =>
 				{
+					if (pError)
+					{
+						this.log.error(`RecordSet [${tmpRecordSet}] dynamically loaded with error: ${pError.message || pError}`, { Stack: pError.stack });
+						return;
+					}
 					this.log.trace(`RecordSet [${tmpRecordSetConfiguration.RecordSet} dynamically loaded.`);
 				});
 		}
@@ -272,6 +295,9 @@ class RecordSetMetacontroller extends libFableServiceProviderBase
 		return false;
 	}
 
+	/**
+	 * @param {Record<string, any>} pRoutePayload - The route payload containing the RecordSet and optional Entity and DefaultFilter.
+	 */
 	handleLoadDynamicRecordSetRoute(pRoutePayload)
 	{
 		if (typeof(pRoutePayload) != 'object')
@@ -287,6 +313,9 @@ class RecordSetMetacontroller extends libFableServiceProviderBase
 		return this.loadRecordSetDynamically(tmpRecordSet, tmpEntity, tmpDefaultFilter);
 	}
 
+	/**
+	 * @param {import('pict-router')} pPictRouter - The Pict Router to add the routes to.
+	 */
 	addRoutes(pPictRouter)
 	{
 		pPictRouter.addRoute('/PSRS/:RecordSet/LoadDynamic', this.handleLoadDynamicRecordSetRoute.bind(this));
@@ -295,6 +324,9 @@ class RecordSetMetacontroller extends libFableServiceProviderBase
 		return true;
 	}
 
+	/**
+	 * @param {string} pCapability - The capability to check for.
+	 */
 	async checkSession(pCapability)
 	{
 		for (const sessionProvider of this.sessionProviders)
@@ -307,6 +339,13 @@ class RecordSetMetacontroller extends libFableServiceProviderBase
 		return true;
 	}
 
+	/**
+	 * @param {string} pNameTemplate - The name template for the record link.
+	 * @param {string} pURLTemplate - The URL template for the record link.
+	 * @param {boolean} pDefault - Whether this is a default link template.
+	 *
+	 * @return {Record<string, any>} - The link template object that was added.
+	 */
 	addRecordLinkTemplate(pNameTemplate, pURLTemplate, pDefault)
 	{
 		return this.fable.providers.RecordSetLinkManager.addRecordLinkTemplate(pNameTemplate, pURLTemplate, pDefault);

package/source/templates/Pict-Template-FilterInstanceViews.js

@@ -30,17 +30,22 @@ class PictTemplateFilterInstanceViewInstruction extends libPictTemplate
 		}
 	}
 
-	_getViewForFilterClauses(pClauses)
+	_getViewForFilterClause(pClause)
 	{
-		const tmpViewHash =`PRSP-FilterType-${pClauses.Type}`;
+		let tmpViewHash = `PRSP-FilterType-${pClause.Type}`;
+		const tmpCustomViewHash = `${tmpViewHash}-${pClause.CustomFilterViewHash}`;
+		if (tmpCustomViewHash in this.pict.views)
+		{
+			tmpViewHash = tmpCustomViewHash;
+		}
 		/** @type {import('../views/filters/RecordSet-Filter-Base.js')} */
 		let tmpView = this.pict.views[tmpViewHash];
 		if (!tmpView)
 		{
-			const tmpViewPrototype = libFilterViews[pClauses.Type] || libFilterViews.Base;
+			const tmpViewPrototype = libFilterViews[pClause.Type] || libFilterViews.Base;
 			if (!tmpViewPrototype)
 			{
-				this.pict.log.error(`Pict: Filter Instance Views Template Render: No view prototype found for filter type [${pClauses.Type}]`);
+				this.pict.log.error(`Pict: Filter Instance Views Template Render: No view prototype found for filter type [${pClause.Type}]`);
 				return null;
 			}
 			//FIXME: is this safe? will this view get rendered at other times?
@@ -103,11 +108,10 @@ class PictTemplateFilterInstanceViewInstruction extends libPictTemplate
 		const tmpClauses = this.pict.Bundle._ActiveFilterState?.[pRecord.RecordSet]?.FilterClauses || [];
 		//FIXME: lookup by hash instead?
 		for (let i = 0; i < tmpClauses.length; i++)
-		//for (const tmpClauses of this.pict.Bundle._ActiveFilterState?.[pRecord.RecordSet]?.FilterClauses || [])
 		{
 			const tmpClause = tmpClauses[i];
 			/** @type {import('../views/filters/RecordSet-Filter-Base.js')} */
-			const tmpView = this._getViewForFilterClauses(tmpClause);
+			const tmpView = this._getViewForFilterClause(tmpClause);
 			if (!tmpView)
 			{
 				continue;
@@ -182,7 +186,7 @@ class PictTemplateFilterInstanceViewInstruction extends libPictTemplate
 		{
 			const tmpClause = tmpClauses[i];
 			/** @type {import('../views/filters/RecordSet-Filter-Base.js')} */
-			const tmpView = this._getViewForFilterClauses(tmpClause);
+			const tmpView = this._getViewForFilterClause(tmpClause);
 			if (!tmpView)
 			{
 				continue;

package/source/views/RecordSet-Filters.js

@@ -148,61 +148,61 @@ const _DEFAULT_CONFIGURATION_SUBSET_Filter =
 //FIXME: export this from PSF?
 const libPictViewDynamicForm = require('pict-section-form/source/views/Pict-View-DynamicForm.js');
 
-class ViewRecordSetSUBSETFilters extends libPictView
+const DynamicInputViewSectionDefinition = (
 {
-	constructor(pFable, pOptions, pServiceHash)
-	{
-		let tmpOptions = Object.assign({}, _DEFAULT_CONFIGURATION_SUBSET_Filter, pOptions);
-		super(pFable, tmpOptions, pServiceHash);
-		/** @type {import('fable') & import('pict') & { PictSectionRecordSet: import('../Pict-Section-RecordSet.js') }} */
-		this.pict;
+	"Hash": "PSRSDynamicInputs",
+	"Name": "Custom Dynamic Inputs",
+	"ViewHash": "PSRSFilterProxyView",
 
-		const tmpDynamicInputViewSection = (
-		{
-			"Hash": "PSRSDynamicInputs",
-			"Name": "Custom Dynamic Inputs",
-			"ViewHash": "PSRSFilterProxyView",
+	"AutoMarshalDataOnSolve": true,
+	"IncludeInMetatemplateSectionGeneration": false,
 
-			"AutoMarshalDataOnSolve": true,
-			"IncludeInMetatemplateSectionGeneration": false,
-
-			"Manifests":
+	"Manifests":
+	{
+		"Section":
+		{
+			"Scope": "PSRSDynamic",
+			"Sections":
+			[
+				{
+					"Hash": "PSRSDynamicInputs",
+					"Name": "Dynamic Inputs"
+				}
+			],
+			"Descriptors":
 			{
-				"Section":
+				"PSRS.DynamicInputPlaceholder":
 				{
-					"Scope": "PSRSDynamic",
-					"Sections":
-					[
-						{
-							"Hash": "PSRSDynamicInputs",
-							"Name": "Dynamic Inputs"
-						}
-					],
-					"Descriptors":
+					"Name": "DynamicInputPlaceholder",
+					"Hash": "DynamicInputPlaceholder",
+					"DataType": "String",
+					"Macro":
 					{
-						"PSRS.DynamicInputPlaceholder":
-						{
-							"Name": "DynamicInputPlaceholder",
-							"Hash": "DynamicInputPlaceholder",
-							"DataType": "String",
-							"Macro":
-							{
-								"HTMLSelector": ""
-							},
-							"PictForm":
-							{
-								"Section": "PSRSDynamicInputs"
-							}
-						}
+						"HTMLSelector": ""
+					},
+					"PictForm":
+					{
+						"Section": "PSRSDynamicInputs"
 					}
 				}
 			}
-		});
-		if (!this.pict.views[tmpDynamicInputViewSection.ViewHash])
+		}
+	}
+});
+class ViewRecordSetSUBSETFilters extends libPictView
+{
+	constructor(pFable, pOptions, pServiceHash)
+	{
+		let tmpOptions = Object.assign({}, _DEFAULT_CONFIGURATION_SUBSET_Filter, pOptions);
+		super(pFable, tmpOptions, pServiceHash);
+		/** @type {import('fable') & import('pict') & { PictSectionRecordSet: import('../Pict-Section-RecordSet.js') }} */
+		this.pict;
+
+		if (!this.pict.views[DynamicInputViewSectionDefinition.ViewHash])
 		{
-			const tmpViewConfiguration = Object.assign({}, tmpDynamicInputViewSection);
+			const tmpViewConfiguration = Object.assign({}, DynamicInputViewSectionDefinition);
 			this.pict.addView(tmpViewConfiguration.ViewHash, tmpViewConfiguration, libPictViewDynamicForm);
-			this.pict.views[tmpDynamicInputViewSection.ViewHash].viewMarshalDestination = 'Bundle';
+			this.pict.views[DynamicInputViewSectionDefinition.ViewHash].viewMarshalDestination = 'Bundle';
 		}
 		for (const tmpView of Object.values(require('./filters')))
 		{
@@ -221,6 +221,25 @@ class ViewRecordSetSUBSETFilters extends libPictView
 		}
 	}
 
+	/**
+	 * @return {string} - The marshalling prefix configured for filters. Usually 'Bundle.'
+	 */
+	getInformaryAddressPrefix()
+	{
+		return `${this.pict.views[DynamicInputViewSectionDefinition.ViewHash].viewMarshalDestination}.`;
+	}
+
+	/**
+	 * @param {string} pAddress - The address of the informary to get the value from.
+	 *
+	 * @return {any} - The value at the given address, using the informary marshalling prefix.
+	 */
+	getInformaryScopedValue(pAddress)
+	{
+		const tmpCompositeAddress = `${this.getInformaryAddressPrefix()}${pAddress}`;
+		return this.pict.resolveStateFromAddress(tmpCompositeAddress);
+	}
+
 	//NOTE: two methods below copied from the pict-section-form metacontroller
 	//TODO: consider subclassing the dynamic view to somehow mark these as filter views so we can only operate on those views
 
@@ -315,6 +334,7 @@ class ViewRecordSetSUBSETFilters extends libPictView
 		{
 			tmpURL = tmpURL.replace(/\/FilteredTo\//, '');
 		}
+		this.render(undefined, undefined, { RecordSet: pRecordSet, ViewContext: pViewContext });
 		this.serializeFilterExperience(this.pict.Bundle._ActiveFilterState[pRecordSet]?.FilterClauses).then((pFilterExperienceSerialized) =>
 		{
 			if (pFilterExperienceSerialized)
@@ -342,6 +362,11 @@ class ViewRecordSetSUBSETFilters extends libPictView
 			{
 				delete tmpClause.Value;
 				delete tmpClause.Values;
+				delete tmpClause.SearchInputValue;
+				delete tmpClause.SelectedValues;
+				delete tmpClause.SearchResults;
+				delete tmpClause.SearchResultsOffset;
+				delete tmpClause.LoadMoreEnabled;
 			}
 		}
 		this.performSearch(pRecordSet, pViewContext);
@@ -428,7 +453,15 @@ class ViewRecordSetSUBSETFilters extends libPictView
 		{
 			return '';
 		}
-		return this.encode(await this.compress(JSON.stringify(pExperience)));
+		const tmpExperience = JSON.parse(JSON.stringify(pExperience));
+		for (const tmpClause of tmpExperience)
+		{
+			//FIXME: avoiding saving search results to the URL but this pattern isn't ideal
+			delete tmpClause.SearchResults;
+			delete tmpClause.SearchResultsOffset;
+			delete tmpClause.LoadMoreEnabled;
+		}
+		return this.encode(await this.compress(JSON.stringify(tmpExperience)));
 	}
 
 	/**

package/source/views/filters/RecordSet-Filter-Base.js

@@ -41,7 +41,7 @@ const _DEFAULT_CONFIGURATION_SUBSET_Filter =
 			Hash: 'PRSP-Filter-Base-Template',
 			Template: /*html*/`
 	<!-- DefaultPackage pict view template: [PRSP-Filter-Base-Template] -->
-	<div>
+	<div id="PRSP_Filter_Container_{~D:Record.Hash~}">
 		<button type="button"
 			onclick="_Pict.views['PRSP-Filters'].removeFilter(event, '{~D:Record.RecordSet~}', '{~D:Record.ViewContext~}', '{~D:Record.Hash~}');"
 			>
@@ -97,6 +97,24 @@ class ViewRecordSetSUBSETFilterBase extends libPictView
 	{
 		return 'PRSP-Filter-Base-Form';
 	}
+
+	/**
+	 * @return {string} - The prefix for the informary address.
+	 */
+	getInformaryAddressPrefix()
+	{
+		return this.pict.views['PRSP-Filters'].getInformaryAddressPrefix();
+	}
+
+	/**
+	 * @param {string} pInformaryAddress - The address of the informary to get the value from.
+	 *
+	 * @return {any} - The value at the informary address.
+	 */
+	getInformaryScopedValue(pInformaryAddress)
+	{
+		return this.pict.views['PRSP-Filters'].getInformaryScopedValue(pInformaryAddress);
+	}
 }
 
 module.exports = ViewRecordSetSUBSETFilterBase;

package/source/views/filters/RecordSet-Filter-ExternalJoinSelectedValue.js

@@ -0,0 +1,270 @@
+
+const ViewRecordSetSUBSETFilterBase = require('./RecordSet-Filter-Base');
+
+const _DEFAULT_CONFIGURATION_Filter_ExternalJoin_SelectedValue =
+{
+	ViewIdentifier: 'PRSP-FilterType-ExternalJoinSelectedValue',
+
+	Templates:
+	[
+		{
+			Hash: 'PRSP-Filter-ExternalJoin-SelectedValue-Template',
+			Template: /*html*/`
+	<!-- DefaultPackage pict view template: [PRSP-Filter-ExternalJoin-SelectedValue-Template] -->
+	<table>
+		<tbody>
+		<td valign="top">{~T:PRSP-Filter-ExternalJoin-SelectedValue-SearchResults~}</td><td valign="top">{~T:PRSP-Filter-ExternalJoin-SelectedValue-SelectedValues~}</td>
+		</tbody>
+	</table>
+	<!-- DefaultPackage end view template:	[PRSP-Filter-ExternalJoin-SelectedValue-Template] -->
+`
+		},
+		{
+			Hash: 'PRSP-Filter-ExternalJoin-SelectedValue-SearchResults',
+			Template: /*html*/`
+	<!-- DefaultPackage pict view template: [PRSP-Filter-ExternalJoin-SearchResults] -->
+	<form id="PRSP_Filter_{~D:Record.Hash~}_Search_Form" onsubmit="_Pict.views['{~D:Context[0].Hash~}'].performSearch(event, '{~D:Record.ClauseAddress~}', '{~D:Record.Hash~}'); return false;">
+		<input id="PRSP_Filter_{~D:Record.Hash~}_Search_Value" type="text" placeholder="Search..." value="{~D:Record.SearchInputValue~}" />
+		<button type="submit" id="PRSP_Filter_{~D:Record.Hash~}_Button_Search" onclick="_Pict.views['{~D:Context[0].Hash~}'].performSearch(event, '{~D:Record.ClauseAddress~}', '{~D:Record.Hash~}')">Search</button>
+	</form>
+	<table>
+		<thead>
+			<tr><th colspan="2">{~D:Record.Label~}</th></tr>
+		</thead>
+		<tbody>
+			{~TSWP:PRSP-Filter-ExternalJoin-SelectedValue-SearchResults-Entry:Record.SearchResults:Record~}
+		</tbody>
+	</table>
+	<button type="button" id="PRSP_Filter_{~D:Record.Hash~}_Button_LoadMore" class="is-hidden" onclick="_Pict.views['{~D:Context[0].Hash~}'].loadMore(event, '{~D:Record.ClauseAddress~}', '{~D:Record.Hash~}', {~D:Record.SearchResultsOffset:0~})">Load More</button>
+	<!-- DefaultPackage end view template:	[PRSP-Filter-ExternalJoin-SearchResults] -->
+`
+		},
+		{
+			Hash: 'PRSP-Filter-ExternalJoin-SelectedValue-SelectedValues',
+			Template: /*html*/`
+	<!-- DefaultPackage view template:	[PRSP-Filter-ExternalJoin-SelectedValue-SelectedValues] -->
+	<table>
+		<thead>
+			<tr><th colspan="2">Selection</th></tr>
+		</thead>
+		<tbody>
+			{~TSWP:PRSP-Filter-ExternalJoin-SelectedValue-SelectedValues-Entry:Record.SelectedValues:Record~}
+		</tbody>
+	</table>
+	<!-- DefaultPackage end view template:	[PRSP-Filter-ExternalJoin-SelectedValue-SelectedValues] -->
+`
+		},
+		{
+			Hash: 'PRSP-Filter-ExternalJoin-SelectedValue-SearchResults-Entry',
+			Template: /*html*/`
+	<!-- DefaultPackage pict view template: [PRSP-Filter-ExternalJoin-SelectedValue-Template] -->
+	<tr><td><button onclick="_Pict.views['{~D:Context[0].Hash~}'].handleSelect(event, {~DVBK:Record.Data:Record.Payload.ExternalFilterTableLookupColumn~}, '{~D:Record.Payload.ClauseAddress~}', '{~D:Record.Payload.Hash~}')">Select</button></td><td>{~TFA:Record.Payload.ExternalRecordDisplayTemplate:Record~}</td></tr>
+	<!-- DefaultPackage end view template:	[PRSP-Filter-ExternalJoin-SelectedValue-Template] -->
+`
+		},
+		{
+			Hash: 'PRSP-Filter-ExternalJoin-SelectedValue-SelectedValues-Entry',
+			Template: /*html*/`
+	<!-- DefaultPackage pict view template: [PRSP-Filter-ExternalJoin-SelectedValue-SelectedValues-Entry] -->
+	<tr><td><button onclick="_Pict.views['{~D:Context[0].Hash~}'].handleRemove(event, {~DVBK:Record.Data:Record.Payload.ExternalFilterTableLookupColumn~}, '{~D:Record.Payload.ClauseAddress~}', '{~D:Record.Payload.Hash~}')">Remove</button></td><td>{~TFA:Record.Payload.ExternalRecordDisplayTemplate:Record~}</td></tr>
+	<!-- DefaultPackage end view template:	[PRSP-Filter-ExternalJoin-SelectedValue-SelectedValues-Entry] -->
+`
+		}
+	],
+};
+
+class ViewRecordSetSUBSETFilterExternalJoinSelectedValue extends ViewRecordSetSUBSETFilterBase
+{
+	constructor(pFable, pOptions, pServiceHash)
+	{
+		if (!pOptions.PageSize)
+		{
+			pOptions.PageSize = 15; // default page size for search results
+		}
+		super(pFable, pOptions, pServiceHash);
+		/*
+		 * show / hide the complex editor since it'll be large ?
+		 * selected record lookup values
+		 * using bundle to load those records (if any)
+		 * templating out the selection
+		 * templating out the search results
+		 * controls to add search result values to selection
+		 */
+	}
+
+	/**
+	 * @param {Record<string, any>} pRecord
+	 */
+	prepareRecord(pRecord)
+	{
+		super.prepareRecord(pRecord);
+
+		pRecord.ClauseDescriptor.DataType = 'Number';
+		if (!pRecord.ExternalFilterTableLookupColumn)
+		{
+			pRecord.ExternalFilterTableLookupColumn = `ID${pRecord.ExternalFilterByTable}`;
+		}
+		if (!pRecord.SearchResults)
+		{
+			pRecord.SearchResults = [];
+		}
+		if (!pRecord.SelectedValues)
+		{
+			pRecord.SelectedValues = [];
+		}
+	}
+
+	getFilterFormTemplate()
+	{
+		return 'PRSP-Filter-ExternalJoin-SelectedValue-Template';
+	}
+
+	/**
+	 * @param {UIEvent} pEvent
+	 * @param {string} pClauseInformaryAddress
+	 * @param {string} pClauseHash
+	 */
+	loadMore(pEvent, pClauseInformaryAddress, pClauseHash, pCurrentOffset = 0)
+	{
+		this.performSearch(pEvent, pClauseInformaryAddress, pClauseHash, pCurrentOffset + this.options.PageSize);
+	}
+
+	/**
+	 * @param {UIEvent} pEvent
+	 * @param {string} pClauseInformaryAddress
+	 * @param {string} pClauseHash
+	 * @param {number} [pOffset=0] - The offset for the search results, defaults to 0
+	 */
+	performSearch(pEvent, pClauseInformaryAddress, pClauseHash, pOffset = 0)
+	{
+		pEvent.preventDefault();
+		const tmpClause = this.getInformaryScopedValue(pClauseInformaryAddress);
+		if (!tmpClause)
+		{
+			this.pict.log.error(`[Filter-ExternalJoinSelectedValue]  No clause found for address: ${pClauseInformaryAddress}`);
+			return;
+		}
+		tmpClause.SearchResultsOffset = pOffset;
+		// get the input value (search box)
+		const tmpSearchInputValue = pOffset > 0 ? tmpClause.SearchInputValue : this.pict.ContentAssignment.readContent(`#PRSP_Filter_${tmpClause.Hash}_Search_Value`);
+		tmpClause.SearchInputValue = tmpSearchInputValue;
+		if (!tmpSearchInputValue)
+		{
+			tmpClause.SearchResults = [];
+			tmpClause.LoadMoreEnabled = false;
+			const tmpRecord = Object.assign({ ClauseAddress: pClauseInformaryAddress }, tmpClause);
+			this.prepareRecord(tmpRecord);
+			const tmpDestinationAddress = `#PRSP_Filter_Container_${pClauseHash}`;
+			this.render(null, tmpDestinationAddress, tmpRecord);
+			return;
+		}
+		const tmpFilterByColumns = tmpClause.ExternalFilterByColumns || (tmpClause.ExternalFilterByColumn ? [ tmpClause.ExternalFilterByColumn ] : [ 'Name' ]);
+		const tmpMeadowFilter = tmpFilterByColumns.map((pColumn) => `FBVOR~${pColumn}~LK~${encodeURIComponent(`%${tmpSearchInputValue}%`)}`).join('~');
+		// bundle load the remote records and put them in the clause
+		this.pict.EntityProvider.gatherDataFromServer(
+			[
+				{
+					Entity: tmpClause.ExternalFilterByTable,
+					Filter: tmpMeadowFilter,
+					Destination: pOffset > 0 ? `${this.getInformaryAddressPrefix()}${pClauseInformaryAddress}.SearchResultsAppend` : `${this.getInformaryAddressPrefix()}${pClauseInformaryAddress}.SearchResults`,
+					RecordStartCursor: pOffset,
+					PageSize: this.options.PageSize,
+				}
+			],
+			(pError, pResult) =>
+			{
+				if (pOffset > 0 && tmpClause.SearchResultsAppend?.length > 0)
+				{
+					tmpClause.SearchResults = tmpClause.SearchResults.concat(tmpClause.SearchResultsAppend);
+				}
+				delete tmpClause.SearchResultsAppend;
+				tmpClause.SearchResultsOffset = pOffset;
+				const tmpRecord = Object.assign({ ClauseAddress: pClauseInformaryAddress }, tmpClause);
+				this.prepareRecord(tmpRecord);
+				const tmpDestinationAddress = `#PRSP_Filter_Container_${pClauseHash}`;
+				this.render(null, tmpDestinationAddress, tmpRecord);
+				const tmpLoadedRecords = pOffset > 0 ? tmpClause.SearchResultsAppend : tmpClause.SearchResults;
+				const tmpLoadMoreEnabled = tmpLoadedRecords && tmpLoadedRecords.length >= this.options.PageSize;
+				tmpClause.LoadMoreEnabled = tmpLoadMoreEnabled;
+				if (tmpClause.LoadMoreEnabled)
+				{
+					this.pict.ContentAssignment.removeClass(`#PRSP_Filter_${tmpClause.Hash}_Button_LoadMore`, 'is-hidden');
+				}
+			});
+	}
+
+	handleSelect(pEvent, pRecordLookupValue, pClauseInformaryAddress, pClauseHash)
+	{
+		pEvent.preventDefault();
+		const tmpClause = this.getInformaryScopedValue(pClauseInformaryAddress);
+		if (!tmpClause)
+		{
+			this.pict.log.error(`[Filter-ExternalJoinSelectedValue]  No clause found for address: ${pClauseInformaryAddress}`);
+			return;
+		}
+		const tmpRecordLookupColumn = tmpClause.ExternalFilterTableLookupColumn || `ID${tmpClause.ExternalFilterByTable}`;
+		const tmpRecordToSelect = tmpClause.SearchResults.find((r) => r[tmpRecordLookupColumn] == pRecordLookupValue);
+		if (!tmpRecordToSelect)
+		{
+			this.pict.log.error(`[Filter-ExternalJoinSelectedValue]  No record found to add for value: ${pRecordLookupValue}`);
+			return;
+		}
+		if (!tmpClause.SelectedValues)
+		{
+			tmpClause.SelectedValues = [];
+		}
+		if (tmpClause.SelectedValues.some((pSV) => pSV[tmpRecordLookupColumn] == pRecordLookupValue))
+		{
+			return;
+		}
+		const tmpValue = tmpRecordToSelect[tmpRecordLookupColumn];
+		if (tmpValue == null)
+		{
+			this.pict.log.error(`[Filter-ExternalJoinSelectedValue]  No value found in record to add: ${JSON.stringify(tmpRecordToSelect)}`);
+			return;
+		}
+		tmpClause.SelectedValues = [ tmpRecordToSelect ];
+		tmpClause.Values = [ tmpValue ];
+		const tmpRecord = Object.assign({ ClauseAddress: pClauseInformaryAddress }, tmpClause);
+		this.prepareRecord(tmpRecord);
+		const tmpDestinationAddress = `#PRSP_Filter_Container_${pClauseHash}`;
+		this.render(null, tmpDestinationAddress, tmpRecord);
+		if (tmpClause.LoadMoreEnabled)
+		{
+			this.pict.ContentAssignment.removeClass(`#PRSP_Filter_${tmpClause.Hash}_Button_LoadMore`, 'is-hidden');
+		}
+	}
+
+	handleRemove(pEvent, pRecordLookupValue, pClauseInformaryAddress, pClauseHash)
+	{
+		pEvent.preventDefault();
+		const tmpClause = this.getInformaryScopedValue(pClauseInformaryAddress);
+		if (!tmpClause)
+		{
+			this.pict.log.error(`[Filter-ExternalJoinSelectedValue]  No clause found for address: ${pClauseInformaryAddress}`);
+			return;
+		}
+		const tmpRecordLookupColumn = tmpClause.ExternalFilterTableLookupColumn || `ID${tmpClause.ExternalFilterByTable}`;
+		const tmpRecordIndexToRemove = tmpClause.SelectedValues.findIndex((r) => r[tmpRecordLookupColumn] == pRecordLookupValue);
+		if (tmpRecordIndexToRemove < 0)
+		{
+			this.pict.log.error(`[Filter-ExternalJoinSelectedValue]  No record found to remove for value: ${pRecordLookupValue}`);
+			return;
+		}
+		const tmpRecordToRemove = tmpClause.SelectedValues.splice(tmpRecordIndexToRemove, 1)[0];
+		const tmpValue = tmpRecordToRemove[tmpRecordLookupColumn];
+		tmpClause.Values = tmpClause.Values.filter((pV) => pV !== tmpValue);
+		const tmpRecord = Object.assign({ ClauseAddress: pClauseInformaryAddress }, tmpClause);
+		this.prepareRecord(tmpRecord);
+		const tmpDestinationAddress = `#PRSP_Filter_Container_${pClauseHash}`;
+		this.render(null, tmpDestinationAddress, tmpRecord);
+		if (tmpClause.LoadMoreEnabled)
+		{
+			this.pict.ContentAssignment.removeClass(`#PRSP_Filter_${tmpClause.Hash}_Button_LoadMore`, 'is-hidden');
+		}
+	}
+}
+
+module.exports = ViewRecordSetSUBSETFilterExternalJoinSelectedValue;
+
+module.exports.default_configuration = Object.assign({}, ViewRecordSetSUBSETFilterExternalJoinSelectedValue.default_configuration, _DEFAULT_CONFIGURATION_Filter_ExternalJoin_SelectedValue);