Donghai’s Blog

我的Git常用命令清单

Wed, 02 Sep 2026 00:00:00 GMT

图例#

git图例

安装#

创建新仓库#

Terminal window

1
# 创建一个项目目录
2
mkdir example-project
3
cd example-project
4

5
# 进行git初始化
6
git init

配置#

.gitconfig —> 用户目录下（全局配置），也可以在项目目录下（项目配置）

Terminal window

1
# 显示当前的git配置
2
git config --list
3

4
# 编辑git配置文件
5
git config -e [--global]
6

7
# 设置提交代码是的用户信息
8
git config [--global] user.name "[name]"
9
git config [--global] user.email "[email address]"

新添/删除文件#

Terminal window展开收起

1
# 添加指定文件到暂存区
2
git add [file1] [file2] ...
3

4
# 添加指定目录到暂存区，包括子目录
5
git add [dir]
6

7
# 添加当前目录的所有文件到暂存区
8
git add .
9

10
# 添加每个变化前，都会要求确认
11
# 对于同一个文件的多处变化，可以实现分次提交
12
git add -p
13

14
# 删除工作区文件，并且将这次删除放入暂存区
15
git rm [file1] [file2] ...
16

17
# 停止追踪指定文件，但该文件会保留在工作区
18
git rm --cached [file]
19

20
# 改名文件，并且将这个改名放入暂存区
21
git mv [file-original] [file-renamed]

展开收起

代码提交#

Terminal window展开收起

1
# 提交暂存区到仓库区
2
git commit -m [message]
3

4
# 提交暂存区的指定文件到仓库区
5
git commit [file1] [file2] ... -m [message]
6

7
# 提交工作区自上次commit之后的变化，直接到仓库区
8
git commit -a
9

10
# 提交时显示所有diff信息
11
git commit -v
12

13
# 使用一次新的commit，替代上一次提交
14
# 如果代码没有任何新变化，则用来改写上一次commit的提交信息
15
git commit --amend -m [message]
16

17
# 重做上一次commit，并包括指定文件的新变化
18
git commit --amend [file1] [file2] ...

展开收起

分支#

Terminal window展开收起

1
# 列出所有本地分支
2
git branch
3

4
# 列出所有远程分支
5
git branch -r
6

7
# 列出所有本地分支和远程分支
8
git branch -a
9

10
# 新建一个分支，但依然停留在当前分支
11
git branch [branch-name]
12

13
# 新建一个分支，并切换到该分支
14
git checkout -b [branch]
15

16
# 新建一个分支，指向指定commit
17
git branch [branch] [commit]
18

19
# 新建一个分支，与指定的远程分支建立追踪关系
20
git branch --track [branch] [remote-branch]
21

22
# 切换到指定分支，并更新工作区
23
git checkout [branch-name]
24

25
# 切换到上一个分支
26
git checkout -
27

28
# 建立追踪关系，在现有分支与指定的远程分支之间
29
git branch --set-upstream [branch] [remote-branch]
30

31
# 合并指定分支到当前分支
32
git merge [branch]
33

34
# 选择一个commit，合并进当前分支
35
git cherry-pick [commit]
36

37
# 删除分支
38
git branch -d [branch-name]
39

40
# 删除远程分支
41
git push origin --delete [branch-name]
42
git branch -dr [remote/branch]

展开收起

远程同步#

Terminal window展开收起

1
# 下载远程仓库的所有变动
2
git fetch [remote]
3

4
# 显示所有远程仓库
5
git remote -v
6

7
# 显示某个远程仓库的信息
8
git remote show [remote]
9

10
# 增加一个新的远程仓库，并命名
11
git remote add [shortname] [url]
12

13
# 取回远程仓库的变化，并与本地分支合并
14
git pull [remote] [branch]
15

16
# 上传本地指定分支到远程仓库
17
git push [remote] [branch]
18

19
# 强行推送当前分支到远程仓库，即使有冲突
20
git push [remote] --force
21

22
# 推送所有分支到远程仓库
23
git push [remote] --all

展开收起

撤销#

Terminal window展开收起

1
# 恢复暂存区的指定文件到工作区
2
git checkout [file]
3

4
# 恢复某个commit的指定文件到暂存区和工作区
5
git checkout [commit] [file]
6

7
# 恢复暂存区的所有文件到工作区
8
git checkout .
9

10
# 重置暂存区的指定文件，与上一次commit保持一致，但工作区不变
11
git reset [file]
12

13
# 重置暂存区与工作区，与上一次commit保持一致
14
git reset --hard
15

16
# 重置当前分支的指针为指定commit，同时重置暂存区，但工作区不变
17
git reset [commit]
18

19
# 重置当前分支的HEAD为指定commit，同时重置暂存区和工作区，与指定commit一致
20
git reset --hard [commit]
21

22
# 重置当前HEAD为指定commit，但保持暂存区和工作区不变
23
git reset --keep [commit]
24

25
# 新建一个commit，用来撤销指定commit
26
# 后者的所有变化都将被前者抵消，并且应用到当前分支
27
git revert [commit]
28

29
# 暂时将未提交的变化移除，稍后再移入
30
git stash
31
git stash pop

展开收起

生成一个可供发布的压缩包#

Terminal window

1
git archive

C# 技术备忘 - LINQ

Mon, 24 Aug 2026 00:00:00 GMT

准备示例数据源#

本地创建控制台应用程序，添加数据源。

1
using System;
2
using System.Collections.Generic;
3
using System.Linq;
4

5
namespace DaikinITC.D365.Sample
6
{
7
    public class Program
8
    {
9
        static void Main(string[] args)
10
        {
11
            // [!code ++:12]
12
            // 准备一个学生列表作为数据源
13
            List<Student> students = new List<Student>
14
            {
15
                new Student { Id = 1, Name = "张三", Age = 20, Class = "软件工程1班", Score = 85, Balance = 50.5m },
16
                new Student { Id = 2, Name = "李四", Age = 22, Class = "软件工程2班", Score = 92, Balance = 120.0m },
17
                new Student { Id = 3, Name = "王五", Age = 21, Class = "软件工程1班", Score = 78, Balance = null },  // 没开通
18
                new Student { Id = 4, Name = "赵六", Age = 23, Class = "软件工程3班", Score = 88, Balance = 30.0m },
19
                new Student { Id = 5, Name = "孙七", Age = 20, Class = "软件工程2班", Score = 95, Balance = 200.0m },
20
                new Student { Id = 6, Name = "周八", Age = 22, Class = "软件工程1班", Score = 60, Balance = null },  // 没开通
21
            };
22
            Console.ReadKey();
23
        }
24
    }
25
    // [!code ++:8]
26
    public class Student
27
    {
28
        public int Id { get; set; }
29
        public string Name { get; set; }
30
        public int Age { get; set; }
31
        public string Class { get; set; }
32
        public int Score { get; set; }
33
        public decimal? Balance { get; set; } // 饭卡余额
34
    }
35
}

展开收起

#1 两种语法#

查询表达式（类似SQL）

1
var result = from s in students
2
             where s.Age > 21
3
             select s;

Lambda表达式 *掌握，项目经常使用

1
var result = students.Where(s => s.Age > 21);

#2 查询#

where#

1
// 过滤（Where）—— 找出年龄大于21岁的学生
2
var temp1 = students.Where(x => x.Age > 21);

select#

1
// 选择（Select）—— 只取出姓名和分数，生成新对象
2
var temp2 = students.Select(s => new { s.Name, s.Score });

selectMany#

#3 排序#

方法	排序方向	说明
`OrderBy`	升序	对集合进行升序排序（从小到大）
`OrderByDescending`	降序	对集合进行降序排序（从大到小）
`ThenBy`	升序	在已有排序基础上，进行后续升序排序
`ThenByDescending`	降序	在已有排序基础上，进行后续降序排序

1
// 按分数升序
2
var sorted2 = students.OrderBy(x => x.Score);
3

4
// 按分数降序
5
var sorted1 = students.OrderByDescending(x => x.Score);
6

7
// 先按班级升序，再按分数降序
8
var multiSort = students.OrderBy(x => x.Class).ThenByDescending(x => x.Score);

#4 聚合方法（Count, Sum, Average, Max, Min）#

1
var stdCount = students.Count();
2
Console.WriteLine($"一共有 {stdCount} 位学生");
3

4
var totalBalance = students.Sum(x => x.Balance);
5
Console.WriteLine($"这些学生的饭卡余额一共是 {totalBalance}");
6

7
var avgScore = students.Average(s => s.Score);
8
var maxScore = students.Max(s => s.Score);
9
var minScore = students.Min(s => s.Score);
10
Console.WriteLine($"平均分: {avgScore}, 最高分: {maxScore}, 最低分: {minScore}");

#5 条件判断#

方法	返回类型	说明	使用场景
`All`	`bool`	判断所有元素是否都满足指定条件	检查全员达标、
`Any`	`bool`	判断是否存在元素满足指定条件	（或集合是否为空）
`Contains`	`bool`	判断集合中是否包含指定的特定元素	检查某个对象是否在集合中

All#

1
// 1. 所有学生都及格了吗？（>= 60分）
2
bool allPassed = students.All(s => s.Score >= 60);
3
Console.WriteLine($"所有学生都及格: {allPassed}");
4

5
// 2. 所有学生都超过80分了吗？
6
bool allOver80 = students.All(s => s.Score >= 80);
7

8
// 3. 所有学生都满18岁了吗？
9
bool allAdult = students.All(s => s.Age >= 18);
10
Console.WriteLine($"所有学生都成年: {allAdult}");

Any#

1
// 1. 判断集合是否有元素（比 Count() > 0 高效）
2
bool hasStudents = students.Any();
3
Console.WriteLine($"集合有学生吗: {hasStudents}");
4

5
// 2. 判断是否有学生超过90分
6
bool hasHighScore = students.Any(s => s.Score > 90);
7
Console.WriteLine($"有超过90分的学生吗: {hasHighScore}");
8

9
// 3. 判断是否有不及格的学生
10
bool hasFailed = students.Any(s => s.Score < 60);
11
Console.WriteLine($"有不及格的学生吗: {hasFailed}");

Contains#

1
// 1. 基本类型 Contains
2
var ids = new List<int> { 1, 2, 3, 4, 5 };
3
Console.WriteLine($"包含 3: {ids.Contains(3)}");    // True
4
Console.WriteLine($"包含 10: {ids.Contains(10)}");  // False
5

6
var names = new List<string> { "张三", "李四", "王五" };
7
Console.WriteLine($"包含 '张三': {names.Contains("张三")}");  // True
8
Console.WriteLine($"包含 '赵六': {names.Contains("赵六")}");  // False
9

10
// 2. 引用类型 Contains（需要实现 IEquatable 或重写 Equals）
11
var targetStudent = students.First(s => s.Id == 2);
12
bool containsTarget = students.Contains(targetStudent);
13
Console.WriteLine($"包含李四吗: {containsTarget}");  // True
14

15
// 3. Contains 用于字符串列表
16
var classNames = new List<string> { "软件工程1班", "软件工程2班", "软件工程3班" };
17
bool hasClass = classNames.Contains("软件工程1班");
18
Console.WriteLine($"有软件工程1班吗: {hasClass}");  // True

展开收起

#6 分组和连接（Join）#

（2026-08-24 14:52<28> 补充）

方法	类型	说明
`GroupBy`	分组	根据指定的键对集合元素进行分组
`Join`	连接（内连接）	基于匹配键关联两个集合，类似 SQL INNER JOIN
`GroupJoin`	连接（分组连接）	关联两个集合并将结果分组，类似 SQL LEFT JOIN

GroupBy#

根据指定的键对集合元素进行分组

1. 基础分组：按班级分组#

1
var groupsByClass = students.GroupBy(s => s.Class);
2
foreach (var group in groupsByClass)
3
{
4
    Console.WriteLine($"班级: {group.Key}");
5
    foreach (var student in group)
6
    {
7
        Console.WriteLine($"  {student.Name} - {student.Score}分");
8
    }
9
}

2.分组 + 聚合统计#

1
var classStats = students.GroupBy(s => s.Class)
2
             .Select(g => new {
3
                 ClassName = g.Key,
4
                 Count = g.Count(),
5
                 AvgScore = g.Average(s => s.Score),
6
                 MaxScore = g.Max(s => s.Score),
7
                 MinScore = g.Min(s => s.Score)
8
             });
9
foreach (var stat in classStats)
10
{
11
    Console.WriteLine($"{stat.ClassName}: {stat.Count}人, 平均分{stat.AvgScore:F1}, " +
12
        $"最高{stat.MaxScore}, 最低{stat.MinScore}");
13
}

3.分组 + 筛选#

1
// （只显示平均分大于80的班级）
2
var highClass = students.GroupBy(s => s.Class)
3
                        .Where(g => g.Average(s => s.Score) > 80)
4
                        .Select(g => new { g.Key, AvgScore = g.Average(s => s.Score) });
5
foreach (var hc in highClass)
6
{
7
    Console.WriteLine($"{hc.Key}: 平均分{hc.AvgScore:F1}");
8
}

4.多键分组（按班级和年龄分组）#

1
var multiGroup = students.GroupBy(s => new { s.Class, s.Age });
2
foreach (var group in multiGroup)
3
{
4
    Console.WriteLine($"班级: {group.Key.Class}, " +
5
        $"年龄: {group.Key.Age}, 人数: {group.Count()}");
6
}

Join#

基于匹配键关联两个集合，类似 SQL INNER JOIN。

调整关联数据：

1
var classes = new List<Class>
2
{
3
    new Class { Id = 1, ClassName = "软件工程1班", Teacher = "王老师" },
4
    new Class { Id = 2, ClassName = "软件工程2班", Teacher = "李老师" },
5
    new Class { Id = 3, ClassName = "软件工程3班", Teacher = "张老师" },
6
};
7

8
public class Class
9
{
10
    public int Id { get; set; }
11
    public string ClassName { get; set; }
12
    public string Teacher { get; set; }
13
}
14

15
// 修改 Student 类，添加 ClassId
16
public class Student
17
{
18
    public int Id { get; set; }
19
    public string Name { get; set; }
20
    public int Age { get; set; }
21
    public int ClassId { get; set; }  // 外键
22
    public string Class { get; set; } // 保留原字段
23
    public int Score { get; set; }
24
    public decimal? Balance { get; set; }
25
}

展开收起

Join - 内连接（查询语法）#

1
var querySyntax = from s in students
2
                  join c in classes on s.ClassId equals c.Id
3
                  select new
4
                  {
5
                      s.Name,
6
                      s.Score,
7
                      c.ClassName,
8
                      c.Teacher
9
                  };
10
foreach (var item in querySyntax)
11
{
12
    Console.WriteLine($"{item.Name} - {item.ClassName} - 班主任: {item.Teacher}");
13
    //张三 - 软件工程1班 - 班主任: 王老师
14
    //李四 - 软件工程2班 - 班主任: 李老师
15
    //王五 - 软件工程1班 - 班主任: 王老师
16
    //赵六 - 软件工程3班 - 班主任: 张老师
17
    //孙七 - 软件工程2班 - 班主任: 李老师
18
    //周八 - 软件工程1班 - 班主任: 王老师
19
}

展开收起

Join - 内连接#

1
var methodSyntax = students.Join(classes,
2
                     s => s.ClassId,  // 左表外键
3
                     c => c.Id,       // 右表主键
4
                     (s, c) => new {  // 结果投影
5
                         s.Name,
6
                         s.Score,
7
                         c.ClassName,
8
                         c.Teacher
9
                     });
10
foreach (var item in methodSyntax)
11
{
12
    Console.WriteLine($"{item.Name} - {item.ClassName} - {item.Score}分");
13
    //张三 - 软件工程1班 - 85分
14
    //李四 - 软件工程2班 - 92分
15
    //王五 - 软件工程1班 - 78分
16
    //赵六 - 软件工程3班 - 88分
17
    //孙七 - 软件工程2班 - 95分
18
    //周八 - 软件工程1班 - 60分
19
}

展开收起

Join + 条件过滤#

1
var filteredJoin = students.Join(classes,
2
                     s => s.ClassId,
3
                     c => c.Id,
4
                     (s, c) => new { s, c })
5
               .Where(x => x.s.Score > 80)
6
               .Select(x => new {
7
                   x.s.Name,
8
                   x.s.Score,
9
                   x.c.ClassName,
10
                   x.c.Teacher
11
               });

GroupJoin（分组连接）#

GroupJoin - 基本用法（查询语法）#

1
var groupQuery = from c in classes
2
                 join s in students on c.Id equals s.ClassId into studentGroup
3
                 select new
4
                 {
5
                     ClassName = c.ClassName,
6
                     Teacher = c.Teacher,
7
                     Students = studentGroup,
8
                     StudentCount = studentGroup.Count()
9
                 };
10

11
foreach (var item in groupQuery)
12
{
13
    Console.WriteLine($"班级: {item.ClassName} ({item.Teacher}) - " +
14
        $"学生数: {item.StudentCount}");
15
    foreach (var student in item.Students)
16
    {
17
        Console.WriteLine($"  {student.Name} - {student.Score}分");
18
    }
19
}

展开收起

GroupJoin - 方法语法#

1
var groupMethod = classes.GroupJoin(
2
    students,
3
    c => c.Id,           // 左表主键
4
    s => s.ClassId,      // 右表外键
5
    (c, studentGroup) => new {
6
        ClassName = c.ClassName,
7
        Teacher = c.Teacher,
8
        Students = studentGroup,
9
        AvgScore = studentGroup.Average(s => s.Score)
10
    });
11
foreach (var item in groupMethod)
12
{
13
    Console.WriteLine($"{item.ClassName} - 平均分: {item.AvgScore:F1}");
14
}

GroupJoin + 处理空组#

1
var groupWithEmpty = classes.GroupJoin(
2
    students,
3
    c => c.Id,
4
    s => s.ClassId,
5
    (c, studentGroup) => new {
6
        ClassName = c.ClassName,
7
        Students = studentGroup.DefaultIfEmpty(),  // 无学生时返回默认值
8
        HasStudents = studentGroup.Any()
9
    });
10
foreach (var item in groupWithEmpty)
11
{
12
    Console.WriteLine($"{item.ClassName}: {(item.HasStudents ? "有学生" : "无学生")}");
13
}

#7 集合转换#

（2026-08-24 16:12<06> 补充）

这些方法把查询结果立即执行并转换成不同数据类型。

方法	描述
`ToList`	将实现了`IEnumerable<T>`接口的集合转换为一个`List<T>`类型的对象，属于将集合转换为特定类型列表的方法
`ToArray`	将一个实现了`IEnumerable<T>`接口的集合转换为一个数组，属于将集合转换为数组类型的方法
`ToDictionary`	将一个`IEnumerable<T>`集合转换为一个`Dictionary<TKey,TValue>`键值对集合（字典）的方法，注意 `ToDictionary` 要求键唯一，否则抛出异常
`ToLookup`	将一个`IEnumerable<T>`集合转换为一个泛型`Lookup<TKey,TElement>`，`Lookup<TKey,TElement>`一个一对多字典，用于将键映射到值的集合

ToList() - 转成 List#

1
var students = new List<Student>
2
{
3
    new Student { Id = 1, Name = "张三", Age = 20, Score = 85, Balance = 50.5m },
4
    new Student { Id = 2, Name = "李四", Age = 22, Score = 92, Balance = 120.0m },
5
    new Student { Id = 3, Name = "王五", Age = 21, Score = 78, Balance = null },
6
};
7

8
// ToList - 立即执行，生成新的 List
9
var highScoreList = students.Where(s => s.Score >= 80).ToList();
10
Console.WriteLine($"高分学生数: {highScoreList.Count}");  // 输出：2
11

12
// 关键：ToList 会立即执行并固化结果
13
var filtered = students.Where(s => s.Age > 20);
14
students.Add(new Student { Id = 4, Name = "赵六", Age = 25, Score = 88 });  // 后添加
15
// 延迟执行：filtered 会包含赵六
16
Console.WriteLine($"延迟执行数量: {filtered.Count()}");  // 输出：3（李四、王五、赵六）
17

18
var filteredToList = students.Where(s => s.Age > 20).ToList();
19
students.Add(new Student { Id = 5, Name = "孙七", Age = 24, Score = 90 });  // 再添加
20
// ToList 已固化：不包含孙七
21
Console.WriteLine($"ToList固化数量: {filteredToList.Count}");  // 输出：3（李四、王五、赵六）

展开收起

ToArray() - 转成数组#

1
// ToArray - 转成数组
2
var highScoreArray = students.Where(s => s.Score >= 80).ToArray();
3
Console.WriteLine($"数组类型: {highScoreArray.GetType()}");  // 输出：Student[]
4
Console.WriteLine($"数组长度: {highScoreArray.Length}");     // 输出：2
5

6
// 使用场景：需要数组的索引访问
7
for (int i = 0; i < highScoreArray.Length; i++)
8
{
9
    Console.WriteLine($"第{i}个高分学生: {highScoreArray[i].Name}");
10
}

ToDictionary() - 转成字典（常用）#

1
// ToDictionary - 把集合转成字典，必须指定唯一的 Key
2
try
3
{
4
    // 用 Id 作为 Key（唯一）
5
    var dictById = students.ToDictionary(s => s.Id);
6
    Console.WriteLine($"字典数量: {dictById.Count}");
7

8
    // 通过 Key 快速查找（O(1) 时间复杂度）
9
    var student = dictById[2];
10
    Console.WriteLine($"ID=2的学生: {student.Name}");  // 输出：李四
11

12
    // 遍历字典
13
    foreach (var kvp in dictById)
14
    {
15
        Console.WriteLine($"Key: {kvp.Key}, Name: {kvp.Value.Name}");
16
    }
17
}
18
catch (ArgumentException ex)
19
{
20
    Console.WriteLine($"转字典报错: {ex.Message}");  // 如果 Key 重复会报错
21
}
22

23
// 带值选择器的 ToDictionary（可以只取部分字段）
24
var dictNameAndScore = students.ToDictionary(
25
    s => s.Id,           // Key 选择器
26
    s => new { s.Name, s.Score }  // Value 选择器
27
);
28
Console.WriteLine($"学生2: {dictNameAndScore[2].Name} - {dictNameAndScore[2].Score}分");

展开收起

ToLookup() - 一对多字典（类似分组）#

1
// ToLookup - 一个 Key 对应多个值（类似分组，但可以索引）
2
var lookupByClass = students.ToLookup(s => s.Class);
3

4
// 获取某个班级的所有学生
5
var class1Students = lookupByClass["软件工程1班"];
6
Console.WriteLine($"软件工程1班学生数: {class1Students.Count()}");
7
foreach (var s in class1Students)
8
{
9
    Console.WriteLine($"  {s.Name}");
10
}
11

12
// 检查某个 Key 是否存在
13
Console.WriteLine($"是否有软件工程1班: {lookupByClass.Contains("软件工程1班")}");
14
Console.WriteLine($"是否有软件工程5班: {lookupByClass.Contains("软件工程5班")}");

使用DBeaver连接Dynamics 365 Dataverse

Mon, 24 Aug 2026 00:00:00 GMT

前置条件：为 TDS 终结点启用用户级访问控制#

参考下面的文档，到Power Platform 管理中心启用TDS

https://learn.microsoft.com/zh-cn/power-platform/admin/control-tds-settings#enable-user-level-control

Step #1 准备工作：下载JDBC#

https://mvnrepository.com/artifact/com.microsoft.sqlserver/mssql-jdbc/13.4.0.jre8

DBeaver本身不包含连接Dataverse的原生驱动，我们需要借助第三方提供的JDBC驱动来实现连接，这里我事先下载了如下jar包：

下载Microsoft JDBC Driver For SQL Server » 13.4.0.jre8

Step #2 创建数据库连接#

配置DBeaver，新建连接

在弹出的连接设置窗口中，填写以下信息：

连接方式：主机
Host：填写你的Dataverse组织URL，例如 your-org-name.crm.dynamics.cn
Database/Schema：按需添加（通常与组织名一致）
认证方式：选择 Active Directory - Password
用户名：XXX
密码：XXX

在弹出的框中输入连接信息

Step #3 配置驱动设置#

点击“编辑驱动设置”

编辑驱动设置

（1）引用 Step #1 下载的JDBC包

（2）点击“添加工件”，输入下面的信息，点击“确认”

添加工件

（3）驱动添加完后是这样的：1个JDBC包，1个“工件”，最后点击“确认”

完成驱动设置

Step #4 测试连接#

返回主连接窗口，点击“测试连接”。如果所有配置正确，DBeaver将提示连接成功

完成驱动设置

Step #5 执行查询验证#

1
select top 10 accountid from account

执行查询验证

（完）

C# 技术备忘 (1)

Wed, 19 Aug 2026 00:00:00 GMT

241228-LINQ#

LINQ语言集成查询是一系列直接将查询功能集成到 C# 语言的技术统称。

241115-错误消息列表的格式化输出#

1
using System;
2
using System.Collections.Generic;
3
using System.Linq;
4
using System.Text;
5

6
namespace ConsoleApp
7
{
8
    internal class Program
9
    {
10
        static void Main(string[] args)
11
        {
12
            // 模拟错误消息列表
13
            List<string> errorMsgList = new List<string>
14
            {
15
                "Field 'xxx1' is empty.",
16
                "Field 'xxx2' is empty.",
17
                "Field 'xxx3' is empty.",
18
                "Field 'xxx4' is empty."
19
            };
20

21
            if (errorMsgList != null && errorMsgList.Any())
22
            {
23
                // ===== 方式1：使用 StringBuilder =====
24
                Console.WriteLine("=========[方式1]=========");
25
                StringBuilder valiMesStrBui = new StringBuilder();
26
                int index = 1;
27
                foreach (string item in errorMsgList.Distinct())
28
                {
29
                    valiMesStrBui.AppendLine($"{index}.{item}");
30
                    index++;
31
                }
32
                valiMesStrBui.AppendLine("存在上述异常，请维护后再尝试提交");
33
                Console.WriteLine(valiMesStrBui.ToString());
34

35
                // ===== 方式2：使用 string.Join + LINQ Select =====
36
                Console.WriteLine("=========[方式2]=========");
37
                string errorMessages = string.Join(
38
                    Environment.NewLine,
39
                    errorMsgList.Select((string msg, int i) =>
40
                    $"{i + 1}.{msg}")) +
41
                    "\n 存在上述异常，请维护后再尝试提交";
42
                Console.WriteLine(errorMessages);
43
            }
44

45
            Console.ReadKey();
46
        }
47
    }
48
}

展开收起

两种方式对比#

特性	方式1：`StringBuilder`	方式2：`string.Join` + `LINQ`
实现方式	命令式循环（`foreach`），逐步追加字符串	函数式风格（`Select`），一次性连接
可读性	步骤清晰，容易理解，适合初学者	代码更简洁、紧凑，表达力强，符合函数式编程习惯
性能	在循环内多次追加，但`StringBuilder`保证了高效的内存使用	在`Select`中生成中间字符串集合，然后一次性连接。对于小列表，差异可忽略
索引处理	手动维护 index 变量	利用`Select`的重载，直接获取索引 i
扩展性	易于在循环中添加复杂逻辑（如条件过滤）	易于链式调用其他LINQ方法（如`Where`、`OrderBy`）
换行符使用	使用`AppendLine`，自动添加平台相关的换行符	使用`Environment.NewLine`显式指定，更明确

Dynamics 365 事件框架、事件执行管道

Fri, 31 Jul 2026 00:00:00 GMT

Dynamics 365 插件运行的“流水线”到底长什么样？

1.简介#

说插件执行管道前，我先从它的上层开始说，也就是“事件框架（Event framework）”。在使用Dynamics 365 这款产品时，除了使用它自身的标准功能外，每个公司的业务都有自己奇奇怪怪的需求，光靠标准的功能肯定不够，这个时候就需要我们写代码来扩展它，这就是事件框架，也就是 MS 官方提供给我们做这件事的基础。

我们可以把它理解成一个插件或自定义逻辑的基础，它负责做以下几件事：

让我们写代码，然后上传到系统里。不管是创建一条记录，还是更新一个订单，我们都可以在这些操作“前、中、后”添加自己的逻辑（就是我们平时说的插件或者工作流）
支持同步跑，也支持异步跑。
- 同步（Synchronous）：比如保存客户时，必须等你的校验逻辑执行完，数据才真正存进去，用户要等着
- 异步（Asynchronous）：不耽误用户操作，我们的逻辑放到后台慢慢排队执行，适合发送邮件、同步第三方系统这类不太着急的活
代码统一托管在数据库里。把写好的插件或工作流活动部署到 Dynamics 365 的数据库里，系统会自动把它同步到数据中心的所有服务器上，不用你一台一台去手动部署，省心

总结下来就是“事件框架”是 Dynamics 365 官方给我们开的一条后门，让我们能在系统核心操作发生时插入自己的业务逻辑，而且支持同步和异步两种玩法，部署也方便，是二次开发的基础。另外，Microsoft Dynamics 365 服务器和 Microsoft Outlook 客户端支持事件框架，如果你是想改页面UI、加按钮什么的，那不归事件框架管，这是前端自定义的范畴。

2.事件执行管道 Event execution pipeline#

事件执行管道说白了就是个流水线，我刚开始接触 Dynamics 365 的时候，有被这个词唬到过，现在回想起来就想笑。好了，言归正传：当我们在系统里点保存按钮时，或者代码里调用了某个更新的接口，系统就会产生一个“消息包”（里面装着我们要存的数据和要干嘛的指令），然后把这个包丢到流水线上，这条流水线有2个哥们：

Dynamics 365
我们注册的插件

大家按顺序轮流对这个“消息包”看一眼，甚至改一改，最后处理完再返回给调用的人。

Tip

只有通过组织服务和OData端点触发的事件才能触发插件，其他接口不行

体系结构和相关组件#

下图是 Microsoft Dynamics 365 平台的整体体系结构，以及同步和异步事件处理

体系结构和相关组件

事件执行管道阶段（流水线的4个阶段）#

事件管道分为多个阶段，其中有 4 个阶段可用于注册自定义开发的插件或第三方插件。在插件注册期间可以进一步在每个阶段对在该阶段中注册的多个插件进行排序（排名）

事件 Event	阶段名称 Stage name	阶段编号 Stage number	说明 Description
前期事件 Pre-Event	预验证 Pre-validation	10	这个阶段在“权限检查”之前执行，所以即使你没有操作权限，这里的代码也能跑
前期事件 Pre-Event	预操作 Pre-operation	20	在系统真正写数据库之前执行，这个阶段在事务里，报错就会全部回滚，数据不会变
平台核心操作 Platform Core Operation	主操作 MainOperation	30	系统真正执行增删改查的地方，这个阶段不让注册插件，是平台自己用的
后期事件 Post-Event	后操作 Post-operation	40	数据库已经改完了，事务还没提交

消息是怎么传递的？#

用户操作触发 —> 系统生成一个 OrganizationRequest 消息（装着数据+指令）
消息从管道一头进入
按阶段顺序依次经过：10 → 20 → 30（平台自己）→ 40
在每个阶段里，如果有多个插件，按你设置的排名（Rank）从小到大依次执行
前面的插件可以修改消息里的数据，后面拿到的就是改过之后的
走到30号阶段，平台执行真正的数据库操作
操作完成后，消息变成OrganizationResponse（响应结果）
继续传给40号阶段的插件，它们可以读取或修改响应结果
最后响应返回给调用者（用户界面或代码）

关于事务，最最容易踩坑的地方#

阶段10（预验证）：默认不在事务里。但也不是绝对的，你可以通过 IPluginExecutionContext 里的 IsInTransaction 属性来判断当前是否在事务中。
阶段20（预操作）和阶段40（后操作）：一定在事务里

1
IPluginExecutionContext executionContext = Context.PluginExecutionContext;
2
bool isInTransaction  = executionContext.IsInTransaction;
3
if (executionContext.Stage == 10)
4
{
5
    // isInTransaction --> false
6
}
7
else if (executionContext.Stage == 20 || executionContext.Stage == 40)
8
{
9
    // isInTransaction --> true
10
}

这意味着如果在阶段20或40的插件里抛出异常，那么：

整个数据库事务会回滚，数据恢复原样
平台上要干的核心操作（比如创建记录）也会被取消
已经排好队但还没执行的其他插件和工作流，也都不会跑了

（简单说就是在20或40阶段报错 = 全剧终，什么都白干）

Tip

不管你同步还是异步，插件的执行时间最长只有2分钟。超时就报System.TimeoutException。如果你的逻辑确实要跑很久，就别用插件了，考虑用工作流或者其他后台任务。这个限制只针对“沙盒”模式下的插件，大部分自己写的插件都是这种。

3.沙盒隔离、信任级别和运行监控#

沙盒是个啥？为啥要有它？#

你可以把沙盒想象成一个带护栏的儿童游乐区——插件在里面可以随便玩，但翻不过去那道墙。具体来说：

能做的事：正常调用D365的SDK，读写业务数据，跟外面一样
不能做的事：访问硬盘文件、写系统日志、改注册表、用某些网络协议（比如TCP）——这些都是被墙挡住的
一个例外：可以访问Azure云服务这类外部端点（这个门是开着的）

沙盒

为什么要这么设计？因为 D365 Online 是微软帮我们管的服务器，我们写的插件是第三方代码，万一写崩了、死循环了、把服务器搞挂了怎么办？所以放在沙盒里跑，再崩也只影响这个沙盒进程，不会把整个平台拖垮。

监控机制 PluginTypeStatistic#

微软会在运行时收集沙盒里跑的所有插件的统计数据，存在数据库的 PluginTypeStatistic 实体里。跑完大概30分钟到1小时，这些数据就会生成，我们可以通过查询接口去查看。更重要的是：系统还会看门！比如说我们在沙盒里写了个非常拉跨的插件，插件执行的时候会出现 CPU占用过高、内存超载，甚至是干脆不响应了，这个时候系统会直接把这个进程杀掉，里面正在跑的插件全部报错失败。

放心，这不是永久封杀。下次再触发这个插件时，它会正常启动运行，不会一直挂掉。另外，每个组织都有自己的进程，你家组织挂了不会影响到别家的组织（这点在 Online 多租户环境里特别重要，比如有问题的插件在开发环境上，这就不会影响到测试机或者正式机）

