次の方法で共有

Aranda Service Management (プレビュー)

  • リファレンス

ビジネス プロセスとサービスを管理、統合、自動化できるマルチテナント ソリューションである Aranda Service Management Suite を使用して、会社の生産性を高め、ユーザー エクスペリエンスを変革します。

このコネクタは、次の製品および地域で利用可能です:

サービス クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   US Government (GCC)
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   US Government (GCC)
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
件名 Aranda Software
[URL] https://arandasoft.com/
メール soporte@arandasoft.com
Connector Metadata
発行者 Aranda Software
Web サイト https://arandasoft.com/
プライバシー ポリシー https://arandasoft.com/politica-de-privacidad/
カテゴリー ビジネス管理;コラボレーション

Aranda Service Management Suite (ASMS)

ビジネス プロセスとサービスを管理、統合、自動化できるマルチテナント ソリューションである Aranda Service Management Suite を使用して、会社の生産性を高め、ユーザー エクスペリエンスを変革します。 インシデント、要件、変更など、ASMS の任意のワークスペース (プロジェクト) に保存されているレコードを作成、検索、更新します。

前提条件

続行するには、次の前提条件に留意してください:

  • Aranda Service Management Suite (ASMS) のサブスクリプションとインスタンス。 ここから開始: https://arandasoft.com/
  • プレミアム コネクタ機能を備えたアクティブな Microsoft Power Automate サブスクリプション。

資格情報の取得

  • 認証を実行するには、統合トークンを使用します。 以下のリンクに、統合トークンの取得方法が記載されています

コネクタの使用を開始する

  1. Aranda Service Management Suite (ASMS) のサブスクリプションが必要です。

  2. 統合トークンを取得する

  3. Aranda Service Management ASMS API (ApiAsms) のベース URLを取得します。API アドレスは、ASMS 管理者 コンソールの設定セクションで確認できます

    検索エンドポイント

  4. ASMS とのコネクション構築

    ConnectionAsms

    As:

    1. ApiAsms
    2. 統合トークン

  5. 画像に示すように、プロパティ ID を追加してコネクタを構成します:

    Ticket

このコネクタは、次の場合に使用できます:

  1. チケットの作成、検索、更新などのアクションを実行できます。
  2. これにより、組織は社内のサポート リクエストを解決し、技術的な問題解決プロセスを管理および合理化できます。
  3. リクエスト者とサポート エージェント間の通信を追跡できます。
  4. 自動応答を提供して、リクエスト者にチケットのステータスを通知します。
  5. 事前に定義されたエイリアスに電子メールを送信してチケットを作成する機能を提供します。

一般的なエラーと解決策

