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	Sales@MAQSoftware.com

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 extracted
• keyphraseCount: Count of Key Phrases to return
• diversityThreshold: 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 scrubbed
• entityList: 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

1. 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 support@maqsoftware.com.

2. 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 support@maqsoftware.com

3. 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

Operation ID:

KeyPhraseExtractor

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

Operation ID:

PIIScrubber

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

Operation ID:

SentimentClassifier

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