Sökmodell

En fråga måste innehålla minst en källa: Query, RawQuery, ImageUrl, ImageBase64, SimilarImageId eller SimilarMetadataId.

Textlägen

Läge	Upstream-parameter	Användning
`Lexical`	`q`	Vanlig ord- och frassökning
`SemanticMetadata`	`metadata_q`	Semantisk sökning i metadata
`SemanticImageContent`	`image_content_q`	Text mot bildinnehåll

Strukturerade filter

Varje SearchTerm blir ett separat fq. Terms använder parenteser, Phrase använder citattecken och MustNot lägger till ett inledande minus. Solr-specialtecken escapes endast här.

var request = new SearchRequest
{
    Query = "Uppsala slott",
    Terms =
    [
        new SearchTerm
        {
            Field = SearchField.EventPlace,
            Value = "Uppsala: centrum?",
            Match = MatchMode.Phrase
        }
    ],
    CollectionIds = ["S-UM"],
    ArtifactTypes = [ArtifactType.Photograph],
    HasPictures = true,
    YearFrom = 1900,
    YearTo = 1950,
    Facets = [FacetField.Collection, FacetField.Type],
    ReturnFields = [StoredField.UniqueId, StoredField.Title]
};

Fält omfattar identitet, samling, typ, namn, titel, klassifikation, producent, avbildad person/plats, material, teknik, licens, händelser, år, mappar, utställningar och allContent. Objekttyperna är Thing, Photograph, Architecture, Artdesign, Building, Exhibition, ExternalArticle, Fineart, Folder, Name och Person.

Rå Solr

RawQuery skickas oförändrad som q och har företräde framför Query. Varje värde i RawFilterQueries skickas oförändrat som ett separat fq. Rå syntax är avsiktligt inte escaped eller validerad som Solr; använd den bara när den strukturerade modellen inte räcker.

Gränser

Limit: 1–20; Offset: minst 0.
Högst 50 termer, råfilter och samlings-ID:n.
Samlings-ID: 1–100 tecken.
År: -9999–9999 och YearFrom <= YearTo.
ImageUrl måste vara en absolut HTTP(S)-URL.

ToParameters() ger en ordnad parameterlista och är användbar för felsökning utan nätverksanrop.

Alla egenskaper

Egenskap	Betydelse
`Query`	Fri text för valt sökläge.
`Mode`	Lexikal, semantisk metadata eller semantiskt bildinnehåll.
`RawQuery`	Oförändrad Solr-`q`; ersätter `Query`.
`Terms`	Strukturerade, escapade fältfilter.
`RawFilterQueries`	Oförändrade, upprepade Solr-`fq`.
`CollectionIds`	Museer/samlingar som OR-kombineras.
`ArtifactTypes`	Tillåtna objekttyper.
`HasPictures`	Kräv eller uteslut poster med bilder.
`YearFrom`, `YearTo`	Händelseintervall som överlappar årtalen.
`ImageUrl`	Publik HTTP(S)-bild som `image_url_q`.
`ImageBase64`	Base64-bild som `image_q`.
`SimilarImageId`	UUID för bildlikhet.
`SimilarMetadataId`	UUID för metadatalikhet.
`Offset`, `Limit`	Startposition och sidstorlek.
`Sort`	Relevans, senast publicerad eller senast uppdaterad.
`Facets`	Upprepade grupperingsfält.
`ReturnFields`	Kommaseparerade lagrade svarsfält.

Sökfält

`SearchField`	DigitaltMuseum-fält
`IdentifierId`	`identifier.id`
`IdentifierOwner`	`identifier.owner`
`UniqueId`	`artifact.uniqueId`
`Type`	`artifact.type`
`PictureCount`	`artifact.pictureCount`
`HasPictures`	`artifact.hasPictures`
`PublishedDate`	`artifact.publishedDate`
`UpdatedDate`	`artifact.updatedDate`
`Name`	`artifact.name`
`Title`	`artifact.title`
`Classification`	`artifact.classification`
`Producer`	`artifact.producer`
`DepictedPerson`	`artifact.depictedPerson`
`DepictedPlace`	`artifact.depictedPlace`
`Material`	`artifact.material`
`Technique`	`artifact.technique`
`License`	`artifact.license`
`EventDescription`	`artifact.eventDescription`
`EventFromYear`	`artifact.event.fromYear`
`EventToYear`	`artifact.event.toYear`
`EventPlace`	`artifact.event.place`
`FolderUids`	`artifact.folderUids`
`ExhibitionUids`	`artifact.exhibitionUids`
`AllContent`	`allContent`

Objekttyper, facetter och sortering

Objekttyper: Thing, Photograph, Architecture, Artdesign, Building, Exhibition, ExternalArticle, Fineart, Folder, Name och Person.

Facetter kan vara identifier.owner, artifact.type, artifact.ingress.license och artifact.ingress.subjects. SortOrder.Relevance lämnar upstreams relevansordning orörd; Published skickar artifact.publishedDate desc och Updated skickar artifact.updatedDate desc.

Lagrade svarsfält

ReturnFields stöder identifier.id, identifier.owner, artifact.uniqueId, artifact.type, artifact.pictureCount, artifact.hasPictures, artifact.defaultMediaIdentifier, artifact.publishedDate, artifact.updatedDate, artifact.ingress.title, artifact.ingress.producer, artifact.ingress.producerRole, artifact.ingress.additionalProducers, artifact.ingress.production.fromYear, artifact.ingress.production.toYear, artifact.ingress.production.place, artifact.ingress.classification, artifact.ingress.subjects, artifact.ingress.license och artifact.coordinate.

Bild- och likhetssökning

De fyra dokumenterade ingångarna kan användas var för sig eller tillsammans med filter: bild-URL (ImageUrl), base64 (ImageBase64), liknande bild (SimilarImageId) och liknande metadata (SimilarMetadataId). Biblioteket avkodar inte base64-innehållet och hämtar inte URL:en; värdet skickas till DigitaltMuseum efter vanlig validering.