コード 件名 プロパティ ソリューション
400 BadRequest CriteriaNeedsSomeArguments 検索パラメータが空でないことを確認してください
400 BadRequest InvalidAdditionalFieldId 追加フィールドの ID が正しいことを確認してください
400 BadRequest InvalidItemType ケース タイプが正しくありません。ケース タイプ ID を変更してください
400 BadRequest InvalidProjectId プロジェクト ID が正しくありません。ケースを関連付けるプロジェクト ID を変更してください
400 BadRequest InvalidStateId チケットを作成または更新するときに追加されたステータスを確認します
400 BadRequest InvalidUploadType ファイルの添付時にエラーが発生しました。システム管理者にサポートを依頼してください
400 BadRequest パラメータ名: {パラメータ名} エラーに記載されているプロパティが null でないことを確認してください
400 BadRequest RequestNeedsSomeArguments チケットの必須フィールドを確認し、対応する値をコネクタに追加します
400 BadRequest SearchListIsRequired システム管理者にサポートを依頼
400 BadRequest パラメータ名が null です: {名前パラメータ} エラーに記載されているプロパティが null でないことを確認してください
400 BadRequest ItemTypeIsRequired ケース　タイプの追加
400 BadRequest TypesListNeedsSomeArguments チケット検索時にケースの種類を追加する必要があります。システム管理者に支援を要請してください
403 無効 DoNotHavePermissionForThisAction 権限を割り当てるには、システム 管理者 に問い合わせてください
コード 件名 プロパティ ソリューション
500 InternalServerError システム管理者にサポートを依頼
500 InternalServerError FailureExportExcel システム管理者にサポートを依頼
500 InternalServerError FailureGetAdditionalFields システム管理者にサポートを依頼
500 InternalServerError FailureGetCategoriesByService システム管理者にサポートを依頼
500 InternalServerError FailureGetChangeFSC システム管理者にサポートを依頼
500 InternalServerError FailureGetFields システム管理者にサポートを依頼
500 InternalServerError FailureGetFieldsList システム管理者にサポートを依頼
500 InternalServerError FailureGetFiles システム管理者にサポートを依頼
500 InternalServerError FailureGetLookupValues システム管理者にサポートを依頼
500 InternalServerError FailureGetMailTemplates システム管理者にサポートを依頼
500 InternalServerError FailureGetModelByCategory システム管理者にサポートを依頼
500 InternalServerError FailureGetOperators システム管理者にサポートを依頼
500 InternalServerError FailureGetReassignmentReasons システム管理者にサポートを依頼
500 InternalServerError FailureGetSimilarItems システム管理者にサポートを依頼
500 InternalServerError FailureSearchQuickManagement システム管理者にサポートを依頼

よくあるご質問

  1. コネクタでさまざまなアクションを使用するために必要な属性の IDを 取得する方法 (プロジェクト、サービス、カテゴリー、グループ、スペシャリストなど)

    ID はさまざまな方法で取得できます:

    • Aranda Query Manager を使用すると、必要なデータが配置されている Aranda Service Management Suite (ASMS) テーブルを照会するレポートを作成できます。 ソリューション内のデータ オブジェクトに関するガイダンスが必要な場合は、次のリンク https://docs.arandasoft.com/docs/database.html にアクセスし、ASMS インストールに対応する Aranda データベース バージョンを特定してください。
    • ASMS オンプレミス インストールを使用している場合、SQL クライアントを使用して必要なデータがある ASMS テーブルにクエリできます。
    • Aranda サポートセンターを経由して、次の Web サイトに示されている連絡先を介してサポート リクエストを作成します。

  2. 添付ファイルの追加アクションを使用する場合、添付できるファイルの最大サイズはどれくらいですか?

    最大サイズは、ASMS インスタンス/インストールの特定の構成によって異なります。 ASMS 管理者にお尋ねください。

  3. コネクタに必要な ASMS 接続の構成でトークンが使用される技術者アカウントに必要なデータ アクセス レベルは何ですか?

    アクセス レベルは、ASMS で通常使用される技術者アカウントと同じです。 つまり、ASMS 内の対応する技術者の役割と権限に基づいて、コネクタを使用してデータにアクセスできます。

  4. コネクタで使用されるトークンを持つ技術者アカウントは、名前付きアカウントにすべきですか、それとも同時アカウントにすべきですか?

    コネクタは関連する ASMS インスタンスに 1 時間に複数回アクセスする可能性があるため、アカウントは名前付きタイプにすることを強くお勧めします。

  5. コネクタを使用したケースの作成または変更は、ASMS インターフェイスにある同じデータ検証ルールに従いますか?

    はい、同じ検証ルールに従います。 たとえば、特定のプロジェクト、サービス、カテゴリのケースを作成するときに、ネイティブ フィールドと追加フィールドに入力する必要がある場合、コネクタを介してケースを送信するときにもこれらのデータが必要になります。

  6. コネクタは、クラウド環境およびオンプレミス環境の ASMS インスタンスに使用できますか?

    はい、ASMS のクラウドとオンプレミスの両方のインストールで使用できます。 オンプレミスのインストールでは、ASMS サーバーと Power Automate 環境との接続性を考慮する必要があります。

  7. Power Automate 標準コネクタのみを使用できるライセンスを使用しています。ASMS コネクタを使用できますか?

    できません。ASMS コネクタは Premium タイプです。

  8. ASMS のイベント (例: ケースが作成されたとき、ケースが特定のグループに割り当てられたとき) から開始するフローを Power Automate で作成したいです。ASMS で発生したイベントから開始するトリガーを使用することは可能ですか?

    はい、できます。 以下の手順をお勧めします:

    • 「HTTP リクエストを受信したとき」のトリガーを初期化し、ASMS から受信すると予想されるデータ構造を含むリクエスト ボディの JSON スキーマを作成します。 トリガーが作成されると、ASMS インスタンスで使用する HTTP 投稿先 URL (WebHook URL) が取得されます。 WebHook URL にアクセスするための認証メカニズム (トークンなど) を考慮することを忘れないでください。
    • ASMS でビジネスルールを作成し、条件を満たすと Power Automate のフローを開始します。 ルール内のアクションとして、「Webhook を呼び出す」を選択し、呼び出し先 URL に、以前に取得した WebHook URL、送信するパラメーター、およびリクエストの本文 (リクエスト本文 JSON スキーマと一致する必要があります) を入力します。 ASMS のルールから Webhook を呼び出す方法の詳細については、次のリンクを参照してください: Webhook ルール
    • 作成したルールをテストし、HTTP リクエストが WebHook URL に送信され、Power Automate のフローが初期化されることを確認します。

  9. Power Automate のフローから ASMS REST API のエンドポイントをアクションとして呼び出すことはできますか？

    はい、できます。 「HTTP」アクションを使用して、必要なデータ (URI、メソッド、ヘッダー、本文など) を入力します。

