- name: suggest
    description: Suggest operations
  - name: favorite
    description: Favorite operations
paths:
  /documents:
    get:
      tags:
        - search
      summary: Finds documents by query
      description: Finds documents by search conditions
      operationId: searchDocuments
      parameters:
        - name: q
          in: query
          description: Search words

 * as well as the alt and title attributes.
 * </p>
 * <p>
 * The class uses {@link DOMParser} to parse HTML documents and {@link XPathAPI} to execute XPath queries.
 * It also provides methods to add custom features and properties to the {@link DOMParser}.
 * </p>
 * <p>

labels.dict_stopwords_button_download=Scarica
labels.dict_stopwords_button_upload=Carica
labels.dict_stopwords_file=File stopwords
labels.boost_document_rule_configuration=Regola di boost documento
labels.boost_document_rule_title_details=Regola di boost documento
labels.boost_document_rule_list_url_expr=Condizione
labels.boost_document_rule_url_expr=Condizione
labels.boost_document_rule_boost_expr=Espressione di boost

        }
        return count;
    }

    /**
     * Deletes documents in an index matching a query.
     *
     * @param index        the index name
     * @param queryBuilder the query to match documents for deletion
     * @return the number of documents deleted
     */
    public long deleteByQuery(final String index, final QueryBuilder queryBuilder) {

{* ../../docs_src/response_directly/tutorial002.py hl[1,18] *}

## Notes

Lorsque vous renvoyez une `Response` directement, ses données ne sont pas validées, converties (sérialisées), ni documentées automatiquement.

Mais vous pouvez toujours les documenter comme décrit dans [Additional Responses in OpenAPI](additional-responses.md){.internal-link target=_blank}.

- [ ] Set up authentication and user roles

### Data Migration

- [ ] Export documents from current system
- [ ] Transform documents to Fess format
- [ ] Validate NDJSON format
- [ ] Import documents via Admin UI or API
- [ ] Verify document count after import
- [ ] Test search queries on migrated data
- [ ] Configure document boost/relevance (if needed)

### Search Integration

            });
            return extractData;
        } finally {
            xpathAPI.remove();
        }
    }

    /**
     * Extracts strings from a document using the specified XPath expression.
     *
     * @param document the DOM document to extract strings from
     * @param path the XPath expression to evaluate

            logger.debug("Total documents added: {}", documentSize.get());
        }

    }

    /**
     * Processes a document through the ingest pipeline.
     * Applies all available ingesters to transform the document data.
     *
     * @param paramMap the data store parameters
     * @param dataMap the document data to process
     * @return the processed document data
     */

    }

    /**
     * Clears all documents from the list and resets metrics.
     * Removes all documents and resets content size and processing time to zero.
     */
    @Override
    public void clear() {
        super.clear();
        contentSize = 0;
        processingTime = 0;
    }

    /**
     * Gets the total content size of all documents in this list.
     *
     * @return the total content size in bytes
     */

        }

        /**
         * Deletes old documents from the search index.
         * This method removes documents that were indexed in previous
         * crawling sessions for the same data configuration, keeping
         * only the documents from the current session.
         *
         * <p>The deletion process:</p>
         * <ul>
         *   <li>Checks if old document deletion is enabled</li>