ServiceNow - アセット管理コネクタThinklet

ServiceNow - インシデント管理コネクタThinkletを設定し、ワークフロー内で特定のアクションを実行させます。

アクション: メールアドレスでユーザーの詳細を取得

メールアドレスによるユーザー詳細取得は、ユーザーデータの詳細を取得します。

ServiceNow - 資産管理コネクタThinkletは、テーブル sys_user GET API endpointに依存しています。

• パラメーター: この操作で使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かに関する詳細情報は、ツールチップアイコンの上にマウスを置いてください。

  • ユーザーのメールアドレス

• 出力: コネクタThinkletの出力を表示します。

  • ユーザーID (UserID)

  • ユーザー名 (UserName): ServiceNow ユーザー名

  • MFAを有効にする (EnableMultifactorAauthn): 多要素認証を有効にする

  • VIP (VIPUser)

  • パスワードリセットが必要 (PasswordNeedsReset)

以下の表は、コネクタを再作成する際に必要なAPIサービスコネクタの詳細を示しています。

フィールド	値
リソースパス	/api/now/table/sys_user?sysparm_query=email={{UserEmailAddress}}
メソッド	GET
ペイロード
出力	EnableMultifactorAauthn $.result[0].enable_multifactor_authn PasswordNeedsReset $.result[0].password_needs_reset UserID $.result[0].sys_id UserName $.result[0].user_name VIPUser $.result[0].vip

アクション: ユーザーIDでユーザーの詳細を取得

ユーザーIDでユーザーの詳細を取得は、詳細なユーザーデータを取得します。

ServiceNow - 資産管理コネクタThinkletは、テーブル sys_user GET API endpointに依存しています。

以下はThinkletセットアップの例です。

• パラメーター: このアクションで使用するパラメーターのデータを設定してください。 パラメーターがどのようにマッピングされ、どんなデータが必要かについての詳細は、ツールチップアイコンにカーソルを合わせてください。

  • ServiceNowユーザーID

• 出力: コネクタThinkletの出力を表示します。

  • ユーザーのメールアドレス (UserEmailAddress)

  • ユーザー名 (UserName): ServiceNow ユーザー名

  • MFAを有効にする (EnableMultifactorAauthn): 多要素認証を有効にする

  • VIP (VIPUser)

  • パスワードリセットが必要 (PasswordNeedsReset)

以下の表は、コネクタを再作成する際に必要なAPIサービスコネクタの詳細を示しています。

フィールド	値
リソースパス	/api/now/table/sys_user/{{ServiceNowUserID}}
メソッド	GET
ペイロード
出力	UserEmailAddress $.result.email EnableMultifactorAauthn $.result.enable_multifactor_authn PasswordNeedsReset $.result.password_needs_reset UserName $.result.user_name VIPUser $.result.vip

アクション: デバイス名でデバイスの詳細を取得

デバイス名でデバイスの詳細を取得は、詳細なデバイスデータを取得します。

ServiceNow - 資産管理コネクタThinkletは、テーブル cmdb_ci_computer GET API endpointに依存しています。

• パラメーター: この操作で使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かに関する詳細情報は、ツールチップアイコンの上にマウスを置いてください。

  • デバイスID

• 出力: コネクタThinkletの出力を表示します。

  • コンピュータID (ComputerID): ServiceNow コンピュータID

  • 購入日 (PurchaseDate)

  • 保証期限日 (WarrantyExpirationDate)

  • 所有者ID (OwnedByID)

  • 割り当てID (AssignedToID)

  • 管理者ID (ManagedByID)

  • 資産ID (AssetID)

  • ライフサイクルステージ (LifeCycleStage): 不良, 配備, 寿命終了, 在庫, 紛失, 運用中, 購入

以下の表は、コネクタを再作成する際に必要なAPIサービスコネクタの詳細を示しています。

フィールド	値
リソースパス	/api/now/table/cmdb_ci_computer?sysparm_query=name={{DeviceName}}
方法	取得
ペイロード
出力	AssetID $.result[0].asset.value AssignedToID $.result[0].assigned_to.value LifeCycleStage $.result[0].life_cycle_stage.value ManagedByID $.result[0].managed_by.value OwnedByID $.result[0].owned_by.value PurchaseDate $.result[0].purchase_date ComputerID $.result[0].sys_id WarrantyExpirationDate $.result[0].warranty_expiration