接続を作成する

このコネクタは、次の認証タイプをサポートしています:
既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ プロパティ Required
Host ASMS string Host ASMS True
認証トークン securestring 認証トークン True

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

ケースの取得

ASMS ケースのメタデータのレコードを取得します。
ケースの更新

ASMS ケースのレコードを更新します。
ケースの検索

クエリに追加された検索条件に応じて、ASMS ケース レコードのリストを取得します。
サポート案件の作成

ASMS で新しいケース レコードを作成します。
メモを追加

ASMS の特定のケース レコードにメモを追加します。
添付ファイルの追加

ASMS 内の特定のケース レコードにファイルを添付します。

ケースの取得

操作 ID:
GetCase

ASMS ケースのメタデータのレコードを取得します。

パラメーター

名前 キー 必須 型 説明
ケース コード
 ticketId True string

メタデータが添付されるレコードのコード。

戻り値

名前 パス 型 説明
サポート案件 ID
 id integer

レコードのシステム ID
ケース コード
 idByProject string

記録のケースコード
サブジェクト
 subject string

サブジェクト
プロパティ
 description string

ケースの詳しい説明です
ソリューション
commentary string

ケースの解決
会社 ID
 projectId integer

会社 ID
Project
 projectName string

プロジェクト名
Case Type
 itemTypeName string

ケース タイプ名
ケースの種類 ID
 itemTypeId integer

ケースの種類 ID
サービス ID
 serviceId integer

サービス ID
サービス
 serviceName string

Service name
Model ID
 modelId integer

Model ID
Model
 modelName string

モデル名
Category ID
 categoryId integer

Category ID
カテゴリ名
 categoryName string

カテゴリー
申請者 ID
 applicantId integer

申請者 ID
Client ID
 customerId integer

Client ID
Client
 customerName string

クライアント名
企業 ID
 companyId integer

企業 ID
Company
 companyName string

Company name
CI ID
 ciId integer

CI ID
CI
 ciName string

CI 名
SLA ID
 slaId integer

SLA ID
SLA
 slaName string

SLA 名
状態 ID
 stateId integer

状態 ID
Status
 stateName string

ステータス名
原因 ID
 reasonId integer

原因 ID
Reason
 reasonName string

