Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Postcloak
 
Table of Contents

Endpoint URIs

URLMETHODInputOutput
http://yourAieHost:17000/rest/ingestApi/getSessionCountGET/POST Number of session registered with the system
http://yourAieHost:17000/rest/ingestApi/getSessionIdsGET/POST A JSON array consisting of the registered session IDs
http://yourAieHost:17000/rest/ingestApi/connectGET/POSTSessionConfig object or null for default session configurationJSON string session ID to be used with all future methods in place of /{sessionId}
http://yourAieHost:17000/rest/ingestApi/disconnect/{sessionId}GET/POST Disconnect a client.
http://yourAieHost:17000/rest/ingestApi/isCompleted/{sessionId}GET/POST Returns true if all sent in documents and messages have completed processing
http://yourAieHost:17000/rest/ingestApi/commit/{sessionId}GET/POST Commit all changes to the index and make all recently fed documents searchable
http://yourAieHost:17000/rest/ingestApi/optimize/{sessionId}GET/POST Optimize the index.
http://yourAieHost:17000/rest/ingestApi/refresh/{sessionId}GET/POST Make any real time field changes visible in search results
http://yourAieHost:17000/rest/ingestApi/delete/{sessionId}POSTList of document id'sHTTP 200
http://yourAieHost:17000/rest/ingestApi/feedDocuments/{sessionId}POSTList of documentsHTTP 200  
http://yourAieHost:17000/rest/ingestApi/feedPrincipals/{sessionId}POSTList of principalsHTTP 200  
http://yourAieHost:17000/rest/ingestApi/deletePrincipals/{sessionId}POSTList of principalsHTTP 200  
http://yourAieHost:17000/rest/ingestApi/getDocumentsSent/{sessionId}GET/POST The number of documents sent to this session
http://yourAieHost:17000/rest/ingestApi/getDocumentsFed/{sessionId}GET/POST The number of documents fed to AIE from this session
http://yourAieHost:17000/rest/ingestApi/sendQueuedDocuments/{sessionId}GET/POST Send the documents in the queue
http://yourAieHost:17000/rest/ingestApi/getDocumentsQueued/{sessionId}GET/POST The number of documents that have been sent but not yet fed to AIE. 
http://yourAieHost:17000/rest/ingestApi/startMessageGroup/{sessionId}GET/POST HTTP 200  
http://yourAieHost:17000/rest/ingestApi/endMessageGroup/{sessionId}GET/POST HTTP 200  
http://yourAieHost:17000/rest/ingestApi/deleteByQuery/{sessionId}POSTDelete by queryHTTP 200  
http://yourAieHost:17000/rest/ingestApi/updateRealTimeField/{sessionId}POSTReal time field update

HTTP 200  

http://yourAieHost:17000/rest/ingestApi/bulkUpdateByIds/{sessionId}POSTBulk update by Id

HTTP 200  

http://yourAieHost:17000/rest/ingestApi/bulkUpdateByQuery/{sessionId}POSTBulk update by query

HTTP 200  

http://yourAieHost:17000/rest/ingestApi/getLastActivity/{sessionId}GET/POST The Date that the session was last used

JSON Document List

Code Block
JavaScript
JavaScript
[ {
  "fields" : {
    "title" : [ "this is the first title" ],
    "date" : [ "1969-12-31T19:00:10.000-0500" ]
  },
  "id" : "1",
  "zone" : "z1",
  "correlationId" : null,
  "mode" : "ADD",
  "permissions" : [ {
    "principal" : {
      "name" : "myGroup1",
      "realm" : "myRealm",
      "groupMemberships" : null,
      "type" : "group"
    },
    "readable" : true
  } ]
}, {
  "fields" : {
    "title" : [ "this is the second title" ],
    "date" : [ "1969-12-31T19:00:20.000-0500" ]
  },
  "id" : "2",
  "zone" : null,
  "correlationId" : "c2",
  "mode" : "ADD",
  "permissions" : [ {
    "principal" : {
      "name" : "Anonymous",
      "realm" : "Anonymous",
      "type" : "user"
    },
    "readable" : true
  } ]
} ]
 


ParameterRequiredDefaultDescription
id(tick) Document ID
zone defaultZone for the document to be indexed in.
correlationId  CorrelationId used for matching up document results if the document ID changes
mode ADDMode to use for processing this document. One of: CREATE, ADD, DELETE, PARTIAL. ADD implies a create or replace where as CREATE requires the user to ensure that no document with the same ID already exists.
fields(tick) Name to List of values for the field. Strings, Dates, and number types are supported.
permissions  A list of permissions for the document if content security is enabled
permissions.principal  The user or group who has permission to read the document
permissions.principal.name(tick) The id of the user who has access to the document
permissions.principal.realm(tick) The realm of the user
permissions.principal.type userone of user or group
permissions.principal.readable trueThe document will be readable by the user if set to true. By default all documents without explicit read permissions are hidden from the user. Setting readble=false is only necessary to implement deny permissions. For example, a document might be readbale by everyone in Engineering except some specific user or sub group.

