Text Analytics (Preview)
Discover meaningful insights in your text data. Perform Sentiment Analysis, extract Key Phrases and scrub PII Data from your text data.
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 | |
|---|---|
| Name | MAQ Software Sales |
| URL | https://maqsoftware.com/contact |
| [email protected] |
| Connector Metadata | |
|---|---|
| Publisher | MAQ Software |
| Website | https://maqsoftware.com/ |
| Privacy Policy | https://maqsoftware.com/privacystatement |
| Categories | AI;Website |
MAQTextAnalytics can be used for processing raw text using the natural language processing models. This connector supports sentiment analysis, extraction of key phrases and scrubbing Personally Identifiable Information (PII).
Prerequisites
Register for the SDK
You will need an O365 Account to register:
- Click here to register using the Free Trial button in the Developer Zone pane
- Save the API Key you receive while registering on the Developer Zone pane. Kindly note the validity until which the subscription will be active
You're now ready to start using this connector.
Capabilities
Sentiment Analysis
Analyze sentiment of raw text. This capability returns a sentiment score between 0 and 1, where a score of 0 corresponds to negative sentiment and a score of 1 corresponds to positive sentiment. In addition, a score of 0.5 corresponds to neutral sentiment.
Key Phrase Extraction
Extract top key phrases from raw text. It outputs each keyphrase with a significance score and most similar key phrases. This capability requires the following information to be entered by user:
text: Input text from which key phrases need to be extractedkeyphraseCount: Count of Key Phrases to returndiversityThreshold: Value of Diversity Threshold can be between 0 and 1. More the score, more different/diverse the keyphrases are. Less the score, more duplicate the keyphrases are.aliasThreshold: Value of Alias Threshold can be between 0 and 1. Similarity threshold for Alias/Similar Keyphrase with Top Key Phrase. More the value, more accurate are the keyphrases in top key-phrase.
Scrub PII Data
Scrub Personally Identifiable Information (PII data) from raw text based on the configured entities. This capability requires the following information to be entered by user:
text: Input text from which PII entities need to be scrubbedentityList: Comma separated list of entities (Refer to List of Supported Entities section below)
List of Supported Entities for scrubbing PII data:
| Entity Name | Action |
|---|---|
| PERSON | A full person name, which can include first names, middle names or initials, and last names. |
| CREDIT_CARD | A credit card number is between 12 to 19 digits. https://en.wikipedia.org/wiki/Payment_card_number |
| DATE_TIME | Absolute or relative dates or periods or times smaller than a day. |
| DOMAIN_NAME | A domain name as defined by the DNS standard. |
| EMAIL_ADDRESS | An email address identifies an email box to which email messages are delivered |
| IBAN_CODE | The International Bank Account Number (IBAN) is an internationally agreed system of identifying bank accounts across national borders to facilitate the communication and processing of cross border transactions with a reduced risk of transcription errors. |
| IP_ADDRESS | An Internet Protocol (IP) address (either IPv4 or IPv6). |
| LOCATION | Name of politically or geographically defined location (cities, provinces, countries, international regions, bodies of water, mountains |
| PHONE_NUMBER | A telephone number |
| US_BANK_NUMBER | A US bank account number is between 8 to 17 digits. |
| US_DRIVER_LICENSE | A US driver license according to https://ntsi.com/drivers-license-format/ |
| US_PASSPORT | A US passport number with 9 digits. |
| US_SSN | A US Social Security Number (SSN) with 9 digits. |
Known issues and limitations
This connector uses API Key offered as part of free trial from MAQ Text Analytics. In the free trial subscription, the API Key has a default quota of 500 calls. In a single call, you can send maximum of 1 document.
FAQ
What happens when my API Key expires?
You can re-register for a free trial subscription by clicking here. For more information, you can connect with us at [email protected].What happens when my API Limit is exhausted?
You will get an API Limit exceeded error when you try to use the connector. You can visit the Developer Zone pane and generate a new API Key. For a premium service, you can connect with us at [email protected]Why I am getting batch size error? You can send a maximum 1 document in a single call for each capability. Verify that you are not trying to send more than 1 document.
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
| Key Phrase Extractor |
Extract Key Phrases from your text data |
| Scrub PII Data |
Scrub PII data from your text based on configured entities |
| Sentiment Classifier |
Perform Sentiment Analysis of your text data |
Key Phrase Extractor
Extract Key Phrases from your text data
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
text
|
text | string |
text |
|
|
keyphrases_count
|
keyphrases_count | integer |
keyphrases_count |
|
|
diversity_threshold
|
diversity_threshold | float |
diversity_threshold |
|
|
alias_threshold
|
alias_threshold | float |
alias_threshold |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
KeyPhrase
|
KeyPhrase | string |
KeyPhrase |
|
Score
|
Score | float |
Score |
|
Similar
|
Similar | array of string |
Similar |
Scrub PII Data
Scrub PII data from your text based on configured entities
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
data
|
data | string |
data |
|
|
entity_list
|
entity_list | string |
entity_list |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
scrubbed_text
|
scrubbed_text | string |
scrubbed_text |
Sentiment Classifier
Perform Sentiment Analysis of your text data
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
id
|
id | integer |
id |
|
|
text
|
text | string |
text |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
id
|
id | integer |
id |
|
sentiment
|
sentiment | float |
sentiment |