原因名
Group ID
 groupId integer

Group ID
Group
 groupName string

Group name
責任ある ID
 responsibleId integer

責任ある ID
責任
 responsibleName string

責任名
レジストリ タイプ ID
 registryTypeId integer

レジストリ タイプ ID
レジストリ タイプ
 registryTypeName string

レジストリタイプの名前
インパクト ID
 impactId integer

インパクト ID
影響
 impactName string

インパクト名
緊急性 ID
 urgencyId integer

緊急性 ID
緊急度
 urgencyName string

緊急度名
優先順位 ID
 priorityId integer

優先順位 ID
優先順位
 priorityName string

優先名
Risk ID
 riskId integer

Risk ID
Risk
 riskName string

リスク名
プロバイダー ID
 providerId integer

プロバイダー ID
Provider
 providerName string

プロバイダー名
UC ID
 ucId integer

UC ID
UC
 ucName string

UC 名
組織のエリア ID
 unitId integer

組織のエリア ID
組織のエリア
 unitName string

組織エリア名
OLA ID
 olaId integer

OLA ID
OLA
 olaName string

OLA 名
レジストリ日
 openedDate string

レジストリ日
クローズした日
 closedDate string

クローズした日
最終日
 finalDate string

最終日 (タスク記録のみ)
開始日
 initialDate string

開始日 (タスク記録のみ)
コスト
 cost number

コスト
実質コスト
 realCost number

実質コスト
見積原価
 estimatedCost number

見積原価
料金
 price number

料金
インターフェイス ID
 interfaceId string

インターフェイス ID
クローズ済みです
 isClosed boolean

クローズ済みです
Progress
 currentProgress number

Progress
実際の日付
 realDate string

実際の日付
予定日
 estimatedDate string

予定日
作成者 ID
 authorId integer

作成者 ID
Author
 authorName string

作成者名
追加フィールド
 additionalFields array of object

追加フィールド
フィールド ID
 additionalFields.fieldId integer

フィールド ID
名前フィールド
 additionalFields.nameField string

名前フィールド
値 ID
 additionalFields.valueDetails.id integer

値 ID
フィールド値
 additionalFields.valueDetails.value string

フィールド値
Values
 additionalFields.values array of string

追加フィールド値

ケースの更新

操作 ID:
UpdateCase

ASMS ケースのレコードを更新します。

パラメーター

名前 キー 必須 型 説明
ケース コード
 ticketId True string

メタデータが添付されるレコードのコード。
サービス ID
 serviceId integer

サービス ID
Category ID
 categoryId integer

Category ID
サブジェクト
 subject string

サブジェクト
プロパティ
 description string

ケースの詳しい説明です
ソリューション
commentary string

ケースの解決
状態 ID
 stateId integer

状態 ID
原因 ID
 reasonId integer

原因 ID
Group ID
 groupId integer

Group ID
責任ある ID
 responsibleId integer

責任ある ID
申請者 ID
 applicantId integer

申請者 ID
Client ID
 customerId integer

Client ID
企業 ID
 companyId integer

企業 ID
レジストリ タイプ ID
 registryTypeId integer

レジストリ タイプ ID
CI ID
 ciId integer

CI ID
緊急性 ID
 urgencyId integer

緊急性 ID
インパクト ID
 impactId integer

インパクト ID
プロバイダー ID
 providerId integer

プロバイダー ID
組織のエリア ID
 unitId integer

組織のエリア ID
フィールド ID
 fieldId string

フィールド ID
Values
 values array of string

Values

戻り値

名前 パス 型 説明
result
 result boolean

Result

ケースの検索

操作 ID:
SearchTickets

クエリに追加された検索条件に応じて、ASMS ケース レコードのリストを取得します。

パラメーター

名前 キー 必須 型 説明
フィルター間の関係
 logicOperator True string

検索条件間の関係を指定します。
フィールドからフィルター
 field True string

フィルターするケース フィールド (例: 'stateName')
演算子の検索
 operator True string

