Method Import

Namespace

LMKit.Retrieval

Assembly

LM-Kit.NET.dll

Import(Attachment, TextChunking, string, string, CancellationToken)

Imports content from a single Attachment into a DataSource by creating a new section.

public DataSource Import(Attachment attachment, TextChunking textChunking, string dataSourceIdentifier, string sectionIdentifier, CancellationToken cancellationToken = default)

Parameters

attachment Attachment

The attachment containing the content to import.

textChunking TextChunking

Specifies how to split the extracted text into chunks.

dataSourceIdentifier string

The unique identifier for the target DataSource. If a matching data source exists, the content is added as a new section; otherwise, a new data source is created.

sectionIdentifier string

The identifier for the new section created from the attachment's content.

cancellationToken CancellationToken

An optional cancellation token to cancel the operation.

Returns

DataSource

The DataSource containing the imported content.

Exceptions

ArgumentNullException

Thrown if attachment, dataSourceIdentifier, or sectionIdentifier is null or empty.

Import(Attachment, string, string, CancellationToken)

Imports content from a single Attachment into a DataSource by creating a new section.

public DataSource Import(Attachment attachment, string dataSourceIdentifier, string sectionIdentifier, CancellationToken cancellationToken = default)

Parameters

attachment Attachment

The attachment containing the content to import.

dataSourceIdentifier string

The unique identifier for the target DataSource. If a matching data source exists, the content is added as a new section; otherwise, a new data source is created.

sectionIdentifier string

The identifier for the new section created from the attachment's content.

cancellationToken CancellationToken

An optional cancellation token to cancel the operation.

Returns

DataSource

The DataSource containing the imported content.

Exceptions

ArgumentNullException

Thrown if attachment, dataSourceIdentifier, or sectionIdentifier is null or empty.

Import(Attachment, TextChunking, string, string, MetadataCollection, CancellationToken)

Imports content from a single Attachment into a DataSource by creating a new section and attaching additional metadata.

public DataSource Import(Attachment attachment, TextChunking textChunking, string dataSourceIdentifier, string sectionIdentifier, MetadataCollection additionalMetadata, CancellationToken cancellationToken = default)

Parameters

attachment Attachment

The attachment containing the content to import.

textChunking TextChunking

Specifies how to split the extracted text into chunks.

dataSourceIdentifier string

The unique identifier for the target DataSource. If a matching data source exists, the content is added as a new section; otherwise, a new data source is created.

sectionIdentifier string

The identifier for the new section created from the attachment's content.

additionalMetadata MetadataCollection

Additional metadata to associate with the imported section.

cancellationToken CancellationToken

An optional cancellation token to cancel the operation.

Returns

DataSource

The DataSource containing the imported content.

Import(Attachment, string, string, MetadataCollection, CancellationToken)

Imports content from a single Attachment into a DataSource by creating a new section and attaching additional metadata.

public DataSource Import(Attachment attachment, string dataSourceIdentifier, string sectionIdentifier, MetadataCollection additionalMetadata, CancellationToken cancellationToken = default)

Parameters

attachment Attachment

The attachment containing the content to import.

dataSourceIdentifier string

The unique identifier for the target DataSource. If a matching data source exists, the content is added as a new section; otherwise, a new data source is created.

sectionIdentifier string

The identifier for the new section created from the attachment's content.

additionalMetadata MetadataCollection

Additional metadata to associate with the imported section.

cancellationToken CancellationToken

An optional cancellation token to cancel the operation.

Returns

DataSource

The DataSource containing the imported content.

Import(IList<Attachment>, string, IList<string>, IList<MetadataCollection>, CancellationToken)

Imports content from multiple Attachment instances into a DataSource, creating a new section for each attachment.

public DataSource Import(IList<Attachment> attachments, string dataSourceIdentifier, IList<string> sectionIdentifiers, IList<MetadataCollection> metadataCollections = null, CancellationToken cancellationToken = default)

Parameters

attachments IList<Attachment>

A list of attachments containing the content to import.

dataSourceIdentifier string

The unique identifier for the target DataSource. If a matching data source exists, the content is added as new sections; otherwise, a new data source is created.

sectionIdentifiers IList<string>

A list of unique identifiers for the sections corresponding to each attachment. The number of identifiers must match the number of attachments.

metadataCollections IList<MetadataCollection>

An optional list of metadata collections to associate with each imported section. If provided, its count must match the number of attachments.

cancellationToken CancellationToken

An optional cancellation token to cancel the operation.

Returns

DataSource

The DataSource containing the imported content.

Exceptions

ArgumentNullException

Thrown if attachments, dataSourceIdentifier, or sectionIdentifiers is null or empty.

ArgumentOutOfRangeException

Thrown if the count of sectionIdentifiers (or metadataCollections, if provided) does not match the number of attachments.

Import(IList<Attachment>, TextChunking, string, IList<string>, IList<MetadataCollection>, CancellationToken)

Imports content from multiple Attachment instances into a DataSource, creating a new section for each attachment.

public DataSource Import(IList<Attachment> attachments, TextChunking textChunking, string dataSourceIdentifier, IList<string> sectionIdentifiers, IList<MetadataCollection> metadataCollections = null, CancellationToken cancellationToken = default)

Parameters

attachments IList<Attachment>

A list of attachments containing the content to import.

textChunking TextChunking

Specifies how to split the extracted text into chunks.

dataSourceIdentifier string

The unique identifier for the target DataSource. If a matching data source exists, the content is added as new sections; otherwise, a new data source is created.

sectionIdentifiers IList<string>

A list of unique identifiers for the sections corresponding to each attachment. The number of identifiers must match the number of attachments.

metadataCollections IList<MetadataCollection>

An optional list of metadata collections to associate with each imported section. If provided, its count must match the number of attachments.

cancellationToken CancellationToken

An optional cancellation token to cancel the operation.

Returns

DataSource

The DataSource containing the imported content.

Exceptions

ArgumentNullException

Thrown if attachments, dataSourceIdentifier, or sectionIdentifiers is null or empty.

ArgumentOutOfRangeException

Thrown if the count of sectionIdentifiers (or metadataCollections, if provided) does not match the number of attachments.