ALVAO (プレビュー)

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

サービス	クラス	地域
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)

お問い合わせ先
件名	ALVAO サポート
[URL]	https://www.alvao.com/en/support-and-services
メール	support@alvao.com

Connector Metadata
発行者	ALVAO
Web サイト	https://www.alvao.com
プライバシー ポリシー	https://www.alvao.com/en/privacystatement
カテゴリー	コラボレーション; IT オペレーション

このコネクタを使用すると、 Power Automate、 Power Apps、または Azure Logic Apps を使用して、Alvao でのアクションを自動化したり、Alvao を他のアプリケーションと統合したりできます。 このコネクタを使用すると、サービス デスクのチケットのワークフローだけでなく、資産管理に登録された資産のライフサイクルにも関連付けられた自動化を開始できます。 コネクタ アクションを使用すると、チケット ワークフローを移動したり、アセットのライフサイクルを管理したりできるようになります。

前提条件

ALVAO のバージョンが少なくとも 11.1 である ALVAO 顧客 (SaaS またはオンプレミス) であり、インターネットから REST API を利用できる必要があります。

資格情報の入手方法

1. Alvao WebApp - Administration - Users でアプリケーション アカウントを作成します。
2. 少なくとも Name and Surname、User name を設定し、オプション Application account - Other applications を有効にします。
3. このアカウントにパスワードを設定します。
4. チケットまたはアセットを操作するために、アカウントに適切な権限を設定します。
5. このコネクタへの接続を作成するには、このアカウントの User name と Password を使用します。

注: Alvao WebApp - Administration - Settings - Web services で確認できる Alvao REST API の URL も必要になります。

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

接続を作成した後、さまざまなトリガーやアクションを使用できます。

たとえば、Alvao サービスデスクでのチケットの承認に基づく自動フローを使用して SharePoint のフォルダーを読み取る権限を付与します。

1. When a ticket transitions to a status トリガーを使用して、プロセスの名前とフローをトリガーする状態を指定します。
2. 次に、Get Ticket アクションを追加し、入力としてトリガーから利用可能な Ticket ID を入力します。
3. 次に、たとえばアクションから取得したリクエスト者のメールを使用して、M365 でユーザーを検索し、適切な権限を割り当てます。

その他のアクションも、資産管理の自動化に役立ちます。 E.g. アセットを作成したり、そのプロパティの値を変更したり、レジストリ内で移動したりするためのアクション。 別のシステムからアセットを定期的にインポートする必要がある場合は、アクション Import objects from CSV を使用できます。

既知の問題と制限事項

• すべてのトリガーは ALVAO 11.2 以降でのみ使用できます。
• これらのアクションは ALVAO 11.2 以降でのみ利用可能です:
  • オブジェクトの作成
  • オブジェクトの取得
  • オブジェクトを取得する
  • オブジェクト プロパティの更新
  • オブジェクトの移動
  • ユーザーを取得する
  • CSV からオブジェクトをインポート
• 一部のアクションでは、入力としてエンティティ ID が必要であり、この ID は Alvao 内に存在している必要があります。 これらの ID は通常、Alvao WebApp の詳細ページまたは編集ページの URL の末尾にあります。

一般的なエラーと解決策

• 403 Forbidden - 使用されているアプリケーション アカウントに、アクションを実行するために必要なすべての権限があるかどうかを確認します。 接続に使用される資格情報も確認してください。
• 404 Not found - すべての入力パラメータが正しいこと、および接続内の REST API URL が正しいことを確認してください。 お使いのバージョンの ALVAO でアクションが使用可能かどうかを確認します。

よくあるご質問

カスタム フィールド

コネクタは、チケットのカスタム フィールドからの値の読み取りと書き込みもサポートします。 カスタム フィールドは一般的なコネクタ定義では記述できないため、処理するには次の手法を使用する必要があります。

チケットのカスタム フィールドの値を読み取るには、Get ticket アクションで式を使用します。 たとえば、TicketCategory フィールドの値を読み取るには、次の式を使用します。

outputs('Get_request')?['body/customItems/TicketCategory/value']

