Xooa Blockchain Database (Preview)
Xooa makes it easy to use blockchain by eliminating common barriers. By gaining an enterprise blockchain platform, you can start leveraging the capabilities of blockchain almost instantly. The Xooa Ledger Database (XLDB) allows you to use blockchain like a simple database. Storing, retrieving, and querying entries without needing to write a smart contract. All you need is a Xooa account. This connector completes the picture by providing access to this database. The current state of a given entry is represented by the World State (a NoSQL database). Because blockchain is append only, the transactions that led to the current state of the entry are stored in the ledger. An entry must take the form of key-value pair where the key uniquely identifies the entry and value can take the form of a JSON object.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| [email protected] |
| Connector Metadata | |
|---|---|
| Publisher | Xooa Inc |
| Website | https://xooa.com/blockchain |
| Privacy policy | https://xooa.com/XooaPrivacyPolicy.htm |
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| API Key | securestring | The API Key for this api | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Create an entry in the database |
Create a key-value entry. Function will fail if the key already exists. If you want to update an entry (the key exists), use Update; if you want to create or update use CreateUpdate. |
| Create or Update a document |
If the key does not already exist, creates a new key-value entry, else updates the value of an existing entry. |
| Deletes an entry |
Creates a transaction to delete an entry with agiven key. The entry’s state no longer appears but the transactions that have updated the entry, including a transaction for the deletion is always kept and never deleted from the ledger. |
| Get the states of entries |
Gives the current state of a given list of entries |
| History for a key |
Get the transaction history for an entry specified by the given key. Can be used to find deleted entries (through their transaction history). |
| Query based on selection criteria |
Query the database and return entries matching the selection criteria given by the selector. |
| Updates a document |
Updates an entry with agiven key. If an existing entry is not found, the request fails. |
Create an entry in the database
Create a key-value entry. Function will fail if the key already exists. If you want to update an entry (the key exists), use Update; if you want to create or update use CreateUpdate.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Asynchronous call indicator
|
async | boolean |
Specifies whether to perform the call asynchronously (default is false). |
|
|
Timeout (synchronous calls only)
|
timeout | integer |
Timeout waiting on a response from a synchronous call (async false).A 202 Pending Transaction Response with the URL to retrieve appears if the timeout value is exceeded. Default timeout value is 5000ms. |
|
|
body
|
body | True | array of string |
Create or Update a document
If the key does not already exist, creates a new key-value entry, else updates the value of an existing entry.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Asynchronous call indicator
|
async | boolean |
Specifies whether to perform the call asynchronously (default is false). |
|
|
Timeout (synchronous calls only)
|
timeout | integer |
Timeout waiting on a response from a synchronous call (async false).A 202 Pending Transaction Response with the URL to retrieve appears if the timeout value is exceeded. Default timeout value is 5000ms. |
|
|
body
|
body | True | array of string |
Returns
- response
- string
Deletes an entry
Creates a transaction to delete an entry with agiven key. The entry’s state no longer appears but the transactions that have updated the entry, including a transaction for the deletion is always kept and never deleted from the ledger.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
List of keys.
|
keys | True | string |
Comma separated list of all the keys or entries to be marked as deleted. |
|
Asynchronous call indicator
|
async | boolean |
Specifies whether to perform the call asynchronously (default is false). |
|
|
Timeout (synchronous calls only)
|
timeout | integer |
Timeout waiting on a response from a synchronous call (async false).A 202 Pending Transaction Response with the URL to retrieve appears if the timeout value is exceeded. Default timeout value is 5000ms. |
Returns
- response
- string
Get the states of entries
Gives the current state of a given list of entries
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Keys of the requested entries.
|
keys | True | string |
Comma separated list of keys. |
|
Asynchronous call indicator
|
async | boolean |
Specifies whether to perform the call asynchronously (default is false). |
|
|
Timeout (synchronous calls only)
|
timeout | integer |
Timeout waiting on a response from a synchronous call (async false).A 202 Pending Transaction Response with the URL to retrieve appears if the timeout value is exceeded. Default timeout value is 5000ms. |
Returns
- response
- string
History for a key
Get the transaction history for an entry specified by the given key. Can be used to find deleted entries (through their transaction history).
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
The entry’s key.
|
key | True | string |
The key of the entry for which transaction history is required. |
|
Asynchronous call indicator
|
async | boolean |
Specifies whether to perform the call asynchronously (default is false). |
|
|
Timeout (synchronous calls only)
|
timeout | integer |
Timeout waiting on a response from a synchronous call (async false).A 202 Pending Transaction Response with the URL to retrieve appears if the timeout value is exceeded. Default timeout value is 5000ms. |
Returns
- response
- string
Query based on selection criteria
Query the database and return entries matching the selection criteria given by the selector.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Selection criteria for querying.
|
selector | string |
This is the criteria for querying the values of entries. For example: {'Make.Model':'3', 'Cost':{'$gt':150}} |
|
|
List of fields.
|
fields | string |
List of fields that need to be returned. If empty, all fields for a given entry will be retrieved. |
|
|
Maximum number of entries.
|
limit | integer |
Maximum number of entries that can be retrieved. |
|
|
Asynchronous call indicator
|
async | boolean |
Specifies whether to perform the call asynchronously (default is false). |
|
|
Timeout (synchronous calls only)
|
timeout | integer |
Timeout waiting on a response from a synchronous call (async false).A 202 Pending Transaction Response with the URL to retrieve appears if the timeout value is exceeded. Default timeout value is 5000ms. |
Returns
- response
- string
Updates a document
Updates an entry with agiven key. If an existing entry is not found, the request fails.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Asynchronous call indicator
|
async | boolean |
Specifies whether to perform the call asynchronously (default is false). |
|
|
Timeout (synchronous calls only)
|
timeout | integer |
Timeout waiting on a response from a synchronous call (async false).A 202 Pending Transaction Response with the URL to retrieve appears if the timeout value is exceeded. Default timeout value is 5000ms. |
|
|
body
|
body | True | array of string |
Returns
- response
- object
Definitions
string
This is the basic data type 'string'.
object
This is the type 'object'.