תבנית לבוט טלגרם פשוט לתלמידי בית ספר בכיתות ז'-ט' באמצעות Powershell

בשיחות עם חברה למדתי פתאום שילדים בכיתות ח'-י' בבית הספר שלהם לא מלמדים בכלל תכנות. וורד, אקסל והכל. אין לוגו, אפילו לא פסקל, אפילו לא VBA עבור אקסל.

הופתעתי מאוד, פתחתי את האינטרנט והתחלתי לקרוא -
אחת המשימות של בית ספר מתמחה היא לקדם את חינוך דור חדש העומד בתנאי חברת המידע ברמת התפתחותו ואורח חייו.
קורס זה יאפשר לסטודנטים לגבש בפועל את הידע שלהם על המבנים הבסיסיים של שפת התכנות פסקל. (מתוך התוכנית של מכון כושר כלשהו לשנת 2017)

בסופו של דבר, החלטתי להקדיש כמה שעות ולשרטט דוגמה של "איך ליצור בוט פשוט לתלמידי בית ספר".

מתחת לחתוך יש איך לכתוב עוד בוט פשוט ב-Powershell ולגרום לו לעבוד ללא webhook, IPs לבנים, שרתים ייעודיים, מכונות וירטואליות פרוסות בענן וכן הלאה - במחשב ביתי רגיל עם Windows רגיל.

TLDR: עוד מאמר משעמם עם שגיאות דקדוקיות ועובדתיות, אין מה לקרוא, אין הומור, אין תמונות.

אין שום חדש בכתבה, כמעט כל מה שנכתב קודם כבר היה ב-Habré, למשל בכתבות הוראות: כיצד ליצור בוטים בטלגרם и בוט טלגרם למנהל מערכת.
יתרה מכך, המאמר מיותר בכוונה כדי לא להתייחס כל פעם לספרות חינוכית. אין התייחסות ל-Gang 4, PowerShell Deep Dives או, נניח, ל-5 עמודי התווך של ה-AWS Architected Well-Framework בטקסט.

במקום הקדמה, אתה יכול לדלג

אתה מוזמן לדלגבשנת 2006, מיקרוסופט פרסמה את PowerShell 1.0 עבור Windows XP, Vista ו- Server 2003 שהיו אז. במובנים מסוימים, זה החליף דברים כמו סקריפטים של cmdbat, סקריפטים vb, Windows Script Host ו-JScript.

אפילו עכשיו, PowerShell יכול להיחשב רק כשלב הבא אחרי אפשרויות הלוגו, במקום דלפי שכנראה עדיין בשימוש (או משהו ישן יותר), למרות הנוכחות של לולאות, מחלקות, פונקציות, קריאות של MS GUI, אינטגרציה של Git וכן הלאה.

משתמשים ב-Powershell לעתים רחוקות יחסית; אתה יכול להיתקל בו רק בצורה של PowerShell Core, VMware vSphere PowerCLI, Azure PowerShell, MS Exchange, Desired State Configuration, PowerShell Web Access ועוד תריסר תוכניות ופונקציות בשימוש נדיר. אולי הוא יקבל רוח שנייה עם השחרור WSL2, אבל זה לא בדיוק.

ל- Powershell יש גם שלושה יתרונות גדולים:

1. זה יחסית פשוט, יש הרבה ספרות ודוגמאות על זה, ואפילו ברוסית, למשל, מאמר על Foreach - מהספר PowerShell לעומק - על ההבדל () ו-{}
2. הוא הולך עם העורך ISE, כלול עם Windows. יש שם אפילו סוג של ניפוי באגים.
3. קל להתקשר ממנו רכיבים לבניית ממשק גרפי.

0. הכנה.

נצטרך:

• Windows PC (יש לי ווינדוס 10)
• לפחות סוג כלשהו של גישה לאינטרנט (דרך NAT למשל)
• למי שיש גישה מוגבלת לטלגרם - פריגייט מותקן ומוגדר בדפדפן, במקרים קשים, יחד עם Symple DNS Crypt
• יש לקוח טלגרם עובד בטלפון שלך
• הבנת היסודות מאוד - מהו משתנה, מערך, לולאה.

פתח וקרא מאמרים - הוראות: כיצד ליצור בוטים בטלגרם и בוט טלגרם למנהל מערכת

1. בואו ניצור בוט בדיקה נוסף.

מכיוון שכולם כבר יודעים את זה, וכבר קרה, אפשר גם לדלג על זהכפי שנאמר במאמר למעלה - קודם כל, בוט לטלגרם - זה עדיין יישום שפועל בצד שלך ומגיש בקשות ל- Telegram Bot API. יתרה מכך, ה-API ברור - הבוט ניגש לכתובת URL ספציפית עם פרמטרים, וטלגרם מגיבה עם אובייקט JSON.

