学ぶ (英語版)
ドキュメント (英語版)
サポート (英語のみ)
コミュニティ (英語版)

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

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

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

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

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

image-20240604-123140.png

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

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

  • 出力: コネクタ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セットアップの例です。

image-20240604-123942.png

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

    • 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に依存しています。

image-20240604-130939.png

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

    • デバイス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に依存しています。

image-20240604-131025.png

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

    • デバイス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の設定ドキュメントを参照してください。

Last updated

Was this helpful?