Flutter ServiceNow API集成插件servicenow_apis的使用

Flutter ServiceNow API集成插件servicenow_apis的使用

ServiceNow APIs

A Flutter 插件以方便访问 ServiceNow® REST API。 此包不是官方 ServiceNow 软件。

特性

支持以下 REST API：

• 表 API v2

开始使用

要使用此插件，请在 pubspec.yaml 文件中添加 servicenow_apis 作为依赖项。

flutter pub add servicenow_apis

使用方法

请查看示例代码。

示例代码

import 'package:flutter/material.dart';
import 'package:servicenow_apis/now/table/v2.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});
  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  // 创建一个 ServiceNowUser 对象，用于存储认证信息
  ServiceNowUser user = ServiceNowUser(
    instance: ServiceNowInstance(name: 'YOUR INSTANCE NAME'), // 替换为你的实例名称
    username: 'YOUR USER NAME', // 替换为你的用户名
    password: 'PASSWORD', // 替换为你的密码
  );

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Center(
        child: FutureBuilder(
          // 使用 TableApi 获取数据
          future: TableApi(user: user).getRecords(
            tableName: 'incident', // 表名
            params: {
              'sysparm_query': ServiceNowQuery.field('active').isEqualTo('true').end(), // 查询条件
              'sysparm_limit': '3' // 限制结果数量
            },
          ),
          builder: (context, snapshot) {
            if (snapshot.hasData) {
              // 如果有数据，则展示数据列表
              return ListView(
                children: [
                  for (var record in snapshot.data!.body.records)
                    ListTile(
                      title: Text(record.fields['short_description']), // 显示短描述
                      subtitle: Text(record.fields['number']), // 显示编号
                    )
                ],
              );
            }
            // 如果还在加载中，则显示进度指示器
            return const CircularProgressIndicator();
          },
        ),
      ),
    );
  }
}