アクション: デバイスIDでデバイスの詳細を取得

デバイスIDでデバイスの詳細を取得は、詳細なデバイスデータを取得します。

ServiceNow - 資産管理コネクタThinkletは、テーブル cmdb_ci_computer GET API endpointに依存しています。

• パラメーター: この操作で使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かに関する詳細情報は、ツールチップアイコンの上にマウスを置いてください。

  • デバイスID

• 出力: コネクタThinkletの出力を表示します。

  • コンピュータ名 (ComputerName): ServiceNow コンピュータ名

  • 購入日 (PurchaseDate)

  • 保証期限日 (WarrantyExpirationDate)

  • 所有者ID (OwnedByID)

  • 割り当てID (AssignedToID)

  • 管理者ID (ManagedByID)

  • 資産ID (AssetID)

  • ライフサイクルステージ (LifeCycleStage): 不良, 配備, 寿命終了, 在庫, 紛失, 運用中, 購入

The table below shows the API Service connector details needed when recreating the connector:

フィールド	値
リソースパス	/api/now/table/cmdb_ci_computer/{{DeviceID}}
方法	取得
ペイロード
出力	AssetID $.result.asset.value AssignedToID $.result.assigned_to.value LifeCycleStage $.result.life_cycle_stage.value ManagedByID $.result.managed_by.value ComputerName $.result.name OwnedByID $.result.owned_by.value 購入日 $.result.purchase_date 保証期間終了日 $.result.warranty_expiration

アクション: CI IDでハードウェア資産の詳細を取得

CI IDでハードウェア資産の詳細を取得は、詳細なハードウェア資産データを取得します。 このデータは、たとえば資産の状態を確認し、_運用中_の状態にあるものに対してのみアクションを開始するためにワークフローに統合できます。

ServiceNow - 資産管理コネクタThinkletは、テーブル alm_hardware GET API endpointに依存しています。

以下はThinkletセットアップの例です。

• パラメーター

  • 構成アイテムID (ConfigurationItemID)

• 出力

  • 状態 (State) - ハードウェア資産の状態— 1- 運用中, 2- 注文中, 3- 保守中, 6- 在庫中, 7- 退役, 8- 紛失, 9- 輸送中, 11- 構築

  • サブステート (Substate) - 状態に依存する資産の現在のサブステート

  • 表示名 (DisplayName)

  • ハードウェア資産ID (HardwareAssetID)

  • シリアル番号 (SerialNumber)

The table below shows the API Service connector details needed when recreating the connector:

フィールド	値
リソースパス	api/now/table/alm_hardware?sysparm_query=ci.value={{ConfigurationItemID}}&sysparm_limit=1
方法	取得
ペイロード
出力	資産タグ $.result[0].asset_tag 表示名 $.result[0].display_name 状態 $.result[0].install_status シリアル番号 $.result[0].serial_number サブステート $.result[0].substatus ハードウェア資産ID $.result[0].sys_id

操作: デバイスのライフサイクルステージとステータスを設定する

デバイスのライフサイクルステージとステータスを設定する操作は、CI（構成アイテム）コンピュータのライフサイクルステージとステータスを更新します。 ライフサイクルステージの標準的な値は、「不良品」、「展開」、「寿命終了」、「在庫」、「不足」、「運用中」、および「購入」です。 各ライフサイクルステージには、「メンテナンス中」や「使用中」などの対応する許可されたステータス値があります。 この操作は、これらのフィールドに対するローカルに定義された構成に従って使用する必要があります。

ServiceNow - 資産管理コネクタThinkletは、Table cmdb_ci_computer PUT API endpointに依存しています。

以下はThinkletセットアップの例です：

• パラメーター

  • コンピュータID (ComputerID)

  • ライフサイクルステージ (LifeCycleStage)

  • ライフサイクルステージのステータス (LifeCycleStageStatus)

• 出力

  • コンピュータID (ComputerID) - ServiceNow コンピュータID

The table below shows the API Service connector details needed when recreating the connector:

フィールド	値
リソースパス	api/now/table/cmdb_ci_computer/{{ComputerID}}
方法	取得
ペイロード	{"life_cycle_stage": "{{LifeCycleStage}}", "life_cycle_stage_status": "{{LifeCycleStageStatus}}"}
出力	コンピュータID $.result[0].sys_id

コネクタThinkletについての詳細は、コネクタThinkletの設定ドキュメントを参照してください。