使用说明
ServiceNow目录管理器
在ServiceNow中实现软件目录和许可证的自动化管理。
📁 项目结构
servicenow-mcp-v2/
├── config/ # Configurações do projeto
│ ├── __init__.py
│ ├── settings.py # Configurações principais
│ ├── .env.example # Template de variáveis de ambiente
│ └── requirements.txt # Dependências Python
│
├── data_manager/ # Gerenciamento de dados
│ ├── __init__.py
│ ├── managers/ # Managers específicos
│ │ └── __init__.py
│ ├── servicenow_catalog_manager.py # Gerenciador de catálogo
│ ├── servicenow_ui_policies.py # Gerenciador de UI Policies
│ └── utils.py # Utilitários
│
├── tasks/ # Tarefas automatizadas
│ └── __init__.py
│
├── scripts/ # Scripts de instalação e setup
│ └── install.sh # Script de instalação
│
├── docs/ # Documentação
│ ├── README.md # Documentação completa
│ ├── START_HERE.md # Guia de início
│ ├── QUICKSTART.md # Guia rápido
│ ├── CATALOG_ITEMS_DETAIL.md # Detalhes dos itens
│ ├── RESUMO_EXECUTIVO.md # Resumo executivo
│ └── INDICE.md # Índice
│
├── servicenow-mcp/ # Biblioteca MCP
│ └── ...
│
├── .gitignore # Arquivos ignorados pelo Git
└── README.md # Este arquivo
🚀 快速入门(3个命令)
# 1. Setup automático (instala tudo)
bash setup.sh
# 2. Configurar credenciais
nano config/.env # Preencher com credenciais ServiceNow
# 3. Executar
python run.py --all
完整详情: 看看 INSTALLATION.md(安装指南.md)
📚 文档
所有文件都在文件夹里 docs/:
- docs/START_HERE.md 翻译为中文是:docs/从这里开始.md(或“docs/入门指南.md”,具体翻译可能根据上下文有所调整) - 从这里开始!
- docs/README.md(文件说明/读我文件.md) - 完整的文件资料
- docs/QUICKSTART.md 翻译为中文是:docs/快速入门指南.md - 15-20分钟快速指南
- 文件:docs/CATALOG_ITEMS_DETAIL.md(或可译为“文档:目录项详情.md”) - 技术细节
- docs/RESUMO_EXECUTIVO.md 翻译为中文是:docs/执行摘要.md - 高层视角/管理视角
🎯 这个项目的作用
在ServiceNow中自动创建:
✅ 5个类别 按等级组织的
✅ 18项目录条目 软件和许可证
✅ 60+个自定义字段 (变量)
✅ 表示“正确”或“已完成”。 5组验证 (用户界面策略)
创建的类别
- 银行软件 - 国家银行软件
- 政府软件 - 政府体系
- 微软许可证 - Office、Power Platform 等。
- 企业软件 - 各种软件
🔧 主要组件
数据管理器
servicenow_catalog_manager.py- 管理类别、项目和变量的创建servicenow_ui_policies.py- 配置验证和业务规则utils.py- 共享实用功能
配置
settings.py- 项目的集中配置.env- 环境变量(凭据)requirements.txt- Python 依赖项
脚本
install.sh- 交互式安装菜单
📊 使用的技术
- Python 3.11+ - 主要语言
- ServiceNow MCP(注:MCP在此处可能代表某个特定的认证、计划或模块,但根据上下文无法确定具体含义,因此直接保留原英文缩写) - 集成库
- 请求: - HTTP客户端
- Pydantic - 数据验证
- Python-dotenv - Gerenciamento de env vars
🔐 凭证设置
编辑文件 config/.env:
# ServiceNow Configuration
SERVICENOW_INSTANCE_URL=https://sua-instancia.service-now.com
SERVICENOW_USERNAME=seu-usuario
SERVICENOW_PASSWORD=sua-senha
SERVICENOW_AUTH_TYPE=basic
🧪 测试
# Testar conexão
cd servicenow-mcp
python scripts/test_connection.py
📝 许可证
MIT 许可证 - 查看 许可证 以了解详情。
👥 作者
德勤 - 2025年1月
🆘 支持
如遇问题或疑问,请咨询:
- docs/README.md(文件名保持不变,中文环境下通常仍直接使用原文件名,但可理解为“文档/README.md”) - 完整的文件资料
- docs/QUICKSTART.md(可译为):快速入门文档/QUICKSTART.md - 故障排除
- ServiceNow-MCP/README.md - MCP库文档
版本: 1.0.0
状态: ✅ 准备就绪,可随时使用