בעיות קשורות: אם בדרך לא ידועה אתה לוקח קוד כלשהו מאובייקט JSON ואיכשהו שולח אותו לביצוע (לא בכוונה), הקוד יבוצע עבורך.

תהליך היצירה מתואר בשני מאמרים למעלה, אבל אני חוזר: במברק אנחנו פותחים אנשי קשר, מחפשים את @botfather, אומרים לו /newbot, יוצרים בוט Botfortest12344321, קוראים לו Mynext1234bot ומקבלים הודעה עם מפתח ייחודי של טופס 1234544311:AbcDefNNNNNNNNNNNNNN

שמרו על המפתח ואל תתנו אותו!

אז אתה יכול להגדיר את הבוט, למשל, לאסור להוסיף אותו לקבוצות, אבל בשלבים הראשונים זה לא הכרחי.

בואו נבקש מ-BotFather "/mybot" ונתאים את ההגדרות אם משהו לא מוצא חן בעינינו.

בואו נפתח שוב את אנשי הקשר, נמצא שם את @Botfortest12344321 (חובה להתחיל את החיפוש עם @), נלחץ על "התחל" ונכתוב לבוט "/Glory to the Robots". הסימן / נדרש, אין צורך בהצעות מחיר.
הבוט, כמובן, לא יענה על כלום.

בואו נבדוק שהבוט נוצר ונפתח אותו.

api.telegram.org/bot1234544311:AbcDefNNNNNNNNNNNNNN/getMe
כאשר 1234544311:AbcDefNNNNNNNNNNNNNN הוא המפתח שהתקבל בעבר,
ומקבלים שורה כמו
{"ok":true,"result":{""}}

יש לנו את הביטוי הסודי הראשון (אסימון). עכשיו אנחנו צריכים לגלות את המספר הסודי השני - המזהה של הצ'אט עם הבוט. כל צ'אט, קבוצה וכו' הוא אינדיבידואלי ויש לו מספר משלו (לעיתים עם מינוס - לקבוצות פתוחות). כדי לברר את המספר הזה, עלינו לבקש בדפדפן (למעשה, זה כלל לא נחוץ בדפדפן, אבל להבנה טובה יותר אפשר להתחיל איתו) את הכתובת (כאשר 1234544311:NNNNNNNNNN הוא האסימון שלך

https://api.telegram.org/bot1234544311:NNNNNNNNN/getUpdates

ותקבל תגובה כמו

