Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 35 additions & 0 deletions b812ceb69337a210633378917cba10bc/Readme.md
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This repo does not require a readme file. This information should be included in your pull request, or in the action itself in the form of annotations, description text, etc.

Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
# KB Broken Link Checker

### Summary
Detects **broken HTTP/HTTPS links** inside ServiceNow Knowledge Base articles.
Returns a list of affected KBs and their problematic URLs.

### Inputs
| Name | Type | Description | Default |
|------|------|-------------|----------|
| `kb_query` | String | Encoded query for filtering KB articles | `active=true^published=true` |
| `max_articles` | Integer | Number of articles to scan | 100 |
| `timeout_seconds` | Integer | Timeout per request | 5 |

### Outputs
| Name | Type | Description |
|------|------|-------------|
| `broken_links` | Array | Array of `{article_sys_id, article_number, article_title, bad_url, http_status}` |
| `count_broken` | Integer | Total broken links found |

### Example Flow Usage
1. Drag the **KB Broken Link Checker** action into your flow.
2. Set `kb_query = active=true^published=true^category=IT`.
3. Run it — outputs will show all invalid links with HTTP status codes.
4. You can chain it with an email notification or table insert to track issues.

### Test Scenario
1. Create a KB article with a bad link like `http://example.invalid/test`.
2. Run the action with `max_articles=10`.
3. Verify output contains:
```json
{
"article_number": "KB0010001",
"bad_url": "http://example.invalid/test",
"http_status": "Error: ..."
}
Loading
Loading