package faqtable import ( "errors" "net/url" "strings" "unicode" ) // Verified DingTalk Notable FAQ field IDs. const ( FieldStandardQuestion = "01ZM8y7" // text: 标准问题(必填) FieldOriginalQuestion = "fj3JQ1C" // text: 原始问题 FieldLanguage = "07YYagS" // text: 语言 FieldAsker = "Eu7gkKu" // user: 提问人 ) type Row struct { StandardQuestion string OriginalQuestion string AskerName string AskerUnionID string } func (r Row) ToFields() map[string]interface{} { fields := map[string]interface{}{ FieldStandardQuestion: safeText(r.StandardQuestion), FieldOriginalQuestion: safeText(r.OriginalQuestion), FieldLanguage: DetectLanguage(r.OriginalQuestion), } if unionID := strings.TrimSpace(r.AskerUnionID); unionID != "" { fields[FieldAsker] = []interface{}{map[string]interface{}{ "name": strings.TrimSpace(r.AskerName), "unionId": unionID, }} } return fields } func safeText(value string) string { value = strings.TrimSpace(value) if value == "" { return "" } if strings.ContainsRune("=+-@", rune(value[0])) { return "'" + value } return value } func DetectLanguage(value string) string { if strings.Contains(value, "日本語") { return "Japanese" } var hasHan, hasKana, hasHangul, hasLatin, hasSpanish bool for _, r := range value { switch { case unicode.In(r, unicode.Hiragana, unicode.Katakana): hasKana = true case unicode.In(r, unicode.Hangul): hasHangul = true case unicode.In(r, unicode.Han): hasHan = true case strings.ContainsRune("áéíóúüñÁÉÍÓÚÜÑ¿¡", r): hasSpanish = true case unicode.In(r, unicode.Latin): hasLatin = true } } switch { case hasKana: return "Japanese" case hasHangul: return "Korean" case hasHan: return "Chinese" case hasSpanish: return "Spanish" case hasLatin: return "English" default: return "Other" } } type RecordLinkBuilder struct { baseID string sheetID string viewID string } func NewRecordLinkBuilder(baseID, sheetID, viewID string) (*RecordLinkBuilder, error) { baseID = strings.TrimSpace(baseID) sheetID = strings.TrimSpace(sheetID) viewID = strings.TrimSpace(viewID) if baseID == "" || sheetID == "" || viewID == "" { return nil, errors.New("faq record link configuration is incomplete") } return &RecordLinkBuilder{baseID: baseID, sheetID: sheetID, viewID: viewID}, nil } func (b *RecordLinkBuilder) Build(recordID string) (string, error) { if b == nil { return "", errors.New("faq record link builder is unavailable") } recordID = strings.TrimSpace(recordID) if recordID == "" { return "", errors.New("faq record id is required") } q := url.Values{} q.Set("dentryUuid", b.baseID) q.Set("rowId", recordID) q.Set("sheetId", b.sheetID) q.Set("viewId", b.viewID) return (&url.URL{Scheme: "https", Host: "docs.dingtalk.com", Path: "/notable/record", RawQuery: q.Encode()}).String(), nil }