M-Files API 22.6.11519.0
SearchForValueListItemsEx2 Method
VaultValueListItemOperations Object : SearchForValueListItemsEx2 Method
The value list the items of which to search for.
The search conditions to be used.
If this is set to "true", the search operation is always carried out on the server-side.
Specifies how, if at all, external value lists are updated for this operation.
When using M-Files API in the client mode, the "ReplaceCurrentUserWithCallersIdentity" parameter must always be set to true.
Specifies the property definition the filter of which should be applied to the list (-1 for none).

The maximum number of results to return. By default, no more than 5,000 results are allowed. You can, however, allow more results vault-specifically by changing the value of the Value List Item Count Limit setting via the advanced vault settings:

  1. Open M-Files Admin.
  2. Select a server and a document vault that you want the setting to affect via the left-side tree view.
  3. Select the Configurations node.
  4. Expand Advanced Vault Settings and then select Configuration.
  5. Expand the Search > Limits section and locate the Value List Item Count Limit settings.
  6. Set the value to something larger than the default value of 5000.

Note, however, that setting this parameter value to 0 or 5000 causes the value specified in the above-mentioned setting to be used. If the setting has not been modified when the parameter value is 0 or 5000, the maximum is the default 5,000 results.

The default limit for traditional folders is a maximum of 100,000 results. In other words, if the value is set to 0 or 5000 and the advanced vault setting has not been modified, a maximum of 100,000 traditional folders are returned.
Description
Searches for value list items in the specified value list
Syntax
Visual Basic
Public Function SearchForValueListItemsEx2( _
   ByVal ValueList As Long, _
   ByVal SearchConditions As SearchConditions, _
   Optional ByVal UpdateFromServer As Boolean = False, _
   Optional ByVal RefreshTypeIfExternalValueList As MFExternalDBRefreshType = MFExternalDBRefreshTypeNone, _
   Optional ByVal ReplaceCurrentUserWithCallersIdentity As Boolean = True, _
   Optional ByVal PropertyDef As Long = -1, _
   Optional ByVal MaxResults As Long = 5000 _
) As ValueListItemSearchResults
Parameters
ValueList
The value list the items of which to search for.
SearchConditions
The search conditions to be used.
UpdateFromServer
If this is set to "true", the search operation is always carried out on the server-side.
RefreshTypeIfExternalValueList
ValueDescription
MFExternalDBRefreshTypeFullThe full refresh updates all the changes. This operation can take several minutes.
MFExternalDBRefreshTypeNoneNo refresh is performed.
MFExternalDBRefreshTypeQuickThe quick refresh searches for new items and imports them to M-Files.
Specifies how, if at all, external value lists are updated for this operation.
ReplaceCurrentUserWithCallersIdentity
When using M-Files API in the client mode, the "ReplaceCurrentUserWithCallersIdentity" parameter must always be set to true.
PropertyDef
Specifies the property definition the filter of which should be applied to the list (-1 for none).
MaxResults

The maximum number of results to return. By default, no more than 5,000 results are allowed. You can, however, allow more results vault-specifically by changing the value of the Value List Item Count Limit setting via the advanced vault settings:

  1. Open M-Files Admin.
  2. Select a server and a document vault that you want the setting to affect via the left-side tree view.
  3. Select the Configurations node.
  4. Expand Advanced Vault Settings and then select Configuration.
  5. Expand the Search > Limits section and locate the Value List Item Count Limit settings.
  6. Set the value to something larger than the default value of 5000.

Note, however, that setting this parameter value to 0 or 5000 causes the value specified in the above-mentioned setting to be used. If the setting has not been modified when the parameter value is 0 or 5000, the maximum is the default 5,000 results.

The default limit for traditional folders is a maximum of 100,000 results. In other words, if the value is set to 0 or 5000 and the advanced vault setting has not been modified, a maximum of 100,000 traditional folders are returned.
See Also

VaultValueListItemOperations Object  | VaultValueListItemOperations Members