ヘッドレスブラウザーのシステムプロパティ

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：5分

    • 次の表に、ServiceNow® の 自動テストフレームワーク (ATF) 用ヘッドレスブラウザーを設定するときに必要なプロパティを示します。

    表 : 1. システムプロパティ
    プロパティ名 タイプ デフォルト値 目的
    sn_atf.headless.browser_options 文字列 "--no-sandbox,--disable-gpu" CLI オプションは起動時にブラウザーに渡されます
    sn_atf.headless.default_browser 文字列 Chrome ヘッドレス要求を開始するときに使用されるデフォルトのブラウザー
    sn_atf.headless.default_os 文字列 Linux ホストマシンのオペレーティングシステム
    sn_atf.headless.docker_image_name 文字列 名前：ホストマシン上の Docker イメージのタグ
    sn_atf.headless.docker_window_seconds int 60 Docker コンテナがこの時間内に 2 回起動に失敗した場合、サービスは再起動を試行しません
    sn_atf.headless.enabled True/False false スケジュール設定された UI テスト実行に対して、インスタンスがヘッドレスクライアントテストランナーの作成を試行するかどうかを決定します
    sn_atf.headless.heartbeat_enabled True/False true プロパティが true の場合、Docker コンテナはインスタンスに REST API 要求を毎分送信して sys_atf_agent がまだオンラインであることを確認し、レコードステータスが「オフライン」である場合、またはレコードが存在しなくなった場合は、そのコンテナを停止します。
    sn_atf.headless.heartbeat_uri 文字列 /api/now/atf_agent/online ハートビートエンドポイントの URL で、ブラウザーがまだ応答することをコンテナが確認できるようにします。
    sn_atf.headless.images_check.enabled True/False false このプロパティが true の場合、テスト実行の前に、インスタンスは要求された Docker image:tag がホストに存在することを確認します。
    sn_atf.headless.login_button_id 文字列 sysverb_login ログインページの [送信/ログイン] ボタンの HTML ID。
    sn_atf.headless.login_page 文字列 login.do ブラウザーが移動するログインページの URL
    sn_atf.headless.password_field_id 文字列 user_password ログインページのパスワードの入力フィールドの HTML ID
    sn_atf.headless.request_timeout_sec int 200 Docker ホストに送信される HTTP 要求がタイムアウトするまでの秒数
    sn_atf.headless.retry_count int 10 テスト実行をキャンセルする前に、エージェントがオンラインになるかどうかをインスタンスがチェックする回数
    sn_atf.headless.runner_banner_id 文字列 test_runner_banner [クライアントテストランナー] ページが正しくロードされたことを確認する要素の ID
    sn_atf.headless.runner_url 文字列 atf_test_runner.do?sysparm_nostack=true&sysparm_scheduled_tests_only=true&sysparm_headless=true [スケジュール設定済みのクライアントテストランナー] ページの URL とそのクエリパラメーター
    sn_atf.headless.secret_gid 文字列 1000 Docker コンテナのデフォルトユーザーの GID
    sn_atf.headless.secret_id 文字列 ホストマシン上の Docker シークレットの ID
    sn_atf.headless.secret_name 文字列 ホストマシン上の Docker シークレットの名前
    sn_atf.headless.secret_path 文字列 /run/secrets/<secret_name> Docker シークレットファイルが存在するパス：(詳細：https://docs.docker.com/engine/swarm/secrets/#how-docker-manages-secrets)
    sn_atf.headless.secret_uid 文字列 1000 Docker コンテナのデフォルトユーザーの UID
    sn_atf.headless.service_clean_exclude_list 文字列 インスタンスサービスのクリーンアップジョブ中に削除すべきでないサービス ID の例外。このジョブは毎晩実行され、ホスト上にあって有効期限が過ぎているサービスを削除します。
    sn_atf.headless.service_stop_deletes True/False false テスト実行の完了時に、このプロパティが true の場合、インスタンスはサービス削除要求を送信しないため、サービスとコンテナはホスト上に保持されます。デバッグに役立ちます。
    sn_atf.headless.timeout_mins int 1440 Docker サービスが自動的にシャットダウンするまでの時間 (分)
    sn_atf.headless.user_field_id 文字列 user_name ログインページのユーザー名の入力フィールドの HTML ID
    sn_atf.headless.username 文字列 インスタンスにログインするユーザー名
    sn_atf.headless.validation_id 文字列 headless_vp_validation 検証ページがロードされたことを確認する要素の ID
    sn_atf.headless.validation_page 文字列 atf_headless_validation_page インスタンスの検証ページの URL
    sn_atf.headless.vp_has_role_id 文字列 headless_vp_has_role ユーザーが正しいロールを持っていることを検証する要素の ID
    sn_atf.headless.vp_success_id 文字列 headless_vp_success ページ全体が正常にロードされたことを示す要素の ID