信任级别（Trusts）#

注册插件时，可以选择两种模式：

模式	官方术语	通俗解释
沙盒模式	部分信任（Partial Trust）	插件在带护栏的游乐场里跑，受限制但安全。
非沙盒模式	完全信任（Full Trust）	插件没有护栏，想干啥干啥，权限全开

区别：

D365 Online（在线版）：只支持沙盒模式。你必须把插件注册成沙盒，否则不让跑
D365 本地部署（On-premises）：两种都支持，你自己选。但官方强烈推荐用沙盒模式，因为更安全、有监控、在所有部署类型里都兼容

沙盒里怎么访问外部网站？#

沙盒插件可以通过HTTP和HTTPS协议访问外部网络，比如调第三方API、抓取网页数据等。但是有以下规定：

只允许HTTP和HTTPS，其他协议不行
不能访问localhost（本机回环地址），别想绕
不能用IP地址（比如 192.168.1.1），必须用域名（比如 api.example.com），因为要走DNS解析
只支持匿名认证，不支持保存用户凭据或弹窗让用户登录。所以如果你要调的外部接口需要认证，得自己把Token写死在代码里或者从配置里取

这些规定系统管理员可以进行修改，访问规则存在服务器注册表中，路径：HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSCRM\SandboxWorkerOutboundUriPattern。默认值是一长串正则表达式，它规定了哪些网址能访问、哪些不能。管理员可以根据需要修改这个值来放宽或收紧限制。不过一般开发者不需要动这个，知道有这么回事就行

（完）

了解2FA（双因素认证）

Tue, 28 Apr 2026 00:00:00 GMT

越来越多项目要求启用2FA，不得不去了解它！

概念#

2FA 即：双因素认证 <=> Two-factor authentication <=> 2FA
双因素认证就是指，通过认证同时需要两个因素的证据，例如银行卡就是最常见的双因素认证，我们必须同时提供“银行卡”、“密码”两种信息才能拿钱

2FA的核心是组合2种不同类型的验证因子，验证因子主要分为以下3类：

你知道的东西：密码、PIN码等
你拥有的东西：手机、电脑安全密钥等，通过获取一次性验证码(OTP)或确认推送通知来完成验证
你是什么：指纹、虹膜等

2FA 方案#

在实际应用中，最常用的 2FA 方案是 “密码 + 你拥有的东西”，因为生物特征（第三因素）需要特殊硬件支持，普适性稍差

方案（一）密码 + 硬件令牌#

例如银行的U盾、以前网络游戏（如DNF）的密保卡、登录GitHub或系统用的YubiKey。用户插入设备或输入设备上动态码后，再输入密码

方案（二）密码 + 手机短信验证码#

国内最常见的方案。登录时向绑定手机发送一条包含短时验证码的短信。注意：此方案安全性相对较低，因为短信可能被拦截、SIM卡可能被克隆，但胜在便捷

方案（三）密码 + 基于时间的一次性密码（TOTP）（当前主流且推荐的方案）#

这是公认较可靠的软件层面2FA方案，国际标准为RFC6238 。用户需要先在自己的手机上安装一个身份验证器App（如 Google Authenticator、Microsoft Authenticator、Authy 等）

第一步（绑定）：服务端生成一个密钥，以二维码形式展示给用户。
第二步（保存）：用户用App扫描二维码，密钥安全保存到手机（也就说这个密钥在手机和服务端上都存有了）。注意，密钥必须跟手机绑定。一旦用户更换手机，就必须生成全新的密钥
第三步（验证）：登录时，App使用密钥和当前时间戳，通过特定算法（如HMAC-SHA1）生成一个30秒或60秒（默认30秒）内有效的6-8位动态验证码。用户在有效期内，把这个动态验证码提交给服务器。服务器也使用密钥和当前时间戳，生成一个动态验证码，跟用户提交的验证码比对。只要两者不一致，就拒绝登录

TOTP的算法#

TOTP 的全称是”基于时间的一次性密码”（Time-based One-time Password），仔细看上面的步骤，我会有一个问题：App和服务端，如何保证30秒期间都得到同一个验证码？答案就是下面的这个公式：

Terminal window

1
TC = floor((unixtime(now) − unixtime(T0)) / TS)

TC —> 时间计数器
unixtime(now) —> 当前 Unix 时间戳
unixtime(T0) —> 约定的起始时间点的时间戳，默认是0，也就是1970年1月1日
TS —> 哈希有效期的时间长度，默认是30秒

因此，上面的公式就变成下面的形式

Terminal window

1
TC = floor(unixtime(now) / 30)

所以，只要在 30 秒以内，TC 的值都是一样的。前提是服务端和手机端的时间必须同步。接下来，就可以算出验证码了。

Terminal window

1
TOTP = HASH(SecretKey, TC)

上面代码中，HASH就是约定的哈希函数，默认是 SHA-1

另外，TOTP 有“硬件生成器”和“软件生成器”之分，都是采用上面的算法

（左：硬件生成器，右：软件生成器）

TOTP硬件和软件生成器

TOTP的实现（Csharp）#

（1）NuGet 引入 SimpleBase 包

（2）简单实现

1
using System;
2
using System.Security.Cryptography;
3
using SimpleBase;
4

5
public class SimpleTotp
6
{
7
    public static string Generate(string base32Secret)
8
    {
9
        // 1. 解码 Base32 密钥
10
        byte[] secret = Base32.Rfc4648.Decode(base32Secret);
11

12
        // 2. 计算时间计数器 (30秒一个窗口)
13
        long counter = DateTimeOffset.UtcNow.ToUnixTimeSeconds() / 30;
14
        byte[] counterBytes = BitConverter.GetBytes(counter);
15
        if (BitConverter.IsLittleEndian) Array.Reverse(counterBytes);
16

17
        // 3. HMAC-SHA1
18
        byte[] hash;
19
        using (var hmac = new HMACSHA1(secret))
20
        {
21
            hash = hmac.ComputeHash(counterBytes);
22
        }
23

24
        // 4. 动态截取
25
        int offset = hash[^1] & 0x0F;
26
        int code = ((hash[offset] & 0x7F) << 24) |
27
                   ((hash[offset + 1] & 0xFF) << 16) |
28
                   ((hash[offset + 2] & 0xFF) << 8) |
29
                   (hash[offset + 3] & 0xFF);
30

31
        code %= 1000000;
32
        return code.ToString("D6");
33
    }
34
}

展开收起

参考#

双因素认证（2FA）教程

（完）

初尝Github Actions

Tue, 28 Apr 2026 00:00:00 GMT

GitHub Actions 是 GitHub 提供的 CI/CD 服务，早在 2018 年 10 月就已推出，但我一直未曾使用。最近遇到一个需求（如何更优雅地部署博客），才终于想起了它。

目前我的站点放在自己的服务器上，每次都要先在本地编译，再手动打包上传到服务器，接着解压到 public 文件夹，整个过程有点繁琐。而博客的源码已经托管在 GitHub 上，我想，如果每次 push 后都能自动完成部署，那就太好了。于是研究了 Github Actions，顺便把一些内容记录下来，方便日后查阅。

Github Actions 是什么#

一个 CI/CD 流程里要做的事情可多了，比如运行测试、登录 SSH、发布应用等等。GitHub 把这些具体任务都叫作 Actions。很多基础操作，我们没必要自己造轮子，直接在 GitHub Actions 市场里搜一下就好。要是有人已经写好了，直接拿来用

Github Actions 市场：https://github.com/marketplace?type=actions

Github Actions 术语#

workflow：持续集成一次运行的过程，就是一个 workflow
job：一个 workflow 由一个或多个 jobs 构成，含义是一次持续集成的运行，可以完成多个任务
step：每个 job 由多个 step 构成，一步步完成
action：每个 step 可以依次执行一个或多个命令（action）

workflow 文件#

workflow 文件

Actions 配置文件叫 workflow 文件，放在代码根目录 .github/workflows 下，workflow 使用的是 YAML 格式，比如 deploy.yml。

Github 只要发现 .github/workflows 下有 .yml 文件就会自动允许这个文件。另外，workflow 配置文件有很多字段，详见官方文档，本文只记录这次我需要用的字段。

（1）`name`#

name字段是 workflow 的名称，如果省略该字段，默认为当前 workflow 的文件名

（2）`on`#

指定触发 workflow 的条件，通常是某些事件，GitHub Actions 也支持外部事件触发，或者定时运行

on.<push|pull_request>.<tags|branches>：指定触发事件时，可以限定分支或标签

Terminal window

1
# 只有main分支发生push事件时，才会触发 workflow
2
on:
3
  push:
4
    branches:
5
      - main

（3）`jobs`#

workflow 文件的主体是jobs字段，表示要执行的一项或多项任务。

jobs.<job_id>.name

Terminal window

1
# jobs 包含2个任务，job_id分别是 m_1_job 和 m_2_job
2
jobs:
3
  m_1_job:
4
    name: my first job
5
  m_2_job:
6
    name: my second job

jobs.<job_id>.needs

needs 字段指定当前任务的依赖关系，即运行顺序，下面这 3 个 job，job2 必须等待 job1 执行完才会执行，job3 必须等待 job1 和 job2 执行完才会执行

Terminal window

1
jobs:
2
  m_1_job:
3
    name: my first job
4
  m_2_job:
5
    name: my second job
6
    needs: [m_1_job] # [!code ++]
7
  m_3_job:
8
    name: my third job
9
    needs: [m_1_job,m_2_job] #[!code ++]

jobs.<job_id>.runs-on

指定运行所需要的虚拟机环境

Terminal window

1
# 指定它运行在 Ubuntu 最新版环境
2
runs-on: ubuntu-latest

jobs.<job_id>.steps

指定每个 Job 的运行步骤，可以包含一个或多个步骤。每个步骤都可以指定以下字段：

jobs.<job_id>.steps.name 名称
jobs.<job_id>.steps.run 命令或action
jobs.<job_id>.steps.env 环境变量
jobs.<job_id>.steps.uses 选哪个工具
jobs.<job_id>.steps.with 传递参数，with 只能用在 uses 后面（即调用第三方 Action 时）

Terminal window

1
steps:
2
  - name: 拉代码
3
    uses: actions/checkout@v4
4
  - name: 安装 Node
5
    uses: actions/setup-node@v4 # 使用 GitHub 官方提供的 setup-node 动作
6
    with:
7
      node-version: 20 # 告诉它装 Node 20 版本

我的 workflow 配置文件#

.github/workflows/deploy.yml展开收起

1
name: Deploy Blog
2

3
# 只有main分支发生push事件时，才会触发 workflow
4
on:
5
  push:
6
    branches:
7
      - main
8
jobs:
9
  build-deploy:
10
    runs-on: ubuntu-latest
11
    steps:
12
      - name: 拉代码
13
        uses: actions/checkout@v4
14
      - name: 安装 Node
15
        uses: actions/setup-node@v4
16
        with:
17
          node-version: 20
18
      - name: 安装依赖
19
        run: npm install
20
      - name: 构建
21
        run: npm run build
22
      - name: 清空服务器目录
23
        uses: appleboy/ssh-action@v1.0.3
24
        with:
25
          host: ${{ secrets.SERVER_HOST }}
26
          username: ${{ secrets.SERVER_USER }}
27
          key: ${{ secrets.SERVER_SSH_KEY }}
28
          script: |