演算子の検索
検索する値
 value True string

検索するフィールド値

戻り値

名前 パス 型 説明
array of object
サポート案件 ID
 id integer

レコードのシステム ID
ケース コード
 idByProject string

記録のケースコード
サブジェクト
 subject string

サポート案件の情報カテゴリ
プロパティ
 description string

ケースの詳しい説明です
会社 ID
 projectId integer

会社 ID
Project
 projectName string

プロジェクト名
Case Type
 itemTypeName string

ケース タイプ名
ケースの種類 ID
 itemTypeId integer

ケースの種類 ID
サービス ID
 serviceId integer

サービス ID
サービス
 serviceName string

Service name
Model ID
 modelId integer

Model ID
Model
 modelName string

モデル名
Category ID
 categoryId integer

Category ID
カテゴリー
 categoryName string

カテゴリ名
申請者 ID
 applicantId integer

申請者 ID
CI ID
 ciId integer

構成項目の ID
CI
 ciName string

主な構成品目名
Client ID
 customerId integer

Client ID
Client
 customerName string

クライアント名
企業 ID
 companyId integer

企業 ID
Company
 companyName string

Company name
SLA ID
 slaId integer

SLA ID
SLA
 slaName string

SLA 名
状態 ID
 stateId integer

状態 ID
Status
 stateName string

ステータス名
原因 ID
 reasonId integer

原因 ID
Reason
 reasonName string

原因名
Group ID
 groupId integer

Group ID
Group
 groupName string

Group name
責任ある ID
 responsibleId integer

責任ある ID
責任
 responsibleName string

責任名
インパクト ID
 impactId integer

インパクト ID
影響
 impactName string

インパクト名
レジストリ日
 openedDate string

レジストリ日
作成者 ID
 authorId integer

作成者 ID
Author
 authorName string

作成者名

サポート案件の作成

操作 ID:
CreateCase

ASMS で新しいケース レコードを作成します。

パラメーター

名前 キー 必須 型 説明
ケースの種類 ID
 itemType True integer

ケースの種類 ID
会社 ID
 projectId True integer

会社 ID
サービス ID
 serviceId True integer

サービス ID
Category ID
 categoryId True integer

Category ID
サブジェクト
 subject True string

サブジェクト
プロパティ
 description string

ケースの詳しい説明です
状態 ID
 stateId integer

状態 ID
原因 ID
 reasonId integer

原因 ID
Group ID
 groupId integer

Group ID
責任ある ID
 responsibleId integer

責任ある ID
申請者 ID
 applicantId integer

申請者 ID
Client
 customerId integer

Client
企業 ID
 companyId integer

企業 ID
レジストリ タイプ ID
 registryTypeId integer

レジストリ タイプ ID
CI ID
 ciId integer

CI ID
緊急性 ID
 urgencyId integer

緊急性 ID
インパクト ID
 impactId integer

インパクト ID
プロバイダー ID
 providerId integer

プロバイダー ID
組織のエリア ID
 unitId integer

組織のエリア ID
fieldId
 fieldId string

Field ID
values
 values array of string

価値

戻り値

名前 パス 型 説明
サポート案件 ID
 id integer

サポート案件 ID
ケース コード
 idByProject string

記録のケースコード

メモを追加

操作 ID:
AttachNote

ASMS の特定のケース レコードにメモを追加します。

パラメーター

名前 キー 必須 型 説明
ケース コード
 ticketId True string

メタデータが添付されるレコードのコード。
注意Note
 message True string

レコードに添付するメモ。

戻り値

添付ファイルの追加

操作 ID:
AttachFile

ASMS 内の特定のケース レコードにファイルを添付します。

パラメーター

名前 キー 必須 型 説明
ケース コード
 ticketId True string

メタデータが添付されるレコードのコード。
File
 file True byte

バイト ファイル
File Name
 fileName True string

ファイル名 (例: 'Vacation_Approval_Form.docx')