チケットのカスタム フィールドに値を書き込むには、カスタム JSON 仕様で Update ticket アクションを使用します。 たとえば、TicketCategory フィールドに「モニター エラー」の値を書き込むには、Custom Items フィールドに次の指定を使用します。

{
  "TicketCategory": {
    "@@odata.type": "#Alvao.Rest.Api.Models.SD.CustomItem",
    "name": "TicketCategory",
    "value": "monitor failure"
  }
}

注: エスケープのため、文字「@」が 2 つになります。

接続を作成する

このコネクタは、次の認証タイプをサポートしています:

既定	接続を作成するためのパラメーター。	すべての地域	共有不可

既定

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

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

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

件名	タイプ	プロパティ	Required
Host	string	ALVAO REST API のホスト URL を指定します	True
Username	string	ALVAO アプリケーション アカウントのユーザー名	True
Password	securestring	ALVAO アプリケーション アカウントのパスワード	True

調整制限

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

アクション

CSV からオブジェクトをインポート	CSV 形式で提供されるオブジェクトをインポートします。 ImportUtil ユーティリティと同様の機能です。
オブジェクト プロパティの更新	オブジェクトのプロパティを更新します。
オブジェクトの作成	指定されたオブジェクトの下にある指定されたテンプレートから新しいオブジェクトを作成します。
オブジェクトの取得	オブジェクトとそのプロパティを返します。
オブジェクトを取得する	OData パラメータに従って、プロパティを持つオブジェクトを返します。
オブジェクトを移動	オブジェクトを指定された宛先に移動します。
チケット ログに記録を作成する	チケット ログに記録を作成する。
チケットの状態を変更する	チケットの状態を変更する。 チケットの解決や再開にも使用できます。 状態 ID または状態名のいずれかが必要です。
チケットをソルバーまたはソルバーチームに割り当てる	チケットをソルバーまたはソルバーチームに割り当てる。
チケットを作成する	新しいチケットを作成する。
チケットを別のサービスに移動する	チケットを別のサービスに移動する。 サービス ID またはサービス名のいずれかが必要です。
チケットを取得する	更新されたチケット プロパティを返します。
チケットを更新する	チケットの列を更新します。 変更するプロパティのみを設定します。 SLA を変更するには、slaId または slaName のいずれかを設定します。 リクエスタを変更するには、リクエスタ ID のみを設定するか、リクエスタ (未登録ユーザー) のすべてのデータを設定します。
ユーザーを取得する	OData パラメーターに従って、ユーザーとそのプロパティを返します。

CSV からオブジェクトをインポート

オブジェクト プロパティの更新

オブジェクトの作成

オブジェクトの取得

オブジェクトを取得する

オブジェクトを移動

チケット ログに記録を作成する

チケットの状態を変更する

チケットをソルバーまたはソルバーチームに割り当てる

チケットを作成する

チケットを別のサービスに移動する

チケットを取得する

チケットを更新する

ユーザーを取得する

トリガー

オブジェクトが作成されたとき	この操作は、特定の種類のオブジェクトが作成されたときにトリガーされます。
オブジェクトが移動されたとき	この操作は、特定の種類のオブジェクトがオブジェクト ツリー内の別の位置に移動されたときにトリガーされます。
オブジェクトプロパティの値が変更されたとき	この操作は、特定のオブジェクトのプロパティの値が変更されたときにトリガーされます。
チケットがステータスに移行するとき	この操作は、チケットが特定のステータスに移行したときにトリガーされます。
チケットフィールドの値が変更されたとき	この操作は、特定のチケットフィールドの値が変更されたときにトリガされます。

オブジェクトが作成されたとき

オブジェクトが移動されたとき

オブジェクトプロパティの値が変更されたとき

チケットがステータスに移行するとき

チケットフィールドの値が変更されたとき

定義

SD.Ticket

Webhook.UpdatedTicket

AM.Object

AM.ObjectExpanded

AM.ObjectsExpandedApiResponse

AM.ImportCsvResponse

Common.Person

Common.UsersApiResponse

string