{"ok":true,"result":[{"update_id":...,... צ'אט":{"תְעוּדַת זֶהוּת":123456789

אנחנו צריכים chat_id.

בואו נבדוק שאנחנו יכולים לכתוב לצ'אט באופן ידני: התקשר לכתובת מהדפדפן

https://api.telegram.org/botваштокен/sendMessage?chat_id=123456789&text="Life is directed motion"

אם אתה מקבל הודעה מבוט בצ'אט שלך, בסדר, אתה עובר לשלב הבא.

כך (דרך הדפדפן) תמיד אפשר לבדוק האם יש בעיות ביצירת הקישורים, או שמשהו מוסתר איפשהו ולא עובד.

מה שאתה צריך לדעת לפני שתמשיך לקרוא

לטלגרם יש כמה סוגים של צ'אטים קבוצתיים (פתוח, סגור). עבור צ'אטים אלה, חלק מהפונקציות (למשל, id) שונות, מה שלעתים גורם לבעיות מסוימות.

בואו נניח שזה סוף 2019, ואפילו הגיבור של זמננו, Man-Orchestra הידוע (מנהל, עורך דין, מומחה אבטחת מידע, מתכנת ולמעשה MVP) Evgeniy V. מבדיל בין המשתנה $i למערך, שולט בלולאות, תראה בשנתיים הקרובות תשלוט ב- Chocolatey, ואז עיבוד מקביל עם PowerShell и ForEach-Object מקביל זה יבוא.

1. אנחנו חושבים מה הבוט שלנו יעשה

לא היו לי רעיונות, הייתי צריך לחשוב. כבר כתבתי מחברת בוט. לא רציתי ליצור בוט "ששולח משהו לאנשהו". כדי להתחבר ל-Azure צריך כרטיס אשראי, אבל מאיפה הסטודנט משיג אותו? יש לציין שהכל לא כל כך נורא: העננים הראשיים נותנים איזושהי תקופת בדיקה בחינם (אבל עדיין צריך מספר כרטיס אשראי - ונראה שיחויב מזה דולר. אני לא זוכר אם זה הוחזר מאוחר יותר.)

בלי AI ML זה לא כל כך מעניין לעשות בוט-עני-משורר-אורג.

החלטתי לעשות בוט שיזכיר לי (או לא לי) מילים באנגלית מהמילון.
כדי להימנע מהתעסקות במסד הנתונים, המילון יאוחסן בקובץ טקסט ויעודכן באופן ידני.
במקרה זה, המשימה היא להראות את יסודות העבודה, ולא ליצור לפחות מוצר מוגמר חלקית.

2. מנסים מה ואיך בפעם הראשונה

בואו ניצור תיקייה C:poshtranslate
ראשית, בואו נראה איזה סוג של Powershell יש לנו, בואו נשיק את ISE דרך start-run
powershell ise
או מצא את Powershell ISE בתוכנות המותקנות.
לאחר ההשקה, "סוג של עורך" המוכר הרגיל ייפתח; אם אין שדה טקסט, אתה תמיד יכול ללחוץ על "קובץ - צור חדש".

בואו נסתכל על הגרסה של powershell - כתוב בשדה הטקסט:

get-host 

והקש F5.

Powershell תציע לשמור - "הסקריפט שאתה עומד להפעיל יישמר.", אנו מסכימים, ונשמור את הקובץ מ-powershell עם השם ב-C: poshtranslate myfirstbotBT100.

לאחר ההשקה, בחלון הטקסט התחתון נקבל טבלת נתונים:

Name             : Windows PowerShell ISE Host
Version          : 5.1.(и так далее)

יש לי משהו 5.1, זה מספיק. אם יש לך Windows 7/8 ישן אז לא עניין גדול - למרות ש-PowerShell יהיה צורך לעדכן לגרסה 5 - למשל. הוראות.

הקלד Get-Date בשורת הפקודה למטה, הקש Enter, הסתכל על השעה, עבור אל תיקיית השורש עם הפקודה
cd
ונקה את המסך עם הפקודה cls (לא, אתה לא צריך להשתמש ב-rm)

עכשיו בואו נבדוק מה עובד ואיך - בואו נכתוב אפילו לא את הקוד, אלא שתי שורות, וננסה להבין מה הם עושים. בואו נעיר את השורה עם get-host עם הסמל # ונוסיף מעט.

# Пример шаблона бота 
# get-host
<# это пример многострочного комментария #>
$TimeNow = Get-Date
$TimeNow

(מה שמעניין הוא שברשימה הנפתחת של עיצוב הקוד ב-Habré יש שתי תריסר אפשרויות - אבל Powershell לא שם. Dos יש. Perl נמצא שם.)

ובואו נריץ את הקוד על ידי לחיצה על F5 או ">" מה-GUI.

אנו מקבלים את הפלט הבא:

Saturday, December 8, 2019 21:00:50 PM (или что-то типа)

עכשיו בואו נסתכל על שני השורות האלה וכמה נקודות מעניינות כדי שלא נחזור לזה בעתיד.

בניגוד לפסקל (ולא רק), PowerShell עצמה מנסה לקבוע איזה סוג להקצות למשתנה; פרטים נוספים על כך כתובים במאמר תוכנית חינוכית בנושא הקלדה בשפות תכנות
לכן, על ידי יצירת משתנה $TimeNow והקצאת הערך של התאריך והשעה הנוכחיים (Get-Date), אנחנו לא צריכים לדאוג יותר מדי לגבי סוג הנתונים שיהיו שם.

נכון, הבורות הזו עלולה לפגוע בהמשך, אבל זה למאוחר יותר. למטה בטקסט תהיה דוגמה.
בוא נראה מה יש לנו. בוא נבצע (בשורת הפקודה)

$TimeNow | Get-member

ולקבל עמוד של טקסט לא מובן

דוגמה לטקסט לא מובן מספר 1

PS C:> $TimeNow | Get-member
   TypeName: System.DateTime
Name                 MemberType     Definition                                                                                                                                       
----                 ----------     ----------                                                                                                                                       
Add                  <b>Method         </b>datetime Add(timespan value)  
..
DisplayHint          NoteProperty   DisplayHintType DisplayHint=DateTime                                                                                                             
Date                 <b>Property       </b>datetime Date {get;}                                                                                                                             
Year                 Property       int Year {get;}   
..                                                                                                                               
DateTime             ScriptProperty System.Object DateTime {get=if ((& { Set-StrictMode -Version 1; $this.DisplayHint }) -ieq  "Date")...                                         

כפי שאתה יכול לראות, משתנה מסוג TypeName: System.DateTime נוצר עם חבורה של מתודות (במובן של מה אנחנו יכולים לעשות עם אובייקט משתנה זה) ומאפיינים.

בואו נתקשר $TimeNow.DayOfYear - אנו מקבלים את מספר היום בשנה.
בואו נתקשר $TimeNow.DayOfYear | Get-Member - אנחנו מקבלים TypeName: System.Int32 וקבוצת שיטות.
בואו נתקשר $TimeNow.ToUniversalTime() - וקבל את השעה ב-UTC

מנפה

לפעמים קורה שיש צורך להפעיל תוכנית עד שורה מסוימת ולראות את מצב התוכנית באותו רגע. למטרה זו, ל-ISE יש פונקציית Debug - נקודת ניתוק
שימו נקודת שבירה איפשהו באמצע, הפעילו את שני השורות הללו וראו איך ההפסקה נראית.

3. הבנת האינטראקציה עם בוט הטלגרם

כמובן, אפילו יותר ספרות נכתבה על אינטראקציה עם הבוט, עם כל getpush וכן הלאה, אבל נושא התיאוריה יכול להיחשב באופן אופציונלי.

במקרה שלנו יש צורך:

• למד לשלוח משהו בהתכתבות
• למד לקבל משהו מהתכתבות

3.1 ללמוד לשלוח משהו בהתכתבות ולקבל ממנו

קוד קטן - חלק 3

Write-output "This is part 3"
$MyToken = "1234544311:AbcDefNNNNNNNNNNNNN"
$MyChatID = "123456789"
$MyProxy = "http://1.2.3.4:5678" 

$TimeNow = Get-Date
$TimeNow.ToUniversalTime()
$ScriptDir = Split-Path $script:MyInvocation.MyCommand.Path
$BotVersion = "BT102"

$MyText01 = "Life is directed motion - " + $TimeNow

$URL4SEND = "https://api.telegram.org/bot$MyToken/sendMessage?chat_id=$MyChatID&text=$MyText01"

Invoke-WebRequest -Uri $URL4SEND

ובפדרציה הרוסית בשלב זה אנו מקבלים את השגיאה לא ניתן להתחבר לשרת המרוחק.

או שאנחנו לא מקבלים את זה - תלוי במפעיל הטלקום והאם ה-proxy מוגדר ופועל
ובכן, כל מה שנותר הוא להוסיף פרוקסי. שים לב ששימוש בפרוקסי לא מוצפן ובדרך כלל הונאה מסוכן מאוד לבריאותך.

המשימה של מציאת פרוקסי עובד היא לא מאוד קשה - רוב פרוקסי http שפורסמו עובדים. אני חושב שהחמישי עבד בשבילי.

תחביר באמצעות פרוקסי:

Invoke-WebRequest -Uri $URL4SEND -Proxy $MyProxy

אם אתה מקבל הודעה בצ'אט שלך עם בוט, אז הכל בסדר, אתה יכול להמשיך הלאה. אם לא, המשך בניפוי הבאגים.

אתה יכול לראות למה מחרוזת $URL4SEND שלך הופכת ולנסות לבקש זאת בדפדפן, כך:

$URL4SEND2 = '"'+$URL4SEND+'"'
start chrome $URL4SEND2 

3.2. למדנו איך לכתוב "משהו" בצ'אט, עכשיו בואו ננסה לקרוא אותו

בואו נוסיף עוד 4 שורות ונראה מה יש בפנים דרך | קבל-חבר

$URLGET = "https://api.telegram.org/bot$MyToken/getUpdates"
$MyMessageGet = Invoke-WebRequest -Uri $URLGET -Method Get -Proxy $MyProxy
Write-Host "Get-Member"
$MyMessageGet | Get-Member

הדבר המעניין ביותר מסופק לנו

Content           Property   string Content {get;}  
ParsedHtml        Property   mshtml.IHTMLDocument2 ParsedHtml {get;}                                    
RawContent        Property   string RawContent {get;set;}

בוא נראה מה יש בהם:

Write-Host "ParsedHtml"
$MyMessageGet.ParsedHtml # тут интересное
Write-Host "RawContent"
$MyMessageGet.RawContent # и тут интересное, но еще к тому же и читаемое. 
Write-Host "Content"
$MyMessageGet.Content

אם הכל עובד בשבילך, תקבל תור ארוך כמו:

{"ok":true,"result":[{"update_id":12345678,
"message":{"message_id":3,"from":{"id"

למרבה המזל, במאמר שפורסם בעבר בטלגרם בוט למנהל מערכת שורה זו (כן, לפי $MyMessageGet.RawContent | get-member הוא System.String), כבר פורק.

4. עבד את מה שאתה מקבל (אנחנו כבר יודעים איך לשלוח משהו)

כפי שכבר נכתב כאן, הדברים הנחוצים ביותר טמונים בתוכן. בואו נסתכל על זה מקרוב.

ראשית, נכתוב עוד כמה ביטויים לבוט מממשק האינטרנט או מהטלפון

/message1
/message2
/message3

ועיין בדפדפן בכתובת שנוצרה במשתנה $URLGET.

נראה משהו כמו:

{"ok":true,"result":[{"update_id":NNNNNNN,
"message":{"message_id":10, .. "text":"/message1"
"message":{"message_id":11, .. "text":"/message2 
"message":{"message_id":12, .. "text":"/message3 

מה זה? אובייקט מורכב כלשהו מתוך מערכים של אובייקטים המכילים מזהה הודעה מקצה לקצה, מזהה צ'אט, מזהה שליחה ועוד הרבה מידע.

עם זאת, אנחנו לא צריכים להבין "איזה סוג של חפץ זה" - חלק מהעבודה כבר נעשה עבורנו. בוא נראה מה יש בפנים:

קריאת הודעות שהתקבלו או חלק 4

Write-Host "This is part 4" <# конечно эта строка нам не нужна в итоговом тексте, но по ней удобно искать. #> 

$Content4Pars01 = ConvertFrom-Json $MyMessageGet.Content
$Content4Pars01 | Get-Member
$Content4Pars01.result
$Content4Pars01.result[0]
$Content4Pars01.result[0] | Get-Member
$Content4Pars01.result[0].update_id
$Content4Pars01.result[0].message
$Content4Pars01.result[0].message.text
$Content4Pars01.result[1].message.text
$Content4Pars01.result[2].message.text

5. מה עלינו לעשות עם זה עכשיו?

בוא נשמור את הקובץ שהתקבל תחת השם myfirstbotBT105 או מה שאתה הכי אוהב, שנה את הכותרת והעיר את כל הקוד שכבר נכתב באמצעות

<#start comment 105 end comment 105#>

עכשיו אנחנו צריכים להחליט איפה להשיג את המילון (טוב, איפה - בדיסק בקובץ) ואיך הוא ייראה.

כמובן, אתה יכול לכתוב מילון ענק ממש בטקסט של התסריט, אבל זה לגמרי לא לעניין.
אז בואו נראה עם מה Powershell יכול לעבוד בדרך כלל.
באופן כללי, לא אכפת לו עם איזה קובץ לעבוד, זה לא משנה לנו.
יש לנו אפשרות בחירה: txt (אתה יכול, אבל למה), csv, xml.
האם נוכל לצפות בכולם? בוא נראה את כולם.
בואו ניצור מחלקה MyVocabClassExample1 ומשתנה $MyVocabExample1
אני שם לב שהכיתה כתובה ללא $

איזה קוד מס' 5

write-host "This is part 5"
class MyVocabClassExample1 {
    [string]$Original  # слово
    [string]$Transcript
    [string]$Translate
    [string]$Example
    [int]$VocWordID # очень интересный момент. Использование int с его ограничениями может порой приводить к диким последствиям, для примера - недавний случай с SSD HPE. Изначально я не стал добавлять этот элемент, потом все же дописал и закомментировал.
    }

$MyVocabExample1 = [MyVocabClassExample1]::new()
$MyVocabExample1.Original = "Apple"
$MyVocabExample1.Transcript = "[ ˈapəl ]"
$MyVocabExample1.Translate = "Яблоко"
$MyVocabExample1.Example = "An apple is a sweet, edible fruit produced by an apple tree (Malus domestica)"
# $MyVocabExample1.$VocWordID = 1

$MyVocabExample2 = [MyVocabClassExample1]::new()
$MyVocabExample2.Original = "Pear"
$MyVocabExample2.Transcript = "[ pe(ə)r ]"
$MyVocabExample2.Translate = "Груша"
$MyVocabExample2.Example = "The pear (/ˈpɛər/) tree and shrub are a species of genus Pyrus"
# $MyVocabExample1.$VocWordID = 2

בואו ננסה לכתוב את זה לקבצים באמצעות מוֹפְתִי.

קצת קוד #5.1

Write-Host $ScriptDir # надеюсь $ScriptDir вы не закомментировали 
$MyFilenameExample01 = $ScriptDir + "Example01.txt"
$MyFilenameExample02 = $ScriptDir + "Example02.txt"
Write-Host $MyFilenameExample01
Out-File  -FilePath $MyFilenameExample01 -InputObject $MyVocabExample1

Out-File  -FilePath $MyFilenameExample01 -InputObject -Append $MyVocabExample2
notepad $MyFilenameExample01

- ואנו מקבלים שגיאה בשורה Out-File -FilePath $MyFilenameExample01 -InputObject -Append $MyVocabExample2.

הוא לא רוצה להוסיף, אה-אה, כמה חבל.

$MyVocabExample3AsArray = @($MyVocabExample1,$MyVocabExample2)
Out-File  -FilePath $MyFilenameExample02 -InputObject $MyVocabExample3AsArray
notepad $MyFilenameExample02

בוא נראה מה קורה. תצוגת טקסט נהדרת - אבל איך לייצא אותה בחזרה? האם עלי להציג סוג של מפרידי טקסט, כגון פסיקים?

ובסופו של דבר אתה מקבל "קובץ ערכים מופרדים בפסיקים (CSV) A תפסיק לחכות.
#

$MyFilenameExample03 = $ScriptDir + "Example03.csv"
$MyFilenameExample04 = $ScriptDir + "Example04.csv"
Export-Csv  -Path $MyFilenameExample03 -InputObject $MyVocabExample1 
Export-Csv  -Path $MyFilenameExample03 -InputObject $MyVocabExample2 -Append 
Export-Csv  -Path $MyFilenameExample04 -InputObject $MyVocabExample3AsArray 

כפי שקל לראות, MS לא נבדלת במיוחד בהיגיון שלה; עבור הליך דומה, במקרה אחד משתמשים ב-FilePath, וב-Path אחר.

בנוסף, בקובץ השלישי השפה הרוסית נעלמה, בקובץ הרביעי התברר... טוב, קרה משהו. #TYPE System.Object[] 00
# "ספירה","אורך","LongLength","Rank","SyncRoot","IsReadOnly","IsFixedSize","IsSynchronized"
#
בוא נשכתב את זה קצת:

Export-Csv  -Path $MyFilenameExample03 -InputObject $MyVocabExample1 -Encoding Unicode
Export-Csv  -Path $MyFilenameExample03 -InputObject $MyVocabExample2 -Append -Encoding Unicode
notepad $MyFilenameExample03
notepad $MyFilenameExample04

נראה שזה עזר, אבל אני עדיין לא אוהב את הפורמט.

אני במיוחד לא אוהב את זה שאני לא יכול להכניס קווים מאובייקט לקובץ ישירות.
אגב, מאז שהתחלנו לכתוב לקבצים, האם נוכל להתחיל לנהל יומן אתחול? יש לנו זמן בתור משתנה, אנחנו יכולים להגדיר את שם הקובץ.

נכון, עדיין אין מה לכתוב, אבל אפשר לחשוב איך הכי טוב לסובב את היומנים.
בוא ננסה את xml לעת עתה.

קצת xml

$MyFilenameExample05 = $ScriptDir + "Example05.xml"
$MyFilenameExample06 = $ScriptDir + "Example06.xml"
Export-Clixml  -Path $MyFilenameExample05 -InputObject $MyVocabExample1 
Export-Clixml  -Path $MyFilenameExample05 -InputObject $MyVocabExample2 -Append -Encoding Unicode
Export-Clixml  -Path $MyFilenameExample06 -InputObject $MyVocabExample3AsArray
notepad $MyFilenameExample05
notepad $MyFilenameExample06

לייצוא ל-xml יש יתרונות רבים - קריאה, ייצוא של האובייקט כולו, ואין צורך בביצוע העלאה.

בואו ננסה קרא קובץ xml.

קריאה קטנה מ-xml

$MyFilenameExample06 = $ScriptDir + "Example06.xml"
$MyVocabExample4AsArray = Import-Clixml -Path $MyFilenameExample06
# $MyVocabExample4AsArray 
# $MyVocabExample4AsArray[0]
# и немного о совершенно неочевидных нюансах. Powershell время от времени ведет себя не так, как вроде бы как бы стоило бы ожидать бы.
# например у меня эти два вывода отличаются
# Write-Output $MyVocabExample4AsArray 
# write-host $MyVocabExample4AsArray 

נחזור למשימה. כתבנו קובץ בדיקה, קראו אותו, פורמט האחסון ברור, במידת הצורך, ניתן לכתוב עורך קבצים קטן נפרד כדי להוסיף ולמחוק שורות.

הרשו לי להזכיר לכם שהמשימה הייתה ליצור בוט אימון קטן.

פורמט עבודה: אני שולח את הפקודה "דוגמה" לבוט, הבוט שולח לי מילה ותעתיק שנבחרו באקראי, ואחרי 10 שניות שולח לי תרגום והערה. אנו יודעים לקרוא פקודות, נרצה גם ללמוד כיצד לבחור ולבדוק פרוקסי אוטומטית, ולאפס מונים להודעות לשכחה.

בואו נבטל את ההערות על כל מה שהעיר בעבר כמיותר, נגיב על הדוגמאות המיותרות כעת עם txt ו-csv, ונשמור את הקובץ כגרסה B106

אה כן. בוא נשלח משהו לבוט שוב.

6. שיגור מפונקציות ועוד

לפני עיבוד הקבלה, עליך ליצור פונקציה לשליחת "לפחות משהו" מלבד הודעת בדיקה.

כמובן שבדוגמה תהיה לנו רק שליחה אחת ורק עיבוד אחד, אבל מה אם נצטרך לעשות את אותו הדבר מספר פעמים?

קל יותר לכתוב פונקציה. אז, יש לנו משתנה מסוג אובייקט $MyVocabExample4AsArray, שנקרא מהקובץ, בצורה של מערך של עד שני אלמנטים.
בוא נלך לקרוא.

במקביל, נתמודד עם השעון; נזדקק לו מאוחר יותר (למעשה, בדוגמה זו לא נצטרך אותו :)

קצת קוד #6.1

Write-Output "This is Part 6"
$Timezone = (Get-TimeZone)
IF($Timezone.SupportsDaylightSavingTime -eq $True){
    $TimeAdjust =  ($Timezone.BaseUtcOffset.TotalSeconds + 3600) } # приведенное время
    ELSE{$TimeAdjust = ($Timezone.BaseUtcOffset.TotalSeconds) 
    }
    
function MyFirstFunction($SomeExampleForFunction1){
$TimeNow = Get-Date
$TimeNow.ToUniversalTime()
# $MyText02 = $TimeNow + " " + $SomeExampleForFunction1 # и вот тут мы получим ошибку
$MyText02 = $SomeExampleForFunction1 + " " + $TimeNow # а тут не получим, кто догадается почему - тот молодец.

$URL4SendFromFunction = "https://api.telegram.org/bot$MyToken/sendMessage?chat_id=$MyChatID&text=$MyText02"
Invoke-WebRequest -Uri $URL4SendFromFunction -Proxy $MyProxy
}

כפי שניתן לראות בקלות, הפונקציה קוראת ל-$MyToken ו-$MyChatID, שקודדו קודם לכן.

אין צורך לעשות זאת, ואם $MyToken הוא אחד עבור כל בוט, אז $MyChatID ישתנה בהתאם לצ'אט.

עם זאת, מכיוון שזו דוגמה, נתעלם ממנה לעת עתה.

מכיוון ש$MyVocabExample4AsArray אינו מערך, למרות שהוא דומה מאוד למערך אחד, אז אתה לא יכול פשוט לקחת את זה לבקש את אורכו.

שוב נצטרך לעשות משהו שלא ניתן לעשות - לצנוח לא לפי הקוד - לקחת ולספור

קצת קוד #6.2

$MaxRandomExample = 0 
foreach ($Obj in $MyVocabExample4AsArray) {
$MaxRandomExample ++
}
Write-Output $MaxRandomExample
$RandomExample = Get-Random -Minimum 0 -Maximum ($MaxRandomExample)
$TextForExample1 = $MyVocabExample4AsArray[$RandomExample].Original
# MyFirstFunction($TextForExample1)
# или в одну строку
# MyFirstFunction($MyVocabExample4AsArray[Get-Random -Minimum 0 -Maximum ($MaxRandomExample -1)].Example)
# Угадайте сами, какой пример легче читается посторонними людьми.

אַקרַאִי תכונה מעניינת. נניח שאנו רוצים לקבל 0 או 1 (יש לנו רק שני אלמנטים במערך). כשמגדירים גבולות 0..1, האם נקבל "1"?
לא - לא נקבל את זה, יש לנו דוגמה מיוחדת דוגמה 2: קבל מספר שלם אקראי בין 0 ל-99 Get-Random - מקסימום 100
לכן, עבור 0..1 עלינו להגדיר את הגודל 0..2, כאשר מספר האלמנט המקסימלי הוא 1.

7. עיבוד הודעות נכנסות ואורך תור מקסימלי

איפה עצרנו קודם? יש לנו את המשתנה $MyMessageGet שהתקבל
ו-$Content4Pars01 שהתקבלו ממנו, מהם אנו מעוניינים באלמנטים של מערך Content4Pars01.result

$Content4Pars01.result[0].update_id
$Content4Pars01.result[0].message
$Content4Pars01.result[0].message.text

בוא נשלח את הבוט /message10, /message11, /message12, /word ושוב /word ו-/hello.
בוא נראה מה קיבלנו:

$Content4Pars01.result[0].message.text
$Content4Pars01.result[2].message.text

בואו נעבור על כל מה שהתקבל ונשלח תגובה אם ההודעה הייתה /word
המקרה של construct, מה שמתארים כמו if-elseif, נקרא ב-powershell באמצעות מתג. יחד עם זאת, הקוד שלהלן משתמש במפתח -ה-wildcard, שהוא מיותר לחלוטין ואף מזיק.

קצת קוד #7.1

Write-Output "This is part 7"
Foreach ($Result in $Content4Pars01.result) # Да, можно сделать быстрее 
 { 
    switch -wildcard ($Result.message.text) 
            {
            "/word" {MyFirstFunction($TextForExample1)}
            }
}

בוא נריץ את התסריט כמה פעמים. נקבל את אותה מילה פעמיים עבור כל ניסיון ביצוע, במיוחד אם עשינו טעות ביישום אקראי.

אבל תפסיק. לא שלחנו שוב /word, אז למה ההודעה מעובדת שוב?

לתור שליחת הודעות לבוט יש אורך סופי (100 או 200 הודעות, אני חושב) ויש לנקות אותו ידנית.

זה כמובן מתואר בתיעוד, אבל אתה חייב לקרוא אותו!

במקרה זה, אנו זקוקים לפרמטר ?chat_id, ו-&timeout, &limit, &parse_mode=HTML ו-&disable_web_page_preview=true אינם נחוצים עדיין.

תיעוד עבור ממשק API של טלגרם נמצא כאן
כתוב בלבן ובאנגלית:
מזהה העדכון הראשון שיוחזר. חייב להיות גדול באחד מהגבוה ביותר מבין המזהים של עדכונים שהתקבלו בעבר. כברירת מחדל, עדכונים מתחילים מהמוקדם ביותר
לא מאושר עדכון מוחזר. עדכון נחשב למאושר ברגע ש-getUpdates נקרא עם an לקזז גבוה יותר מאשר update_id שלו. ניתן לציין את ההיסט השלילי כדי לאחזר עדכונים החל מ--offset update מסוף תור העדכונים. כל העדכונים הקודמים יישכחו.

בוא נסתכל על:

$Content4Pars01.result[0].update_id
$Content4Pars01.result[1].update_id 
$Content4Pars01.result | select -last 1
($Content4Pars01.result | select -last 1).update_id

כן, ואנו נאפס אותו ונכתוב מעט את הפונקציה. יש לנו שתי אפשרויות - להעביר את כל ההודעה לפונקציה ולעבד אותה כולה בפונקציה, או לתת רק את מזהה ההודעה ולאפס אותה. לדוגמה, השני נראה פשוט יותר.

בעבר, מחרוזת השאילתה "כל ההודעות" שלנו נראתה כך

$URLGET = "https://api.telegram.org/bot$MyToken/getUpdates"

וזה ייראה כמו

$LastMessageId = ($Content4Pars01.result | select -last 1).update_id
$URLGET1 = "https://api.telegram.org/bot$mytoken/getUpdates?offset=$LastMessageId&limit=100" 
$MyMessageGet = Invoke-WebRequest -Uri $URLGET1 -Method Get -Proxy $MyProxy 

אף אחד לא אוסר עליך לקבל תחילה את כל ההודעות, לעבד אותן, ורק לאחר עיבוד מוצלח בקשה לא אושרה -> אושרה.

מדוע הגיוני להתקשר לאישור לאחר השלמת כל העיבוד? כשל אפשרי באמצע הביצוע, ואם למשל של צ'אט בוט חינמי, חסר של הודעה בודדת אינו משהו מיוחד, אז אם אתה מעבד משכורת או עסקת כרטיס של מישהו, התוצאה עלולה להיות גרועה יותר.

עוד כמה שורות קוד

$LastMessageId = ($Content4Pars01.result | select -last 1).update_id  #ошибку в этом месте предполагается исправить самостоятельно. 
$URLGET1 = "https://api.telegram.org/bot$mytoken/getUpdates?offset=$LastMessageId&limit=100" 
Invoke-WebRequest -Uri $URLGET1 -Method Get -Proxy $MyProxy

8. במקום מסקנה

פונקציות בסיסיות - קריאת הודעות, איפוס תור, קריאה מקובץ וכתיבה לקובץ נעשות ומוצגות.

נותרו רק ארבעה דברים לעשות:

• שליחת התשובה הנכונה לבקשה בצ'אט
• שליחת תגובה לכל צ'אט אליו התווסף הבוט
• ביצוע קוד בלולאה
• הפעלת בוט מתזמן Windows.

כל המשימות הללו פשוטות וניתן לבצע אותן בקלות על ידי קריאת התיעוד על פרמטרים כגון
Set-ExecutionPolicy Unrestricted ו-ExecutionPolicy מעקף
מחזור הטופס

$TimeToSleep = 3 # опрос каждые 3 секунды
$TimeToWork = 10 # минут
$HowManyTimes = $TimeToWork*60/$TimeToSleep # счетчик для цикла
$MainCounter = 0
for ($MainCounter=0; $MainCounter -le $HowManyTimes) {
sleep $TimeToSleep
$MainCounter ++

תודה לכל מי שקרא.

מקור: www.habr.com