29
            rm -rf /opt/1panel/www/sites/mgrowup.com/index/*
30
      - name: 上传文件
31
        uses: appleboy/scp-action@v0.1.7
32
        with:
33
          host: ${{ secrets.SERVER_HOST }}
34
          username: ${{ secrets.SERVER_USER }}
35
          key: ${{ secrets.SERVER_SSH_KEY }}
36
          source: "dist/*"
37
          target: "/opt/1panel/www/sites/mgrowup.com/index"

展开收起

Github仓库配置环境变量#

打开Github仓库，点击设置，在左侧找到 “Secrets and variables”

Github仓库配置环境变量

（完）

Dynamics 365集中视图/聚焦视图/Focused View

Wed, 22 Apr 2026 00:00:00 GMT

Dynamics 365 中的“聚焦视图（Focused View）”功能，是 2023 年 4 月随 2023 年第 1 发布波次正式推出的。它主要解决了用户在传统页面中需要反复切换才能查看和编辑记录的痛点：现在可以在同一页面的左侧查看记录列表，右侧查看并编辑详情，无需来回跳转。

不过，我一直没有使用这个功能。今天，有用户通过邮件反馈了一个关于聚焦视图的问题：在**合同（自定义实体）**上点击“集中视图”后没有数据，而点击“只读视图”则正常。

我起初有点疑惑：聚焦视图怎么会出现在自定义实体上？后来查阅文档后推测，大概是 2023 年 4 月系统更新时默认启用了聚焦视图，所以合同视图页上出现了该按钮。而且，这位用户平时在客户实体、联系人实体上习惯了使用聚焦视图，看到合同上也有这个按钮，便试着使用，结果却没有数据。

因此，我今天抽了点时间，想看看具体情况，顺便也深入了解一下聚焦视图。

聚焦视图（Focused View）是什么#

聚焦视图在系统中似乎有两个翻译名称：集中视图 / 聚焦视图，二者含义相同。

聚焦视图是一个集中位置，可以查看包含到期或待处理的活动，以及所有已打开的记录，而无需浏览多个屏幕，这是它最大的优点。

默认情况下，潜在顾客实体会在聚焦视图中打开。

聚焦视图（Focused View）界面长什么样#

Focused View画面

聚焦视图分为 4 个部分（位置参考上图）：

第 1 部分：切换视图，一般显示“只读视图”按钮，在三个点的地方是更多选项（导出Excel、导入Excel等按钮）
第 2 部分：视图列表操作，在这里可以搜索、筛选、排序
第 3 部分：记录列表，显示当前视图下的数据
第 4 部分：记录详情

使用聚焦视图（Focused View）的前提条件#

管理员账号
环境已启用集中视图

为环境启用集中视图（Focused View）#

（1）登录 Power Platform 管理中心

（2）选择目标环境

（3）选择设置 -》产品 -》特性

（4）在“网格和视图”部分，开启“为所有记录启用聚焦视图”开关

自定义实体添加 Focused View#

（1）打开 Power Apps

（2）选择目标实体 -》选择目标视图 -》点击组件

点击组件按钮

（3）在组件中搜索“集中视图”，添加它

（4）然后点击“保存”

添加集中视图组件

（5）发布，发布之后可以到对应的实体上点击“集中视图”看看效果

所以用户和我反馈的问题原因就是没有为视图配置 Focused View 导致的

自动刷新记录#

请参考：

https://learn.microsoft.com/zh-cn/dynamics365/sales/set-focused-view-as-default#refresh-records-automatically

（完）

通过手动提交工单解决Bing不收录网站问题

Thu, 22 Jan 2026 00:00:00 GMT

网站接入 Bing Webmaster Tools 半年却始终不被收录？本文详细记录从排查、提交 Sitemap、URL 检查到最终通过工单解决 Bing 索引问题的完整流程，附英文工单模板和后续收录验证。

前言#

半年多前我就把网站接入了 Bing Webmaster Tools，期间一直没太关注收录情况，直到最近偶然用 Bing 搜索自己的站点，才发现一个尴尬的事实：在 Bing 里输入 site:mgrowup.com 后搜素完全搜不到自己的站点

site.com没有结果

既然发现了问题，那就看看怎么解决，也顺便把整个过程记录下来，供遇到同类问题的博友参考

一、事先已经做过的排查#

在提工单之前，其实我已经把常规能做的事情都做了一遍

1.提交站点地图（Sitemap）#

2026年1月21日，在 Bing Webmaster Tools 中提交了站点地图，站点地图状态正常，没有报错

提交站点地图

2.使用 URL 检查工具#

对首页和部分文章页进行 URL Inspection 时，发现一条关键信息：

The inspected URL is known to Bing but has some issues which are preventing indexation.

翻译：Bing 已发现该 URL，但存在某些问题导致无法索引

URL检查

3. 请求索引（Request Indexing）#

点击 “Request Indexing” 按钮（我于1月14日操作），但等待 7-8 天后状态依然无变化，常规手段无效后，决定联系官方支持

二、提交工单（Case）的完整流程#

1. 访问反馈入口#

Bing Webmaster Tools 官方反馈入口：https://www.bing.com/webmasters/urlinspection

2. 填写工单信息#

按照以下配置填写：

字段	选择/填写内容
问题类型	`Indexing`
需要哪方面帮助	`站点找不到索引`（中文界面）或类似选项
问题描述	建议用英文填写（处理更快）

英文工单模板（可直接复制使用）：

I am contacting you because my website, mgrowup.com, is not indexed in Bing.
Despite having quality content and following SEO best practices, it does not appear in search results.
I have verified that:
（1）The website is accessible with no technical issues.
（2）There are no robots.txt blocks for Bing.
（3）I have submitted a sitemap in Bing Webmaster Tools.
I would appreciate your assistance in resolving this issue. Please let me know if there are reasons for the lack of indexing.

3. 提交确认#

site.com没有结果

填写完内容后，点击 Next

系统会询问问题是否已解决，选择是，然后输入验证码，点击 Create support ticket（创建服务工单）

创建服务工单

Tip

成功提交后会看到提示： Your request has been successfully submitted..

Your request has been successfully submitted

4. 确认邮件#

提交后，注册邮箱会立即（反正很快）收到 Bing 的服务工单确认邮件，说明 Case 已进入人工处理流程

紧接着会收到服务工单邮件

三、处理时间线记录#

日期	事件	状态
2026-01-22	提交工单	等待处理
2026-01-23	工单状态更新	继续等待
2026-01-26	收到官方邮件回复	建议等待 2-3 周
2026-01-26	批量提交文章 URL	主动补充提交
2026-01-31	`site:mgrowup.com` 可检索到	收录完成

site.com 可以检索到了

四、常见问题与解决方案#

Q1: Bing Webmaster Tools 反馈入口失效怎么办？#

如果上述入口无法访问，可以从以下路径进入：

如果上面的 Bing Webmaster Tools 反馈入口失效了，可以从这里进入

Q2: 工单提交后多久会有回复？#

根据我的经验：

自动确认邮件：即时
人工回复：2-5 个工作日
实际生效：2-3 周左右

Q3: 除了提交工单，还能做什么？#

在等待期间，可以：

批量提交文章 URL
确保网站内容质量
检查 robots.txt 配置

五、番外篇：让 Bing 显示网站图标#

收录问题解决后，我发现搜索结果中仍不显示网站图标：

Bing不显示站点图标

解决方案#

如法炮制，再次提交工单：

字段	填写内容
问题类型	Crawling
需要哪方面帮助	Other
问题描述	My website has a valid favicon configuration, and the favicon is displayed correctly in Google search results, but it does not appear in Bing search results.

时间线#

日期	事件	状态
2026-01-31	提交工单	等待处理
2026-02-23	收到官方邮件回复	继续等待
2026-02-25	图标显示	图标显示

处理结果#

2026-02-25：收到 Bing 回复，图标问题已解决

Bing显示站点图标

总结#

如果你的网站遇到 Bing 不收录的问题，可以按照以下路径解决：

自查：提交 Sitemap、检查 robots.txt、使用 URL 检查工具
请求索引：通过 Webmaster Tools 手动请求
提交工单：如果前两步无效，直接联系 Bing 官方支持（用英文填写）
耐心等待：一般需要 2-3 周生效
补充优化：收录后检查图标等细节问题

Bing 的工单响应速度和解决效率其实不错，关键是要把问题描述清楚

（完）

还在手敲时间戳？Win11输入法一个技巧，秒输当前时间戳

Mon, 22 Dec 2025 00:00:00 GMT

前言#

最近经常在 共享文档 / Excel 里给用户回复问题。

很多时候需要在一个单元格里顺手补一句：

2025-12-22 10:31<08> 已联系用户
2025-12-22 14:05<42> 问题已复现

如果每次都手敲时间，或者切到别的工具复制粘贴，就很不方便。后来发现：Win11 自带的微软输入法，其实已经支持快速输入时间戳，而且配置一次，后面几乎是“肌肉记忆”。

效果展示#

配置完成后，只需要输入：

1
ndt + 空格

当前日期时间就会自动填写，整个过程不到1秒。

效果

配置步骤#

1.打开「用户自定义短语」#

在右下角任务栏，右击中 / 英文输入法图标，选择「用户自定义短语」

打开用户自定义短语

2.添加新的短语词条#

在「用户自定义短语」界面中，点击添加，填写以下内容：

拼音：ndt
在候选窗口中的位置：默认 1
短语：

1
// 标准时间戳，示例输出：2025-12-22 10:31:08
2
%yyyy%-%MM%-%dd% %HH%:%mm%:%ss%
3

4
// 中文时间格式，示例输出：2025年12月22日 10:31:08
5
%yyyy%年%MM%月%dd%日 %HH%:%mm%:%ss%

添加新的短语词条

Note

填写完成后点击「保存」，配置就生效了

注意事项#

浏览器无痕模式不生效#

如果你在 Chrome / Edge 的无痕窗口（隐私模式）里发现短语没有生效，这是正常现象

原因：浏览器无痕模式会限制输入法的用户自定义词库调用，这不是配置问题，也不是输入法坏了，换回普通窗口即可正常使用

其他可能的情况#

如果 ndt 已被其他词条占用，可以换一个拼音，比如 sjc（时间戳）、rq（日期）

短语中的时间格式变量（如 %yyyy%）区分大小写，请严格按照示例填写

配置生效后，建议重启一下正在使用的应用（如 Excel）以确保加载

（完）

工作术语备忘录（持续更新）

Sun, 21 Dec 2025 00:00:00 GMT

Table of contents#

一、借贷项#

2025/10/15 新添
第一次在项目里看到「借贷项」这个词时，我的第一反应是：
这是人用的？

直到后来我发现，它其实并不复杂，只是名字非常容易把人劝退。

借贷项到底在解决什么问题？

借和贷不是“借钱”和“还钱”，而是用来描述同一件事的两个方向。

会计世界里有一个非常重要的前提：任何一笔业务，一定同时影响至少两个东西。不可能“凭空”多出钱，也不可能“无代价”得到东西。

一个动作，两个去向

还是用最容易理解的话来讲：

一件事发生时，总要回答两个问题：

钱（或价值）变成了什么？
钱（或价值）是从哪里来的？

会计用借 / 贷，就是在给这两个问题贴标签。

借（Debit）：这笔钱 / 价值现在在哪
（Credit）：这笔钱 / 价值是从哪来的

用开小卖铺来理解借和贷
假设我在小区门口开了一家小卖铺，下面是 3 件很普通的事。

一、进货：花 100 元买 5 箱可乐

发生了什么？
我多了：5 箱可乐
我少了：100 元现金

换个角度问：
钱现在在哪？
变成了可乐
钱从哪来的？
来自我原本的存款

会计怎么记？
借：库存商品（可乐） ← 东西进来了
贷：存款 ← 钱出去了

记忆点：
东西 / 资产增加 → 记在「借」
钱的来源减少 → 记在「贷」

二、卖货：卖出 1 瓶可乐，收 5 元

发生了什么？
我少了：1 瓶可乐
我多了：5 元现金
同时，我做成了一笔生意（收入）

两个角度再看：
钱现在在哪？
变成了现金
钱从哪来的？
来自卖可乐这件事（收入）

会计怎么记？
借：现金 ← 钱进来了
贷：主营业务收入 ← 收入这个“来源”增加了
注意：成本、利润这些可以继续拆，但理解借贷本身不需要先管那么细。

三、借钱：向银行借 1 万元

发生了什么？
我多了：1 万元现金
我多了一笔：欠银行的钱

两个问题：
钱现在在哪？
在我手里（现金）
钱从哪来的？
是借来的（负债）

会计怎么记？
借：现金 ← 钱进来了
贷：银行贷款 ← 欠的钱增加了

为什么很多人一开始都学不会？因为大脑会自动这样翻译：
借 = 我借别人钱
贷 = 别人借我钱

但在会计里，这个翻译是错的，正确的理解方式是：
不要管“借钱 / 还钱”这件事，
只盯着：价值的去向和来源。

一个简单但好用的口诀
借看 “现在在哪”，贷看“从哪来的”
想不明白时，永远先问这两个问题，借贷自然就出来了。

二、什么是 VV、RV、PV 和 UV ？#

这几个词我第一次见是在需求评审 / 数据看板 / 产品周报里，最开始完全分不清谁是谁，只知道“都跟访问量有关”。后来发现，它们其实是从不同角度描述访问这件事。

VV（Visit View）：访问次数
RV（Repeat Visitor）：重复访问的用户
PV（Page View）：页面被浏览的次数
UV（Unique Visitor）：去重后的访问用户数

用逛博客来理解

假设有一天发生了这些事情：

小明 👦 今天打开了你博客 3 次
每次进来都看了 2 个页面
小红 👧 今天打开了你博客 1 次
看了 1 个页面

那么数据可以这样理解：

指标	含义	对应本例
UV	独立访客数（人）	2（小明 + 小红）
VV	访问次数（会话）	4（小明 3 次 + 小红 1 次）
PV	页面浏览量	7（小明 6 + 小红 1）
RV	重复访客	1（小明）

常见误区

UV ≠ PV，一个用户可以刷很多页面
VV ≠ UV，一个用户可以来很多次
PV 高不一定说明用户多，可能只是页面跳转多、或者内容分散

什么时候关注哪个？

产品 / 市场：更关心 UV、RV（有没有人来、会不会再来
内容 / 博客：更关心 PV（内容是否被持续阅读）
运营分析：会把 VV + UV + PV 放一起看趋势

三、Dev，SIT，UAT， Staging， Prod，DR 环境分别是意思？#

这是我在项目里最常被问、也最怕搞错的一组词。一句话：它们描述的是系统在不同阶段、给不同人用的环境

环境	全称	谁在用	用来干嘛
Dev	Development	开发	写代码、改 Bug
SIT	System Integration Test	测试 / 开发	系统集成测试
UAT	User Acceptance Test	业务 / 客户	验收是否符合需求
Staging	预生产环境	运维 / 开发	模拟正式上线
Prod	Production	真实用户	正式使用
DR	Disaster Recovery	运维	灾备、应急切换

按时间线来理解

1
写代码 → 联调 → 业务验收 → 准备上线 → 正式使用 → 灾备兜底
2
Dev      SIT      UAT         Staging     Prod        DR

（完）

XrmToolBox导出安全角色表级权限到Excel

Thu, 18 Dec 2025 00:00:00 GMT

本文介绍使用 XrmToolBox 的 Role Documenter 插件，将 Dynamics 365 安全角色的表权限快速导出 Excel ，适合系统审计与权限分析

前言#

最近公司内部在进行系统审计，需要提供一份清晰的权限说明文档，最开始的思路是直接通过SQL查询数据库导出权限数据，但考虑到SQL查询结果可读性较差，而且查询出来后还要进行二次加工，太耗费工数了！于是开始寻找现成工具，最终发现 XrmToolBox 里已经有一个非常成熟、好用的插件：Role Documenter，它可以一键导出安全角色的表级权限，并生成 Excel ，非常适合审计、权限梳理和系统交付场景

使用 Role Documenter 导出权限#

Step 1：在 XrmToolBox 中安装插件#

打开 XrmToolBox
在插件库中搜索 Role Documenter
点击下载并安装
安装完成后，在工具列表中即可看到该插件

下载 Role Documenter

Step 2：选择安全角色并导出#

打开 Role Documenter
连接到目标 Dynamics 365 / Dataverse 环境
在角色列表中选择安全角色
点击 Export

插件会自动生成一份 Excel 文件，其中包含：

每个安全角色
每个表（Entity / Table）
对应的权限级别（Create / Read / Write / Delete / Append / Append To 等）

Export

（完）

Excel 笔记

Fri, 12 Dec 2025 00:00:00 GMT

1. 删除 Excel 中的所有图片#

按 F5 打开定位器，然后点击定位条件

打开定位器

选择对象 → 点击确认 → 在 Excel 中选择图片 → 按下 Delete 键即可

通过对象定位删除图片

2. 筛选出有小数点的行#

使用 MOD / INT 函数筛选，创建辅助列公式

Terminal window

1
=MOD(A2,1)<>0
2

3
// 或者
4

5
=IF(A2=INT(A2),"整数","小数")

3. 设置往单元格粘贴URL时不自动添加“超链接”#

文件(左上角) —> 选项 —> 校对 —> “自动更正选项(A)…” —> 键入时自动套用格式 —> 取消勾选 “Internet及网络路径替换为超链接”

设置往单元格粘贴URL时不自动添加“超链接”

（完）

World 笔记

Fri, 12 Dec 2025 00:00:00 GMT

IMPORTANT

还在整理中

使用Oh My Posh美化PowerShell

Thu, 11 Dec 2025 00:00:00 GMT

我平时经常使用 Win Terminal + PowerShell，但在视觉体验上却略显单调(小黑窗)，最近在看视频时偶然发现对方使用的也是 Win Terminal + PowerShell，而且看起来很美观。

今晚搜了下相关教程，发现使用 Oh My Posh的主题就可以做到这种效果，下面是设置步骤。

设置步骤#

1.安装 Terminal#

在微软商店搜索 Windows Terminal 进行安装即可

微软商店安装Terminal

2.安装 Oh My Posh 主题#

同样地，在微软商店搜索 Oh My Posh 进行安装即可

微软商店安装Oh My Posh

3.安装 Meslo 字体#

为什么需要安装字体？→ 官方建议的，因为主题应用了各种图标，使用一般字体会显示异常。

为什么安装字体

Meslo 字体的 Github 地址：Meslo-Font

访问后到 Releases 里面下载并解压，最好安装下面 4 种字体够了（双击 tff 文件，点击安装）

xxxxx Regular.ttf → 正常字体
xxxxx Bold.ttf → 加粗
xxxxx Italic.ttf → 斜体
xxxxx Bold Italic.ttf → 加粗斜体

4.设置 PowerShell 的字体和主题#

在 Terminal 设置 PowerShell 的字体和主题

5.创建配置文件#

在 PowerShell 输入命令：

Terminal window

1
# 检查配置文件是否存在，不存在则新建
2
if (-not (Test-Path $PROFILE)) {
3
    New-Item -Path $PROFILE -Type File -Force
4
}

输入命令，打开配置文件

Terminal window

1
notepad $PROFILE

输入 Oh my posh 的配置：

在这里挑选主题：https://ohmyposh.dev/docs/themes

下面是使用 cert 主题

Terminal window

1
oh-my-posh init pwsh --config "$env:POSH_THEMES_PATH/cert.omp.json" | Invoke-Expression

（完）

mailto 链接的基础用法

Wed, 10 Sep 2025 00:00:00 GMT

记录 mailto 链接的基础用法，包括设置邮件主题、正文内容，以及通过 %0D%0A 实现正文换行，适合在博客或页面中快速生成邮件入口。

使用 mailto 参数快速生成邮件链接#

在日常写博客或制作页面时，有时会希望用户点击链接即可打开默认邮件客户端，并自动填充收件人、主题甚至正文内容。mailto 协议正好可以满足这个需求。

基础用法：生成邮件链接#

最简单的写法如下，只指定收件人邮箱地址：

1
[Email](mailto:xxx@xxx.com)

点击链接后，浏览器会调用本地默认的邮件客户端，并自动填写收件人。

设置邮件主题和正文内容#

mailto 支持通过参数的方式，预先设置邮件主题（subject）和正文内容（body），示例如下

1
[Email](mailto:recipient@example.com?subject=这是主题&body=这是邮件正文内容)

（多个参数之间使用 & 连接）

subject：邮件主题
body：邮件正文内容

正文内容如何换行？#

如果希望在邮件正文中实现换行，需要使用 URL 编码，使用 %0D%0A 即可实现换行

在 body 参数中插入 %0D%0A，即可表示一次换行。例如：

1
mailto:xxx@xxx.com?body=第一行%0D%0A第二行

（完）

XrmToolBox设置用户默认时区

Thu, 28 Aug 2025 00:00:00 GMT

详细步骤#

详细步骤如下

Step #1 XrmToolBox 安装并打开 User Settings Utility#

Open User Settings Utility

Step #2 加载用户信息#

Load User Information

Step #3 选择并勾选用户，选择时区，最后点击更新用户设置#

Update User Settings

通过SQL查询用户目前使用的时区#

另外，还可以通过下面的SQL查询用户目前使用的时区：

1
SELECT s.fullname AS UserName,
2
       s.businessunitidname AS BusinessUnit,
3
       s.domainname AS Domain,
4
       us.timezonecode AS TimeZoneCode,
5
       tz.standardname AS TimeZoneName
6
FROM   systemuser AS s
7
       INNER JOIN
8
       usersettings AS us
9
       ON s.systemuserid = us.systemuserid
10
       INNER JOIN
11
       timezonedefinition AS tz
12
       ON us.timezonecode = tz.timezonecode
13
WHERE  s.isdisabled = 0;

Query User Time Zone via SQL

SQL字段说明#

#	Field	Description
1	UserName	Full name of the user.
2	BusinessUnit	The business unit to which the user belongs.
3	Domain	The user’s domain account (e.g., `contoso\johndoe`).
4	TimeZoneCode	The numeric code that represents the time zone in Dynamics 365.
5	TimeZoneName	The standard name of the time zone (e.g., Pacific Standard Time).

（完）

2025年福建厦门和福州溜达

Mon, 19 May 2025 00:00:00 GMT

晚上好！又来记一篇流水账，这次公司团建去了厦门，节奏不赶，好吃的很多，整体体验挺好。

05-15 第一天#

晚上七点一刻落地厦门高崎机场

厦门高崎国际机场

大同鸭肉粥#

到酒店安顿好已经九点左右，肚子开始抗议。打开点评，挑了两家评分高的店，出门觅食。打车前往附近的一条老街，虽然是晚上九点多，但街上是还是挺多的，所以车开得很缓慢，等得有点不耐烦，最后让司机给我指了条近路让我步行穿过去，在小巷里拐了几下，才找到目的地

走街串巷

第一顿是鸭肉粥，没有踩雷。店在老街里，到的时候还有零星几桌。老板娘很热情，点了一碗鸭肉粥，我加了不少料：鸭腿、鱿鱼、大肠全上。

百成大同鸭肉粥 | 思明区大同路128-130号

粥熬得浓稠，鱿鱼和大肠混在里面毫不违和。鸭腿埋在粥底，肉皮吸满米香，夹起来轻轻一抿就脱骨。鱿鱼是卤过的，弹；大肠软糯，没有异味。一勺粥配一口肠，油脂香很到位，大肠爱好者必点，我强推它

百成大同鸭肉粥 | 思明区大同路128-130号

吃完沿着老街溜达了一会，街不长，这条老街清一色都是骑楼，临近十点，还是热闹

走街串巷

陈佳甜品#

第二站是陈佳甜品，刚吃得有点饱，只点了龟苓膏和西士多，一苦一甜，搭着吃刚好

陈佳甜品 | 龟苓膏、西士多

吃完甜品回酒店，洗漱，睡觉，第一天结束

05-16 第二天#

今天是“团建日”，行程满满：

早餐
08：30 ~ 10：00 赴泉州梧林
10：00 ~ 11：30 游览梧林
12：15 ~ 13：15 午餐
13：45 ~ 14：45 开元寺
14：45 ~ 15：45 西街
15：45 ~ 17：15 返回厦门
18：00 ~ 20：00 晚宴

早餐后在酒店楼下集合，大巴直奔泉州梧林

前往梧林传统村落

梧林村落

路上补了会觉，到地方精神刚好，事务组在梧林安排了两个活动。

活动一：发现#

规则：

出发泉州前，在团建群发送 3 张主题照片，主要为梧林古村落和西街某处的景点
每个小组在旅程中找到该景点拍照，照片中必须包含至少团队中 5 名成员，发送到团建群
按照提交照片顺序，5 分 → 4 分 → 3 分 → 2 分 → 1 分，分别累计小组积分

团建活动的3张主题照片

活动二：学习#

规则：

出发泉州前，在团建群发送“短语”内容
各小组在当天行程中，学习短语的闽南语发音，选择 1 名成员在当天晚宴中宣读（*选择的成员不能会闽南语）
由全体成员投票，选择第 1 名~第 5 名，按照 5 分 → 4 分 → 3 分 → 2 分 → 1 分，分别累计小组积分

我被分到 A 组，摇骰子摇成了队长（哈哈哈），到村落后兵分两路，找排水兽、找窗花，折腾了好一阵才集齐

寻找小鱼排水兽

寻找窗花

剩下“爱”字在开元寺附近，先放着吧，距离集合的时间还早，先在在村里四处转转

梧林村落

古早的墙根？

梧林村落

游览结束，集合吃午饭

午餐

活动三：照片组合短语#

下午坐着大巴车抵达泉州开元寺，开启第三个活动

规则：

从发出的 3 个短语中，选择本队任务的短语。请各队长选择短语后私聊团长
在后续旅程中发现包含短语文字的景点拍照。用照片组成短语。
在 15 点 30 分前，由队长在问卷星提交收集到的文字照片。禁止使用自行加工的文字。（问卷星只能提交一次，一旦提交视为该队任务结束）
按照提交照片顺序，5 分 → 4 分 → 3 分 → 2 分 → 1 分，分别累计小组积分

我们小组选择了“人与空气之间总有大金”，分工后又是一轮地毯式搜索

照片组合短语

这些字很好找，不到一会就找齐了，完成任务后，在开元寺里慢慢逛了一圈，先是进了大雄宝殿（里面不方便拍照），看了里面的五方佛、飞天乐伎

开元寺-大雄宝殿

这个是千年地标双塔，我分不清拍的是东塔（镇国塔）还是西塔（仁寿塔）了

开元寺

顺便补拍了“爱”字合照

寻找爱

团建活动的任务全部完成，我们组第一名，收工，随后在西街随便走走，等集合回厦门

开元寺附近的西街

提前到了酒店，但距离晚宴还有些时间，和同事在沿海的堤上溜达，吹吹海风

环岛南路

接下来就是晚宴了，做些趣味活动、发奖之类的，气氛轻松

晚餐活动

晚宴后回酒店休息，一天结束。

05-17 第三天#

今天是自由活动，我没有什么特别想去的地方，只好到处走走，边看边玩。

同安大肠血#

第一站，同安大肠血，同安大肠血是厦门思明区内主营闽南传统小吃大肠血的餐饮店，主营菜品以猪血灌入大肠熬煮为特色。

我在大众点评上搜索了一会，选了一家评分较高的店，在新华路附近（坐标：思明区新华路122-124号），点了份大肠血加小肚、另加卤大肠头。本想配一碗咸饭，可惜来得稍早（其实也快十点了），咸饭要中午才出锅，想吃咸饭的朋友建议中午前往

同安大肠血 | 思明区新华路122-124号

鼓浪屿#

吃完大肠血后，临时起意去鼓浪屿，还好东渡客运码头离得近，说走就走

东渡客运码头

因为是临时决定，没能买到即时的船票，只好买1小时后出发的班次，于是在候船厅里闲逛，消磨时间，码头二层设有观景台，视野很不错

东渡客运码头2F观景台

上了鼓浪屿后，从东渡客运码头一路走到三丘田码头，岛上感觉还行，和想象中的一样，是一座安逸的小岛

鼓浪屿海滩

鼓浪之歌

在岛上买了几盒黄胜记凤梨酥寄回家，当作伴手礼正合适

鼓浪屿黄胜记买手店

在鼓浪屿看到的人力车，已经很多年没看到过了，让我想起了老家镇上拉甘蔗出来卖的蔗农

鼓浪屿上的人力车

在街上看到了一簇开得正旺的三角梅

鼓浪屿某街角的三角梅

走了不到一小时（好像），到了三丘田码头，出岛了

鼓浪屿三丘田码头

返程的这趟船人有点多，只好坐在楼梯上

鼓浪屿出岛的船上

沙茶面#

在鼓浪屿走了不少路，出岛后肚子有点饿，准备去吃碗当地特色：沙茶面，在大众点评搜了家评分不错的店：四里沙茶面（故宫店），我点了份沙茶面，里面额外加了瘦肉、猪肝、海蛎子（一共25R），看隔壁桌在吃的凉拌鸭杂卖相不错，我也加了一份（30R）

沙茶面面是碱水面，面条爽滑劲道，汤色红亮，汤底味道蛮复杂的，我只能尝出有虾、蒜、五香粉、胡椒粉、芝麻、咖喱，红亮的汤色应该是虾煸炒出来的，总体味道很浓郁

四里沙茶面

四果汤#

吃完沙茶面后，感觉有点腻人，打算去找一碗四果汤清爽一下，我去了附近的川伯四果汤（黑市街），点了一碗四果汤（6R），冰凉的糖水飘着莲子、银耳、绿头等，吃起来很解腻，这个四果汤很像老家的清补凉

川伯四果汤

芒果冰#

我正在街边等公交车前往部门聚餐的火锅店，发现公家车后面有一家饮品店有很多人在排队，我也去凑了热闹，点了杯芒果冰，他家的果味很足，怪不得人气这么旺

坐标：松柏纯契茶·厦门市思明区屿后路209号

纯契茶芒果冰

海鲜火锅（朱富贵）#

部门聚餐是自助海鲜小火锅，这家店生意挺火，人头攒动。味道嘛，食材算是新鲜，毕竟是涮火锅，把蘸料调好后能难吃到哪儿去？

朱富贵海鲜火锅

其他#

吃完火锅后，应同事邀请去了KTV，喝了几瓶啤酒和鬼哭狼嚎了几首才尽兴而归。今天还吃了不少闽南小吃（海蛎煎、土笋冻、面线糊、花生汤），但这些没我想象的好吃，所以没拍照，明天打算去尝尝姜母鸭，希望能好吃

05-18 第四天#

姜母鸭#

最后一天了。上午自由活动，决定去尝姜母鸭。在附近找了家“阿呆姜母鸭”，进门便见一排砂锅咕嘟咕嘟炖着鸭肉。点了半只，味道确实不错，砂锅端上来芝麻油和姜香直接扑脸，鸭肉焦香、酱香重，很下饭。

今天是最后一天，下午三点半在酒店门口集合前往高崎机场，所以还有小半天的自由活动，上午在酒店收拾完后接近十一点，打算去吃姜母鸭。在大众点评搜了家评分高的姜母鸭店，选了家叫阿呆姜母鸭的店

花了20分钟，从酒店步行到了这家店，该说不说，这天气是真的热！

我点了半只姜母鸭，这道菜味道确实不错，砂锅端上来芝麻油和姜香直接扑脸，鸭肉焦香、酱香重，很下饭

阿呆姜母鸭

白鹭洲#

吃完姜母鸭后，肚子有点撑了，打算去溜达溜达，在点评上看了附近有什么好去处，推荐了附近的白鹭洲公园，步行过去也不远，后面在白鹭洲慢悠悠逛了一大圈

白鹭洲

返程#

从白鹭洲出来后便回酒店集合，出发前往机场。原定晚上七点多的航班，延误至九点多起飞，抵家时已近深夜

最后，团建圆满结束，感谢组织，团长、团建事务局！

（完）

2025年劳动节假：南宁、钦州、珠海

Mon, 05 May 2025 00:00:00 GMT

又回来记流水账了，这次假期累惨了，吃饭、赶路、见亲戚，一件接一件。

行程#

25/5/1 ：上海 → 南宁
25/5/2 ：南宁 → 钦州小董
25/5/3 ：钦州 → 广州南 → 中山
25/5/4 ：中山 → 珠海拱门
25/5/5 ：珠海
25/5/6 ：珠海 → 上海

05-01 南宁#

高铁上买了一瓶无糖酸奶，把提前洗好的蓝莓倒进去，原本没抱什么期待，结果味道还不错

路上

晚上去了琅西夜，人很多！多得让人不得不放慢脚步，小心不被推着往前走，嗦螺蛳粉，饮柠檬茶

南宁琅西夜市

螺嗦螺蛳粉，饮柠檬茶粉

05-02 钦州#

回了一趟小董，看外公外婆，他们的精神状态比我预想得要好，我们坐着聊了一会儿天。后来在街上走了一会儿，零散的宅基地、小卖部，还有不太热闹的路口，这些地方没什么变化，也不需要变化。路过九德的时候突然想喝雷公根，碰巧的是下午的雷公根没做好，这次是喝不了，可惜了。

黄九德雷公根

晚上和家里人吃饭，之后又约朋友九点多在大富烧鸡喝酒唠嗑

05-03 中山#

从钦州到广州南，再换乘去中山，老妈给宝子买了束花，只是那时候太累了，忘记拍照了，晚上下起了雨，我们坐在沙发上聊天，没有出门

05-04 珠海#

第二天起得很早，小姨和六一已经把早饭做好了。

六一作品（下厨）

早饭

吃完饭后，和六一下楼随便走走

下午打车从中山到珠海，这段路有点难熬。天气很热，空调开得很小，车顶是透明的，阳光直接落下来，让司机把空调调高一点，还要额外加钱，好在路不算长，一个小时之后，总算下了车。

下午和宝子他爸聊了会天，傍晚去了白藤头海鲜市场，到了附近的海鲜市场买了点海鲜，然后去加工店加工。市场人声鼎沸，空气里全是潮湿的海味。买好海鲜，交给加工店，花螺、螃蟹等等，一样一样端上来。

白藤头海鲜市场

白藤头海鲜市场贺富海鲜美食店

吃到很晚，回去的时候，街上已经安静了。

05-05 珠海#

宝子和她爸早早过了澳门，我因为忘记办港澳通行证，只能留在珠海这边，这小半天我只能在附件溜达了

走街串巷

看到一家肠粉店，老板娘见谁都打招呼，声音爽朗，这种店通常不会难吃，点了肠粉和馄饨，果然没失望

华记肠粉

吃完又回去睡了一觉，中午起床后，去吃生焗排骨

余美娟生焗排骨饭

下午去了情侣路，风不大，阳光也刚好废话！大阴天的！，走着走着，就有点想打盹

珠海海滨公园

珠海渔女

珠海香炉湾沙滩

傍晚去了拱北口岸等宝子，之后在附近吃了一顿海鲜自助

拱北口岸1

拱北口岸2

夜里又点了生滚粥和肠粉，想到回上海后再吃这些会变得很麻烦（家附近没有好吃的店，要跑去其他的区），就多吃了几口

肠粉和猪杂粥

05-06 返程#

返程，假期结束

返程

（完）

Dynamics 365许可证有效期查看方法（国际版与世纪互联版）

Mon, 21 Apr 2025 00:00:00 GMT

本文介绍如何在 Microsoft 365 管理中心 查看 Dynamics 365 许可证的到期日期，操作路径因版本（国际版/世纪互联版）而略有不同

国际版操作步骤#

访问并登录 Microsoft 365 管理中心
在左侧菜单栏选择账单 → 你的产品
在产品列表页面，查看 续订或到期日 列即可获取许可证有效期信息

国际版-查看许可证到期日

世纪互联版（国内版）操作步骤#

访问并登录 Microsoft 365 管理中心（世纪互联版）
在左侧菜单栏选择账单 → 订阅
页面跳转后，在订阅列表中选择对应的许可证
在详情页中查看 将于 [日期] 过期 信息

世纪互联版-订阅页面

世纪互联版-查看许可证效期

（完）

在Garmin Connect中正确设置跑步心率区间

Sun, 13 Apr 2025 00:00:00 GMT

Step 1：打开 Garmin Connect App#

确保已经登录账号，并且手表正常同步。

Step 2：进入「用户信息」#

点击右上角手表图标
点击设备
选择用户信息

Garmin Connect App - 打开用户信息

Step 3：新增「运动心率区间」#

点击心率和功率区间
点击心率
点击新增运动心率（如果之前已经设置过的话，点击运动心率）

Garmin Connect App - 新增心率区间

Step 4：设置「跑步」心率区间#

点击跑步（如果没有这个选项，点击新增运动）
点击区间
选择基于储备心率百分比
设置区间值（从上往下设置，区间参考 “Tips 1. 储备心率百分比区间”）

Garmin Connect App - 新增跑步心率区间

Tips#

Tips 1：储备心率百分比区间（HRR）#

区间	区间描述	百分比	备注
Z5	无氧耐力	95–100%	I 区间，最大摄氧量
Z4	临界心率	88–95%	A 区间，无氧耐力
Z3	有氧耐力	84–88%	T 区间，乳酸阈值
Z2	脂肪燃烧	74–84%	M 区间，马拉松配速
Z1	热身	59–74%	E 区间，轻松跑

为什么叫 I / A / T / M / E 区间？

很简单，因为首字母来自训练类型：

I：Interval training（间歇）
A：Anaerobic running（无氧）
T：Threshold running（阈值）
M：Marathon-pace running（马拉松配速）
E：Easy running（轻松跑）

Tips 2：什么是「储备心率百分比（HRR%）」#

储备心率百分比（Heart Rate Reserve Percentage，HRR%）
是一种比“最大心率百分比”更精准的强度评估方法。

它考虑了：

最大心率
静息心率
两者之间的差值

相比只看最大心率的某个百分比，HRR 更贴合个人体能差异，也更适合长期训练和减脂跑。

Tips 3：估算最大心率#

常用公式：

最大心率 = 208 - （年龄 * 0.7）

这是一个经验公式，适合日常训练使用。

Tips 4：估算静息心率#

推荐方式：

每天早上睡醒后
起床并站立时测量心率
连续 5 ～ 7 天
取最大值作为静息心率参考

（完）

（记录）调查并解决Dynamics 365邮件发送失败

Wed, 26 Mar 2025 00:00:00 GMT

本文记录调查并解决 Dynamics 365 邮件发送失败。

问题背景#

今天一大早，就有不少用户反馈收不到审批邮件通知，检查 Dynamics 365 的 “电子邮件” 实体时发现，从 2025-03-20 09:00 起系统已无法正常发送邮件(ORZ!!!!)，暂停发送状态的邮件积压了1600多封…

通过查看邮件日志，最终定位到根本原因：发送邮箱的密码已过期

提示：电子邮件记录上方显示的“此邮件尚未提交，因此无法传送。有关详细信息，请参阅帮助”信息较为笼统，实际排查时需要进一步查看邮件日志。

当时看了电子邮件记录上方提示的 “此邮件尚未提交，因此无法传送。有关详细信息，请参阅帮助” 对我毫无帮助，我找了一会才找到查看邮件日志的地方，这次将其记录下来，以备下次找不到

截图-邮件发送异常-暂停发送

排查步骤#

Step 1. 查看邮件日志#

登录 Power Platform 管理中心
选择对应环境
点击设置
选择 电子邮件设置

截图-查看邮件日志-01

在邮件队列中，找到用于发送邮件的邮箱记录

若出现异常，其传出电子邮件状态通常显示为失败

截图-查看邮件日志-02

点击进去后，通过警告可以看到日志，可以看到日志信息:

电子邮件服务器错误代码: OutgoingEmailAuthenticationError，以及由于无法验证连接到电子邮件服务器所需的服务器证书或用于发送电子邮件的凭据不正确或未提供访问权限，因此邮箱 XXXXXX 无法发送电子邮件

该错误明确提示了身份验证问题，通常由密码过期引起。

截图-查看邮件日志-03

Step 2. 修复步骤#

重置发送邮箱的密码
在对应的邮件服务提供商处完成密码重置
更新 Dynamics 365 邮箱配置
- 在邮箱设置页面更新密码
- 点击 “测试和启用邮箱” 验证连接

截图-查看邮件日志-04

3. 验证修复结果#

修复完成后：

传出电子邮件状态 应变为成功
电子邮件实体中积压的 “暂停发送” 邮件将自动重新发送

（完）

Garmin Connect 导出 CSV 乱码怎么办？

Tue, 18 Mar 2025 00:00:00 GMT

从 Garmin Connect 导出的 CSV 跑步记录在 Excel 打开全是乱码？别担心，这是编码不兼容导致的常见问题。本文提供无需安装任何软件的纯手工解决方案，通过记事本两步操作即可让中文正常显示，轻松用 Excel 统计你的运动数据。

今天在 Garmin Connect 里导出了跑步记录，想用 Microsoft Excel 做点简单统计。

结果 CSV 文件在本地打开后，列标题全是乱码（无论是 Excel 还是记事本，看起来都不太对）

乱码的原因其实很常见：CSV 文件的编码和 Windows / Excel 默认识别的编码不一致，尤其是包含中文字段时。

好在这个问题不用装插件、不用脚本，改一下编码就能解决。

下载的 CSV 打开后是乱码#

下载的CSV打开后乱码

解决问题的步骤#

Step 1：复制原始内容
- 导出 CSV 文件
- 右键 → 另存到桌面
- 使用记事本打开该 CSV
- Ctrl + A 全选 → Ctrl + C 复制
Step 2：用指定编码重新保存
- 新建一个记事本文件
- 粘贴刚才复制的内容
- 点击「另存为」
- 设置：
  - 编码：ANSI
  - 保存类型：所有文件 (*)
  - 文件名：起一个有意义的名字，后缀手动写 .csv
- 点击保存

另存csv文件

Step 3：用 Excel 打开新文件

使用 Excel 打开 Step 2 保存的 CSV 文件，你会发现：原本乱码的列标题现在已经正常显示中文

乱码的列标题已经显示正常

（完）

Dynamics 365将多选字段的显示名称存储到文本字段，用于SSRS报表

Fri, 14 Mar 2025 00:00:00 GMT

在 D365 项目中，SSRS 报表无法直接查询多选项字段。本文结合实际经验，介绍通过插件、工作流，将多选项的显示名称同步存储到文本字段中。

背景与问题#

在 Dynamics 365 项目中制作 SSRS 分页报表 时，如果报表字段来自 多选项（Multi Select Option Set），基本都会踩到同一个坑：

多选项字段 无法直接 添加到 SSRS 数据集（无论是 FetchXML 还是 SQL 方式）

在 Report Designer 中尝试添加字段时，系统会直接阻止并提示错误。

Microsoft SQL Server Report Designer: "MultiSelectPicklist"

解决思路#

在实际项目中，一个 稳定且通用 的做法是：

新增一个 文本字段
用来存储多选项字段当前选中值的 显示名称
在多选项字段变更时，同步更新该文本字段
SSRS 报表 只使用文本字段进行展示

这样做的好处是：

不依赖报表侧的特殊处理
数据在数据库层面就是可读文本
对后续统计、导出、对接都更友好

多选项之间的分隔符（例如英文逗号 ,），只需要在项目中与业务方提前约定即可

示例说明#

以 Contact 实体为例：

字段类型	字段名
Multi Select Option Set	`gdh_multi_select`
Text	`gdh_multi_select_text`

当用户修改 gdh_multi_select 时，系统会自动将选中项的 显示名称拼接后 写入 gdh_multi_select_text

Contact实体上的gdh_multi_select和gdh_multi_select_text字段

实现方式#

根据项目复杂度和技术栈不同，可以选择以下两种实现方式。

方式一：插件（推荐）#

插件方案更适合：

对数据一致性要求高
有开发资源
不希望引入第三方组件的项目

注册方式

实体：Contact
Message：Create / Update
Stage：Post-Operation
Filtering Attributes：gdh_multi_select

插件逻辑非常简单：
当检测到多选项字段发生变化时，读取其选中值对应的显示名称，并更新到文本字段

插件完整代码见文末

方式二：工作流（低代码）#

如果项目中不方便开发插件，也可以使用工作流方案。

这里借助第三方工具 Dynamics-365-Workflow-Tools ：

GitHub 地址：
https://github.com/demianrasko/Dynamics-365-Workflow-Tools

安装 Dynamics-365-Workflow-Tools 基本步骤

#	基本步骤说明
1	打开 GitHub 仓库，进入 Releases（页面右下角）
2	下载 Dynamics 365 Workflow Tools Solution（建议使用 Latest 版本）
3	将解决方案导入到系统中，并按向导完成安装

在 Power Apps 中新建 Workflow

新建 Workflow：

在Power Apps 新建工作流

填写一个有意义的名称，并选择空白模板后点击 Create。

新建工作流-填写名称和选择空白模板

选择 Workflow-Tools → 选择 GetMultiSelectOptionSet

使用workflow-tools

点击 Set Properties

点击 Set Properties

填写/选择参数 (参数如下) → 保存并关闭

#	参数	值
1	Source Record URL	记录URL(Dynamic)
2	Attribute Name	多选字段，本示例填写的是：gdh_multi_select
3	Retrieve Options Names	选“是”

添加更新步骤 → 点击 Set Properties

点击 Set Propertie

为字段赋值 → 保存并关闭

为 Multi Select（Text）赋值

最后激活工作流即可

这种方式实现成本低，但在性能和可控性上略逊于插件，更适合轻量级场景

插件代码示例#

1
using Microsoft.Crm.Sdk.Messages;
2
using Microsoft.Xrm.Sdk;
3
using Microsoft.Xrm.Sdk.Messages;
4
using Microsoft.Xrm.Sdk.Metadata;
5
using Microsoft.Xrm.Sdk.Query;
6
using System;
7
using System.Collections.Generic;
8
using System.IdentityModel.Metadata;
9
using System.Linq;
10
using System.Runtime.Remoting.Services;
11
using System.Text;
12
using System.Threading;
13
using System.Threading.Tasks;
14

15
namespace Blog.D365.Plugins.Contact
16
{
17
    public class ContactPostUpdatePlugin : IPlugin
18
    {
19
        public void Execute(IServiceProvider serviceProvider)
20
        {
21
            ITracingService tracer = (ITracingService)serviceProvider.GetService(typeof(ITracingService));
22
            IPluginExecutionContext context =
23
                (IPluginExecutionContext)serviceProvider.GetService(typeof(IPluginExecutionContext));
24
            try
25
            {
26
                if (context.InputParameters.Contains("Target") &&
27
                context.InputParameters["Target"] is Entity)
28
                {
29
                    IOrganizationServiceFactory factory =
30
                        (IOrganizationServiceFactory)serviceProvider.
31
                        GetService(typeof(IOrganizationServiceFactory));
32
                    IOrganizationService service = factory.CreateOrganizationService(context.UserId);
33
                    IOrganizationService serviceAdmin = factory.CreateOrganizationService(null);
34
                    Entity targetEntityRecord = (Entity)context.InputParameters["Target"];
35

36
                    // "context.Stage == 40" -> PostOperation
37
                    if (context.Stage == 40 && targetEntityRecord.Attributes.Contains("gdh_multi_select") &&
38
                        (context.MessageName == "Create" || context.MessageName == "Update"))
39
                    {
40
                        SetMultiSelectText(serviceAdmin, targetEntityRecord); // [!code highlight]
41
                    }
42
                }
43
            }
44
            catch (Exception ex)
45
            {
46
                tracer.Trace($"ContactPostUpdatePlugin unexpected exception:\n{ex.Message}");
47
                throw;
48
            }
49
        }
50

51
        private void SetMultiSelectText(IOrganizationService organization, Entity contactEn)
52
        {
53
            if (contactEn.Attributes.Contains("gdh_multi_select"))
54
            {
55
                OptionSetValueCollection optionSetValues =
56
                    contactEn.GetAttributeValue<OptionSetValueCollection>("gdh_multi_select");
57
                string roleText =
58
                    GetMultiSelectOptionSetLabels(
59
                      organization,
60
                      "contact",
61
                      "gdh_multi_select",
62
                      optionSetValues);
63
                if (!string.IsNullOrEmpty(roleText))
64
                {
65
                    Entity updateContact = new Entity(contactEn.LogicalName, contactEn.Id);
66
                    updateContact["gdh_multi_select_text"] = roleText;
67
                    organization.Update(updateContact);
68
                }
69
            }
70
        }
71

72
        public static string GetMultiSelectOptionSetLabels(
73
            IOrganizationService service,
74
            string entityLogicalName,
75
            string attributeLogicalName,
76
            OptionSetValueCollection values,
77
            int? languageCode = null)
78
        {
79
            if (values == null || !values.Any())
80
                return string.Empty;
81
            // Retrieve the attribute metadata
82
            RetrieveAttributeRequest retrieveAttributeRequest = new RetrieveAttributeRequest
83
            {
84
                EntityLogicalName = entityLogicalName,
85
                LogicalName = attributeLogicalName,
86
                RetrieveAsIfPublished = true
87
            };
88
            RetrieveAttributeResponse retrieveAttributeResponse =
89
            (RetrieveAttributeResponse)service.Execute(retrieveAttributeRequest);
90
            MultiSelectPicklistAttributeMetadata attributeMetadata =
91
            retrieveAttributeResponse.AttributeMetadata as MultiSelectPicklistAttributeMetadata;
92
            if (attributeMetadata == null)
93
                throw new InvalidPluginExecutionException("Attribute is not a Metadata.");
94
            // Prepare a map from option value to label
95
            Dictionary<int, string> optionLabels = attributeMetadata.OptionSet.Options.ToDictionary(
96
                o => o.Value.GetValueOrDefault(),
97
                o => GetLocalizedLabel(o, languageCode)
98
            );
99
            // Map selected values to labels
100
            var selectedLabels = values
101
                .Select(v => optionLabels.ContainsKey(v.Value) ?
102
                optionLabels[v.Value] : $"(Unknown {v.Value})")
103
                .ToList();
104
            return string.Join(", ", selectedLabels);
105
        }
106

107
        private static string GetLocalizedLabel(OptionMetadata option, int? languageCode = null)
108
        {
109
            if (languageCode.HasValue)
110
            {
111
                var label = option.Label.LocalizedLabels
112
                    .FirstOrDefault(l => l.LanguageCode == languageCode.Value);
113
                return label?.Label ?? $"(No label for {option.Value})";
114
            }
115
            else
116
            {
117
                return option.Label.UserLocalizedLabel?.Label ?? $"(No label for {option.Value})";
118
            }
119
        }
120

121
        public static int GetCurrentUserLanguageCode(IOrganizationService service)
122
        {
123
            WhoAmIResponse whoAmI = (WhoAmIResponse)service.Execute(new WhoAmIRequest());
124
            Guid userId = whoAmI.UserId;
125
            QueryExpression query = new QueryExpression("usersettings");
126
            query.Criteria.AddCondition(
127
              new ConditionExpression("systemuserid", ConditionOperator.Equal, userId));
128
            query.ColumnSet.AddColumns("uilanguageid");
129
            Entity result = service.RetrieveMultiple(query).Entities.FirstOrDefault();
130
            return result != null && result.Attributes.Contains("uilanguageid")
131
                ? (int)result["uilanguageid"]
132
                : 1033;
133
        }
134
    }
135
}

展开收起

（完）#

XrmToolBox导出实体数据字典

Fri, 14 Mar 2025 00:00:00 GMT

在使用 Microsoft Dynamics 365 或 Power Apps 时，业务用户常常会需要查看实体中选项集（选择字段）的详细信息。若实体仅包含少量选项集字段，用户可直接通过 Level up for Dynamics 365 / Power Apps 浏览器扩展，利用它显示选项集值功能，并将结果复制粘贴至 Excel 中就能搞定

但当实体包含大量选项集字段时，这种手动操作方式效率较低，更实用的解决方案是借助 XrmToolBox 工具，将实体元数据直接导出为如 Excel 这样的结构化格式

本文件将推荐两款适用于此场景的工具：

Metadata Document Generator
Attributes Factory

工具一：Metadata Document Generator#

在 XrmToolBox 上安装 Metadata Document Generator 并打开它

Open Metadata Document Generator

操作步骤如下：

点击 Load Entity
选择导出文件的保存位置
选择需要导出的实体
根据需求配置导出选项（详见下方表格）
点击 Generate Document

Metadata Document Generator - Generate Customer Entity Data Dictionary

Available Options#

选项	选择（中文）
Include Audit information	包括审计信息
Include Field Level Security information	包括字段级安全信息
Include Requirement leve information	包括要求级别信息
Include Valid for Advanced Find information	包括高级查找有效信息
Include Attribute location in Forms	包括表单中的属性位置
Exclude Virtual attributes(name,base,date,state)	排除虚拟属性（名称、基础、日期、状态）
Export all attributes in one sheet(Excel only)	在一张表中导出所有属性（仅限 Excel）
Gather entitys list in a summary(Excel only)	在摘要中收集实体列表（仅限 Excel）

生成的 Excel 数据字典将呈现如下格式：

Generated Customer Entity Data Dictionary (Excel)

工具二：Attributes Factory#

另一个可选方案是 Attributes Factory 插件。在 XrmToolBox 中安装并打开 Attributes Factory：

Install Attributes Factory

导出步骤：

选择导出表
选择目标解决方案
勾选要导出的实体
根据需要选择导出选项
点击确定

Attributes Factory Operation - 01

指定文件保存路径与文件名，然后点击保存

Attributes Factory Operation - 02

生成的 Excel 文件将以如下格式包含实体数据字典：

Generated Customer Entity Data Dictionary (Excel)

（完）

Dynamics 365消息提醒(In-App Notification)

Tue, 11 Mar 2025 00:00:00 GMT

在实施 Dynamics 365 项目时，经常有用户要求当某些单据的状态发生变化，需要给用户消息提醒，像这种情况，我一般是先使用In-App Notification，因为它相较于邮件或Teams，配置起来也更快捷！接下来我将使用三种方式(Flow、API、C#)为用户创建“消息提醒”。

前言#

本文示例场景：当 Account 的负责人(Owner)发生变更时，向新负责人发送应用内通知

效果展示#

消息提醒效果展示

前置条件：启用应用内消息通知功能#

在使用 In-App Notification 之前，需要先在应用层级启用该功能，否则后续代码或Flow都无法生效，启用功能很简单，下面是启用步骤

(1) 打开 Power Apps
(2) 点击菜单栏中的 App
(3) 选择目标应用
(4) 点击“三个点”
(5) 选择“编辑”(Edit)

启用消息通知-步骤1

(6) 在应用编辑页面顶部，点击 Settings 按钮

启用消息通知-步骤2

(7) 切换到 Features 选项卡，启用 In App Notification，并保存设置。

启用消息通知-步骤3

Tip

启用成功后，可以在 Dataverse 表列表中看到新增的 Notification（appnotification） 表，这也是后续所有通知的基础

推送方式一：Cloud Flow(低代码)#

Tip

如果团队偏向低代码，或者通知逻辑简单的话，我推荐使用 Cloud Flow 创建消息提醒

Step 1. 新建 Cloud Flow#

打开 Power Apps → 打开解决方案 → 左侧菜单栏选择 “Object” → 然后选择 “All” → 点击 “+New” → 点击 “Automation” → 点击 “Cloud flow” → 点击 “Automated”

新建Cloud Flow-步骤1

Step 2. 配置 Cloud Flow#

在弹出的新建 Cloud flow 页面输入一个有意义的名称，然后通过模糊搜索(输入 Dataverse)，选择触发器：When a row is added, modified or deleted，最后点击 Create

新建Cloud Flow-步骤2

Step 3. 配置触发器#

在 Flow 设计器中，配置 When a row is added, modified or deleted 触发器，然后点击 “+ New step” 继续后续步骤

本示例中的配置如下：

Change type：Modified
Table name：Accounts
Scope：Organization
Select columns：ownerid

配置Flow

Note

该配置示例用于监听 Account 记录的负责人发生变化的场景，后续基于该事件向用户发送消息提醒

推送方式二：Client API#

如果希望在表单、按钮或前端逻辑中即时发送消息提醒，Client API 会更加灵活，下面的示例是通过 Xrm.WebApi.createRecord 直接创建消息提醒

1
async function sendInAppNotification() {
2
  let globalContext = Xrm.Utility.getGlobalContext();
3
  const userId = globalContext.userSettings.userId.replace(/[{}]/g, "");
4
  const inAppNotification = {
5
    title: "负责人变更提醒",
6
    body: "你已被设置为该客户的负责人，请及时查看。",
7
    "ownerid@odata.bind": "/systemusers(" + userId + ")",
8
    icontype: 100000000,
9
    toasttype: 200000000,
10
  };
11
  try {
12
    await Xrm.WebApi.createRecord("appnotification", inAppNotification);
13
    console.log("In-App Notification sent successfully.");
14
  } catch (error) {
15
    console.error("Failed to send notification:", error.message);
16
  }
17
}

展开收起

Client Api Notification

(补充说明)Icon Type选项

Icon Type	Value
Info	100000000
Success	100000001
Failure	100000002
Warning	100000003
Mention	100000004

推送方式三：Csharp(C#)#

代码如下：

1
/// <summary>
2
/// Example of SendAppNotification with formatted content
3
/// </summary>
4
/// <param name="service">Authenticated client implementing the IOrganizationService interface</param>
5
/// <param name="userId">The Id of the user to send the notification to.</param>
6
/// <returns>The app notification id</returns>
7
public static Guid SendAppNotificationWithFormattedContent(IOrganizationService service, Guid userId)
8
{
9

10
    var request = new OrganizationRequest()
11
    {
12
        RequestName = "SendAppNotification",
13
        Parameters = new ParameterCollection
14
        {
15
            ["Title"] = "Complete overhaul required (sample)",
16
            ["Recipient"] = new EntityReference("systemuser", userId),
17
            ["Body"] = "Maria Campbell mentioned you in a post.",
18
            ["IconType"] = new OptionSetValue(100000004), //mention
19
            ["OverrideContent"] = new Entity()
20
            {
21
                Attributes =
22
                {
23
                    ["title"] = "[Complete overhaul required (sample)](?pagetype=entityrecord&etn=incident&id=0a9f62a8-90df-e311-9565-a45d36fc5fe8)",
24
                    ["body"] = "[Maria Campbell](?pagetype=entityrecord&etn=contact&id=43m770h2-6567-ebm1-ob2b-000d3ac3kd6c) mentioned you in a post: _\"**[@Paul](?pagetype=entityrecord&etn=contact&id=03f770b2-6567-eb11-bb2b-000d3ac2be4d)** we need to prioritize this overdue case, [@Robert](?pagetype=entityrecord&etn=contact&id=73f970b2-6567-eb11-bb2b-000d3ac2se4h) will work with you to engage with engineering team ASAP.\"_"
25
                }
26
            }
27
        }
28
    };
29

30
    OrganizationResponse response = service.Execute(request);
31
    return (Guid)response.Results["NotificationId"];
32
}

展开收起

参考#

Send in-app notifications within model-driven apps

（完）

Dynamics 365货币字段

Mon, 10 Mar 2025 00:00:00 GMT

深入了解 Dynamics 365 货币字段

本文通过一个简单但完整的实验，来梳理 Dynamics CRM 中的货币字段(Currency Field)是如何工作的，以及它在多币种场景下是什么样的表现

前言#

在本文的实验环境中：

基础货币 (Base Currency) 设置为美元(USD)
新建了2个用于实验的实体，两个实体之间是 1:N 关系(Invoice → Invoice Detail)
- Invoice 实体
- Invoice Detail 实体

基本概念#

在 Dynamics 365 中，货币(Currency)是一种特殊的字段类型，它用于存储与金额相关的数据，还有一个容易被忽略但重要的点是：当你在实体中创建一个“货币字段”时，系统实际上会在后台自动创建 4 个字段

以我在 Invoice Detail 实体中新建的 Amount 货币字段为例，系统在后台生成了以下字段：

gdh_amount —> 存储实际输入的货币值
gdh_amount_Base —> 存储根据汇率换算后的基础货币金额

此外，还会自动关联两个字段：

币种(Currency)
汇率(Exchange Rate)

Invoice Detail实体新添的Amount货币字段

开始实验#

Step 1. 新建币种(Currency)#

打开 Power Platform 管理中心 —> 选择 “环境” —> 进入 “设置” —> 选择 “币种”

新建币种-01

在弹出的页面，新添币种

新建币种-02

我添加了两个币种：人民币和日元，新建的信息如下：

货币名称	货币代码	货币符号	汇率	货币精度
US Dollar	USD	$	1.0000	2
RMB	CNY	￥	7.2500	2
JPY	JPY	JPY ￥	147.6300	2

Tip

(1) 汇率更新时，Dynamics 365 不会重新计算所有货币字段

(2) 汇率由系统管理员设定

Step 2. 添加实验数据：多币种金额如何换算？#

在 Invoice Detail 中，分别创建了3条记录，使用不同币种填写 Amount 字段：

No.	Currency	Amount	Amount(Base)	Exchange Rate
SASD-00001260	JPY	JPY ￥ 1,000.00	$6.77	147.6300000000
SASD-00001259	US Dollar	$1,000.00	$1,000.00	1.0000000000
SASD-00001258	RMB	￥ 1,000.00	$137.93	7.2500000000

新建实验数据

打开 Invoice 记录可以清楚看到，当币种是 “基础货币(USD)” 时，Amount 与 Amount(Base) 完全一致，当币种不是 “基础货币” 时，系统会根据：Amount(Base) = Amount ÷ Exchange Rate 自动完成换算，无需任何自定义逻辑或插件

Step 3. 货币字段 + 汇总（Rollup）会发生什么？#

接下来我在 Invoice 实体中新建一个货币类型的汇总字段：Example - Total Amount，该字段用于汇总当前 Invoice 下所有 Invoice Detail 的金额

新建货币汇总字段

汇总字段的配置规则如下：

汇总来源：Invoice Detail
汇总字段：Amount
汇总方式：Sum

字段汇总规则

汇总结果：

汇总结果

最终你会发现，系统并不是直接 “把不同币种的 Amount 相加”，实际执行逻辑是：

将子表金额统一转换为 Base 金额
汇总 Amount(Base)
再根据当前 Invoice 的 “币种(Currency)” 和 “汇率(Exchange Rate)” ，换算为显示金额，

也就是说，汇总字段的计算核心，永远围绕 Amount(Base) 展开

Tip

Dynamics 365 中的汇总字段是定时计算的，可在系统作业中设置频率，最快每 1 小时计算一次，也可以在字段旁点击“小键盘”图标，手动触发重新计算

重新计算

（完）

Dynamics 365日期和时间字段

Fri, 07 Mar 2025 00:00:00 GMT

概述#

由于 Dataverse 统一以 UTC 时区存储日期时间数据，而 (1)界面显示、(2)Client API 与 (3)Web API 又根据字段配置和用户时区产生不同的行为，这类字段常常成为以下问题的重灾区：

不同用户看到的日期不一致
表单显示正确，但数据库或接口返回 “少了/多了8小时”
Client API / Web API 返回的时间与预期不符

本文通过字段配置说明 + 实际实验 + 数据库存储 / API 返回对比的方式，一次性理清这些容易混淆的点

基本概念#

Dataverse 以 UTC 时区存储所有日期和时间值，当应用显示值或处理用户输入时，会根据字段的“格式”和“时区调整”选项，结合当前用户的时区设置进行动态转换

基本概念1：仅日期或日期和时间#

在实体新建日期和时间字段时，可以选择以下以下格式

格式	描述
仅日期	存储时间为 00:00<00>（UTC），界面仅显示日期
日期和时间	同时存储并显示日期与时间

选择日期和时间字段的 “格式”

基本概念2：时区调整#

在“高级选项”中，可以设置“时区调整”，需要注意的是，“时区调整”的选项和“格式”(仅日期或日期和时间)联动，联动逻辑如下

高级选项中的时区调整

格式等于“仅日期”#

如果格式选择了“仅日期”，那么“时区调整”将有如下3个选项

选项	时区调整	描述
1	用户当地时间	默认值，根据用户时区进行转换
2	时区无关	不进行时区转换
3	仅日期	不存储时间部分（始终为 00:00<00>）

格式等于“日期和时间”#

如果格式选择了“日期和时间”，那么“时区调整”将有如下2个选项

选项	时区调整	描述
1	用户当地时间	默认值，根据用户时区进行转换
2	时区无关	不进行时区转换

Tip

字段创建完成后，“格式” 和 “时区调整” 在一定条件下仍可修改（详见下文）

基本概念3：已创建字段“格式”和“时区调整”还能修改吗？#

经实际验证，结论如下：

“格式” & “时区调整”	“格式”是否可以修改？	“时区调整”是否可以修改？
仅日期 & 用户当地时间	✔	✔
仅日期 & 时区无关	✔	❌
仅日期 & 仅日期	❌	❌
日期和时间 & 用户当地时间	✔	✔
日期和时间 & 时区无关	✔	❌

基本概念4：“时区调整”该如何选择？#

用户当地时间#

这是默认选项。字段值会根据每个用户个人设置中的时区进行动态转换。例如，一个销售订单的“创建时间”在伦敦的用户看来是 2024-01-01 12:00:00，而在纽约的用户看来则会显示为 2024-01-01 07:00:00（如果该时间点对应的是同一UTC时刻）。这个选项适用于绝大多数需要记录事件发生时刻，并期望在不同地区用户视角下呈现为当地时间场景，例如会议时间、任务截止日期、操作日志等

时区无关#

选择此选项后，字段值将不进行任何时区转换。无论查看者身处哪个时区，他们在界面上看到的日期和时间值都是完全相同的。数据库存储的值是什么，用户看到的就是什么。这适用于那些本身就不包含时区信息，或不应受时区影响的场景。例如，酒店的入住登记时间（通常以酒店当地时间为准）、健身房的打卡记录（以打卡地当地时间为准）、或者一个全球统一发布的公告的“发布日期和时间”

仅日期#

此选项仅在字段“格式”为“仅日期”时可用。选择后，字段将仅存储日期部分，时间部分固定为 00:00<00>（UTC），并且不进行任何时区转换。所有用户，无论身处何地，都将看到完全相同的日期。适用于生日、结婚纪念日、节日等只关心日期，不关心具体时间和时区的场景

实例#

接下来，我将在 Invoice 实体新建如下5个“日期和时间”字段，然后对它们进行赋值，接着到数据库上看存储情况

Tip

目前我所在的时区是(GMT+08:00) Beijing, Chongqing, Hong Kong, Urumqi
用户 Test06 使用的的时区是 (GMT+04:00) Baku

接下来是具体的“实验”步骤

Step 1. 新建日期和时间字段#

字段清单如下

#	名称	字段名称	格式	时区调整
1	D - User Local	`gdh_d_userlocal`	仅日期	用户当地时间
2	D - TZ independent	`gdh_d_tz_independent`	仅日期	时区无关
3	D - D	`gdh_d_d`	仅日期	仅日期
4	DT - User Local	`gdh_dt_userlocal`	日期和时间	用户当地时间
5	DT - TZ independent	`gdh_dt_tz_independent`	日期和时间	时区无关

Step 2. 在表单中填写日期和时间字段#

在 (GMT+08:00) Beijing, Chongqing, Hong Kong, Urumqi 时区下，对字段进行赋值

对日期和时间字段进行赋值

#	名称	字段名称	填写内容
1	D - User Local	`gdh_d_userlocal`	`2025-03-10`
2	D - TZ independent	`gdh_d_tz_independent`	`2025-03-12`
3	D - D	`gdh_d_d`	`2025-03-14`
4	DT - User Local	`gdh_dt_userlocal`	`2025-03-10 14:30`
5	DT - TZ independent	`gdh_dt_tz_independent`	`2025-03-24 09:30`

Step 3. 数据库查看数据#

1
SELECT gdh_d_userlocal AS 'D - User Local',
2
       gdh_d_tz_independent AS 'D - TZ independent',
3
       gdh_d_d AS 'D - D',
4
       gdh_dt_userlocal AS 'DT - User Local',
5
       gdh_dt_tz_independent AS 'DT - TZ independent'
6
FROM   gdh_invoice
7
WHERE  gdh_no = 'SAS-00000001';

在数据库查看数据

#	名称	字段名称	填写内容	数据库存储的值
1	D - User Local	`gdh_d_userlocal`	`2025-03-10`	`2025-03-09 16:00:00.000`
2	D - TZ independent	`gdh_d_tz_independent`	`2025-03-12`	`2025-03-12 00:00:00.000`
3	D - D	`gdh_d_d`	`2025-03-14`	`2025-03-14 00:00:00.000`
4	DT - User Local	`gdh_dt_userlocal`	`2025-03-10 14:30`	`2025-03-10 06:30:00.000`
5	DT - TZ independent	`gdh_dt_tz_independent`	`2025-03-24 09:30`	`2025-03-24 09:30:00.000`

问题：为什么D-User Local在数据库中存储的是2025-03-09 16:00<00>.000 ？#

前面说过，我是在(GMT+08:00) Beijing, Chongqing, Hong Kong, Urumqi时区下填写 2025-03-10，Dataverse 是以UTC时区存储所有日期时间数据，且 “仅日期 + 用户当地时间” 格式的字段会先将用户填写的本地日期转换为 UTC 时间，再存储到数据库

1
为了转换为 UTC 时间存储，计算逻辑：
2
= 2025-03-10 00:00:00 (GMT+08:00) - 8 小时
3
= 2025-03-09 16:00:00 (UTC)

Step 4. 使用 Test06 查看数据#

Tip

用户 Test06 使用的的时区是 (GMT+04:00) Baku

使用 Test06 查看数据

#	名称	字段名称	数据库存储的值	看到的值
1	D - User Local	`gdh_d_userlocal`	`2025-03-09 16:00:00.000`	`2025-03-09`
2	D - TZ independent	`gdh_d_tz_independent`	`2025-03-12 00:00:00.000`	`2025-03-12`
3	D - D	`gdh_d_d`	`2025-03-14 00:00:00.000`	`2025-03-14`
4	DT - User Local	`gdh_dt_userlocal`	`2025-03-10 06:30:00.000`	`2025-03-10 10:30`
5	DT - TZ independent	`gdh_dt_tz_independent`	`2025-03-24 09:30:00.000`	`2025-03-24 09:30`

问题：为什么 Test06 在表单上看到的 DT - User Local 是 2025-03-10 10:30<00>.000 ？#

Test06（GMT+04<00> 巴库时区）看到 DT - User Local 是 2025-03-10 10:30，本质是 Dataverse 从 UTC 存储值反向转换为用户本地时区时间的规则导致，Test06 所在时区是 GMT+04<00>（Baku，比 UTC 快 4 小时），系统会将 UTC 存储值转换为其本地时间：

1
Test06 看到的时间 = UTC 存储值 + 4 小时
2
= 2025-03-10 06:30:00 + 4 小时
3
= 2025-03-10 10:30:00

问题：为什么 D - User Local 是 2025-03-09 ？#

D - User Local 是“仅日期+用户当地时间”，数据库存储的 UTC 是 2025-03-09 16:00，转换为巴库时间：

1
2025-03-09 16:00（UTC） + 4 小时 = 2025-03-09 20:00（巴库时间）

由于是“仅日期”格式，表单只显示日期部分 2025-03-09

Step 5. Client API 获取日期时间字段值的结果解析#

(1) “用户当地时间”字段（D/DT - User Local）的取值逻辑#

js获取gdh_d_userlocal和gdh_dt_userlocal

1
Xrm.Page.getAttribute("gdh_d_userlocal").getValue();
2
// Mon Mar 10 2025 00:00:00 GMT+0800 (中国标准时间)
3
Xrm.Page.getAttribute("gdh_d_userlocal").getValue().toUTCString();
4
// 'Sun, 09 Mar 2025 16:00:00 GMT'
5
Xrm.Page.getAttribute("gdh_dt_userlocal").getValue();
6
// Mon Mar 10 2025 14:30:00 GMT+0800 (中国标准时间)
7
Xrm.Page.getAttribute("gdh_dt_userlocal").getValue().toUTCString();
8
// 'Mon, 10 Mar 2025 06:30:00 GMT'

Client API 中，getAttribute("字段名").getValue() 返回的是 JavaScript Date 对象，返回的是
对于“用户当地时间”类型的字段，这个 Date 对象的底层存储是 UTC 时间（和数据库一致）
调用 toUTCString() 会直接输出该 Date 对象的 UTC 字符串，因此和数据库值完全匹配

(2) “时区无关”字段（D/DT - TZ independent）的取值逻辑#

1
Xrm.Page.getAttribute("gdh_d_tz_independent").getValue();
2
// Wed Mar 12 2025 00:00:00 GMT+0800 (中国标准时间)
3
Xrm.Page.getAttribute("gdh_d_tz_independent").getValue().toString();
4
// 'Wed Mar 12 2025 00:00:00 GMT+0800 (中国标准时间)'
5
Xrm.Page.getAttribute("gdh_dt_tz_independent").getValue();
6
// Mon Mar 24 2025 09:30:00 GMT+0800 (中国标准时间)
7
Xrm.Page.getAttribute("gdh_dt_tz_independent").getValue().toString();
8
// 'Mon Mar 24 2025 09:30:00 GMT+0800 (中国标准时间)'

我所在浏览器的时区是 GMT+08，因此 toString() 输出的是 GMT+0800 对应的时间（和数据库存储的数值完全一致，只是时区标识变成了浏览器时区）

Step 6. Web API 获取日期时间字段的解析#

1
var req = new XMLHttpRequest();
2
var apiVersion = "v9.1";
3
var entityName = "gdh_invoices";
4
var recordId = "98F83878-1E35-EF11-8409-0017FA0671FA";
5
var selectFields = [
6
  "gdh_d_d",
7
  "gdh_d_tz_independent",
8
  "gdh_d_userlocal",
9
  "gdh_dt_tz_independent",
10
  "gdh_dt_userlocal",
11
].join(",");
12
var baseUrl = Xrm.Page.context.getClientUrl();
13
var apiPath = `/api/data/${apiVersion}/${entityName}(${recordId})`;
14
var queryParams = `?$select=${selectFields}`;
15
var fullUrl = baseUrl + apiPath + queryParams;
16
req.open("GET", fullUrl, true);
17
req.setRequestHeader("OData-MaxVersion", "4.0");
18
req.setRequestHeader("OData-Version", "4.0");
19
req.setRequestHeader("Accept", "application/json");
20
req.setRequestHeader("Content-Type", "application/json; charset=utf-8");
21
req.setRequestHeader("Prefer", 'odata.include-annotations="*"');
22
req.onreadystatechange = function () {
23
  if (this.readyState === 4) {
24
    req.onreadystatechange = null;
25
    if (this.status === 200) {
26
      var result = JSON.parse(this.response);
27
      var gdh_d_d = result["gdh_d_d"];
28
      var gdh_d_tz_independent = result["gdh_d_tz_independent"];
29
      var gdh_d_userlocal = result["gdh_d_userlocal"];
30
      var gdh_dt_tz_independent = result["gdh_dt_tz_independent"];
31
      var gdh_dt_userlocal = result["gdh_dt_userlocal"];
32
    } else {
33
      Xrm.Utility.alertDialog(this.statusText);
34
    }
35
  }
36
};
37
req.send();

展开收起

1
{
2
  "@odata.context": "https://sample.com/api/data/v9.1/$metadata#gdh_invoices(gdh_d_d,gdh_d_tz_independent,gdh_d_userlocal,gdh_dt_tz_independent,gdh_dt_userlocal)/$entity",
3
  "@odata.etag": "W/\"9300793\"",
4
  "gdh_invoiceid": "98f83878-1e35-ef11-8409-0017fa0671fa",
5
  "gdh_dt_userlocal@OData.Community.Display.V1.FormattedValue": "2025/03/10 14:30",
6
  "gdh_dt_userlocal": "2025-03-10T06:30:00Z", // [!code highlight]
7
  "gdh_d_d@OData.Community.Display.V1.FormattedValue": "2025/03/14",
8
  "gdh_d_d": "2025-03-14", // [!code highlight]
9
  "gdh_d_userlocal@OData.Community.Display.V1.FormattedValue": "2025/03/10",
10
  "gdh_d_userlocal": "2025-03-09T16:00:00Z", // [!code highlight]
11
  "gdh_d_tz_independent@OData.Community.Display.V1.FormattedValue": "2025/03/12",
12
  "gdh_d_tz_independent": "2025-03-12T00:00:00Z", // [!code highlight]
13
  "gdh_dt_tz_independent@OData.Community.Display.V1.FormattedValue": "2025/03/24 09:30",
14
  "gdh_dt_tz_independent": "2025-03-24T09:30:00Z" // [!code highlight]
15
}

展开收起

(补充说明)ISO 8601 中 T/Z 的含义#

字符	定义	Web API中的实际作用
T	分隔日期和时间	固定格式分隔符，Web API 所有带时间的日期字段返回值都会包含 T （如 2025-03-10T06:30<00z>）
Z	代表 UTC 时区（Zulu 时间）	明确标识该时间是 UTC 时间，无偏移量； Web API中所有用户当地时间/时区无关的时间字段都会带Z

(补充说明)Web API 与 Client API 的取值对比#

特性	Web API	Client API
返回格式	ISO 8601 字符串(带 T/Z)	JavaScript Date 对象
时区处理	仅返回 UTC 原始值(无转换)	用户当地时间返回 UTC Date 对象，时区无关返回浏览器时区 Date 对象
仅日期字段	D-D 无 T/Z，其他带 T/Z	均返回 Date 对象（含时间）
适用场景	跨系统集成(如对接外部服务)	表单内前端逻辑处理

补充说明#

避坑提醒：仅日期字段的查询注意事项#

“仅限日期” 类型的日期和时间字段，不允许使用下面的查询运算符，当这些运算符用于查询时，会引发无效运算符异常错误

X 分钟以前
X 小时以前
过去 X 小时
接下来 X 小时

例如：对 “D-D” 列进行筛选，筛选条件如下：

对“D-D”列设置筛选条件

执行后会报错：2147779605The operator is not valid or it is not supported.

出现异常：2147779605The operator is not valid or it is not supported.

该错误码对应 Dataverse 官方文档中的 DMQE_INVALID_OPERATOR 错误，描述为：

The specified operator is not valid for the attribute type, or the operator is not supported for the query type.（指定的运算符对该属性类型无效，或该运算符不支持此查询类型。）

如何设置用户的时区？#

个人设置#

右上角的设置按钮 —> 个性化设置 —> General Tab —> 选择时区

后台设置#

后台设置的具体操作步骤，请参考我的另一篇文章：

XrmToolBox设置用户默认时区

介绍如何在XrmToolBox中设置用户的默认时区，通过使用User Settings Utility轻松设置用户时区

2025-08-28Dynamics 365#XrmToolBox

（完）

解决XrmToolBox启动时报NuGet程序集加载失败

Wed, 05 Mar 2025 00:00:00 GMT

记录 XrmToolBox 启动时报 NuGet.Protocol、NuGet.Versioning 等程序集加载失败的排查过程，最终通过清理并重建插件目录解决问题，适合遇到类似启动错误的 D365 使用者参考。

问题现象#

在启动 XrmToolBox 时，程序尚未完全加载，就弹出了程序集加载失败的错误提示，例如：

未能加载文件或程序集 NuGet.Protocol, Version=6.4.0.123，或它的某一个依赖项
系统找不到指定的文件

有时提示的并不一定是 NuGet.Protocol，也可能是 NuGet.Versioning、NuGet.Common 等 NuGet 相关组件，但共同点是：XrmToolBox 无法正常启动，点击关闭后程序直接退出。

初步判断#

这类错误通常不是 XrmToolBox 主程序损坏，而更像是以下原因之一：

某个插件更新过程中异常中断
插件依赖的 NuGet 程序集版本冲突
插件目录中的文件不完整或已损坏

换句话说，问题往往出在插件环境，而不是 XrmToolBox 本身

解决思路#

让 XrmToolBox 重新生成插件环境：

删除现有的 Plugins 插件目录，让 XrmToolBox 在下次启动时重新初始化

解决方法#

完全关闭 XrmToolBox（确认进程已退出）
打开 XrmToolBox 的插件存储目录（路径见下文）
删除整个 Plugins 文件夹
重新启动 XrmToolBox
根据需要，在内置商店中重新安装常用插件

如果担心配置或数据问题，可以在删除前先将 Plugins 文件夹整体备份

插件目录位置说明#

方式一：直接通过路径访问#

将下面路径中的“你的用户名”替换为实际的 Windows 用户名：

Terminal window

1
C:\Users\你的用户名\AppData\Roaming\MscrmTools\XrmToolBox\Plugins

方式二：通过 XrmToolBox 界面打开#

在 XrmToolBox 顶部菜单栏点击 Configuration → Settings
在 Settings 面板中选择 Paths
点击 Open XrmToolBox storage folder

打开插件存储目录

结果#

删除插件目录后，XrmToolBox 可以正常启动，之前的 NuGet 程序集加载错误不再出现

重新安装插件后，常用工具运行也未发现异常

（完）

奉化溪口新建村徒步（2025年）

Sat, 22 Feb 2025 00:00:00 GMT

果然，人还是要时不时在路上，才能重新确认生活的手感。

行程安排#

08：00 ~ 11：00 上海 —> 奉化溪口
11：00 ~ 13：00 吃饭闲逛
13：00 ~ 17：00 徒步赏梅
17：00 ~ 20：00 返程

溪口#

溪口古镇，位于宁波市西南约四十公里处。一边是山，一边是水。东靠武岭，南临剡溪，北接雪窦山。小镇被溪流环绕，四季各有风景。近代因蒋氏故居的缘故，被更多人熟知

山脚下#

（1）剡江

从游客集散中心的停车场出来往前走就是平沙路，这段路不算长，两侧是典型的江南风格民居，夹着几家卖小吃和纪念品的店铺。

剡(Shàn)江

（2）当地海苔千层饼

因为下雨，我们也没在街上多逛。正好到了饭点，我上大众点评找了家评分不错的店，叫荷悦餐厅，就在蒋氏故居旁边，打算吃完饭顺道去看看。去餐厅的路上，看到一家卖饼的小店，这种饼以前没见过，问了才知道是当地的千层饼。我买了几个尝尝，咸香口，面上铺着厚厚一层海苔粉，一口咬下去，酥得掉渣

酥脆掉渣的千层饼1

酥脆掉渣的千层饼2

（3）荷悦餐厅

吃了千层饼后过了个红绿灯就到了饭店，我们在点评买了个159块的套餐，一共五道菜：炸小鱼、油爆虾、梅干菜烧肉、炒时蔬、番茄鸡蛋汤

椒盐小溪鱼，外表金黄酥脆，但略显火候过了头，少了点鲜香
油爆虾哈哈，微辣开胃，水准在线
梅干菜烧肉，肥而不腻，梅干菜香浓，下饭神器
清炒上海青，家常菜，清淡爽口
番茄鸡蛋汤，家常菜

荷悦餐厅

（4）奉化芋头

奉化盛产芋头，街边一筐筐码得整整齐齐，只不过景区门口的价格偏高，差不多一公斤二十块，真要买的话我建议是再往街里面走走也许会更便宜

奉化芋艿头

（5）武山庙

路过武山庙，因为下雨，庙前聚了不少人歇脚，我们也在门口石墩停留了一会，细雨落在屋檐上，声音很轻

武山庙

（6）武岭西路步行街

雨一直没停，临时在小卖铺买了几件雨披，我们披上后继续沿着武岭西路步行街慢慢走

武岭西路步行街溜达1

来一张合影吧

（7）麦当劳躲雨

雨越下越大，只好钻进麦当劳躲雨。我们等了半个小时，雨势依旧，不见示弱，但我们最后还是决定冒雨上山，到时候路不好走的话再回去，毕竟人都来了！

麦当劳躲雨

上山#

爬上山坡后，老天倒是给面子，雨变成了毛毛雨。朝对面山上望去，云雾缭绕的，多少有那么点意思

缓慢爬山1

被雨水浇过的梅花，开得格外扎眼，这一路上我们走走停停，各种玩、各种拍

缓慢爬山2

缓慢爬山1

缓慢爬山2

在半山腰，粉色的梅花成片开，其中也有几颗白色的梅花，互相映衬，因为下雨，几乎没有花香（很淡吧，要靠很近才能闻到），反倒是泥土的气息更重

梅花1

梅花2

梅花3

再来合影吧

继续往里走，雾越来越浓，四周静得出奇，只剩雨点敲在叶子上的声音，和我们急促的呼吸，如果是自己一个人的话，这种环境多少有点慌

山里穿梭1

山里穿梭2

下山路特别滑，不少人直接坐进泥里。我们也没好到哪去，人均摔了几次（第二天屁股老疼了）。快到出口时，遇到一片盛开的梅花丛，小沟渠在旁边缓缓流过，有些春天的实感。

梅花丛

原以为是轻松的5公里，下雨后难度直接翻倍，虽然很狼狈，但是还挺好玩的，打算下次再组队去别打地方徒步

佳明数据#

佳明数据截图1

（完）

Dynamics 365项目中常用的SQL语句(持续更新)

Mon, 17 Feb 2025 00:00:00 GMT

1. 查询指定实体下的所有系统视图#

该查询用于快速检索 Dynamics 365 中特定实体（如客户、联系人）下配置的所有系统视图

1
-- Example: Query all views and their Ids under the Account entity
2
SELECT
3
    v.SavedQueryId AS 'View Id',
4
    v.Name AS 'View name',
5
    v.returnedtypecode AS 'Owning entity'
6
FROM
7
    SavedQuery v
8
WHERE
9
    returnedtypecode = 'account'

2. 检索系统报表清单与元数据#

通过查询报表主表，可以获取环境中所有报表的详细信息，包括创建人、创建时间及文件名称，常用于报表资产盘点或清理闲置报表

1
SELECT reportid,
2
       name,
3
       filename,
4
       description,
5
       owneridname,
6
       componentstatename,
7
       createdon,
8
       createdbyname
9
FROM   report;

3. 查询Annotation容量#

1
-- Warning: May freeze if data is large
2
-- 1 MB = 1024 * 1024 Bytes = 1,048,576 Bytes
3
SELECT SUM(filesize) / 1048576 AS TotalFileSizeMB
4
FROM   annotation;

4. 查询特定安全角色的所有分配用户#

此脚本用于审计，清晰列出拥有某个特定安全角色（如“售前顾问”）的所有用户

1
SELECT
2
    systemuser.fullname AS UserFullName,
3
    systemuser.domainname AS DomainName,
4
    systemuser.systemuserid AS UserId,
5
    role.name AS RoleName
6
FROM
7
    systemuserroles
8
INNER JOIN
9
    systemuser ON systemuserroles.systemuserid = systemuser.systemuserid
10
INNER JOIN
11
    role ON systemuserroles.roleid = role.roleid
12
WHERE
13
    role.name = 'Pre-sales' -- Security role name

Query result:

UserFullName	DomainName	UserId	RoleName
Zhang San	zhangsan@sample.com	xxx..	Pre-sales
Li Si	lisi@sample.com	xxx..	Pre-sales

5. 查看用户分配了哪些安全角色#

1
SELECT
2
    su.fullname AS UserFullName,
3
    su.domainname AS DomainName,
4
    su.systemuserid AS UserId,
5
    STRING_AGG(r.name, ', ') AS RoleNames
6
FROM
7
    systemuserroles sur
8
INNER JOIN
9
    systemuser su ON sur.systemuserid = su.systemuserid
10
INNER JOIN
11
    role r ON sur.roleid = r.roleid
12
GROUP BY
13
    su.fullname,
14
    su.domainname,
15
    su.systemuserid
16
ORDER BY
17
    su.fullname

展开收起

查询结果：

UserFullName	DomainName	UserId	RoleName
Zhang San	zhangsan@sample.com	xxx	Pre-sales, Sales Manager
Li Si	lisi@sample.com	xxx	Pre-sales, Sales Director, System Administrator

（完）

Plugin Registration Tool安装指南

Sun, 16 Feb 2025 00:00:00 GMT

详细介绍Dynamics 365 Plugin Registration Tool的两种安装方式，直接下载安装包与 PowerShell脚本自动化安装。

Plugin Registration Tool是 Dynamics 365 开发中用于注册和管理插件的核心工具。另外，如果你不想单独安装Plugin Registration Tool，也可以直接在 XrmToolBox 中安装使用

安装方式（一）（推荐）#

此方法直接从NuGet获取安装包，步骤简单直接

Step 1.访问 NuGet Gallery#

地址：NuGet Gallery

Step 2. 下载安装包#

点击右侧的 Download package

download package

Step 3. 解压缩#

修改压缩包后缀名，将下载的文件后缀名更改为.zip

解压缩

解压缩，Plugin Registration 就在 tools 文件夹里

tool文件夹

安装方式（二）#

Step 1. 创建文件夹#

例：D:\Dynamics_365_Development_Tools\pluginsTool

Step 2. Powershell#

PowerShell 进入 D:\Dynamics_365_Development_Tools\pluginsTool

Step 3. 运行代码#

先运行代码：

Terminal window

1
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
2
$sourceNugetExe = "https://dist.nuget.org/win-x86-commandline/latest/nuget.exe"
3
$targetNugetExe = ".\nuget.exe"
4
Remove-Item .\Tools -Force -Recurse -ErrorAction Ignore
5
Invoke-WebRequest $sourceNugetExe -OutFile $targetNugetExe
6
Set-Alias nuget $targetNugetExe -Scope Global -Verbose

再运行代码：

Terminal window

1
##
2
##Download Plugin Registration Tool
3
##
4
./nuget install Microsoft.CrmSdk.XrmTooling.PluginRegistrationTool -O .\Tools
5
md .\Tools\PluginRegistration
6
$prtFolder = Get-ChildItem ./Tools | Where-Object {$_.Name -match 'Microsoft.CrmSdk.XrmTooling.PluginRegistrationTool.'}
7
move .\Tools\$prtFolder\tools\*.* .\Tools\PluginRegistration
8
Remove-Item .\Tools\$prtFolder -Force -Recurse

附录：PowerShell 代码#

Terminal window展开收起

1
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
2
$sourceNugetExe = "https://dist.nuget.org/win-x86-commandline/latest/nuget.exe"
3
$targetNugetExe = ".\nuget.exe"
4
Remove-Item .\Tools -Force -Recurse -ErrorAction Ignore
5
Invoke-WebRequest $sourceNugetExe -OutFile $targetNugetExe
6
Set-Alias nuget $targetNugetExe -Scope Global -Verbose
7
##
8
##Download Plugin Registration Tool
9
##
10
./nuget install Microsoft.CrmSdk.XrmTooling.PluginRegistrationTool -O .\Tools
11
md .\Tools\PluginRegistration
12
$prtFolder = Get-ChildItem ./Tools | Where-Object {$_.Name -match 'Microsoft.CrmSdk.XrmTooling.PluginRegistrationTool.'}
13
move .\Tools\$prtFolder\tools\*.* .\Tools\PluginRegistration
14
Remove-Item .\Tools\$prtFolder -Force -Recurse
15
##
16
##Download CoreTools
17
##
18
./nuget install  Microsoft.CrmSdk.CoreTools -O .\Tools
19
md .\Tools\CoreTools
20
$coreToolsFolder = Get-ChildItem ./Tools | Where-Object {$_.Name -match 'Microsoft.CrmSdk.CoreTools.'}
21
move .\Tools\$coreToolsFolder\content\bin\coretools\*.* .\Tools\CoreTools
22
Remove-Item .\Tools\$coreToolsFolder -Force -Recurse
23
##
24
##Download Configuration Migration
25
##
26
./nuget install  Microsoft.CrmSdk.XrmTooling.ConfigurationMigration.Wpf -O .\Tools
27
md .\Tools\ConfigurationMigration
28
$configMigFolder = Get-ChildItem ./Tools | Where-Object {$_.Name -match 'Microsoft.CrmSdk.XrmTooling.ConfigurationMigration.Wpf.'}
29
move .\Tools\$configMigFolder\tools\*.* .\Tools\ConfigurationMigration
30
Remove-Item .\Tools\$configMigFolder -Force -Recurse
31
##
32
##Download Package Deployer
33
##
34
./nuget install  Microsoft.CrmSdk.XrmTooling.PackageDeployment.WPF -O .\Tools
35
md .\Tools\PackageDeployment
36
$pdFolder = Get-ChildItem ./Tools | Where-Object {$_.Name -match 'Microsoft.CrmSdk.XrmTooling.PackageDeployment.Wpf.'}
37
move .\Tools\$pdFolder\tools\*.* .\Tools\PackageDeployment
38
Remove-Item .\Tools\$pdFolder -Force -Recurse
39
##
40
##Remove NuGet.exe
41
##
42
Remove-Item nuget.exe

展开收起

（完）

Dynamics 365画布应用(Canvas App)分享给安全组

Mon, 10 Feb 2025 00:00:00 GMT

前言#

最近实施的 Dynamics 365 项目使用了画布应用，在配置用户使用画布应用权限时，有些繁杂，例如新增用户时，现在我们需要：

分配许可证
分配业务部门
分配安全角色
分配画布应用(单独在画布应用中进行共享操作，否则用户就算拥有系统访问权限，也无法在 Power Apps 中看到相应的画布应用)

如果逐一为每个用户手动共享应用，不仅操作繁琐，而且在用户数量超过 100 时，Power Apps 会明确提示：

Caution

Try security groups. For best results, we recommend using security groups to share your app with more than 100 users.

更烦人的是项目通常涉及开发/测试/生产至少三个环境，如果每新加一个用户就要去对应环境分享画布应用，效率很低。相比之下，通过“安全组”共享画布应用，只需在新增用户时将其加入对应的安全组，即可自动获得应用访问权限。这种方法显著提升了多环境和多用户场景下的管理效率。题外话，如果你从没有实践过这两种方式，可能难以体会通过安全组共享的方式带来的效率提升，以下是具体步骤。

具体步骤#

Step 1. 创建安全组#

打开 Microsoft 365 admin center

Tip

注意区分 Microsoft 365 admin center 版本：

国际版：portal.partner.microsoftonline.com

世纪互联版：portal.partner.microsoftonline.cn

导航至：“Teams和组 ” —> “活动团队 & 组” —> “安全性” —> “添加组”
组类型选择 “安全”
根据实际填写 “名称” 和 “说明” ，然后点击 “下一步”
确认信息后点击 “创建组”

Step 2. 将用户添加到安全组#

在用户列表中搜索目标用户
勾选相应用户
点击菜单栏中的 “管理组”
搜索并勾选对应的安全组，点击 “保存更改”

Step 3. 画布应用分享给安全组#

打开 Power Apps 门户

Tip

注意区分 Power Apps 门户 版本：

国际版：https://make.powerapps.com

世纪互联版：https://make.powerapps.cn

切换到 “所有应用” 页面
勾选目标画布应用
点击工具栏上的 “共享” 按钮
搜索并选择创建的安全组
确认选择后点击“共享”

（完）

上海龙华寺（2025年2月）

Sun, 09 Feb 2025 00:00:00 GMT

今天我们和大哥他们一起去了趟龙华寺，我来上海这么多年，坐地铁经常路过龙华寺站，但一直没去看过。这次算是跟着小分队凑个热闹，顺便尝尝龙华寺的斋饭，这才是我的目的

前言#

我这次是真去凑热闹的，他们去龙华寺目的是帮父母买根求根红绳，求平安（好像是本命年）。反正目前我是不信这些东西的，我从小到大，家里逢年过节都会有各种“拜”，拜土地、拜太阳、拜契（我的契是块石头，你敢信？就是拜一块石头），基本上大人让干嘛就干嘛，至于为什么拜，答案大都是赶紧拜，拜了好，记得说点好话云云。直到现在，我其实也没完全搞明白这些仪式具体意味着什么，有什么作用？

龙华寺#

龙华塔，又称“报恩塔”，始建于三国吴赤乌十年（247年），出了地铁后远远就能看到这个塔

龙华塔(又称报恩寺)

在寺门口花了二十块钱，买了一把线香。进了寺，跟着人流走，双手捧着香，绕着龙华塔走了三圈。我留心看了看，有人走到东南西北四个方向，都会停下来拜一拜。也有人简单些，只在南边和北边弯弯腰。

龙华寺1

绕完塔后，他们又去弥勒殿参拜，拜完后把线香插进香池。这个香池挺深的，插的时候得当心，一不小心就容易烫着，要是够不着，直接丢进去也行，反正最后都会有工作人员统一清理焚烧。

龙华寺香池

我在旁边站着看了一会儿，瞧见一群穿着统一马甲、手里拿着装备的人也在拜。没想到这玩意儿还有组团来的。

组团来上香

之后他们去了法务流通处排队买手绳，没想到这么多人买这绳子，后面发现价格还不便宜，稍微震惊一下下。

法务流通处

买了两根绳子，左边的绳子自称是“犯太岁手绳”，右边的是“三合生肖手绳”（说是今年冲太岁的属猪、刑太岁的属虎、破太岁的属猴，都可以佩戴），两根绳子的价格差不了多少，左边的是168块，右边的是198块，估计那根合体手绳覆盖范围广，所以价格贵些。

手绳

他们排队买绳子的时候我在法务流通处旁边发现有个小门，进去瞧了瞧，里面养着几只鹿，还有一口大钟，环境和外面相比安静不少。

小鹿

大钟

买完绳子后往里走不到二百米，便到了食堂，我们点了几碗罗汉面和一些凉菜，都挺好吃的，只不过辣椒不是很香，比如法喜寺的辣椒酱就很好吃。

罗汉面

素鸭与凉拌白菜

自我科普#

1.什么是太岁#

太岁，又称太岁神。古人以干支纪年，十天干、十二地支相配，形成六十种组合，每一种组合对应一位太岁神。民间习俗认为每一年，都会有一位太岁神负责“值守”，监察人间事务。

2.“六十”太岁的来历#

天干与地支两两配对，形成 60 个组合（甲子、乙丑、丙寅……一直到癸亥），这就是六十甲子。每一个组合对应一位太岁神。通俗来说，就是 10 和 12 的最小公倍数。也有说法是“阳配阳，阴配阴”，所以：

一个天干对应六个地支（10×6）
一个地支对应五个天干（12×5）

天干地支

3.犯太岁意味着什么#

当某个生肖与当年的太岁形成：相冲、相刑、相破、相害，就被称为“犯太岁”，民间认为这一年容易遇到不顺。

4.为什么要拜太岁#

简单说就是太岁被视为主管人间运势的重要神灵，拜太岁是一种求平安、求顺遂的心理寄托。

一些感想#

我曾看到这么一个对话，很符合我现在脑子里的想法：

Q同学问：科学这么发达了，为什么还有人信教？

牢A回答他：若你不信神，你的精神力量要从哪里来？

（完）

Firefly 代码块示例

Wed, 01 Jan 2025 00:00:00 GMT

在这里，我们将探索如何使用 Expressive Code 展示代码块。提供的示例基于官方文档，您可以参考以获取更多详细信息。

表达性代码#

语法高亮#

语法高亮

常规语法高亮#

1
console.log("此代码有语法高亮!");

渲染 ANSI 转义序列#

Terminal window展开收起

1
Standard ANSI colors:
2
- Dimmed:      Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
3
- Foreground:  Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
4
- Background:  Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
5
- Reversed:    Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
6

7
8-bit colors (showing colors 160-171 as an example):
8
- Dimmed:      160  161  162  163  164  165  166  167  168  169  170  171 
9
- Foreground:  160  161  162  163  164  165  166  167  168  169  170  171 
10
- Background:  160  161  162  163  164  165  166  167  168  169  170  171 
11
- Reversed:    160  161  162  163  164  165  166  167  168  169  170  171 
12

13
24-bit colors (full RGB):
14
- Dimmed:      ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
15
- Foreground:  ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
16
- Background:  ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
17
- Reversed:    ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
18

19
Font styles:
20
- Default
21
- Bold
22
- Dimmed
23
- Italic
24
- Underline
25
- Reversed
26
- Strikethrough

展开收起

编辑器和终端框架#

编辑器和终端框架

代码编辑器框架#

my-test-file.js

1
console.log("标题属性示例");

src/content/index.html

1
<div>文件名注释示例</div>

终端框架#

Terminal window

1
echo "此终端框架没有标题"

PowerShell 终端示例

1
Write-Output "这个有标题!"

覆盖框架类型#

1
echo "看，没有框架!"

PowerShell Profile.ps1

1
# 如果不覆盖，这将是一个终端框架
2
function Watch-Tail { Get-Content -Tail 20 -Wait $args }
3
New-Alias tail Watch-Tail

文本和行标记#

文本和行标记

标记整行和行范围#

1
// 第1行 - 通过行号定位
2
// 第2行
3
// 第3行
4
// 第4行 - 通过行号定位
5
// 第5行
6
// 第6行
7
// 第7行 - 通过范围 "7-8" 定位
8
// 第8行 - 通过范围 "7-8" 定位

选择行标记类型 (mark, ins, del)#

line-markers.js

1
function demo() {
2
  console.log("此行标记为已删除");
3
  // 此行和下一行标记为已插入
4
  console.log("这是第二个插入行");
5

6
  return "此行使用中性默认标记类型";
7
}

为行标记添加标签#

labeled-line-markers.jsx

1
<button
2
  role="button"
3
  {...props}
4
  value={value}
5
  className={buttonClassName}
6
  disabled={disabled}
7
  active={active}
8
>
9
  {children &&
10
    !active &&
11
    (typeof children === "string" ? <span>{children}</span> : children)}
12
</button>

在单独行上添加长标签#

labeled-line-markers.jsx

1
<button
2
  role="button"
3
  {...props}
4
  value={value}
5
  className={buttonClassName}
6
  disabled={disabled}
7
  active={active}
8
>
9
  {children &&
10
    !active &&
11
    (typeof children === "string" ? <span>{children}</span> : children)}
12
</button>

使用类似 diff 的语法#

1
此行将标记为已插入
2
此行将标记为已删除
3
这是常规行

1
--- a/README.md
2
+++ b/README.md
3
@@ -1,3 +1,4 @@
4
+this is an actual diff file
5
-all contents will remain unmodified
6
 no whitespace will be removed either

结合语法高亮和类似 diff 的语法#

1
function thisIsJavaScript() {
2
  // 整个块都会以 JavaScript 高亮显示，
3
  // 并且我们仍然可以为其添加 diff 标记！
4
  console.log('要删除的旧代码')
5
  console.log('新的闪亮代码！')
6
}

标记行内的单独文本#

1
function demo() {
2
  // 标记行内的任何给定文本
3
  return "支持给定文本的多个匹配项";
4
}

正则表达式#

1
console.log("单词 yes 和 yep 将被标记。");

转义正斜杠#

Terminal window

1
echo "Test" > /home/test.txt

选择内联标记类型 (mark, ins, del)#

1
function demo() {
2
  console.log("这些是插入和删除的标记类型");
3
  // return 语句使用默认标记类型
4
  return true;
5
}

自动换行#

自动换行

为每个块配置自动换行#

1
// 启用换行的示例
2
function getLongString() {
3
  return "这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间";
4
}

1
// wrap=false 的示例
2
function getLongString() {
3
  return "这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间";
4
}

配置换行的缩进#

1
// preserveIndent 示例（默认启用）
2
function getLongString() {
3
  return "这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间";
4
}

1
// preserveIndent=false 的示例
2
function getLongString() {
3
  return "这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间";
4
}

可折叠部分#

可折叠部分


5 collapsed lines
1
// 所有这些样板设置代码将被折叠
2
import { someBoilerplateEngine } from "@example/some-boilerplate";
3
import { evenMoreBoilerplate } from "@example/even-more-boilerplate";
4

5
const engine = someBoilerplateEngine(evenMoreBoilerplate());
6

7
// 这部分代码默认可见
8
engine.doSomething(1, 2, 3, calcFn);
9

10
function calcFn() {
11
  // 您可以有多个折叠部分
3 collapsed lines
12
  const a = 1;
13
  const b = 2;
14
  const c = a + b;
15

16
  // 这将保持可见
17
  console.log(`计算结果: ${a} + ${b} = ${c}`);
18
  return c;
19
}
20

4 collapsed lines
21
// 直到块末尾的所有代码将再次被折叠
22
engine.closeConnection();
23
engine.freeMemory();
24
engine.shutdown({ reason: "示例样板代码结束" });

展开收起

行号#

行号

为每个块显示行号#

1
// 此代码块将显示行号
2
console.log("来自第2行的问候!");
3
console.log("我在第3行");

// 此块禁用行号
console.log("你好?");
console.log("抱歉，你知道我在第几行吗?");

更改起始行号#

5
console.log("来自第5行的问候!");
6
console.log("我在第6行");

Tab 代码块#

由 rehype-code-group 提供，语法与 VitePress 代码组一致：用 ::: code-group labels=[...] 包裹多个代码块，即可合并成一组标签页。

Note

labels=[...] 中的标签按顺序对应组内的代码块，用英文逗号分隔；::: 与 code-group 之间的空格不能省略。

基本用法#

1
::: code-group labels=[code.js, code.py, code.html]
2

3
```js
4
export function greet(name) {
5
  return `Hello, ${name}!`;
6
}
7
```
8

9
```py
10
def greet(name):
11
    return f"Hello, {name}!"
12
```
13

14
```html
15
<p>Hello, world!</p>
16
```
17

18
:::

展开收起

渲染效果：

code.jscode.pycode.html

1
export function greet(name) {
2
  return `Hello, ${name}!`;
3
}

1
def greet(name):
2
    return f"Hello, {name}!"

1
<p>Hello, world!</p>

标签中使用 Emoji#

标签支持 emoji 短代码，构建时会自动转换成 emoji：

1
::: code-group labels=[:package: npm, :package: pnpm, :yarn: yarn]

📦 npm📦 pnpm🧶 yarn

Terminal window

1
npm create astro@latest

Terminal window

1
pnpm create astro@latest

Terminal window

1
yarn create astro

与其他代码块特性组合#

组内仍是普通的 Expressive Code 代码块，标题、行号、行标记、折叠、终端框架等特性都可以照常使用。

配置文件终端折叠

astro.config.mjs

1
export default {
2
  theme: "firefly",
3
  codeGroup: true,
4
};

部署

1
pnpm build && pnpm preview


3 collapsed lines
1
// 这三行默认折叠
2
import { a } from "a";
3
import { b } from "b";
4

5
console.log(a, b);

不止是代码块#

标签页内可以放任意内容，例如文字、列表或图片：

说明列表

这是一段普通的段落内容。

列表项一
列表项二

Tip

标签栏在构建期生成，默认展开第一项；支持鼠标点击与键盘 ← / → / Home / End 切换。

在提醒框内使用（MDX 组件）#

::: code-group 和 ::: tip 等 Docusaurus 风格提醒框都使用 ::: 容器语法，而 micromark-directive 规定父子容器的冒号数必须不同，因此 ::: code-group 无法嵌套在 ::: tip 等提醒框内（整块会失效）。

这种情况改用 MDX 组件 TabGroup：MDX 组件不经过 ::: 指令解析，在提醒框内外都能正常使用，也方便日后扩展更多 UI 组件。把文章后缀改为 .mdx，从统一入口 @/components/firefly-mdx 引入（可一次引入多个组件）：

1
import { TabGroup } from "@/components/firefly-mdx";
2

3
:::tip
4

5
<TabGroup labels={["test.js", "test.py"]} client:load>
6
  ```js
7
  console.log(1)
8
  ```
9

10
```py
11
print("hello world")
12
```
13

14
</TabGroup>
15

16
:::

展开收起

Tip

labels 数组给每个代码块声明标签，顺序一一对应
组件用 client:load 激活标签切换

Firefly 文章加密

Wed, 01 Jan 2025 00:00:00 GMT

这是一篇密码保护的示例文章，用于演示文章加密功能。

Firefly 一款清新美观的 Astro 博客主题模板

Wed, 01 Jan 2025 00:00:00 GMT

🌟 项目概述#

Firefly 是一款基于 Astro 框架和 Fuwari 模板开发的清新美观且现代化个人博客主题模板，专为技术爱好者和内容创作者设计。该主题融合了现代 Web 技术栈，提供了丰富的功能模块和高度可定制的界面，让您能够轻松打造出专业且美观的个人博客网站。

🖥️在线预览： Firefly - Demo site

📝Firefly使用文档： https://docs-firefly.cuteleaf.cn

⭐Firefly开源地址：https://github.com/CuteLeaf/Firefly

⭐Fuwari开源地址：https://github.com/saicaca/fuwari

CuteLeaf

Firefly

🍀Firefly, fresh and aesthetic Astro blog theme template.

✨A static blog template built with Astro.

—

MIT

Astro

Firefly

🚀 技术架构#

静态站点生成: 基于 Astro ，提供极快的加载速度和优秀的 SEO 优化
TypeScript 支持: 完整的类型安全，提升开发体验和代码质量
响应式设计: 使用 Tailwind CSS 构建，完美适配桌面端和移动端
组件化开发: 支持 Astro、Svelte 组件，灵活可扩展

📖 配置说明#

📚 详细配置文档: 查看 Firefly 使用文档获取完整的配置指南

KaTeX 数学公式示例

Wed, 01 Jan 2025 00:00:00 GMT

本文展示了 Firefly 主题对 KaTeX 数学公式的渲染支持。

行内公式 (Inline)#

行内公式使用单个 $ 符号包裹。

例如：欧拉公式 eiπ+1=0e^{i\pi} + 1 = 0eiπ+1=0 是数学中最优美的公式之一。

质能方程 E=mc2E = mc^2E=mc2 也是家喻户晓。

块级公式 (Block)#

块级公式使用两个 $$ 符号包裹，会居中显示。

∫−∞∞e−x2dx=π\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}∫−∞∞e−x2dx=πx=−b±b2−4ac2ax = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}x=2a−b±b2−4ac

复杂示例#

矩阵 (Matrices)#

(abcd)(αβγδ)=(aα+bγaβ+bδcα+dγcβ+dδ)\begin{pmatrix} a & b \\ c & d \end{pmatrix} \begin{pmatrix} \alpha & \beta \\ \gamma & \delta \end{pmatrix} = \begin{pmatrix} a\alpha + b\gamma & a\beta + b\delta \\ c\alpha + d\gamma & c\beta + d\delta \end{pmatrix}(acbd)(αγβδ)=(aα+bγcα+dγaβ+bδcβ+dδ)

极限与求和 (Limits and Sums)#

∑n=1∞1n2=π26\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}n=1∑∞n21=6π2lim⁡x→0sin⁡xx=1\lim_{x \to 0} \frac{\sin x}{x} = 1x→0limxsinx=1

麦克斯韦方程组 (Maxwell’s Equations)#

∇⋅E=ρε0∇⋅B=0∇×E=−∂B∂t∇×B=μ0J+μ0ε0∂E∂t\begin{aligned} \nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \\ \nabla \cdot \mathbf{B} &= 0 \\ \nabla \times \mathbf{E} &= -\frac{\partial \mathbf{B}}{\partial t} \\ \nabla \times \mathbf{B} &= \mu_0\mathbf{J} + \mu_0\varepsilon_0\frac{\partial \mathbf{E}}{\partial t} \end{aligned}∇⋅E∇⋅B∇×E∇×B=ε0ρ=0=−∂t∂B=μ0J+μ0ε0∂t∂E

化学方程式 (Chemical Equations)#

\ceCH4+2O2−>CO2+2H2O\ce{CH4 + 2O2 -> CO2 + 2H2O}\ceCH4+2O2−>CO2+2H2O

符号	代码	渲染结果
Alpha	`\alpha`	α\alphaα
Beta	`\beta`	β\betaβ
Gamma	`\Gamma`	Γ\GammaΓ
Pi	`\pi`	π\piπ
Infinity	`\infty`	∞\infty∞
Right Arrow	`\rightarrow`	→\rightarrow→
Partial	`\partial`	∂\partial∂

Markdown 扩展功能

Wed, 01 Jan 2025 00:00:00 GMT

GitHub 仓库卡片#

您可以添加链接到 GitHub 仓库的动态卡片，在页面加载时，仓库信息会从 GitHub API 获取。

CuteLeaf

Firefly

🍀Firefly, fresh and aesthetic Astro blog theme template.

—

MIT

Astro

使用代码 ::github{repo="CuteLeaf/Firefly"} 创建 GitHub 仓库卡片。

1
::github{repo="CuteLeaf/Firefly"}

提醒框(Admonitions)配置#

Firefly 采用了 rehype-callouts 插件，支持了四种风格的提醒框主题：GitHub、Obsidian、VitePress 和 Docusaurus。您可以在 src/config/siteConfig.ts 中进行配置：

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  // ...
3
  rehypeCallouts: {
4
    // 选项: "github" | "obsidian" | "vitepress" | "docusaurus"
5
    theme: "github",
6
  },
7
  // ...
8
};

注意：更改配置后需要重启开发服务器才能生效。

以下是各个主题支持的类型列表，每个主题风格和语法不同，可根据喜好选择。

1. GitHub 主题风格#

这是 GitHub 官方支持的 5 种基本类型。

GitHub

基本语法

1
> [!NOTE] NOTE
2
> 突出显示用户应该考虑的信息。
3

4
> [!TIP] TIP
5
> 可选信息，帮助用户更成功。
6

7
> [!IMPORTANT] IMPORTANT
8
> 用户成功所必需的关键信息。
9

10
> [!WARNING] WARNING
11
> 关键内容，需要立即注意。
12

13
> [!CAUTION] CAUTION
14
> 行动的负面潜在后果。
15

16
> [!NOTE] 自定义标题
17
> 这是一个带有自定义标题的示例。

展开收起

2. Obsidian 主题风格#

Obsidian 风格支持非常丰富的类型和别名。

点击展开 Obsidian 语法列表

1
> [!NOTE] NOTE
2
> 通用的笔记块。
3

4
> [!ABSTRACT] ABSTRACT
5
> 文章的摘要。
6

7
> [!SUMMARY] SUMMARY
8
> 文章的总结（同 Abstract）。
9

10
> [!TLDR] TLDR
11
> 太长不看（同 Abstract）。
12

13
> [!INFO] INFO
14
> 提供额外信息。
15

16
> [!TODO] TODO
17
> 需要完成的事项。
18

19
> [!TIP] TIP
20
> 实用技巧或提示。
21

22
> [!HINT] HINT
23
> 暗示（同 Tip）。
24

25
> [!IMPORTANT] IMPORTANT
26
> 重要信息（Obsidian 风格通常使用类似的图标）。
27

28
> [!SUCCESS] SUCCESS
29
> 操作成功。
30

31
> [!CHECK] CHECK
32
> 检查通过（同 Success）。
33

34
> [!DONE] DONE
35
> 已完成（同 Success）。
36

37
> [!QUESTION] QUESTION
38
> 提出问题。
39

40
> [!HELP] HELP
41
> 寻求帮助（同 Question）。
42

43
> [!FAQ] FAQ
44
> 常见问题（同 Question）。
45

46
> [!WARNING] WARNING
47
> 警告信息。
48

49
> [!CAUTION] CAUTION
50
> 注意事项（同 Warning）。
51

52
> [!ATTENTION] ATTENTION
53
> 引起注意（同 Warning）。
54

55
> [!FAILURE] FAILURE
56
> 操作失败。
57

58
> [!FAIL] FAIL
59
> 失败（同 Failure）。
60

61
> [!MISSING] MISSING
62
> 缺失内容（同 Failure）。
63

64
> [!DANGER] DANGER
65
> 危险操作警告。
66

67
> [!ERROR] ERROR
68
> 错误信息（同 Danger）。
69

70
> [!BUG] BUG
71
> 报告软件缺陷。
72

73
> [!EXAMPLE] EXAMPLE
74
> 展示一个例子。
75

76
> [!QUOTE] QUOTE
77
> 引用一段话。
78

79
> [!CITE] CITE
80
> 引证（同 Quote）。
81

82
> [!NOTE] 自定义标题
83
> 这是一个带有自定义标题的示例。

展开收起

Obsidian

3. VitePress 主题风格#

VitePress 风格提供了一套现代化的、扁平的默认样式。目前仅包含与 GitHub 一致的 5 种 基础类型。

点击展开 VitePress 语法列表

1
> [!NOTE] NOTE
2
> 对应 GitHub 的 Note。
3

4
> [!TIP] TIP
5
> 对应 GitHub 的 Tip。
6

7
> [!IMPORTANT] IMPORTANT
8
> 对应 GitHub 的 Important。
9

10
> [!WARNING] WARNING
11
> 对应 GitHub 的 Warning。
12

13
> [!CAUTION] CAUTION
14
> 对应 GitHub 的 Caution。
15

16
> [!TIP] 自定义标题
17
> VitePress 风格同样支持自定义标题。

展开收起

VitePress

4. Docusaurus 主题风格#

Docusaurus 风格提供了一套现代化的提醒框样式，支持 5 种类型。

点击展开 Docusaurus 语法列表

支持以下类型的提醒框：note tip info warning danger

1
:::note
2
突出显示用户应该考虑的信息，即使在快速浏览时也是如此。
3
:::
4

5
:::tip
6
可选信息，帮助用户更成功。
7
:::
8

9
:::info
10
一般信息。
11
:::
12

13
:::warning
14
由于潜在风险需要用户立即注意的关键内容。
15
:::
16

17
:::danger
18
行动的负面潜在后果。
19
:::
20

21
:::tip[自定义标题]
22
可选信息，帮助用户更成功。
23
:::

展开收起

Docusaurus

剧透#

您可以为文本添加剧透。文本也支持 Markdown 语法。

内容被隐藏了哈哈！

1
内容 :spoiler[被隐藏了 **哈哈**]！

图片画廊网格 (Image Grid)#

您可以使用 [grid] 和 [/grid] 标签将多张图片纵向并排展示。这对于展示照片画廊或对比图非常有用。系统会自动根据包裹在其中的图片数量（最多支持并排展示4张）以响应式网格进行布局。

自动补齐图片高度： 同一排中如果有高度、大小或者比例不一的图片，会像「九宫格画廊相册」一样自动撑满。较短或不协调的图片会自动使用 object-cover 进行完美中心裁剪补充视野。图片边框水平彻底对齐无缝隙，但被裁剪后，只有点击图片通过灯箱才能查看完整图片，所以建议尽量避免使用长宽比例不一致的图片在同一排中。

图注恒定底端对齐： 不论上面的图片长宽如何变化，在同一行的所有图像解释文字（图注）都会对标到一条完美的水平基线上了。

示例图片一

示例图片二

基本语法

1
[grid]
2
![示例图片一](/assets/images/firefly1.avif)
3
![示例图片二](/assets/images/firefly2.avif)
4
![示例图片二](/assets/images/firefly3.avif)
5
[/grid]

Markdown Mermaid 图表

Wed, 01 Jan 2025 00:00:00 GMT

Markdown 中 Mermaid 图表完整指南#

本文演示如何在 Markdown 文档中使用 Mermaid 创建各种复杂图表，包括流程图、时序图、ER 图、类图、状态图、XY 图、甘特图、思维导图等。

Mermaid 图表由 Merman 实现。Firefly 在 Astro 构建阶段生成亮色和深色两套静态 SVG，无需在浏览器中加载 Mermaid 渲染运行时。可以前往 Merman Playground 实时编辑语法并预览渲染结果。

流程图示例#

流程图非常适合表示流程或算法步骤。

是

否

选项 1

选项 2

选项 3

子过程详情

子步骤 1

子步骤 2

子步骤 3

开始

条件检查

处理步骤 1

处理步骤 2

另一个决策

结果 1

结果 2

结果 3

结束

是

否

选项 1

选项 2

选项 3

子过程详情

子步骤 1

子步骤 2

子步骤 3

开始

条件检查

处理步骤 1

处理步骤 2

另一个决策

结果 1

结果 2

结果 3

结束

时序图示例#

时序图显示对象之间随时间的交互。

数据库服务器网页应用用户数据库服务器网页应用用户alt[认证成功][认证失败]提交登录请求发送认证请求查询用户凭据返回用户数据返回认证结果显示欢迎页面请求用户数据获取用户偏好返回偏好设置返回用户数据加载个性化界面显示错误消息提示重新输入

ER 图示例#

ER 图（实体关系图）非常适合表示数据库结构。

writes

posts

has

belongs to

USER

int

string

username

string

datetime

created_at

ARTICLE

int

string

title

text

content

datetime

published

int

author_id

COMMENT

int

text

content

datetime

created_at

int

user_id

int

article_id

类图示例#

类图显示系统的静态结构，包括类、属性、方法及其关系。

写作

发表

拥有

属于

User

+String username

+String password

+String email

+Boolean active

+login()

+logout()

+updateProfile()

Article

+String title

+String content

+Date publishDate

+Boolean published

+publish()

+edit()

+delete()

Comment

+String content

+Date commentDate

+addComment()

+deleteComment()

状态图示例#

状态图显示对象在其生命周期中经历的状态序列。

提交

拒绝

批准

发布

归档

撤回

草稿

审核中

已批准

已归档

已发布

临时隐藏

恢复

活跃

隐藏

提交

拒绝

批准

发布

归档

撤回

草稿

审核中

已批准

已归档

已发布

临时隐藏

恢复

活跃

隐藏

XY 图示例#

XY 图表非常适合展示趋势和对比数据。

月度访问量趋势1月2月3月4月5月6月5000450040003500300025002000150010005000访问量

饼图示例#

饼图适合直观展示各部分在整体中的占比。

45%30%15%10%内容类型占比技术文章 [45]项目记录 [30]生活随笔 [15]其他 [10]

甘特图示例#

甘特图可以按时间轴展示项目阶段、任务依赖和当前进度。

07/0107/0307/0507/0707/0907/1107/1307/1507/17需求整理视觉设计功能实现内容迁移构建检查正式上线准备开发发布博客版本发布计划

思维导图示例#

思维导图适合梳理主题层级和知识结构。

Firefly

内容

技术文章

生活记录

体验

搜索

深色模式

图表

工程

Astro

Svelte

Merman

Firefly

内容

技术文章

生活记录

体验

搜索

深色模式

图表

工程

Astro

Svelte

Merman

时间线示例#

时间线用于按年份或阶段呈现项目的重要事件。

2024建立博客完成基础主题2025加入搜索与图库完善内容系统2026升级 Astro 7使用 Merman 渲染图表Firefly 演进时间线

用户旅程图示例#

用户旅程图能够描述用户在不同阶段的行为和体验评分。

读者

发现内容

发现内容读者

打开首页

打开首页读者

搜索主题

阅读文章

阅读文章读者

浏览正文

浏览正文读者

查看图表

继续探索

继续探索读者

查看相关文章

查看相关文章读者

分享文章

分享文章读者浏览文章的旅程

读者

发现内容

发现内容读者

打开首页

打开首页读者

搜索主题

阅读文章

阅读文章读者

浏览正文

浏览正文读者

查看图表

继续探索

继续探索读者

查看相关文章

查看相关文章读者

分享文章

分享文章读者浏览文章的旅程

Git 图示例#

Git 图可以清晰展示分支、提交和合并历史。

mainfeatureinitadd-diagramspolish-themesmerge-featurerelease

看板示例#

看板适合展示任务在不同工作阶段之间的分布。

待办

进行中

已完成

整理需求

准备示例

接入 Merman

服务端渲染

亮暗主题

待办

进行中

已完成

整理需求

准备示例

接入 Merman

服务端渲染

亮暗主题

Sankey 图示例#

Sankey 图通过连线宽度展示流量在不同节点之间的流向。

Home 1650Post list 1200Search 450Post detail 1220Related posts 260External shares 180

总结#

Mermaid 是在 Markdown 文档中创建各种类型图表的强大工具。本文演示了流程图、时序图、ER 图、类图、状态图、XY 图、饼图、甘特图、思维导图、时间线、用户旅程图、Git 图、看板和 Sankey 图。这些图表可以帮助您更清晰地表达复杂的概念、流程和数据结构。

要使用 Mermaid，只需在代码块中指定 mermaid 语言，并使用简洁的文本语法描述图表。图表会在构建时自动渲染为 SVG，无需客户端 JavaScript 加载。

可以前往 Merman Playground 尝试更多语法，再将图表代码粘贴到文章中。

Markdown PlantUML 图表

Wed, 01 Jan 2025 00:00:00 GMT

Markdown 中 PlantUML 图表指南#

PlantUML 是一种使用纯文本描述图表的工具。你只需要写一段结构化语法，就可以生成时序图、类图、用例图、活动图等常见工程图。

它特别适合写在技术博客和项目文档里：

图表和正文一起版本管理，便于协作与审阅
修改图只需要改文本，适合频繁迭代
能和 Markdown 无缝结合，保持文档统一

在 Firefly 中，plantuml 代码块会在构建阶段编码并生成服务器 SVG 地址，页面端再根据亮暗主题自动切换图源，并支持缩放、拖拽和全屏交互。

如果你想快速上手，可以记住这个最小模板：

活动图示例#

状态图示例#

用例图示例#

组件图示例#

部署图示例#

ER 图示例#

时序图示例（登录与刷新令牌）#

C4 风格容器图示例#

Markdown 教程

Wed, 01 Jan 2025 00:00:00 GMT

这是一个展示如何编写 Markdown 文件的示例。本文档汇总了核心语法与常见扩展（GFM）。

块级元素
- 段落与换行
- 标题
- 引用
- 列表
- 代码块
- 分割线
- 表格
内联元素
- 链接
- 强调
- 行内代码
- 图片
- 删除线
杂项
- 自动链接
- 反斜杠转义
内联 HTML

块级元素#

段落与换行#

段落#

HTML 标签：<p>

使用一个或多个空行分隔段落。（仅包含空格或制表符的行也视为空行。）

代码：

1
This will be
2
inline.
3

4
This is second paragraph.

预览：

This will be inline.

This is second paragraph.

换行#

HTML 标签：<br />

在行末添加两个或更多空格来产生换行。

代码：

1
This will be not
2
inline.

预览：

This will be not
inline.

标题#

Markdown 支持两种标题样式：Setext 与 atx。

Setext#

HTML 标签：<h1>，<h2>

使用等号 (=) 表示 <h1>、使用短横线 (-) 表示 <h2>，数量不限，作为“下划线”。

代码：

1
This is an H1
2
=============
3
This is an H2
4
-------------

预览：

This is an H1#

This is an H2#

atx#

HTML 标签：<h1>，<h2>，<h3>，<h4>，<h5>，<h6>

在行首使用 1-6 个井号 (#)，对应 <h1> 至 <h6>。

代码：

1
# This is an H1
2
## This is an H2
3
###### This is an H6

预览：

This is an H1#

This is an H2#

This is an H6#

可选：你可以在行尾“闭合” atx 标题。末尾的井号数量不必与开头一致。

代码：

1
# This is an H1 #
2
## This is an H2 ##
3
### This is an H3 ######

预览：

This is an H1#

This is an H2#

This is an H3#

引用#

HTML 标签：<blockquote>

Markdown 使用邮件风格的 > 作为引用符号。若手动换行并在每行前加 >，显示效果最佳。

代码：

1
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
2
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4
>
5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
> id sem consectetuer libero luctus adipiscing.

预览：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

Markdown 允许“偷懒”：在一个硬换行段落中，只在第一行前加 > 即可。

代码：

1
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
2
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4

5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
id sem consectetuer libero luctus adipiscing.

预览：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

引用可以嵌套（引用中的引用），通过增加 > 层级实现。

代码：

1
> This is the first level of quoting.
2
>
3
> > This is nested blockquote.
4
>
5
> Back to the first level.

预览：

This is the first level of quoting.
This is nested blockquote.
Back to the first level.

引用内可包含其他 Markdown 元素，包括标题、列表与代码块。

代码：

1
> ## This is a header.
2
>
3
> 1.   This is the first list item.
4
> 2.   This is the second list item.
5
>
6
> Here's some example code:
7
>
8
>     return shell_exec("echo $input | $markdown_script");

预览：

This is a header.#

This is the first list item.

This is the second list item.

Here’s some example code:
1
return shell_exec("echo $input | $markdown_script");

列表#

Markdown 支持有序（数字）与无序（圆点）列表。

无序列表#

HTML 标签：<ul>

无序列表可使用 星号 (*)、加号 (+) 或 短横线 (-)。

代码：

1
*   Red
2
*   Green
3
*   Blue

预览：

Red
Green
Blue

等价于：

代码：

1
+   Red
2
+   Green
3
+   Blue

或者：

代码：

1
-   Red
2
-   Green
3
-   Blue

有序列表#

HTML 标签：<ol>

有序列表使用数字加英文句点：

代码：

1
1.  Bird
2
2.  McHale
3
3.  Parish

预览：

Bird
McHale
Parish

注意：像下面这样可能会“意外触发”有序列表：

代码：

1
1986. What a great season.

预览：

What a great season.

你可以用反斜杠转义 (\) 句点：

代码：

1
1986\. What a great season.

预览：

1986. What a great season.

列表中的缩进内容#

列表项里的引用#

在列表项内放置引用，需要将 > 符号整体缩进：

代码：

1
*   A list item with a blockquote:
2

3
    > This is a blockquote
4
    > inside a list item.

预览：

A list item with a blockquote:

This is a blockquote inside a list item.

列表项里的代码块#

在列表项内放置代码块，需要缩进两层——8 个空格或两个 Tab：

代码：

1
*   A list item with a code block:
2

3
        <code goes here>

预览：

A list item with a code block:
```
1
<code goes here>
```

嵌套列表#

代码：

1
* A
2
  * A1
3
  * A2
4
* B
5
* C

预览：

A
- A1
- A2
B
C

代码块#

HTML 标签：<pre>

将代码块中的每行缩进至少4 个空格或1 个制表符。

代码：

1
This is a normal paragraph:
2

3
    This is a code block.

预览：

This is a normal paragraph:

1
This is a code block.

代码块会一直持续，直到遇到未缩进的行（或文末）。

在代码块内，与号 (&) 和尖括号 (< >) 会自动转为 HTML 实体。

代码：

1
    <div class="footer">
2
        &copy; 2004 Foo Corporation
3
    </div>

预览：

1
<div class="footer">
2
    &copy; 2004 Foo Corporation
3
</div>

下文的“围栏代码块”和“语法高亮”属于扩展语法，你也可以用它们来书写代码块。

围栏代码块#

使用成对的反引号围起来（如下所示），就不需要四空格缩进了。

代码：

1
Here's an example:
2

3
```
4
function test() {
5
  console.log("notice the blank line before this function?");
6
}
7
```

预览：

Here’s an example:

1
function test() {
2
  console.log("notice the blank line before this function?");
3
}

语法高亮#

在围栏代码块后添加可选的语言标识，即可启用语法高亮（参见支持语言列表）。

代码：

1
```ruby
2
require 'redcarpet'
3
markdown = Redcarpet.new("Hello World!")
4
puts markdown.to_html
5
```

预览：

1
require 'redcarpet'
2
markdown = Redcarpet.new("Hello World!")
3
puts markdown.to_html

分割线（水平线）#

HTML 标签：<hr /> 一行中放置三个或以上的短横线 (-)、星号 (*) 或下划线 (_)。符号之间允许有空格。

代码：

1
* * *
2
***
3
*****
4
- - -
5
---------------------------------------
6
___

预览：

表格#

HTML 标签：<table>

这是扩展语法。

用竖线 (|) 分隔列，用短横线 (-) 分隔表头，使用冒号 (:) 指定对齐方式。

两侧的竖线 (|) 与对齐可选。用于表头分隔时，每列至少需要 3 个短横线。

代码：

1
| Left | Center | Right |
2
|:-----|:------:|------:|
3
|aaa   |bbb     |ccc    |
4
|ddd   |eee     |fff    |
5

6
 A | B
7
---|---
8
123|456
9

10

11
A |B
12
--|--
13
12|45

预览：

Left	Center	Right
aaa	bbb	ccc
ddd	eee	fff

A	B
123	456

A	B
12	45

内联元素#

链接#

HTML 标签：<a>

Markdown 支持两种链接样式：行内链接与引用式链接。

行内链接#

行内链接格式：[文本](URL "标题")

标题可选。

代码：

1
This is [an example](http://example.com/ "Title") inline link.
2

3
[This link](http://example.net/) has no title attribute.

预览：

This is an example inline link.

This link has no title attribute.

如果引用同一站点的本地资源，可以使用相对路径：

代码：

1
See my [About](/about/) page for details.

预览：

See my About page for details.

引用式链接#

可以预定义链接引用。定义格式：[id]: URL "标题"

标题同样可选。引用时使用：[文本][id]

代码：

1
[id]: http://example.com/  "Optional Title Here"
2
This is [an example][id] reference-style link.

预览：

This is an example reference-style link.

说明：

方括号中包含链接标识（不区分大小写，可在左侧缩进最多三格空格）；
随后是冒号；
再跟一个或多个空格（或 tab）；
然后是链接 URL；
URL 可选地用尖括号包裹；
可选地跟随标题属性，用引号或圆括号包裹。

以下三种定义等价：

代码：

1
[foo]: http://example.com/  "Optional Title Here"
2
[foo]: http://example.com/  'Optional Title Here'
3
[foo]: http://example.com/  (Optional Title Here)
4
[foo]: <http://example.com/>  "Optional Title Here"

如果使用空的方括号，则链接文本本身会作为名称。

代码：

1
[Google]: http://google.com/
2
[Google][]

预览：

Google

强调#

HTML 标签：<em>，<strong>

Markdown 使用 星号 (*) 或 下划线 (_) 表示强调。一个分隔符对应 <em>；两个分隔符对应 <strong>。

代码：

1
*single asterisks*
2

3
_single underscores_
4

5
**double asterisks**
6

7
__double underscores__

预览：

single asterisks

single underscores

double asterisks

double underscores

但如果两侧有空格，则会被视作普通字符而非强调语法。

你可以使用反斜杠进行转义：

代码：

1
\*this text is surrounded by literal asterisks\*

预览：

*this text is surrounded by literal asterisks*

行内代码#

HTML 标签：<code>

用反引号 (`) 包裹。

代码：

1
Use the `printf()` function.

预览：

Use the printf() function.

若行内代码中需要包含反引号字符，可使用多重反引号作为定界符：

代码：

1
``There is a literal backtick (`) here.``

预览：

There is a literal backtick (`) here.

行内代码两侧的定界符允许包含空格（开头一个、结尾一个），方便在代码起始或结尾放置反引号字符：

代码：

1
A single backtick in a code span: `` ` ``
2

3
A backtick-delimited string in a code span: `` `foo` ``

预览：

A single backtick in a code span: `

A backtick-delimited string in a code span: `foo`

图片#

HTML 标签：<img />

Markdown 的图片语法与链接类似，支持行内与引用两种方式。

行内图片#

行内图片语法：![替代文本](URL "标题")

标题可选。

代码：

1
![Alt text](/path/to/img.jpg)
2

3
![Alt text](/path/to/img.jpg "Optional title")

预览：

Alt text

说明：

一个感叹号 !；
后接方括号，放置图片的替代文本；
再接圆括号，内含图片 URL/路径，及可选的标题（引号包裹）。

引用式图片#

引用式图片语法：![替代文本][id]

代码：

1
[img id]: https://s2.loli.net/2024/08/20/5fszgXeOxmL3Wdv.webp  "Optional title attribute"
2
![Alt text][img id]

预览：

Alt text

删除线#

HTML 标签：<del>

这是扩展语法。

GFM 增加了删除线语法。

代码：

1
~~Mistaken text.~~

预览：

Mistaken text.

杂项#

自动链接#

Markdown 支持一种便捷写法来创建“自动链接”（URL 与邮箱地址）：只需用尖括号将其包住即可。

代码：

1
<http://example.com/>
2

3
<address@example.com>

预览：

http://example.com/

address@example.com

GFM 会自动识别标准 URL 并转换为链接。

代码：

1
https://github.com/emn178/markdown

预览：

https://github.com/emn178/markdown

反斜杠转义#

Markdown 允许使用反斜杠来转义那些本用于 Markdown 语法的特殊字符，使其按字面显示。

代码：

1
\*literal asterisks\*

预览：

*literal asterisks*

以下字符可通过反斜杠转义以按字面量输出：

Code:

1
\   backslash
2
`   backtick
3
*   asterisk
4
_   underscore
5
{}  curly braces
6
[]  square brackets
7
()  parentheses
8
#   hash mark
9
+   plus sign
10
-   minus sign (hyphen)
11
.   dot
12
!   exclamation mark

内联 HTML#

对于 Markdown 语法未覆盖的标记，直接使用原生 HTML 即可。无需特别声明从 Markdown 切换到 HTML，直接写标签就行。

代码：

1
This is a regular paragraph.
2

3
<table>
4
    <tr>
5
        <td>Foo</td>
6
    </tr>
7
</table>
8

9
This is another regular paragraph.

预览：

This is a regular paragraph.

Foo

This is another regular paragraph.

请注意：在块级 HTML 标签内不会处理 Markdown 语法。

与块级标签不同，在行内级标签内会处理 Markdown 语法。

代码：

1
<span>**Work**</span>
2

3
<div>
4
    **No Work**
5
</div>

预览：

Work

**No Work**

***

什么是VV/RV/PV/UV？

Wed, 01 Jan 2025 00:00:00 GMT

快速了解四个指标#

指标	英文全称	中文含义	通俗理解
VV	Visit View	访问次数	用户打开了网站几次（会话数）
RV	Repeat Visitor	重复访客	来了又来的老用户
PV	Page View	页面浏览量	所有页面被看了多少次
UV	Unique Visitor	独立访客	有多少个用户来过（去重）

用一个逛博客的故事来理解#

假设有一天发生了这些事情：

小明今天打开了你博客 3 次
每次进来都看了 2 个页面
小红今天打开了你博客 1 次
看了 1 个页面

那么数据可以这样理解：

指标	含义	对应本例
UV	独立访客数（人）	2（小明 + 小红）
VV	访问次数（会话）	4（小明 3 次 + 小红 1 次）
PV	页面浏览量	7（小明 6 + 小红 1）
RV	重复访客	1（小明）

常见误区

UV ≠ PV，一个用户可以刷很多页面
VV ≠ UV，一个用户可以来很多次
PV 高不一定说明用户多，可能只是页面跳转多、或者内容分散

什么时候关注哪个？

产品 / 市场：更关心 UV、RV（有没有人来、会不会再来
内容 / 博客：更关心 PV（内容是否被持续阅读）
运营分析：会把 VV + UV + PV 放一起看趋势

（完）

在文章中嵌入视频

Wed, 01 Jan 2025 00:00:00 GMT

只需从 YouTube 或其他平台复制嵌入代码，然后将其粘贴到 markdown 文件中。

1
---
2
title: 在文章中嵌入视频
3
published: 2023-10-19
4
// ...
5
---
6

7
<iframe width="100%" height="468" src="https://www.youtube.com/embed/5gIf0_xpFPI?si=N1WTorLKL0uwLsU_" title="YouTube video player" frameborder="0" allowfullscreen></iframe>

YouTube#

Bilibili#

杭州法喜寺和十里锒铛（2024年12月）

Mon, 30 Dec 2024 00:00:00 GMT

1.目的地#

(1)法喜寺

杭州山里有三座古寺，被称为天竺三寺，其中建得最晚的一座，就是上天竺——法喜寺。别看是“最晚”，也已经在山里待了一千多年，听说乾隆还亲笔题过“法喜寺”三字，现在看，多少还能感受到点皇家气息

(2)十里锒铛

十里琅珰这个名字就很有画面感，也有人叫它郎当岭、琅珰岭，早年还叫“扪壁岭”。它在西湖西侧，从龙井村一路往山里走，连接五云山和天竺一带，全程差不多十里，因此得名

2.路线与准备#

(1)路线

法喜寺 —> 龙井村 —> 十里琅珰 —> 三分叉 —> 瞭望亭 —> 真际院 —> 云栖竹径，全程大约十公里，这个距离对新手算是很友好了

徒步路线图

(2)装备与补给，准备其实很简单：

运动服，建议待个薄外套，下山会冷，容易感冒
小背包
运动鞋
水、少量零食

3.行程安排#

08：00 ~ 12：00 抵达法喜寺
12：00 ~ 13：00 吃斋饭、在寺庙里到处逛逛
13：00 ~ 17：30 徒步
17：30 ~ 20：00 返程

4.记录过程#

（1）法喜寺#

进法喜寺要花十块钱买门票，也可以在网上订（微信、支付宝扫码），我推荐网上买，不用排队

法喜寺入口

一进去，右手边就是饭堂。正好到了饭点，肚子也饿了，就打算先吃口饭再逛。饭票五块钱一个人，饭菜挺合我胃口

斋饭

从饭堂出来没多远，立着几块碑。上面字多，我也懒得细看，倒是注意到刻着“安”“孝”“子”这几个字的地方，被人摸得锃光瓦亮的（估计是某种祈福）

红框的是已经被摸得秃噜皮的字

接下来就是逛寺庙。法堂、藏经阁这些，跟别的寺庙也差不太多。今天天气好，阳光从窗户透进来，好好拍的话，应该能出几张片子

窗

藏经阁

寺庙的院子里有几座小塔，塔顶上落了不少白鸽。一只只都白白胖胖的，有的站在屋檐上，有的倚在树枝上，看着都挺悠闲

屋檐上的鸽子

鸽子

（2）登山途中#

从法喜寺出来，跟着人流走，或者找人打听一下，就能找到十里锒铛的入口。入口离法喜寺不远，也就两三百米。这条徒步路线挺火的，就算一个人来也完全没问题，不用担心迷路

石板路

徒步途中，来合张影吧

这条路线大多数都是石板路，山上种满了茶树。我们跟着人流在山脊上慢悠悠的走着

沿着山脊走

连绵山脊

因为天气好的缘故，还能看到远处的钱塘江

钱塘江远景

山上到处是金灿灿的叶子，随手一拍，都不算太差

叶子1

叶子2

走到另一座山头上，山顶上种着一棵千年银杏树，树冠大得很，路过这棵树会不自觉地放慢了脚步看它。我们去的时候，它已经秃了顶，也不知道夏天能不能长出叶子来，要是真长满了绿叶，在底下乘凉那该有多爽

上千年的银杏树1

上千年的银杏树2

上千年的银杏树3

（3）下山#

路过银杏树后，就开始进入下山路段，坡度很缓和。

下山走到云栖竹径时，我们看到一群人在哪里烧纸草，后来在车上我查了下这处地方，原来是莲花大师墓

下山的林间小路

祭扫人群

（完）

使用JavaScript设置可编辑子网格为只读

Thu, 26 Dec 2024 00:00:00 GMT

在 Dynamics 365 模型驱动应用(Model-driven App) 中，可编辑子网格(Editable Subgrid)为数据录入提供了非常高效的体验

但在某些业务场景下，我们可能希望子网格整体可编辑，但部分列只读，或在特定时机(如选中行后)，临时禁止编辑

遗憾的是Dynamics 365并没有提供开箱即用的方式来控制可编辑子网格中单个列的只读状态。因此，通常需要通过 JavaScript Client API 在子网格行被选中时动态控制字段的可编辑性

本文将介绍两种常见实现方式：

将子网格中所有列设置为只读
仅将指定列设置为只读

全部列设置为只读#

下面的示例中，在子网格行被选中时，遍历当前行的所有字段，并将其对应的控件统一设置为只读。

1
Disabled_XXXXX_SubGridOnSelect: function (ExecutionContext) {
2
    let that = this;
3
    let objFormContext = ExecutionContext.getFormContext();
4
    let entObject = objFormContext.data.entity;
5
    entObject.attributes.forEach(function (attribute) {
6
            let allColumnControl = attribute.controls.get(0);
7
            allColumnControl.setDisabled(true);
8
        });
9
}

指定列设置为只读#

如果只需要控制部分字段，可以根据字段的 Logical Name 进行判断

1
Disabled_XXXXX_SubGridOnSelect: function (ExecutionContext) {
2
    let objFormContext = ExecutionContext.getFormContext();
3
    let entObject = objFormContext.data.entity;
4
    entObject.attributes.forEach(function (attribute) {
5
        let columnName = attribute.getName();
6
        if (
7
            columnName == "your field name 1" ||
8
            columnName == "your field name 2" ||
9
            columnName == "your field name 3" ||
10
            columnName == "your field name 4" ||
11
            columnName == "your field name 5" ||
12
            columnName == "your field name 6") {
13
            attribute.controls.get(0).setDisabled(true);
14
        }
15
    });
16
}

展开收起

事件绑定方式#

打开目标表单，选中可编辑子网格，为其绑定上述 JavaScript 方法。

需要注意两点：

事件选择：On Record Select
勾选：将执行上下文作为第一个参数传递

Bind JavaScript to Editable Subgrid

（完）

Dynamics 365 SSRS导出PDF

Sun, 15 Dec 2024 00:00:00 GMT

本文介绍如何在Dynamics 365中限制SSRS报表只能导出PDF(自定义)

背景#

最近在实施一个 Dynamics 365 项目，我们为报价单自定义开发了一张蛮复杂的 SSRS 报表(甲方公司各种复杂的计算公式、报价单格式布局、审批人签章)，用作销售团队向客户提供的标准报价模板，但是他们管理层反馈现在销售部门的用户在系统里打印报价单可以选择很多种导出格式(如下截图)，担心他们导出成 Excel 格式后继续在线下“加工”，希望系统限制一下，只能导出 PDF 格式

报表导出页面

因为 Dynamics 365 标准的报表“另存为”本身就是可以选择怎么多格式，同时我还咨询了微软，这些格式并不能做配置隐藏掉，所以只能想想别的办法了！

Note

其实就算系统限制只能导出 PDF 格式，也防止不了用户继续在线下“加工”，毕竟 PDF 也是可以编辑的，这也只能是“防君子不防小人”

解决思路#

经过综合考虑(考虑到现有报表已投入大量开发资源)，采用了方案二，通过自定义按钮实现直接导出SSRS报表的PDF文件

方案	实现方式	优点	缺点
方案一前端生成 PDF	使用第三方 JS 库（如 PrintJS）重新设计报表	完全自定义，控制灵活	需要重新开发，成本较高
方案二 JS调用SSRS导出PDF	通过 JavaScript 调用现有 SSRS 报表，强制导出 PDF 格式	复用现有报表，开发效率高	依赖现有报表结构

详细步骤(JS调用SSRS导出PDF)#

假设#

客户实体上有一张自定义的 SSRS 报表，报表名称为 PrintAccount.rdl，现在我们将在客户实体上新添自定义按钮，点击按钮后直接导出这张报表的 PDF 文件，下面是详细的实现步骤

Step 1. 添加Web资源#

在 Web 资源中创建 Account.js 文件
将附录中的完整代码复制到文件中
保存后务必发布更改

添加Javascript脚本

Step 2. 配置自定义按钮#

Tip

这里我使用新版的按钮编辑界面，你也可以使用 Ribbon Workbench 添加按钮，达到目的就行

(1) 登录 Power Apps → 应用 → 选择应用 → 编辑

选择编辑命令栏-01

(2) 选择客户视图 → 编辑命令栏

选择编辑命令栏-02

(3) 选择 Main Form

选择 Main Form

(4) 绑定Account.js，并填写相关属性

Label：Export Account info
Action：Run JavaScript
Library：gdh_/Account/Account.js (根据实际情况填写)
Parameter 1：Gdh.D365.Account.ExportPrintAccountReportPDF (根据实际情况填写)

绑定Account.js

最后保存并发布

补充说明#

1. 为什么不使用“Convert to PDF”功能？#

为什么不使用系统的标准功能来实现生成PDF

因为”Convert to PDF”功能存在以下限制：

关联数据过滤问题：无法过滤停用的关联记录
举个例子：客户与联系人是一对多关系，使用 Word 模板转 PDF 时，即使联系人已停用，仍会显示在输出中

2. Account.js 中的 CRM_FilteredAccount 在哪里找？#

代码中的 CRM_FilteredAccount 是 SSRS 报表的参数，用于传递 FetchXML 查询条件：

CRM_FilteredAccount

3. Account.js 核心方法说明#

ExportPrintAccountReportPDF(); → 导出 PDF 主方法
GetReportIdByReportFileName(); → 获取报表 ID
ExecuteReport(); → 执行报表生成
Get_SSRS_Report_PDFBase64(); → 获取 PDF Base64 数据

附录#

Account.js#

1
/**
2
 * Account Entity Javascript.
3
 */
