}

    /**
     * Gets the search role for a given user.
     *
     * @param name The username.
     * @return The search role.
     */
    public String getSearchRoleByUser(final String name) {
        return createSearchRole(ComponentUtil.getFessConfig().getRoleSearchUserPrefix(), name);
    }

    /**
     * Gets the search role for a given group.
     *
     * @param name The group name.

     * @return array of file protocol strings with colon suffix (e.g., "file:", "ftp:")
     */
    public String[] getFileProtocols() {
        return fileProtocols;
    }

    /**
     * Checks if the given URL uses a valid web protocol.
     *
     * @param url the URL to validate
     * @return true if the URL starts with a supported web protocol, false otherwise
     */

        return new SearchLogContext(fessConfig, roles, userCode, userId, request, clientIp, virtualHostKey);
    }

    /**
     * Builds a SearchLog from the given parameters and context, then adds it to the queue.
     *
     * @param params The search request parameters.
     * @param requestedTime The time the search was requested.
     * @param queryId The ID of the search query.

            });
        } catch (final Exception e) {
            logger.warn("Failed to parse JSON.", e);
            return Map.of();
        }
    }

    /**
     * Gets a nested map value from the given map.
     *
     * @param map the source map.
     * @param key the key to look up.
     * @return the map value, or {@code null} if not found or not a map.
     */
    @SuppressWarnings("unchecked")

                logger.warn("Failed to encode similar document hash: hash={}", hash, e);
            }
        }
        return hash;
    }

    /**
     * Appends line numbers to each line of content with a given prefix.
     * Useful for debugging and displaying content with line references.
     *
     * @param prefix the prefix to add before each line number
     * @param content the content to add line numbers to

labels.backup_bulk_file=Bulk File
labels.backup_button_upload=Upload
labels.process_time_is_exceeded=The search processing time has exceeded the limit. The displayed results may be partial.
labels.user_given_name=Given Name
labels.givenName=Given Name
labels.user_surname=Surname
labels.surame=Surname
labels.user_mail=Mail
labels.mail=Mail
labels.user_employeeNumber=Employee Number
labels.employeeNumber=Employee Number

     */
    public IndexExportJob format(final String format) {
        this.formatter = createFormatter(format);
        return this;
    }

    /**
     * Creates a formatter for the given format name.
     *
     * @param format the format name
     * @return the formatter instance
     * @throws IllegalArgumentException if the format is null, empty, or not supported
     */

errors.failed_to_delete_doc_in_admin = Failed to delete a document.
errors.failed_to_send_testmail=Failed to send a test mail.
errors.invalid_query_unknown = The specified query has an unknown condition.
errors.invalid_query_parse_error = The given query is invalid.
errors.invalid_query_sort_value = The specified sort {0} is invalid.
errors.invalid_query_unsupported_sort_field = The specified sort {0} is unsupported.

errors.failed_to_delete_doc_in_admin = Failed to delete a document.
errors.failed_to_send_testmail=Failed to send a test mail.
errors.invalid_query_unknown = The specified query has an unknown condition.
errors.invalid_query_parse_error = The given query is invalid.
errors.invalid_query_sort_value = The specified sort {0} is invalid.
errors.invalid_query_unsupported_sort_field = The specified sort {0} is unsupported.

                buf.append(ip);
            }
        } catch (final Exception e) {
            // ignore
        }
        return buf.toString();
    }

    /**
     * Checks if the given filename is a log file based on its extension.
     *
     * @param name the filename to check
     * @return true if the file is a log file (.log or .log.gz), false otherwise
     */