JSON SessionConfig

 

Code Block
{
  "sessionTimeout" : -1,
  "documentBatchSize" : 1,
  "orderedCommits" : true,
  "commitInterval" : 1000,
  "commitOnDisconnect": true,
  "ingestWorkflowName" : "fileIngest",
  "messageResultListenerClass" : "com.acme.myListener",
  "messageResultListenerProperties" : {
    "foo" : "bar"
  }
}


ParameterRequiredDefaultDescription
sessionTimeout 10 minutesNumber of milliseconds between any two posts that will cause the session to be automatically closed. A value of -1 will cause the session to never expire. Any call using a sessionId will cause the session timer to be reset.
documentBatchSize
 1The number of documents to send to AIE in a single batch.
orderedCommits
 trueOrdered commits will cause the system to wait for all previously fed content to be indexed before processing the commit.
commitInterval
 0Issue a commit every x number of documents submitted. Se to 0 to disable autmatic commits.
commitOnDisconnect
true(Added in Attivio Platform 5.6.2) Issue a commit when calling disconnect for this session
ingestWorkflowName
 ingestThe workflow to use for all ingestion documents and messages
messageResultListenerClass
 System default - LoggingResultListenerThe class to use for processing message results.
messageResultListenerProperties
  Key to Value map of properties for the custom message result listener class to use for configuration.

JSON Principal

Code Block
JavaScript
JavaScript
{
  "name" : "myUsername",
  "id" : "myId", 
  "realm" : "myRealm",
  "type" : "user",
  "groupMemberships" : [ {
    "name" : "myGroup1",
    "realm" : "myRealm"
  }, {
    "name" : "myGroup2",
    "realm" : "myRealm"
  } ]
}
{
  "name" : "myOtherUsername",
  "realm" : "myOtherRealm",
  "type" : "user"
}
{
  "name" : "myAlias",
  "realm" : "aliases",
  "type" : "group",
  "principalAliases" : [ {
    "name" : "myUsername",
	"id" : "myId",
    "realm" : "myRealm"
  }, {
    "name" : "myOtherUsername",
    "realm" : "myOtherRealm"
  } ]
}


ParameterRequiredDefaultDescription
name(tick) Name of the user/group
realm(tick) Realm of the user/group
id value of 'name' parameterId of user/group
type userOne of user or group
groupMemberships  The groups that the user/group is a member of
groupMemberships.name(tick) The group name
groupMemberships.realm(tick) The group realm
groupMemberships.id value of 'groupMemberships.name' parameterThe group id
principalAliases  The principals to be included in the alias
principalAliases.name(tick) The principal name
principalAliases.realm(tick) The principal realm
principalAliases.id value of 'principalAliases.name' parameterThe principal id

JSON Real Time Field Update

Code Block
JavaScript
JavaScript
{
  "id" : "doc1",
  "zone" : "zone1",
  "fieldName" : "field1",
  "values" : [ "val1", "val2" ]
}


ParameterRequiredDefaultRequired
id(tick) The ID of the document to update
zone defaultThe zone the document is in
fieldName(tick) The name of the real time field to update
values
(tick) The new values for the field. Set to null to clear the real time field.

JSON Delete By Query

Code Block
JavaScript
JavaScript
{
  "query" : "title:foo",
  "queryLanguage" : "advanced",
  "queryInitWorkflow" : "queryInit"
}


ParameterRequiredDefaultRequired
query(tick) The query to use for matchign documents to delete.
querylanguage advanced

The query language to use for parsing the query. One of simple or advanced

queryInitWorkflow queryInitThe name of the workflow to proces the query with before sending to the ingestion workflow. Genreally speaking this workflow is responsible for query parsing.

JSON Bulk Update By IDs

Code Block
JavaScript
JavaScript
{
  "fields" : {
    "myRealTimeField" : [ "val1", "val2" ]
  },
  "documentIds" : [ "doc1", "doc2" ]
}


ParameterRequiredDefaultRequired
fields(tick) Name to List of values for the field. Strings, Dates, and number types are supported.
documentIds(tick) 

List of document ids to update with the new field values.

JSON Bulk Update by Query

Code Block
JavaScript
JavaScript
{
  "fields" : {
    "myRealTimeField" : [ "val1", "val2" ]
  },
  "query" : "title:foo",
  "queryLanguage" : "advanced",
  "queryInitWorkflow" : "queryInit"
}


ParameterRequiredDefaultRequired
fields(tick) Name to List of values for the field. Strings, Dates, and number types are supported.
query(tick) The query to use for matchign documents to delete.
querylanguage advanced

The query language to use for parsing the query. One of simple or advanced

queryInitWorkflow queryInitThe name of the workflow to proces the query with before sending to the ingestion workflow. Genreally speaking this workflow is responsible for query parsing.