4
if (Gdh === undefined) {
5
  var Gdh = {};
6
}
7
if (Gdh.D365 === undefined) {
8
  Gdh.D365 = {};
9
}
10
Gdh.D365.Account = (function () {
11
  "use strict";
12
  return {
13
    Constants: {
14
      Fields: {
15
        AccountName: "name",
16
        Phone: "telephone1",
17
        Fax: "fax",
18
        Website: "websiteurl",
19
      },
20
      Reports: {
21
        PrintAccountReport: "PrintAccount.rdl",
22
      },
23
      SystemAdminId: "SystemAdminId",
24
    },
25
    OnLoad: function (ExecutionContext) {
26
      try {
27
        let objFormContext = ExecutionContext.getFormContext();
28
      } catch (e) {
29
        console.error("Error during OnLoad: ", e);
30
      }
31
    },
32
    ExportPrintAccountReportPDF: function (primaryControl) {
33
      let objFormContext = primaryControl;
34
      let CurrentAccountId = objFormContext.data.entity
35
        .getId()
36
        .replace("{", "")
37
        .replace("}", "");
38
      let that = this;
39
      console.log(CurrentAccountId, CurrentAccountId);
40
      let selectAttributes = `${that.Constants.Fields.AccountName}`;
41
      console.log(selectAttributes, selectAttributes);
42
      let accountEn = this.RetrieveSingleRecord(
43
        "accounts",
44
        CurrentAccountId,
45
        selectAttributes,
46
      );
47
      let accountName = accountEn[this.Constants.Fields.AccountName];
48
      // CRM_FilteredAccount -> SSRS report argument
49
      let reportPrefilter =
50
        "CRM_FilteredAccount=" +
51
        "<fetch version='1.0' output-format='xml-platform' mapping='logical' distinct='false'>" +
52
        "<entity name='account'>" +
53
        "  <all-attributes />" +
54
        "  <filter type='and'>" +
55
        "    <condition attribute='accountid' operator='eq' value='" +
56
        CurrentAccountId +
57
        "' />" +
58
        "  </filter>" +
59
        "</entity>" +
60
        "</fetch>";
61
      let arrReportSession = this.ExecuteReport(
62
        this.Constants.Reports.PrintAccountReport,
63
        reportPrefilter,
64
      );
65
      this.Get_SSRS_Report_PDFBase64(arrReportSession, 2052)
66
        .then(function (base64String) {
67
          // Size of the file in KB
68
          let fSize =
69
            encodeURIComponent(base64String).replace(/%../g, "x").length / 1024;
70
          let openFileOptions = { openMode: 2 };
71
          let file = {};
72
          file.fileContent = base64String;
73
          file.fileSize = fSize;
74
          // Set file name
75
          file.fileName = accountName + " - Info" + ".pdf";
76
          file.mimeType = "application/pdf";
77
          Xrm.Navigation.openFile(file, openFileOptions);
78
        })
79
        .catch(function (error) {
80
          console.error(error);
81
        });
82
    },
83
    GetReportIdByReportFileName: function (reportFileName) {
84
      let lValue = "";
85
      let lResponse = this.RetrieveMultipleRecord(
86
        "reports",
87
        "filename eq '" + reportFileName + "'",
88
        "reportid",
89
        false,
90
      );
91
      if (
92
        lResponse !== null &&
93
        lResponse !== undefined &&
94
        lResponse.value.length > 0
95
      ) {
96
        lValue = lResponse.value[0]["reportid"];
97
      }
98
      return lValue;
99
    },
100
    ExecuteReport: function (reportFileName, reportPrefilter) {
101
      let reportGuid = this.GetReportIdByReportFileName(reportFileName);
102
      let pth = this.GetClientUrl() + "/CRMReports/rsviewer/ReportViewer.aspx";
103
      let orgUniqueName = Xrm.Utility.getGlobalContext().getOrgUniqueName();
104
      let query =
105
        "id=%7B" +
106
        reportGuid +
107
        "%7D&uniquename=" +
108
        orgUniqueName +
109
        "&iscustomreport=true&reportnameonsrs=&reportName=" +
110
        reportFileName +
111
        "&isScheduledReport=false&p:" +
112
        reportPrefilter;
113
      let retrieveEntityReq = new XMLHttpRequest();
114
      retrieveEntityReq.open("POST", pth, false);
115
      retrieveEntityReq.setRequestHeader("Accept", "*/*");
116
      retrieveEntityReq.setRequestHeader(
117
        "Content-Type",
118
        "application/x-www-form-urlencoded",
119
      );
120
      retrieveEntityReq.send(query);
121
      let x = retrieveEntityReq.responseText.lastIndexOf("ReportSession=");
122
      let y = retrieveEntityReq.responseText.lastIndexOf("ControlID=");
123
      let ret = [];
124
      ret[0] = retrieveEntityReq.responseText.slice(x + 14, x + 14 + 24);
125
      ret[1] = retrieveEntityReq.responseText.slice(y + 10, y + 10 + 32);
126
      return ret;
127
    },
128
    /**
129
     *
130
     * @param {any} arrResponseSession
131
     * @param {any} lcId (Language code)
132
     * @returns
133
     */
134
    Get_SSRS_Report_PDFBase64: function (arrResponseSession, lcId) {
135
      let that = this;
136
      return new Promise(function (resolve, reject) {
137
        let pth =
138
          that.GetClientUrl() +
139
          "/Reserved.ReportViewerWebControl.axd?ReportSession=" +
140
          arrResponseSession[0] +
141
          "&Culture=" +
142
          lcId +
143
          "&CultureOverrides=True&UICulture=" +
144
          lcId +
145
          "&UICultureOverrides=True&ReportStack=1&ControlID=" +
146
          arrResponseSession[1] +
147
          "&OpType=Export&FileName=Public&ContentDisposition=OnlyHtmlInline&Format=PDF";
148
        let retrieveEntityReq = new XMLHttpRequest();
149
        retrieveEntityReq.open("GET", pth, true);
150
        retrieveEntityReq.setRequestHeader("Accept", "*/*");
151
        retrieveEntityReq.responseType = "arraybuffer";
152
        retrieveEntityReq.onreadystatechange = function () {
153
          if (
154
            retrieveEntityReq.readyState == 4 &&
155
            retrieveEntityReq.status == 200
156
          ) {
157
            let binary = "";
158
            let bytes = new Uint8Array(this.response);
159
            for (let i = 0; i < bytes.byteLength; i++) {
160
              binary += String.fromCharCode(bytes[i]);
161
            }
162
            let base64PDFString = btoa(binary);
163
            resolve(base64PDFString);
164
          }
165
        };
166
        retrieveEntityReq.send();
167
      });
168
    },
169
    GetClientUrl: function () {
170
      let lGlobalContext = "";
171
      try {
172
        lGlobalContext = Xrm.Utility.getGlobalContext();
173
      } catch (e) {
174
        lGlobalContext = parent.Xrm.Utility.getGlobalContext();
175
      }
176

177
      if (lGlobalContext !== null) {
178
        return lGlobalContext.getClientUrl();
179
      }
180
      return null;
181
    },
182
    RetrieveMultipleRecord: function (
183
      lEntityName,
184
      lFilter,
185
      lCommaSeparatedAttributeNames,
186
      isAdmin,
187
    ) {
188
      let lResponse = null;
189
      let lXMLHttpRequest = new XMLHttpRequest();
190
      lXMLHttpRequest.open(
191
        "GET",
192
        this.GetClientUrl() +
193
          "/api/data/v9.2/" +
194
          lEntityName +
195
          "?$select=" +
196
          lCommaSeparatedAttributeNames +
197
          "&$filter=" +
198
          lFilter,
199
        false,
200
      );
201
      lXMLHttpRequest.setRequestHeader("OData-MaxVersion", "4.0");
202
      lXMLHttpRequest.setRequestHeader("OData-Version", "4.0");
203
      lXMLHttpRequest.setRequestHeader("Accept", "application/json");
204
      lXMLHttpRequest.setRequestHeader(
205
        "Content-Type",
206
        "application/json; charset=utf-8",
207
      );
208
      lXMLHttpRequest.setRequestHeader(
209
        "Prefer",
210
        'odata.include-annotations="*"',
211
      );
212
      // If IsAdmin is true, it is executed as an administrator
213
      if (isAdmin) {
214
        lXMLHttpRequest.setRequestHeader(
215
          "MSCRMCallerID",
216
          this.GetConfigurationValue(this.Constants.SystemAdminId),
217
        );
218
      }
219
      lXMLHttpRequest.onreadystatechange = function () {
220
        if (this.readyState === 4) {
221
          lXMLHttpRequest.onreadystatechange = null;
222
          if (this.status === 200) {
223
            lResponse = JSON.parse(this.response);
224
          } else {
225
            Xrm.Navigation.openAlertDialog(
226
              "An exception has occurred, please contact the system administrator.",
227
            );
228
            console.log("Error:");
229
            console.log(this.statusText);
230
          }
231
        }
232
      };
233
      lXMLHttpRequest.send();
234
      return lResponse;
235
    },
236
    RetrieveSingleRecord: function (
237
      lEntityName,
238
      lEntityId,
239
      lCommaSeparatedAttributeNames,
240
      admin,
241
    ) {
242
      let lResponse = null;
243
      let lXMLHttpRequest = new XMLHttpRequest();
244
      lXMLHttpRequest.open(
245
        "GET",
246
        this.GetClientUrl() +
247
          "/api/data/v9.2/" +
248
          lEntityName +
249
          "(" +
250
          lEntityId +
251
          ")" +
252
          "?$select=" +
253
          lCommaSeparatedAttributeNames,
254
        false,
255
      );
256
      lXMLHttpRequest.setRequestHeader("OData-MaxVersion", "4.0");
257
      lXMLHttpRequest.setRequestHeader("OData-Version", "4.0");
258
      lXMLHttpRequest.setRequestHeader("Accept", "application/json");
259
      lXMLHttpRequest.setRequestHeader(
260
        "Content-Type",
261
        "application/json; charset=utf-8",
262
      );
263
      lXMLHttpRequest.setRequestHeader(
264
        "Prefer",
265
        'odata.include-annotations="*"',
266
      );
267
      if (admin) {
268
        lXMLHttpRequest.setRequestHeader(
269
          "MSCRMCallerID",
270
          this.GetConfigurationValue(this.Constants.SystemAdminId),
271
        );
272
      }
273
      lXMLHttpRequest.onreadystatechange = function () {
274
        if (this.readyState === 4) {
275
          lXMLHttpRequest.onreadystatechange = null;
276
          if (this.status === 200) {
277
            lResponse = JSON.parse(this.response);
278
          } else {
279
            Xrm.Navigation.openAlertDialog(
280
              "An exception has occurred, please contact the system administrator.",
281
            );
282
            console.log("Error:");
283
            console.log(this.statusText);
284
          }
285
        }
286
      };
287
      lXMLHttpRequest.send();
288
      return lResponse;
289
    },
290
    /**
291
     * Get Configuration Value
292
     * P.S: This is my own new configuration entity, there are two main fields: (1) name , (2) value.
293
     * if you need to use, please create and modify the following field information
294
     * @param {any} configName
295
     * @returns
296
     */
297
    GetConfigurationValue: function (configName) {
298
      let lValue = "";
299
      let lResponse = this.RetrieveMultipleRecord(
300
        "Your Config Entity Logical Collection Name",
301
        "gdh_name eq '" + configName + "'",
302
        "gdh_value",
303
      );
304
      if (
305
        lResponse !== null &&
306
        lResponse !== undefined &&
307
        lResponse.value.length > 0
308
      ) {
309
        lValue = lResponse.value[0][this.Constants.ConfigurationsField.Value];
310
      }
311
      return lValue;
312
    },
313
  };
314
})();

