virtual_services_test_data

    Operations on TDM (Test Data Manager) datasets for virtual services.

    Dataset variables are referenced in transaction DSLs using ${fieldName} syntax (not Handlebars).
    Matcher name rules — MUST follow these exactly or matching will fail:
      - URL path with ${fieldName}: matcherName MUST be "equals_url". Never use "matches_url" with variables.
        Example: path "/users/${id}", matcherName "equals_url", matchingValue "/users/${id}"
      - Headers, query params, cookies: matcherName must be "equals" or "equals_insensitive".
        "contains", "matches", "not_matches" do NOT work with dataset variables.
      - Body (plain text): matcherName "equals"
      - Body (JSON): "equals_json" (variables embedded as JSON values e.g. {"id": "${id}"}) and
        "equals_xml" are the ONLY body matchers that get an auto-populated sampleBody. "matches_json"
        with equalTo() helper e.g. [[$.field, equalTo(${id})]] does NOT get a sampleBody — prefer
        equals_json/equals_xml when a request payload should be preserved as the sample body.
      - Body (XML): matcherName "equals_xml" or "matches_xml" with matching() helper
      - Path matchers (matches_json/matches_xml): ONE [[path, fn(arg)]] pair per matcher, where fn is
        equalTo(value) or matching(regex) and the argument is written WITHOUT quotes (quotes are matched
        literally). To check several paths, use one matcher per path.
      - matchingValue/sampleBody on body matchers are supplied as plain text — the
        virtual_services_http_transaction tool base64-encodes/decodes them automatically on
        create/update/read/list. Do NOT base64-encode them yourself before calling that tool.
      - Response content: base64-encoded string containing ${fieldName} — variables resolve at runtime.
    Additional rules:
      - If the same variable appears multiple times in one transaction (e.g. /test/${id}/${id}?q=${id}),
        ALL occurrences must match the SAME value in the incoming request.
      - Variables not defined in the dataset are treated as literal strings — the request must contain
        the exact text "${varName}" to match.
    Note: Handlebars ({{...}}) is separate — it is for dynamic response templating, not dataset substitution.

    Actions:
    - create_from_schema: Create a dataset by defining entities with field names and generator
        expressions. Supported generators include sequenceGenerator(start), randInt(min,max),
        randText(minLen,maxLen), randDate(min,max), guid(), regExp(pattern), and 80+ others.
        See https://help.blazemeter.com/docs/guide/test-data-generator-functions.html
        args(dict):
            workspace_id (int): Mandatory.
            service_id (int): Mandatory.
            service_name (str): Mandatory. Used in package/asset naming.
            entities (list): Mandatory. Each entry:
                name (str): entity name.
                fields (list): each {name: str, generator: str}.
                repeat (int, default=1000): rows to generate.
            global_variables (dict, optional): flat str→str map of global variables.

    - create_from_csv: Create a dataset from a local CSV file. Column headers become field names;
        the entity name is derived as "{stem}_csv" (e.g. accounts.csv → entity "accounts_csv").
        Generators use valueOfCSV("{filename}", "{field}") — values are sampled from CSV rows at runtime.
        args(dict):
            workspace_id (int): Mandatory.
            service_id (int): Mandatory.
            service_name (str): Mandatory.
            csv_file_path (str): Mandatory. Absolute local path to the CSV file.
            global_variables (dict, optional): flat str→str map of global variables.

    - list: List data-model assets in a workspace (TDM assets endpoint, type=data-model).
        args(dict):
            workspace_id (int): Mandatory.
            limit (int, default=50): max results.
            offset (int, default=0): skip count.

    - read: Read a data-model asset by service. Fetches with full content (withData=true).
        args(dict):
            workspace_id (int): Mandatory.
            service_id (int): Mandatory.
            service_name (str): Mandatory.

    - update: Update an existing schema-based data-model by replacing its entities/fields. Use this
        when the dataset was created with create_from_schema.
        args(dict):
            workspace_id (int): Mandatory.
            service_id (int): Mandatory.
            service_name (str): Mandatory.
            entities (list): Mandatory. Full new entity list (same format as create_from_schema).
            global_variables (dict, optional): flat str→str map of global variables.

    - update_from_csv: Update an existing CSV-based data-model from a local CSV file. Use this
        when the dataset was created with create_from_csv. Rebuilds the entity with valueOfCSV
        generators. Optionally renames entity fields via field_mappings (e.g. when the entity field
        name should differ from the CSV column name).
        By default only the data-model JSON is updated (field rename / mapping change).
        Set upload_csv=true only when the CSV file content itself has changed.
        args(dict):
            workspace_id (int): Mandatory.
            service_id (int): Mandatory.
            service_name (str): Mandatory.
            csv_file_path (str): Mandatory. Absolute local path to the CSV file (used for headers).
            field_mappings (list, optional): rename CSV columns to different entity field names.
                Each entry: {name: str (entity field name), csv_column: str (CSV column name)}.
                Example: [{"name": "account_name2", "csv_column": "account_name"}]
            upload_csv (bool, default=false): set true to re-upload the CSV file content.
            global_variables (dict, optional): flat str→str map of global variables.

    TdmAsset Schema:
    {'additionalProperties': True, 'properties': {'id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Asset id (UUID)', 'title': 'Id'}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Asset name', 'title': 'Name'}, 'displayName': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Asset display name', 'title': 'Displayname'}, 'type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Asset type: data-model, mock-svc, global-entity', 'title': 'Type'}, 'packageId': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Package id this asset belongs to', 'title': 'Packageid'}, 'content': {'anyOf': [{}, {'type': 'null'}], 'default': None, 'description': 'Parsed data-model content (present when withData=true)', 'title': 'Content'}}, 'title': 'TdmAsset', 'type': 'object'}