/AWS1/CL_KNDDOCUMENT¶
A document in an index.
CONSTRUCTOR¶
IMPORTING¶
Required arguments:¶
iv_id TYPE /AWS1/KNDDOCUMENTID /AWS1/KNDDOCUMENTID¶
A identifier of the document in the index.
Note, each document ID must be unique per index. You cannot create a data source to index your documents with their unique IDs and then use the
BatchPutDocumentAPI to index the same documents, or vice versa. You can delete a data source and then use theBatchPutDocumentAPI to index the same documents, or vice versa.
Optional arguments:¶
iv_title TYPE /AWS1/KNDTITLE /AWS1/KNDTITLE¶
The title of the document.
iv_blob TYPE /AWS1/KNDBLOB /AWS1/KNDBLOB¶
The contents of the document.
Documents passed to the
Blobparameter must be base64 encoded. Your code might not need to encode the document file bytes if you're using an Amazon Web Services SDK to call Amazon Kendra APIs. If you are calling the Amazon Kendra endpoint directly using REST, you must base64 encode the contents before sending.
io_s3path TYPE REF TO /AWS1/CL_KNDS3PATH /AWS1/CL_KNDS3PATH¶
S3Path
it_attributes TYPE /AWS1/CL_KNDDOCUMENTATTRIBUTE=>TT_DOCUMENTATTRIBUTELIST TT_DOCUMENTATTRIBUTELIST¶
Custom attributes to apply to the document. Use the custom attributes to provide additional information for searching, to provide facets for refining searches, and to provide additional information in the query response.
For example, 'DataSourceId' and 'DataSourceSyncJobId' are custom attributes that provide information on the synchronization of documents running on a data source. Note, 'DataSourceSyncJobId' could be an optional custom attribute as Amazon Kendra will use the ID of a running sync job.
it_accesscontrollist TYPE /AWS1/CL_KNDPRINCIPAL=>TT_PRINCIPALLIST TT_PRINCIPALLIST¶
Information on principals (users and/or groups) and which documents they should have access to. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents.
it_hierarchicalaccessctllist TYPE /AWS1/CL_KNDHIERARCHICALPRINC=>TT_HIERARCHICALPRINCIPALLIST TT_HIERARCHICALPRINCIPALLIST¶
The list of principal lists that define the hierarchy for which documents users should have access to.
iv_contenttype TYPE /AWS1/KNDCONTENTTYPE /AWS1/KNDCONTENTTYPE¶
The file type of the document in the
Blobfield.If you want to index snippets or subsets of HTML documents instead of the entirety of the HTML documents, you must add the
HTMLstart and closing tags (content) around the content.
iv_accesscontrolconfid TYPE /AWS1/KNDACCESSCONTROLCONFID /AWS1/KNDACCESSCONTROLCONFID¶
The identifier of the access control configuration that you want to apply to the document.
Queryable Attributes¶
Id¶
A identifier of the document in the index.
Note, each document ID must be unique per index. You cannot create a data source to index your documents with their unique IDs and then use the
BatchPutDocumentAPI to index the same documents, or vice versa. You can delete a data source and then use theBatchPutDocumentAPI to index the same documents, or vice versa.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ID() |
Getter for ID, with configurable default |
ASK_ID() |
Getter for ID w/ exceptions if field has no value |
HAS_ID() |
Determine if ID has a value |
Title¶
The title of the document.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_TITLE() |
Getter for TITLE, with configurable default |
ASK_TITLE() |
Getter for TITLE w/ exceptions if field has no value |
HAS_TITLE() |
Determine if TITLE has a value |
Blob¶
The contents of the document.
Documents passed to the
Blobparameter must be base64 encoded. Your code might not need to encode the document file bytes if you're using an Amazon Web Services SDK to call Amazon Kendra APIs. If you are calling the Amazon Kendra endpoint directly using REST, you must base64 encode the contents before sending.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_BLOB() |
Getter for BLOB, with configurable default |
ASK_BLOB() |
Getter for BLOB w/ exceptions if field has no value |
HAS_BLOB() |
Determine if BLOB has a value |
S3Path¶
S3Path
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_S3PATH() |
Getter for S3PATH |
Attributes¶
Custom attributes to apply to the document. Use the custom attributes to provide additional information for searching, to provide facets for refining searches, and to provide additional information in the query response.
For example, 'DataSourceId' and 'DataSourceSyncJobId' are custom attributes that provide information on the synchronization of documents running on a data source. Note, 'DataSourceSyncJobId' could be an optional custom attribute as Amazon Kendra will use the ID of a running sync job.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ATTRIBUTES() |
Getter for ATTRIBUTES, with configurable default |
ASK_ATTRIBUTES() |
Getter for ATTRIBUTES w/ exceptions if field has no value |
HAS_ATTRIBUTES() |
Determine if ATTRIBUTES has a value |
AccessControlList¶
Information on principals (users and/or groups) and which documents they should have access to. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ACCESSCONTROLLIST() |
Getter for ACCESSCONTROLLIST, with configurable default |
ASK_ACCESSCONTROLLIST() |
Getter for ACCESSCONTROLLIST w/ exceptions if field has no v |
HAS_ACCESSCONTROLLIST() |
Determine if ACCESSCONTROLLIST has a value |
HierarchicalAccessControlList¶
The list of principal lists that define the hierarchy for which documents users should have access to.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_HIERARCHICALACCCTLLIST() |
Getter for HIERARCHICALACCESSCTLLIST, with configurable defa |
ASK_HIERARCHICALACCCTLLIST() |
Getter for HIERARCHICALACCESSCTLLIST w/ exceptions if field |
HAS_HIERARCHICALACCCTLLIST() |
Determine if HIERARCHICALACCESSCTLLIST has a value |
ContentType¶
The file type of the document in the
Blobfield.If you want to index snippets or subsets of HTML documents instead of the entirety of the HTML documents, you must add the
HTMLstart and closing tags (content) around the content.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_CONTENTTYPE() |
Getter for CONTENTTYPE, with configurable default |
ASK_CONTENTTYPE() |
Getter for CONTENTTYPE w/ exceptions if field has no value |
HAS_CONTENTTYPE() |
Determine if CONTENTTYPE has a value |
AccessControlConfigurationId¶
The identifier of the access control configuration that you want to apply to the document.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ACCESSCONTROLCONFID() |
Getter for ACCESSCONTROLCONFIGURATIONID, with configurable d |
ASK_ACCESSCONTROLCONFID() |
Getter for ACCESSCONTROLCONFIGURATIONID w/ exceptions if fie |
HAS_ACCESSCONTROLCONFID() |
Determine if ACCESSCONTROLCONFIGURATIONID has a value |
Public Local Types In This Class¶
Internal table types, representing arrays and maps of this class, are defined as local types:
TT_DOCUMENTLIST¶
TYPES TT_DOCUMENTLIST TYPE STANDARD TABLE OF REF TO /AWS1/CL_KNDDOCUMENT WITH DEFAULT KEY
.