展开收起

（完）

青椒肉丝卤，一顿能吃三碗饭

Fri, 13 Dec 2024 00:00:00 GMT

材料#

青椒、肉丝、蒜、葱

备料#

肉丝投洗干净，攥干水份
腌肉丝：少量盐、胡椒粉、生抽，抓匀，然后放入兑好的淀粉水（土豆淀粉最佳）
切青椒（青椒丝）、蒜末、葱末

操作#

起锅放油，下肉丝，中小火炒至变色
炒至变色后放入葱末、蒜末、青椒，炒香
然后加入生抽、老抽、少许蚝油提鲜
翻炒均匀后加入热水（末过食材），盖盖
大概焖煮4~5分钟，加入食盐，然后进行勾芡即可出锅

为Dynamics 365添加系统更新日志页面(自定义)

Thu, 12 Dec 2024 00:00:00 GMT

前言#

最近在实施一个项目，经常有用户问这次发版更新了什么内容，系统有没有画面能看到等待，基于这个背景，我在 Dynamics 365 加了个自定义的系统更新日志页面，用于集中展示系统的更新记录

效果展示#

系统更新日志页面效果示例

实现思路#

整体设计思路比较简单，以日期作为更新日志的一级维度进行汇总，在每个日期下，再细分具体的更新内容。因此，我们只需要在系统新建2个实体：

系统更新日志：用于记录更新日期等汇总信息
系统更新日志明细：用于记录具体的更新内容

在此基础上，通过一个自定义的 HTML Web 资源，使用 FetchXML 获取数据并进行前端展示

实现步骤#

新建 “系统更新日志” 实体
新建 “系统更新日志明细” 实体
新建并配置自定义 HTML Web 资源

使用说明#

创建 “系统更新日志” 实体
创建 “系统更新日志明细” 实体
新建 SystemUpdateLog_v1.html Web 资源，该资源我上传在Github仓库：Github-SystemUpdateLog_v1.html

根据自己的实际情况，替换代码中实体的逻辑名称和字段的逻辑名称

SystemUpdateLog_v1.html展开收起

1
// 根据自己的实际情况，替换代码中实体的逻辑名称和字段的逻辑名称
2
const App = {
3
            data() {
4
                return {
5
                    Constants: {
6
                        Entities: {
7
                            // [!code highlight:4]
8
                            log: "gdh_system_update_log",
9
                            logCollection: "gdh_system_update_logs",
10
                            logDetail: "gdh_system_update_log_detail",
11
                            logDetailCollection: "gdh_system_update_log_details",
12
                        },
13
                        Fields: {
14
                            // log entitie field
15
                            // [!code highlight:3]
16
                            log_UpdateDate: "gdh_date",
17
                            log_Remark: "gdh_remark",
18
                            log_id: "gdh_system_update_logid",
19

20
                            // log detail entitie field
21
                            // [!code highlight:4]
22
                            logDetail_SystemModel: "gdh_systemtype",
23
                            logDetail_UpdateType: "gdh_updatetype",
24
                            logDetail_Content: "gdh_content",
25
                            logDetail_RefLog: "gdh_system_update_log",
26

27
                            // common statecode
28
                            state: "statecode",
29
                        }
30
                    },
31
                    fLogData: [],
32
                };
33
            }

展开收起

前端依赖资源#

页面依赖以下 3 个前端资源，需要提前上传为 Web 资源（可在我的 GitHub 仓库中获取）：

Github仓库

vue3.js
element-plus.js
element-plus.css

（完）

Dynamics 365添加按钮组（按钮列表）

Thu, 12 Dec 2024 00:00:00 GMT

前言#

在实施 Dynamics 365 项目时，一般需要添加自定义按钮的话，通常是添加单个按钮，也就是在某个视图或表单上添加一个自定义按钮，点击按钮后触发某个逻辑，但有时候表单按钮上的“单个”按钮太多会导致有些按钮会显示在 “…” 里面，用户很难察觉，如下截图

表单按钮栏省略号

这个时候我们可以考虑使用“按钮组”，把单一业务场景使用的按钮都归在一起，方便用户操作。最近正好有一个类似的改善，需要在表单上以“分组”的形式展示多个按钮，顺手把这个配置过程记录下来，方便以后查阅

Note

本示例是在商机实体(Opportunity)表单上添加按钮组/按钮列表，下面是具体的配置步骤

配置步骤#

Step 1. 打开 Ribbon Workbench 并加载目标实体#

这里是正常操作了，不做过多的赘述。需要注意的是需要使用 Ribbon Workbench 才可以添加按钮组/按钮列表，目前新版本的 Command 还不支持添加

Step 2. 添加 FLYOUT 组件到按钮栏#

在按钮栏(Command Bar)中拖入一个 FLYOUT 组件，它将作为按钮组的入口

添加FLYOUT组件

Step 3. 展开 FLYOUT 的子窗口#

点击刚刚添加的 FLYOUT 组件，将其对应的小窗口(Flyout Panel)显示出来，后续的按钮配置都在这里完成

点击FLYOUT组件弹出的小窗口

Step 4. 添加 MENU SECTION 组件#

将 MENU SECTION 组件拖入到 FLYOUT 的小窗口中，它相当于按钮组中的一个“分组容器”

将MENU SECTION组件拖到小窗口中

Step 5. 修改 MENU SECTION 的标题（按钮组名称）#

选中 MENU SECTION，修改其 Title，这个标题会作为按钮组在界面上显示的名称

修改 MENU SECTION 的 Title

Tip

如果你发现按钮名称没有立刻更新，通常是前端界面未刷新导致的，解决方法很简单：点击一次空白区域，再重新点击该按钮即可

Step 6. 在 MENU SECTION 下添加按钮#

现在就可以在 MENU SECTION 下方继续插入按钮了，后续对按钮的配置（如 Command、Enable Rule、Display Rule 等）与添加单个按钮的操作完全一致，这里不再赘述

在MENU SECTION下方插入按钮

参考#

Customize commands and the ribbon

（完）

Dynamics 365 发展历程

Thu, 21 Nov 2024 00:00:00 GMT

#1 三个关键阶段#

Microsoft Dynamics CRM发展过程可以分为三个关键阶段:

早期探索 (1.0-4.0)
品牌统一与功能丰富期 (CRM 2011-2016)
革命性的云时代 (Dynamics 365)

#2 时间线#

2016 - 至今
Dynamics 365 革命性的云时代
- 核心变革：Dynamics 365不再是一个单一产品，而是模块化（按需付费）的商业应用平台。它将销售、服务、营销等CRM能力，与财务、供应链等ERP能力无缝整合在一个统一的平台上。
- 技术与生态融合：这一阶段全面拥抱 Power Platform（Power BI, Power Apps, Power Automate），使低代码定制和流程自动化变得前所未有的简单。同时，统一接口确保了在PC、平板和手机上的体验一致性。
- 持续创新模式：MS改为每年两次的发布波次（4-9月为Wave 1，10-3月为Wave 2），持续为产品注入新功能。
2015、2016年（品牌统一与功能丰富期）
Dynamics CRM 2015 & 2016 深化集成
这一时期的核心是深化与 Office 365 的集成，并增强了销售自动化和分析能力。特别值得一提的是，2016 版引入了互动服务中心，专为客服人员设计了沉浸式的工作台，这个组件后来在 Dynamics 365 中演进为客户服务中心。
2013年（品牌统一与功能丰富期）
Dynamics CRM 2013 效率提升
在2011版的基础上进一步刷新了界面，提升了系统性能，并通过业务流程流来引导用户规范地完成工作。
2011年（品牌统一与功能丰富期）
Dynamics CRM 2011 体验飞跃
版本号5.x。这次更新带来了全新的、更现代的用户体验，并首次引入了仪表盘和实时分析功能，让管理者能更直观地掌握业务动态。
2007年（早期探索与市场进入）
Dynamics CRM 4.0 战略转型
这是一个里程碑式的版本。它带来了两项影响深远的变革：一是推出了在线服务SaaS版本，即Dynamics CRM Online，与 Salesforce 直接竞争；二是技术上实现了多租户架构，为企业上云铺平了道路。同时，它支持多语言和多币种，国际化能力大大增强
2005年（早期探索与市场进入）
Dynamics CRM 3.0 品牌确立
品牌确立，这是第一次以 Dynamics CRM 命名的版本，标志着产品功能的扩展，开始引入基础的营销自动化和报表功能，不再局限于销售自动化。
2003年（早期探索与市场进入）
CRM 1.0 初露锋芒
MS 进入 CRM 市场并非一蹴而就，而是通过与自身优势深度捆绑的策略逐步打开局面（很重要，利用自身优势）。
基于.NET 框架构建，最大的特点是深度集成了 Microsoft Outlook 和 SQL Server，利用MS生态的熟悉度降低用户的学习门槛。当时，它主要被视为一个增强版的“数字名片盒”，功能集中于联系人管理和邮件营销。

#3 其他说明#

Power Platform#

Power Platform 是 MS 为企业打造的一个低代码/无代码的应用平台，它主要由四个部分组成，侧重解决不同的问题。我们可以把 Power Platform 想象成一个乐高工厂，它提供了一系列现成的、功能强大的乐高积木和工具，让业务人员、流程经理、数据分析师这些非专业乐高建筑师也能亲手搭出自己需要的建筑。

组件	我的通俗理解	侧重点
Power BI	数据仪表盘	看数据，让用户通过拖拽，快速生成可视化的图表和报告，洞察业务状况
Power Apps	积木块	快速开发应用，用户通过拖拽，就能创建可在电脑、手机、平板上运行的定制化应用（如：员工报修应用、项目审批应用）
Power Automate	传动轴	自动处理重复任，让用户创建“当A发生时，自动执行B”的自动化流程（如：收到客户填写的表单邮件后，自动在日历中创建日程并通知负责人）务
Power Virtual Agents	智能对话	快速搭建智能客服机器人，让用户通过图形化界面，无需写代码就能创建能自动回答常见问题的智能聊天机器人

Power Platform 和 Dynamics 365#

Dynamics 365 是建立在 Power Platform 之上的应用，MS在开发 Dynamics 365 时，就是直接使用 Power Platform 的核心技术和组件（特别是 Microsoft Dataverse，一个统一的数据平台）来构建的。这意味着 Dynamics 365 天生就和 Power Platform 同根同源。

即 Power Platform 是一个面向所有人的、强大的低代码开发平台。Dynamics 365 是基于这个平台构建的一套高级、标准的业务应用（CRM/ERP）。两者结合：Dynamics 365 提供了最佳实践的“骨架”，而 Power Platform 提供了根据业务需求量身定制的能力。它们共同构成了一个既能开箱即用，又能无限扩展的强大商业应用生态。

（完）

为Dynamics 365选项(OptionSet)添加颜色标签

Thu, 14 Nov 2024 00:00:00 GMT

介绍在Dynamics 365中为选项字段(OptionSet)添加颜色标签

视图/表单/子网格/快速创建表单效果展示#

1.视图效果#

视图效果

2.表单效果#

表单效果

3.子网格效果#

子网格效果

4.快速创建表单效果#

快速创建表单效果

详细步骤#

无论是全局添加还是“局部”添加，都需要先设置选项颜色

设置选项颜色

Step 1.全局添加（一次设置，多处生效）#

全局设置指仅需在一个位置配置，即可在视图、表单、子网格等所有位置显示选项颜色。

(1)打开解决方案#

Tip

请使用经典UI界面操作，目前新版UCI界面中我没能找到对应设置位置，如果您知道如何在新版界面中设置，欢迎在评论区分享交流

(2)添加组件#

选择实体，添加控件

添加控件

选择 Power Apps 网格控件

添加网格空间

将 启用选项集颜色 设置为“是”，并确保 Power Apps 网格控件 在 Web 端等平台启用。

启用选项颜色

最后记得保存并发布

Step 2.局部添加#

局部添加的意思是你只想在某个位置(子网格、快速创建表单、常规表单等)为选项添加颜色，步骤都是一样的，下面我以在快速创建表单添加为例：

打开快速创建表单
选中选项字段，点击“更改属性”
在字段属性选项卡上选择“控件”Tab
添加 OptionSet Wrapper 控件，然后设置 OptionSet Wrapper 控件在Web端等启用
保存并发布即可

局部添加控件

（完）

Dynamics 365使用FetchXML创建自定义报表

Thu, 17 Oct 2024 00:00:00 GMT

本文是 Dynamics 365 SSRS 报表开发的完整指南，不仅涵盖从 Visual Studio 环境搭建到使用 FetchXML 创建自定义报表的全过程，还包含“获取用户最后一次登录时间”的实例、连接字符串配置及报表发布步骤

1. 环境搭建#

请按下面的顺序执行以下步骤，否则会出现意想不到的问题

Visual studio 2019 → 开发环境
SQL Server Data Tools → 报表设计基础工具
Microsoft Reporting Services Projects 下载
重启电脑 → 确保组件正确加载
安装 Dynamics 365 Report Authoring Extension 下载

Tip

完成第3步安装后必须重启计算机！

重启后再继续安装 Dynamics 365 Report Authoring Extension 扩展

2. 实例：获取用户最后一次登录时间#

Step 1. 创建报表项目#

打开 Visual Studio 2019，选择 “创建新项目”
在搜索框中输入 “报表”，选择 “报表服务器项目”
点击 “下一步”，输入一个有意义的项目名称，然后创建项目

Visual studio 2019 创建报表项目

项目创建成功后，文件结构如下：

Visual studio 2019 报表项目文件结构

Step 2. 添加报表文件#

右击报表项目下的 “报表” 文件夹(上面截图中D365CrmSampleCode.Reports项目下的报表文件夹)
选择 “添加” → “新建项”
选择 “报表” 模板，输入一个有意义的报表名称(中文、英文都可以)

Visual studio 2019 添加报表

Step 3. 配置数据源#

右击左侧报表数据面板中的 “数据源” 文件夹 → 选择 “添加新数据源”
设置数据源属性，请看下方表格

#	数据源属性	值
1	名称	输入一个有意义的名称就行，一般我写的是 “DynamicsCRMDataSource”
2	类型	选择 “Microsoft Dynamics 365 Fetch”
3	连接字符串	根据实际情况填写，格式为 `{环境URL}/{环境唯一名称}`

Tip

(1) 如果不小心关掉了左侧的“报表数据”，可以通过快捷键重新打开，快捷键：Ctrl + Alt + D

(2) 连接字符串获取方法可以参考本文补充说明章节中的 “获取连接字符串”

点击添加数据源

填写数据源属性信息

Step 4. 准备 FetchXML 查询#

本实例使用到的 FetchXML 如下

1
<fetch aggregate="true">
2
  <entity name="audit">
3
    <attribute name="createdon" alias="LastLoginDate" aggregate="max" />
4
    <filter>
5
      <condition attribute="operation" operator="eq" value="4" />
6
    </filter>
7
    <link-entity name="systemuser" from="systemuserid" to="objectid" link-type="inner" alias="SystemUser">
8
      <attribute name="fullname" alias="FullName" groupby="true" />
9
      <attribute name="domainname" alias="DomainName" groupby="true" />
10
      <attribute name="isdisabled" alias="IsDisabled" groupby="true" />
11
      <attribute name="accessmode" alias="AccessMode" groupby="true" />
12
      <attribute name="userlicensetype" alias="UserLicenseType" groupby="true" />
13
    </link-entity>
14
  </entity>
15
</fetch>

展开收起

Step 5. 创建数据集#

右击右击左侧报表数据面板中的 “数据集” 文件夹 → 选择 “添加数据集”

添加数据集

配置数据集属性：
- 使用 “嵌入在报表中的数据集”
- 选择之前创建的数据源(DynamicsCRMDataSource)
- 查询类型选择 “文本”
- 粘贴 Step 4 中的 FetchXML

Tip

首次连接时会弹出 Dynamics 365 登录框，请使用开发账号登录

填写数据集信息

Step 6. 设计报表界面#

添加标题：从工具箱拖拽 “文本框” 控件，输入报表标题

添加文本框组件

添加表格：拖拽 “表(Table)” 控件到设计区域，设计列标题和样式

添加表格组件

Step 7. 绑定数据字段#

以 “用户名称” 列为例，后续是列操作都是差不多的，相信你能搞定的！

右击单元格 → 选择 “表达式”
在表达式编辑器中，双击 “字段” 下的 “FullName”
点击 “确定” 完成绑定。

数据绑定

重复上述步骤，为所有列绑定对应字段：

为各列添加表达式

Step 8. 预览报表#

点击 “Preview” 选项卡查看报表效果：

预览报表

最终的效果如下：

效果

Step 9. 发布到 Dynamics 365#

进入 Power Apps 门户，创建或打开解决方案
点击 “新建” → 选择 “报表”

在解决方案新添报表

上传 .rdl 文件，填写一个有意义的报表名称

填写报表信息

完成后将会看到我们新建的报表，打开报表就可以查看了

在环境中打开报表

补充说明#

自定义报表的分类#

在 Dynamics 365 中，自定义报表主要分为两类：

全局类报表，如本例所示，可通过报表实体或视图工具栏访问
单记录类报表，通常嵌入在业务记录表单中，接收特定记录的 GUID 作为参数

获取连接字符串#

连接字符串格式：{环境URL}/{环境唯一名称}

例如你的环境 URL 是 https://sample.crm.dynamics.cn，你的环境唯一名称是 123456789，那么完整的连接字符串应该是 https://sample.crm.dynamics.cn/123456789

方法一：UCI 界面(推荐)#

Tip

注意区分 Power Apps 版本：

国际版：https://make.powerapps.com

世纪互联版：https://make.powerapps.cn

点击右上角设置按钮(⚙️) → 选择 “开发人员资源”

UCI界面获取环境唯一名称

在这里就能看到环境唯一名称：

环境唯一名称

方法二：经典 UI 界面#

设置 → 自定义项 → 开发人员资源

经典UI界面打开自定义项

选择自定义项

在页面中查找”实例唯一名称”

环境唯一名称

（完）

使用API调式工具访问Dynamics 365

Thu, 17 Oct 2024 00:00:00 GMT

本文详细介绍如何使用 API 测试工具访问 Dynamics 365，包括注册 Azure 应用、获取 ClientId 和 ClientSecret、配置身份验证和 API 权限，以及在 Postman 中设置环境变量和获取访问令牌。

前言#

在实施项目时，我通常会使用 API 测试工具来验证 Web 服务接口。这类工具在接口调试、参数校验和结果验证方面都非常好用！实际上，Dynamics 365 也提供有许多标准的接口，也可以使用测试工具直接访问和调试它。本文将以 Postman 为例，演示怎么调用 Dynamics 365 的标准接口

前期准备#

拥有管理员账号(访问 Azure Active Directory / Entra ID)
本地安装 API 调试工具，例如 Postman

详细步骤#

步骤(一)：获取 ClientId 和 ClientSecret#

Step 1. 注册 Azure 应用#

（1）访问并登录 Azure Portal

Tip

国际版请访问：https://portal.azure.com 世纪互联版请访问：https://portal.azure.cn

（2）在顶部的搜索框，搜索“应用注册” 并点击它

注册应用-01

（3）点击“+新注册”

注册应用-02

（4）在弹出的页面输入一个有意义的应用程序名称 –> 勾选受支持的账号类型 –> 点击“注册”按钮

注册应用-03

Step 2. 获取 ClientId#

Note

ClientSecret 是一个密码性质的秘钥，可以有效防止未经授权的访问，相比使用用户名和密码，ClientSecret 可以提供更加安全的身份验证方式，降低数据泄露的风险

完成 Step 1. 之后，我们可以从“概览”找到“应用程序ID”(ClientId)，请将该值复制并保存，后续配置 Postman 时会用到

获取ClientId

步骤(二)：配置应用（身份验证、清单、API 权限）#

Step 1. 配置身份验证(Authentication)#

身份验证 → 点击 “+添加平台” → 选择 Web

添加身份验证-01

配置如下内容：

重定向 URI：http://localhost
勾选 “访问令牌（用于隐式流）”

添加身份验证-02

Step 2. 修改“清单”配置文件#

进入清单页面，将以下两个属性设置为 true，并保存：

AllowPublicClient
oauth2AllowImplicitFlow

修改清单配置文件

Step 3. 添加API权限#

(1) 在左侧菜单栏打开“API 权限”，然后点击“+添加权限”

添加API权限-01

(2) 选择“我的组织使用的 API”，搜索并选择 Dataverse

添加API权限-02

Note

如果在 Microsoft API 列表中能直接搜索到 Dynamics CRM，也可以选择该项，否则请选择 Dataverse

添加API权限-03

（3）选择“委托的权限”，勾选所需权限并添加

添加API权限-04

步骤(三)：使用API调试工具测试#

Step 1. 创建 Collection#

新建一个 Collection，并取一个有意义的名称，例如：

Postman新建Collection

Step 2. 创建 Environment#

Postman新建Environment

Step 3. 为 Environment 添加变量#

Postman添加环境变量

变量名	说明
url	CRM 环境 URL
clientid	Azure 应用的 ClientId
version	9.0
webapiurl	{{url}}/api/data/v{{version}}/
callback	`http://localhost`
authurl	授权地址需要区分国内版和国际版(见下方说明)

Note

国际版：https://login.microsoftonline.com/common/oauth2/authorize?resource={{url}} 国内版：https://login.partner.microsoftonline.cn/common/oauth2/authorize?resource={{url}}

Step 4. 配置请求并获取 Token#

在对应的 Collection 中点击 “+”，选择“Add request”，然后为为请求取个有意义的名称，例如：GetToken

Postman新建请求

在 Authorization 中配置 OAuth 2.0：

Auth Type 选择 “Oauth 2.0”
Add authorization data to 选择 “Request Head”
Token Name 取个有意义的名称
Grant Type 选择 “Implicit”
Callback URL 填写 {{callback}}
Auth URL 填写 {{authurl}}
Client ID 填写 {{clientid}}
Client Authentication 选择 “Send as Basic Auth header”

Postman为请求配置获取Token信息

点击 Get New Access Token，完成登录后即可成功获取访问令牌

Postman获取Token

（完）

在线检查访问速度(Dynamics 365 Diagnostics)

Tue, 15 Oct 2024 00:00:00 GMT

Note

Dynamics 365 Diagnostics不仅能测试访问速度，还能收集版本信息、系统配置等信息

详细说明#

提示

假设您的环境链接是：https://sample.dynamics.cn/main.aspx

在此链接后面追加 /tools/diagnostics/diag.aspx，然后访问链接

Terminal window

1
# 示例链接
2
https://sample.dynamics.cn/tools/diagnostics/diag.aspx

访问该链接后，将出现 Dynamics 365 Diagnostics 界面

点击 Run 按钮，稍等片刻后，将看到诊断结果：

Check access speed

（完）

2024年国庆假期在东北屯子过秋收的一周

Sun, 13 Oct 2024 00:00:00 GMT

国庆假期，和宝子回东北。第一次在秋天北上，很期待那片金黄的旷野。

行程#

10月1日上海、哈尔滨
10月2日海伦、屯子
10月3日屯子
10月4日屯子
10月5日海伦
10月6日海伦、哈尔滨
10月7日哈尔滨、上海

10-01 Day1 出发#

差不多早上六点，天刚蒙蒙亮，我俩就拎着行李往浦东机场跑，一通折腾十点多才落地太平国际机场。刚下飞机脸蛋就被”秋风“呼呼的吹，接着打车到哈尔滨西站坐火车回海伦，这趟短途列车还蛮有意思，因为是假期的缘故，一列车大部分都是在哈尔滨上学的学生，聊天的声音响个不停，嘻嘻哈哈，像是进了麻雀窝。还有一个小细节印象很深，就是这边的火车行李架感觉都很高，我往上放行李箱时，只能脱了鞋子踩上座椅才能放上去（之前在家那边这是不应该的），所以说网上说的”南方小土豆“多少是有点依据。

火车正在开往海伦市

到家正好是晚饭饭点，餐桌上摆满了各式各样的菜：面条、炖排骨、蘸酱菜等等，结结实实干了一顿。因为明天早上要回屯子呆两天，帮爷爷奶奶收苞米，所以我们饭后看了一会电视，就去洗漱睡觉了，这一天够折腾的。

10-02 Day 2 摘玉米的一天#

今天要回屯子，得早点走。六点多钟我就起来了，早餐吃了份包子，喝了碗豆浆，然后去小区门口的超市买了些东西，水果、牛奶、蔬菜、肉，装了两大袋子，拎出来后在大门口叫了辆车，直接往回走。海伦到屯子不算远，三十多公里，路况也挺好，路两边每隔几百米就种着一簇树，这边的树叶子已经开始泛黄，再过一个来月怕是都要掉光了。

回爱民乡的路上

走了大概四十多分钟，就到了。我站在大门口看了会，三间平房，坐北朝南，摆成一个凹字形，房前房后是菜地，菜地面积还挺大，我估摸着少说也有三百来平。只是眼下地里除了大白菜和萝卜这两样抗冻的，别的菜都已经摘干净，收到下屋里存起来了，地里算是“罢园”了。”罢园“这个词我也是今天刚学会，这是个庄稼话，意思是农民收完最后一茬之后，地里的剩东西就不要了，谁想捡谁捡，也表示今年的农活已经干完了。

罢园后的菜地

进屋后歇了一会，两个老头一直拿各种吃的投喂我们，好像怕我们饿着似的。没过多久，老头又从下屋搬了一捆甜杆到院子里，蹲在那儿一根根砍，砍好了递给我们吃

切甜杆

菜园里的大白菜长得是真好，拿这种菜叶子打饭包，那肯定香

又没过多久，爷说要去河边收网兜，钓鱼/网鱼是他在屯子里的日常娱乐，我们也跟着一起去

收渔

其中一位大爷特别有型：坐得笔直，脸上全是风霜，眼神却很松弛

收完渔获往家走的路上，路上时不时能碰见拉草料的小拖拉机，其中一位大爷特别有型：腰板坐得溜直，脸上沟沟壑壑的，全是风霜刻出来的印子

开拖拉机的大爷

开饭啦！拔丝土豆、酸菜炖大骨、尖椒干豆腐、红烧小笨鸡，都是下饭菜。在东北的这两天我每顿饭都是两碗起步，这边的大米饭太香了

干饭

吃完午饭后有点晕碳，呼呼睡了一个半小时，起来后我们出发摘玉米，玉米地一共三块，地方虽然看着不大，但是摘起来真的很累。我这种纯外行，掰一根玉米要磨蹭差不多一分钟，全靠一股子蛮劲拧来拧去，好不容易才弄下来一根

掰苞米

下午太阳有点晒，摘完第一块地后我们先回去休息（蹭拖拉机回去）

坐上拖拉机回家

回到家后拿了瓶饮料在院门口的榆树吹风，树荫底下凉快，坐着坐着就有点犯困。正迷糊着，突然听到远处传来“哒哒哒”的拖拉机声，抬头一看，是爷开着车回来了，车上满满当当装的全是苞米

爷驾着满载苞米的车1

爷驾着满载苞米的车2

傍晚去摘柿子。这一排柿子树，晚上都盖着塑料布，昨天回来的时候就注意到，当时还纳闷这是什么玩意，后来才知道那是特意给我们留着的，等我们回来摘

奶正在采摘柿子

刚摘下来的柿子就是好吃

刚摘下来的柿子

门外咔咔咔响着的打豆机

打大豆

夕阳

大概七点左右天就开始黑了。吃完晚饭，大家坐着聊了会儿天，到九点多也就睡下了。我在写这篇流水账的时就在想，为什么在屯子能怎么早睡着，之前我们在上海起码都是十一点才上床睡觉，我觉得除了运动量大之外（摘玉米），更大的原因是环境，一是外部环境，在屯子或者乡下这个地理环境是安静的，大家都习惯早睡，没有城市里的车水马龙、灯红酒绿，更没有各种各样的杂事，是一种更纯粹的生理规律，所以我们在这种环境里，生理上就会顺应。第二是内部环境，内部环境是指我们心里松弛有度，因为离开了牛马工作环境，所以心境松弛了，再加上身旁坐着的都是亲朋好友，没有谁跟谁过不去，也没有什么利益上的磕磕绊绊，这个时候心里是没有负担，没有杂念，心里自然就顺应节奏，完全放松

10-03 Day 3 又是摘玉米的一天#

昨天摘了一下午的玉米，还剩一半没摘完，今天上午还得接着干

卸苞米

从七点半开始动手，一直摘到中午才总算摘完，收工回家，正好赶上饭点

继续干饭

今天宝子的表妹也过来帮忙，摘了些玉米。吃完午饭，大伙儿在院子里啃甜杆。两姊妹坐在拖拉机车斗上，一边啃着甜杆，一边有一搭没一搭地聊着天

晒太阳

这是我第一次睡东北大炕，拍个照记录一下

东北大土炕

晚上我们整了点烧烤，印象最深的是烤辣椒，新鲜的辣椒往火上一架，烤出来那个味道，吃起来真叫一个爽，咬一口下去，辣得人嘶哈嘶哈的（嘴都合不拢），这会儿写到这儿，不争气的口水又流下来了

烤串儿

10-04 Day 4 回海伦#

今天要回海伦，昨晚我们提前把行李都收拾好，一会吃个早饭就可以返程。天刚蒙蒙亮我就起来了，自然醒真的好舒服，我先悄悄的穿好衣服到院外，做了几组拉伸。活动完，我悄咪咪到厨房蒸了几个馒头吃，没想到火烧得太旺，把馒头表面烤得焦黄酥脆

土灶热馒头

后院的苞米杆还躺着，叶子上全是晨露

屯子后院

在榆树下坐着等车回海伦

海伦市爱民乡屯子合影

10-05 Day 5 海伦#

今天一觉起来已经快中午，简单收拾了下我们去了商场逛街，依旧是买买买吃吃吃，晚上他们搓麻将，我只好在边上观战，毕竟这边的麻将规则不熟悉，还是别上桌丢人了

10-06 Day 6 哈尔滨#

今天动身去哈尔滨，打算在哈尔滨逗留一天，去中央大街转转，然后坐明天的动车回上海。临上车前，家里人给包了饺子。北方有句老话，叫“上车饺子下车面”

吃饺子

在海伦火车站站台候车，假期末尾，好些人都在往外走

哈尔滨海伦市火车站

十一点多到了哈尔滨，先去酒店放下行李，歇了半小时，就往中央大街去了

中央大街#

来了哈尔滨总得来中央大街打个卡，号称 “亚洲第一街”，各种欧式建筑一字排开，风格各异，历史感倒是有几分。。。街上人不少，游客三三两两，而且手里都攥着一根马迭尔雪糕，边走边吃

哈尔滨市中央大街

索菲亚教堂#

索菲亚教堂哈尔滨的地标之一。1907 年建成的拜占庭式建筑，砖红色的穹顶在蓝天下颇有气势，没来过的可以看看，广场上随处可见摄影师揽客，边上还提供租衣服的服务，主打“暗黑系”风格，穿上大概能拍出《沉睡魔咒》(Maleficent) 里女主那种神秘感。另外教堂内部也开放，花十块钱门票就能进去

哈尔滨市中央大街索菲亚教堂

防洪胜利纪念塔#

防洪胜利纪念塔在中央大街尽头的松花江畔，巍然矗立。1958 年建成，为纪念哈尔滨战胜 1957 年的特大洪水而立，设计出自李光耀大师，塔身静静地立在那里，见证着这座城市的岁月

哈尔滨中央大街防洪胜利纪念塔

松花江边#

松花江边的某座桥

哈尔滨中央大街街尾松花江边

街头一角#

一排画画老师支起画架，摆摊谋生

哈尔滨中央大街摆摊画画的师傅们

烤肉#

临近傍晚，从中央大街往外走，路过一家烤肉店，看着不错，就进去了

在哈尔滨吃烤肉

10-07 Day 7#

一整天在高铁上，七天假期愉快结束

（完）

2024年青岛4天3晚游记

Sat, 24 Aug 2024 00:00:00 GMT

八月中旬，二阳想在暑假结束前来上海玩一周，但那段时间我们工作比较忙，抽不出时间陪他在上海转转，导致这家伙在家躺了两三天。后面和领导商量，决定请两三天年假一起出去玩。晚饭我们讨论目的地，一开始打算去北京，但现在是暑假期间，很多博物馆预约不上，只好下次再去。最后决定去青岛，饭后便把车票、酒店都订好了，第二天一早直接出发。

行程#

出行：我，领导，二阳
整体路线：黄岛，市区，黄岛

08-15 Day 1 出发#

早上从虹桥站出发，乘坐 D2928 列车前往青岛，因为是昨晚临时买票，只能买到站票(暑假期间出行的人多)。全程大概5小时，好在餐车里还有空座，最后坐了一路。大概中午十二点抵达青岛西站，打了辆车先去酒店放行李，稍微歇了一下，随后打车去酒店附近的商场觅食，后面选了一家海鲜烧烤，量大、价格合理，三个人直接吃到扶墙

胖哥海鲜烧烤

下午我们租了两辆电瓶车环岛，沿连三岛路骑行，这个景点的路线很成熟，在小岛绕了一圈，全程都设有非机动车道，在这里骑行肯定很爽

电瓶车环岛路线

小岛一圈大概15公里，沿着连三岛路骑了十几分钟就到银沙滩，在银沙滩停留一会玩玩水

银沙滩

随后经过几个观景台、鱼鸣嘴村，沿岸咖啡店，整体节奏很轻松

环岛线观景台

一下午在岛上走走停停的玩，一直到傍晚七点我们才慢悠悠地往车行走，归还电瓶车后在附近找了一家“大锅强”吃海鲜，这是一家连锁店，晚上八九点了还有很多人排队，我们取了号之后等了半小时才轮到我们进入，但是味道还不错，这个队排得不亏…

大锅强

菜品简评

鱼籽海肠捞饭，一定要点大份的！小份的量只够一个人吃，根本不过瘾
椒盐皮皮虾，味道一般，可点可不点
178元档的大锅蒸海鲜，份量刚好适合三个人，里面有四个生蚝、几只大虾，剩下的大多是扇贝、蛤蜊和海兔
啤酒，必须喝散啤，二厂、四厂都不错

吃完饭后发现这里离金沙滩很近，临时起意去哪里看看，走一会消消食。金沙滩和银滩相比，好像金沙滩更热闹，怎么晚了人还是很多，在这里玩了一个小时就撤了

金沙滩

第一天行程拉满，冲凉后倒头就睡

08-16 Day2 老城区一日游#

一觉起来已经快中午，洗漱完后先和老弟去附近的商场觅食（外面太热了，只想去有空调的地方），而领导打算先去商场二楼理发店做头发。我俩在餐饮楼层转了一圈，打算吃一家店名叫“老板恋上鱼”的店，其实我是被它门口的广告（鱼杂拌面）给吸引住了，鱼杂并不是没吃过，以往都是放大量姜丝香煎吃，这样可以把腥味压下去，但用来拌面还没有尝试过。总体来说味道还行，没有特别惊艳的地方（家常红烧的做法），后来在网上查了下，发现这是一家连锁店，难怪能把鱼杂处理得这么干净利索，原来是预制

老板恋上鱼

吃完饭后，打算去老城区的景点（栈桥、老街一带）看看。我们现在呆的地方属于青岛的新区，好像是叫黄岛区（也叫西海岸新区），这边建筑都挺新的（感觉有点像上海的浦东新区）

栈桥景区附近的景点挺多的，像栈桥、五四广场、八大关、崂山啤酒博物馆等。怎么说呢，这些景点个人感觉一般，节假日非常的拥挤，更别提体验感了，一逛一个不吱声

浙江路·天主教堂

崂山矿泉水博物馆

在栈桥这边浅浅闲逛了一阵子，看天色还早决定去小麦岛看看（某书推荐景点），从栈桥打车到小麦岛，一路开了半个多小时，下车后远远望去就能看到一个小山包，原来这就是小麦岛。如果今天让我评价最让人失望的景点，那小麦岛稳坐第一，周围大面积施工，走进去仿佛置身工地，通道被铁皮围得严实，空气中时不时飘来一股腥味，我们走到入口便打了退堂鼓，索性在桥边随便逛一下，便匆匆跑路

小麦岛出口处

晚上去吃了一家“野馄饨”，本地特色名词，实际就是馄饨+烧烤。味道也就一般般吧，店名就不说了，没必要专门跑一趟。

什么是“野馄饨”？
在青岛，大街小巷都能见到“野馄饨”的招牌（xxx 家馄饨、xxx 野馄饨）。其实“野馄饨”不过是个外号，听着更有卖点，和我们平时吃的馄饨并无二致。此外，之所以叫“野馄饨”，是因为青岛话里“热”的发音近似“野”，算是个本地特色的谐音梗。“野馄饨”只是青岛的叫法，和普通馄饨没什么区别

08-17 Day3#

昨天在老城区体验得不是很好，我们临时调整行程，上午逛完啤酒博物馆之后再转战黄岛区

老王头拉面馆#

退房后在隔壁一条街看到了家面馆，味道挺好（烤的肉筋也好吃）

王老头拉面馆

青岛啤酒博物馆#

吃完牛肉面后直接打车前往博物馆，到的时候已经快中午，游客很多，在门口扫码购票，博物馆还提供行李寄存的服务（这点好评，原本以为要拉着行李箱进去）

我们在博物馆里游览了近两个小时，除了人多、天气热让人不舒服外，其他方面还挺好，博物馆浏览路线设计合理，科普了啤酒的制作过程，有点意思

博物馆主要分为三个游览区域：

百年历史文化陈列区
青岛啤酒的酿造工艺展示区
多功能互动休闲区

因为游览路线是博物馆设计好的，我们跟着人流走就能挨个参观这几个区域

青岛啤酒博物馆

让我印象最深刻的是博物馆赠送的两杯啤酒，博物馆门票里包含了两杯啤酒，一杯原浆和一杯生啤，还有一小袋啤酒豆。啤酒是真的好喝！尤其是第二杯，香甜！（有知道的朋友麻烦留言告知）

青岛啤酒博物馆

黄岛区#

下午再次回到黄岛区，这次在城市阳台这边住，行李放好后便去了附近的海边玩

城市阳台

今天是晴天，又是农历十四，月亮格外圆

城市阳台

08-18 Day4#

今天是返程日，老弟一早就打车去机场飞哈尔滨，我们中午才高铁站回上海，假期结束

青岛火车站入口

青岛火车站候车大厅

小结#

玩水：优先黄岛，沙滩更大更干净，人也相对少
住宿：黄岛性价比明显高于市区，打车进城完全可接受
交通：不建议新手自驾，青岛市区坡多路窄，而且盲区也多（拐弯），事故概率不低
啤酒：推荐四厂的散啤，个人感觉更好喝，有点甜丝丝的

青岛，下次还来

（完）

（记录）Dynamics 365标准实体的状态选项及对应的状态描述状态码

Sun, 11 Aug 2024 00:00:00 GMT

记录 Dynamics 365中常用标准实体的信息，包括其 状态选项 (statecode) 和相应的 状态描述代码 (statuscode)

Account#

Logical Name: account

Entity Name	Status (statecode)	Status Reason (statuscode)
Account	0 Active	1 Active
1 Inactive	2 Inactive

Activity#

Logical Name: activitypointer

Entity Name	Status (statecode)	Status Reason (statuscode)
Activity (activitypointer)	0 Open	1 Open
1 Completed	2 Completed
2 Canceled	3 Canceled
3 Scheduled	4 Scheduled

Appointment#

Logical Name: appointment

Entity Name	Status (statecode)	Status Reason (statuscode)
Appointment	0 Open	1 Free
2 Tentative
1 Completed	3 Completed
2 Canceled	4 Canceled
3 Scheduled	5 Busy
6 Out of Office

Article#

Logical Name: kbarticle

Entity Name	Status (statecode)	Status Reason (statuscode)
Article
1 Draft	1 Draft
2 Unapproved	2 Unapproved
3 Published	3 Published

Campaign#

Logical Name: campaign

Entity Name	Status (statecode)	Status Reason (statuscode)
Campaign	0 Active	0 Proposed
1 Ready To Launch
2 Launched
3 Completed
4 Canceled
5 Suspended

Campaign Activity#

Logical Name: campaignactivity

Entity Name	Status (statecode)	Status Reason (statuscode)
Campaign Activity	0 Open	0 In Progress
1 Proposed
4 Pending
5 System Aborted
6 Completed
1 Closed	2 Closed
2 Canceled	3 Canceled

Campaign Response#

Logical Name: campaignresponse

Entity Name	Status (statecode)	Status Reason (statuscode)
Campaign Response	0 Open	1 Open
1 Closed	2 Closed
2 Canceled	3 Canceled

Case#

Logical Name: incident

Entity Name	Status (statecode)	Status Reason (statuscode)
Case	0 Active	1 In Progress
2 On Hold
3 Waiting for Details
4 Researching
1 Resolved	5 Problem Solved
2 Canceled	6 Canceled

Case Resolution#

Logical Name: incidentresolution

Entity Name	Status (statecode)	Status Reason (statuscode)
Case Resolution	0 Open	1 Open
1 Completed	2 Closed
2 Canceled	3 Canceled

Contact 联系人#

Logical Name: contact

Entity Name	Status (statecode)	Status Reason (statuscode)
Contact	0 Active	1 Active
1 Inactive	2 Inactive

Contract 合同#

“合同”、“合同子项”和“合同模板”实体已弃用，从 2022 年 4 月 1 日起不再提供支持。它们将在 Dynamics 365 的未来主要版本中删除。

Logical Name: contract

Entity Name	Status (statecode)	Status Reason (statuscode)
Contract	0 Draft	1 Draft
1 Invoiced	2 Invoiced
2 Active	3 Active
3 On Hold	4 On Hold
4 Canceled	5 Canceled
5 Expired	6 Expired

Contract Line 合同子项#

“合同”、“合同子项”和“合同模板”实体已弃用，从 2022 年 4 月 1 日起不再提供支持。它们将在 Dynamics 365 的未来主要版本中删除。

Logical Name: contractdetail

Entity Name	Status (statecode)	Status Reason (statuscode)
Contract Line	0 Existing	1 New
1 Renewed	2 Renewed
2 Canceled	3 Canceled
3 Expired	4 Expired

E-mail#

Logical Name: email

Entity Name	Status (statecode)	Status Reason (statuscode)
E-mail	0 Open	1 Draft
8 Failed
1 Completed	2 Completed
3 Sent
4 Received
6 Pending Send
7 Sending
2 Canceled	5 Canceled

Lead 线索/潜在客户#

Logical Name: lead

Entity Name	Status (statecode)	Status Reason (statuscode)
Lead	0 Open	1 New
2 Contacted
1 Qualified	3 Qualified
2 Disqualified	4 Lost
5 Cannot Contact
6 No Longer Interested
7 Canceled

Opportunity 商机/引合#

Logical Name: opportunity

Entity Name	Status (statecode)	Status Reason (statuscode)
Opportunity	0 Open	1 In Progress
2 On Hold
1 Won	3 Won
2 Lost	4 Canceled
5 Out-Sold

Quote 报价单#

Logical Name: quote

Entity Name	Status (statecode)	Status Reason (statuscode)
Quote	0 Draft	1 In Progress
1 Active	2 In Progress
3 Open
2 Won	4 Won
3 Closed	5 Lost
6 Canceled
7 Revised

Order 订单/销售订单#

Logical Name: salesorder

Entity Name	Status (statecode)	Status Reason (statuscode)
Order	0 Active	1 New
2 Pending
1 Submitted	3 In Progress
2 Canceled	4 No Money
3 Fulfilled	100001 Complete
100002 Partial
4 Invoiced	10003 Invoiced

Product 产品#

Logical Name: product

Entity Name	Status (statecode)	Status Reason (statuscode)
Product	0 Active	1 Active
1 Inactive	2 Inactive

Task#

Logical Name: task

Entity Name	Status (statecode)	Status Reason (statuscode)
Task	0 Open	2 Not Started
3 In Progress
4 Waiting on someone else
7 Deferred
1 Completed	5 Completed
2 Canceled	6 Canceled

Invoice 发票#

Logical Name: invoice

Entity Name	Status (statecode)	Status Reason (statuscode)
Invoice	0 Active	1 New
2 Partially Shipped
4 Billed
5 Booked (applies to services)
6 Installed (applies to services)
1 Closed (deprecated)	3 Canceled (deprecated)
7 Paid in Full (deprecated)
2 Paid	100001 Complete
100002 Partial
3 Canceled	100003 Canceled

（完）

2024年长沙三日游：臭豆腐、洗脚、橘子洲头

Sat, 27 Jan 2024 00:00:00 GMT

晚上好啊，最近上海天气真是够差劲，又湿又冷！前阵子跟公司团建去了趟湖南长沙，我又来记流水账了

01-19 第一天#

行程#

08：20 - 14：10 上海 → 长沙
14：10 - 15：00 集合、前往酒店
15：00 - 15：30 归置行李，布置会场
15：30 - 17：50 进行团建活动
17：50 - 20：00 晚宴干饭

出发#

出发

团建活动：危楼饼存#

这个活动蛮考验耐心和细心，因为有时间限制，慌慌张张地搭了个危塔，哈哈！

规则

各小组将获得木棍、双面胶及圆盘状饼干，需在规定时间内，搭建一座独立式高塔

核心要求：塔体需保持结构稳定，不可借助外力
最终标志：塔的顶端必须成功放置一块饼干，作为完成的象征
评判标准：在结构稳固的前提下，测量塔身的垂直高度，高者胜出

团建活动：危楼饼存，图1

团建活动：危楼饼存，图2

辣妹子#

没想到还有隐藏的彩蛋！在等待上菜的间隙，部长和副中心长一起表演了《辣妹子》，直接把气氛拉满，为现场带来了阵阵欢笑

辣妹子表演

黄兴广场#

晚饭后刚八点，时间还早，邀了钱兄和刁兄一起步行去附近的黄兴广场觅食，酒店离黄兴广场不远，步行一会就到了

只是天刚下完雨，道上不好走

黄兴广场银幕

还没走近就看到了不少人停留在地铁口，走近一看才看清“大长沙美食城寨”几个字，这里应该是个网红打卡地吧？

墙上密密麻麻的霓虹灯牌，赛博朋克风格？

黄兴广场

黄兴广场人流

臭豆腐#

提到长沙，我的第一反应是臭豆腐（毕竟国内美食街都有它），来到发源地，自然得尝尝正宗的是什么味道。我挑了家人最多的店，排了会队，点了一份，味道还行。接着又打卡了当地奶茶扛把子“茶颜悦色”，喝了一口，和霸王茶姬差不多

温馨提示：买茶颜悦色千万别在一家店死等，放眼望去，每隔不远处就有一家，这家排队，下一家也许就空着了

臭豆腐、茶颜悦色

洗脚#

去酒店的路上，导游提起长沙还有个绰号——“脚都”，当时只是听听，走在大街上才发现，这名号半点不虚，随便抬头往楼上看就能看到各类洗脚的招牌。我们选了连锁品牌“颐而康”体验一番，不得不说，确实舒服，按完出来，一整天的疲乏感荡然无存

洗脚

洗完脚出来，已近十二点，打道回府，Day1结束

01-20 第二天#

今天是自由活动，除了橘子洲头和省博物馆，我其实没有什么特别想去的地方，打算随便走走

沙火车#

一觉醒来，发现九点多了，昨晚睡前在高德地图上瞄了一眼，发现酒店离长沙火车站挺近，个人经验：火车站附近的居民区，往往藏着一些宝藏小店，打算去那边碰碰运气

长沙火车站

嗦粉#

在火车站对面的街里偶遇一家粉店（马季粉店），门口人气很旺，而且他们都操着一口本地普通话，在这种本地人扎堆的粉店，味道应该错不了，就在这吃早餐吧

马记粉店

店面复古得很彻底啊！木桌长凳，搪瓷碗碟，只有很小时候才见过这种

马记粉店

我点了一碗肉丝粉，狠狠加了几勺辣椒，入口鲜香，吃得额头微微冒汗，太好吃了！一碗落肚后，我还意犹未尽，于是又加了一碗

马记粉店

橘子洲头#

嗦完粉，我直奔橘子洲头。

今天是阴天，江面上水汽弥漫，江面可见度蛮差的，虽然天气不咋样，但游客挺多

刚进去走不大一会，看到了个题着“恰同学少年”的门，想起了上学时背诵的沁园春长沙，“恰同学少年，风华正茂；书生意气，挥斥方遒”

橘子洲头-图1

从景区大门到最南端的橘子洲头（也就是毛泽东青年艺术雕塑所在地），步行大约需要3公里。如果想走完一圈（洲头至洲尾），大概是9公里多的路程。既来了，便慢慢走吧

橘子洲头-图2

橘子洲头-图3

橘子洲头-图4

火宫殿#

从橘子洲头出来，应邀去了坡子街的火宫殿用吃饭，味道中规中矩，没有特别惊艳。火宫殿始建于明代，原为祭祀火神的庙宇，不过今天所见的建筑大都是新建的，商业氛围蛮浓厚，尽管如此，如果时间充裕，不妨来感受一下

火宫殿

从火宫殿出来，回去的路上正好路过 IFS 国金中心，顺便打了卡，我对钢筋水泥一向不感冒，拍个照走人

IFS国金中心#

IFS国金中心

湘江边#

中午在橘子洲头绕了一圈属实有点累，下午回酒店补了个觉充充电。晚上应了长沙本地朋友的邀约，小酌了一阵子，酒足饭饱后在江边溜达，醒醒酒

湘江边

江岸正好有人放烟花

湘江边放烟花

一天结束，真的累趴了

01-21 第三天#

岳麓书院#

今天是集体活动，前往岳麓书院。我们跟着导游从右侧门进入，依次经过前门、赫曦台、大门、二门、讲堂、御书楼……后面的路线就记不太清了。

Note

岳麓书院，位于湖南省长沙市岳麓区岳麓山东侧山脚（岳麓山景区南门附近），为中国古代“四大书院”之一。岳麓书院始建于北宋开宝九年（976年），由潭州太守朱洞创建，历经多个朝代，于1903年改制为湖南高等学堂；1937年成为国立湖南大学。如今，岳麓书院是湖南大学的历史与哲学学院。

书院碑刻#

岳麓书院

潇湘槐市#

“潇湘槐市”潇湘槐市是移管古文词组，具有地理和文化的双重意向，代指文风鼎盛、人才荟萃的湖南地区

岳麓书院

书院一角#

岳麓书院

爱晚亭#

这个亭子原名“红叶亭”，后被湖广总督毕沅，据《山行》诗句，更名为“爱晚亭”沿用至今。以前的岳麓书院山长为欣赏岳麓山枫叶所建的，去的时候没有枫叶，如果是秋天应该会很好看

爱晚亭（岳麓山）

岳麓书院导览图#

附一张导览图

岳麓书院导览图

返程#

下午乘上 G1362 次列车返程

返程

小结#

此行唯一的遗憾，是“胃容量”跟不上时间的节奏。计划中要尝的口味蟹、酱板鸭、剁椒鱼头……都还没来得及吃上

也好，留点念想，下次再来

（完）

什么是BMI？

Thu, 01 Jun 2023 00:00:00 GMT

什么是 BMI?#

BMI 的全称是 Body Mass Index（身体质量指数），计算公式非常简单：

BMI = 体重(kg) ÷ 身高 ²(m²)

拿我自己举个例子：

82 ÷ (1.65 × 1.65) ≈ 30.1

咳咳，按照常见标准：超过 30，就属于肥胖。

不过别急着自闭——BMI 只是一个参考指标，它并不会区分：

脂肪
肌肉
体脂率

所以肌肉量比较高的人（比如健身党），看起来很结实，但 BMI 也可能偏高。

BMI 到底有什么用？#

虽然它谈不上“精确”，但 BMI 的优势在于：

计算简单
易于对比
适合长期追踪趋势

对于普通人来说，BMI 是一个快速判断体重是否偏离健康区间的工具。

如果你也在减脂、跑步、或者刚开始运动，可以偶尔用 BMI 看看整体趋势，但别把它当成唯一标准。

BMI 范围	分类
BMI ≤ 18.5	过轻
18.5 ＜ BMI ≤ 24	正常
24 ＜ BMI ≤ 28	过重
28 ＜ BMI ≤ 32.5	轻度肥胖
32.5 ＜ BMI ≤ 37.5	中度肥胖
37.5 ＜ BMI ≤ 50	重度肥胖症
BMI ＞ 50	极重度肥胖症

运动真的能改变 BMI 吗？#

答案是：当然可以，但前提是——别只盯着体重。

脂肪减少
肌肉增加
体能变好

哪怕体重变化不大，你的 BMI、体型和健康状态都会慢慢往更合理的方向走。

我目前的计划是：

每周跑 4 次
每次大约 1 小时
目标体重：82kg → 70kg
把 BMI 拉回到 “正常区间”

同时也在刻意练习把心率控制在合适区间（Zone 3），提高燃脂效率，这个东西真的有点门道，后面可以单独写一篇。

参考#

肥胖症诊疗指南（2024 年版）

（完）

使用 ClientSecret 授权方式在 .NET 控制台应用中连接 Dynamics 365

Fri, 25 Feb 2022 00:00:00 GMT

前提条件#

拥有管理员权限，否则无法访问 Azure Active Directory / Entra ID 获取密钥等信息

Microsoft.Xrm.Tooling 支持的授权方式一览#

连接主要使用的是 Microsoft.Xrm.Tooling.Connector 包，这个包提供了多种身份认证方式，但是根据我的实施经验，目前最常用的是以下2种认证方式

Office365（用户名 + 密码）
ClientSecret（应用程序 + 密钥）

Name	Value	Description
Office365	4	Office365 base login process
ClientSecret	7	Client Id + Client Secret Auth
InvalidConnection	-1	Invalid connection
AD	0	Active Directory Auth
Live	1	Live Auth
IFD	2	SPLA Auth
Claims	3	CLAIMS based Auth
OAuth	5	OAuth based Auth
Certificate	6	Certificate based Auth
ExternalTokenManagement	99	Host managed token

详细步骤#

步骤(一) 获取 ClientId 和 ClientSecret#

Step 1. 注册 Azure 应用#

（1）访问并登录 Azure Portal

Tip

国际版请访问：https://portal.azure.com

世纪互联版请访问：https://portal.azure.cn

（2）在顶部的搜索框，搜索“应用注册” 并点击它

注册应用-01

（3）点击“+新注册”

注册应用-02

（4）在弹出的页面输入一个有意义的应用程序名称 –> 勾选受支持的账号类型 –> 点击“注册”按钮

注册应用-03

Step 2. 获取 ClientId#

完成应用注册后，在 “概览(Overview)” 页面中可以看到 应用程序(客户端)ID ，请将该值复制并保存，后续配置会用到

获取 ClientId

Step 3. 创建 ClientSecret#

打开 “证书和密码”
选择客户端密码
点击 “+ 新客户端密码”
填写描述并设置有效期
点击 “添加”

获取 ClientSecret - 01

创建完成后，请立即复制 ClientSecret 的“值”并保存

Tip

页面刷新后该值将被隐藏，若未保存只能删除后重新创建

获取 ClientSecret - 02

步骤（二）在 Power Platform 中添加应用程序用户#

接下来需要将刚创建的应用与 Dynamics 365 环境关联上，步骤如下：

选择 “应用程序用户”

配置项说明：

应用：选择刚才在 Azure 中注册的应用
业务部门：建议选择根业务部门
安全角色：至少分配系统管理员

完成后点击 “创建”

步骤（三）创建控制台应用程序进行连接测试#

Step 1. 创建控制台应用程序#

打开 Visual Studio —> 创建新项目，选择 “控制台应用(.NET Framework)”

新建项目-01

输入项目名称 —> 选择 “.NET Framework 版本” —> 点击 “创建”

新建项目-02

Step 2. 添加NuGet包#

为项目安装以下依赖：

Microsoft.CrmSdk.CoreAssemblies
System.Configuration.ConfigurationManage

下面是具体的操作步骤说明和截图：

项目 —> 右键 —> 管理 NuGet 程序包 —>

为项目添加依赖包-01

浏览 —> 搜索 —> 安装

为项目添加依赖包-02

Step 3. 为 App.config 添加连接信息#

在 App.config 文件中添加连接字符串配置：

打开 App.config 文件
在 <configuration> 节点下添加 <connectionStrings> 节
替换以下占位符为实际值：

1
<connectionStrings>
2
  <!-- Dev 环境（ClientSecret 认证方式） -->
3
  <add name="Dev-ClientSecret" connectionString="
4
     Url=https://xxx.crm.dynamics.cn/;
5
     AuthType=ClientSecret;
6
     ClientId=yourClientId;
7
     ClientSecret=yourClientSecret;" />
8
</connectionStrings>

需要替换的值：

Url —> Dynamics 365 环境访问地址
ClientId —> 应用程序 ID
ClientSecret —> 客户端密钥

为 App.config 文件添加连接信息

Step 4. 添加测试代码#

在 Program.cs 中：

引用命名空间

1
using Microsoft.Crm.Sdk.Messages;
2
using Microsoft.Xrm.Sdk;
3
using Microsoft.Xrm.Tooling.Connector;
4
using System;
5
using System.Configuration;

Main 方法代码

1
string connectionStr = ConfigurationManager.ConnectionStrings["Dev-ClientSecret"].ConnectionString;
2
CrmServiceClient client = new CrmServiceClient(connectionStr);
3
if (client.IsReady)
4
{
5
    IOrganizationService orgServiceorgService = client;
6
    // 使用 WhoAmI 进行测试
7
    WhoAmIResponse resTest = (WhoAmIResponse)orgServiceorgService.Execute(new WhoAmIRequest());
8
    Console.Write($"UserId: {resTest.UserId}");
9
    Console.Read();
10
}
11
else
12
{
13
    throw new Exception(client.LastCrmError);
14
}

添加测试代码

Step 5. 运行#

将当前项目设为启动项目

设当前项目为启动项目

使用 F5 或点击 “启动” 按钮

启动测试项目

如果程序成功输出 UserId，说明：

ClientSecret 认证成功
已成功连接 Dynamics 365
可继续使用 IOrganizationService 进行 CRUD 操作

打印用户的Id

（完）

使用 Office365 授权方式在 .NET 控制台应用中连接 Dynamics 365

Fri, 25 Feb 2022 00:00:00 GMT

前言#

本文演示如何使用 Office365 授权方式，在 .NET Framework 控制台应用中连接 Dynamics 365

Microsoft.Xrm.Tooling 支持的授权方式一览#

连接主要使用的是 Microsoft.Xrm.Tooling.Connector 包，这个包提供了多种身份认证方式，但是根据我的实施经验，目前最常用的是以下2种认证方式

Office365（用户名 + 密码）
ClientSecret（应用程序 + 密钥）

Name	Value	Description
Office365	4	Office365 base login process
ClientSecret	7	Client Id + Client Secret Auth
InvalidConnection	-1	Invalid connection
AD	0	Active Directory Auth
Live	1	Live Auth
IFD	2	SPLA Auth
Claims	3	CLAIMS based Auth
OAuth	5	OAuth based Auth
Certificate	6	Certificate based Auth
ExternalTokenManagement	99	Host managed token

详细步骤#

Step 1. 创建控制台应用程序#

打开 Visual Studio —> 创建新项目，选择 “控制台应用(.NET Framework)”

新建项目-01

输入项目名称 —> 选择 “.NET Framework 版本” —> 点击 “创建”

新建项目-02

Step 2. 添加NuGet包#

为项目安装以下依赖：

Microsoft.CrmSdk.CoreAssemblies
System.Configuration.ConfigurationManage

下面是具体的操作步骤说明和截图：

项目 —> 右键 —> 管理 NuGet 程序包 —>

为项目添加依赖包-01

浏览 —> 搜索 —> 安装

为项目添加依赖包-02

Step 3. 为 App.config 添加连接信息#

在 App.config 文件中添加连接字符串配置：

打开 App.config 文件
在 <configuration> 节点下添加 <connectionStrings> 节
替换以下占位符为实际值：

1
 <connectionStrings>
2
  <!-- Dev 环境（Office365 认证方式） -->
3
  <add name="Dev-Office365"
4
     connectionString="AuthType=Office365;
5
     Url=urlofyourdynamics365instance;
6
     Username=yourusername;
7
     Password=yourpassword;" />
8
 </connectionStrings>

需要替换的值：

https://xxx.crm.dynamics.cn/ → 您的Dynamics 365环境URL
yourusername → 登录用户名（通常是邮箱地址）
yourpassword → 登录密码

为 App.config 文件添加连接信息

Step 4. 添加测试代码#

在 Program.cs 中：

引用命名空间

1
using Microsoft.Crm.Sdk.Messages;
2
using Microsoft.Xrm.Sdk;
3
using Microsoft.Xrm.Tooling.Connector;
4
using System;
5
using System.Configuration;

Main 方法代码

1
string connectionStr = ConfigurationManager.ConnectionStrings["Dev-ClientSecret"].ConnectionString;
2
CrmServiceClient client = new CrmServiceClient(connectionStr);
3
if (client.IsReady)
4
{
5
    IOrganizationService orgServiceorgService = client;
6
    // 使用 WhoAmI 进行测试
7
    WhoAmIResponse resTest = (WhoAmIResponse)orgServiceorgService.Execute(new WhoAmIRequest());
8
    Console.Write($"UserId: {resTest.UserId}");
9
    Console.Read();
10
}
11
else
12
{
13
    throw new Exception(client.LastCrmError);
14
}

添加测试代码

Step 5. 运行#

将当前项目设为启动项目

设当前项目为启动项目

使用 F5 或点击 “启动” 按钮

启动测试项目

如果程序成功输出 UserId，说明：

ClientSecret 认证成功
已成功连接 Dynamics 365
可继续使用 IOrganizationService 进行 CRUD 操作

打印用户的Id

（完）

我常用的插件注释模板(Dynamics 365)

Wed, 16 Feb 2022 00:00:00 GMT

在 Dynamics 365 项目中，插件往往是业务逻辑最集中、最容易踩坑的地方。当项目周期拉长、人员更替或多人并行开发时，如果缺少清晰、统一的插件注释，维护成本会迅速放大

下面整理的是我在多个 Dynamics 365 项目中反复使用的插件注释模板，目标只有一个：让后来的人在不翻代码、不查注册记录的情况下，也能快速理解这个插件在 “什么时候、对什么、做了什么”

插件注释模板示例#

Terminal window展开收起

1
/// <summary>
2
/// <list type="bullet">
3
/// <item>模块：售前(示例)</item>
4
/// <item>功能</item>
5
/// <list type="number">
6
/// <item>功能描述 xxxx xxxx xxxx</item>
7
/// <item>功能描述 xxxx xxxx xxxx</item>
8
/// </list>
9
/// <item>Primary Entity: Lead</item>
10
/// <item>Message: Update</item>
11
/// <item>Update Attributes: qualifyingopportunityid, statecode</item>
12
/// <item>State: PostOperation</item>
13
/// <item>Mode: Synchronous</item>
14
/// </list>
15
/// </summary>

展开收起

说明#

模块 + 功能描述：从业务角度快速定位用途
Primary Entity / Message / Stage / Mode：与插件注册信息一一对应
Update Attributes：明确触发条件，避免“为什么会执行”的疑问

这套结构在代码审查、问题排查、插件迁移时都非常实用

Message/State/Mode 常见取值#

Message	1	Create
2	Update
3	Delete
4	Associate
5	Disassociate
6	SetStateDynamicEntity
7	RetrieveMultiple
8	Retrieve
9	QualifyLead
10	Assign
State 执行阶段	1	Pre-validation
2	Pre-operation
3	Post-operation
Mode 执行模式	1	Synchronous
2	Asynchronous

完整插件示例#

1
using Microsoft.Xrm.Sdk;
2
using System;
3
namespace Blog.D365.Plugins.Account
4
{
5
    // [!code ++:15]
6
    /// <summary>
7
    /// <list type="bullet">
8
    /// <item>模块：售前(示例)</item>
9
    /// <item>功能</item>
10
    /// <list type="number">
11
    /// <item>功能描述 xxxx xxxx xxxx</item>
12
    /// <item>功能描述 xxxx xxxx xxxx</item>
13
    /// </list>
14
    /// <item>Primary Entity: Lead</item>
15
    /// <item>Message: Update</item>
16
    /// <item>Update Attributes: qualifyingopportunityid, statecode</item>
17
    /// <item>State: PostOperation</item>
18
    /// <item>Mode: Synchronous</item>
19
    /// </list>
20
    /// </summary>
21
    public class AccountPostUpdate : IPlugin
22
    {
23
        public void Execute(IServiceProvider serviceProvider)
24
        {
25
            // 此处代码省略
26
        }
27
    }
28
}

展开收起

（完）

Donghai’s Blog

我的Git常用命令清单

图例#

安装#

创建新仓库#

配置#

新添/删除文件#

代码提交#

分支#

远程同步#

撤销#

生成一个可供发布的压缩包#

推荐阅读#

C# 技术备忘 - LINQ

准备示例数据源#

#1 两种语法#

#2 查询#

where#

select#

selectMany#

#3 排序#

#4 聚合方法 （Count, Sum, Average, Max, Min）#

#5 条件判断#

All#

Any#

Contains#

#6 分组和连接（Join）#

GroupBy#

1. 基础分组：按班级分组#

2.分组 + 聚合统计#

3.分组 + 筛选#

4.多键分组（按班级和年龄分组）#

Join#

Join - 内连接（查询语法）#

Join - 内连接#

Join + 条件过滤#

GroupJoin（分组连接）#

GroupJoin - 基本用法（查询语法）#

GroupJoin - 方法语法#

GroupJoin + 处理空组#

#7 集合转换#

ToList() - 转成 List#

ToArray() - 转成数组#

ToDictionary() - 转成字典（常用）#

ToLookup() - 一对多字典（类似分组）#

使用DBeaver连接Dynamics 365 Dataverse

前置条件：为 TDS 终结点启用用户级访问控制#

Step #1 准备工作：下载JDBC#

Step #2 创建数据库连接#

Step #3 配置驱动设置#

Step #4 测试连接#

Step #5 执行查询验证#

C# 技术备忘 (1)

241228-LINQ#

241115-错误消息列表的格式化输出#

两种方式对比#

Dynamics 365 事件框架、事件执行管道

1.简介#

2.事件执行管道 Event execution pipeline#

体系结构和相关组件#

事件执行管道阶段（流水线的4个阶段）#

消息是怎么传递的？#

关于事务，最最容易踩坑的地方#

3.沙盒隔离、信任级别和运行监控#

沙盒是个啥？为啥要有它？#

监控机制 PluginTypeStatistic#

信任级别（Trusts）#

沙盒里怎么访问外部网站？#

了解2FA（双因素认证）

概念#

2FA 方案#

方案（一）密码 + 硬件令牌#

方案（二）密码 + 手机短信验证码#

方案（三）密码 + 基于时间的一次性密码（TOTP）（当前主流且推荐的方案）#

TOTP的算法#

TOTP的实现（Csharp）#

参考#

初尝Github Actions

Github Actions 是什么#

Github Actions 术语#

#4 聚合方法（Count, Sum, Average, Max, Min）#

（1）`name`#

（2）`on`#

（3）`jobs`#