Så konfigurerar du en Discord-bot för Google Sheets-sökning

Innan du börjar

• Aktivera Pro-modulen Sheet Lookup på en bot i en Discord-server som du hanterar. Välj en testserver eller testkanal innan du delar kommandot.
• Förbered en flik med rubriker som inte är tomma och minst två kolumner. Välj en kolumn med unika nycklar och kolumner som får visas i Discord.
• Ta inte med privata, känsliga eller åtkomstskyddade data. Modulen accepterar en publicerad CSV-länk, inte ett privat kalkylark; alla med länken kan läsa den publicerade fliken.

1. Förbered en liten testflik med unika nycklar

   Använd första raden som kolumnrubriker och lägg till ofarliga testrader. Till exempel kan Item vara nyckelkolumn och Answer vara utdatakolumn. Varje nyckel ska förekomma en gång. Sökningen tar bort omgivande blanksteg och bortser från versaler och gemener, men söker inte efter delar av text och väljer inte mellan dubbletter.

   Det krävs minst två kolumner, rubriker som inte är tomma och rader med lika många fält som rubrikerna. Modulen avvisar felaktig CSV, valda kolumner som saknas och dubbla nycklar.

2. Publicera fliken som en CSV-länk

   Publicera den förberedda fliken på webben i Google Sheets som kommaseparerade värden (.csv) och kopiera HTTPS-länken. Sheet Lookup validerar en publicerad kalkylarksadress på docs.google.com med publiceringssökvägen och parametern output=csv. gid och single=true får finnas kvar om de ingår i den publicerade adressen.

   Använd inte redigeringslänken, en filexport, en API-adress eller en länk som kräver inloggning: valideringen avvisar dem. Kontrollera i en privat webbläsarsession att länken går till just den flik du avsåg att dela.

3. Konfigurera länken och svarskolumnerna

   Öppna botens modulflik, välj Sheet Lookup och server, och klistra in den publicerade CSV-länken. Välj kolumnen med unika nycklar och fälten som ska visas. Modulen accepterar en nyckelkolumn och en till tio utdatakolumner; interna kolumnpositioner börjar på noll.

   Behåll lookup som namn för första testet eller välj ett namn med små bokstäver, siffror, bindestreck eller understreck. Namnet får ha ett till 32 tecken och får inte ersätta ett reserverat kommando. Spara och aktivera sökning för servern först efter att du granskat de offentliga uppgifterna.

4. Testa en exakt nyckel i Discord

   Kör /lookup med ett värde från nyckelkolumnen. I exemplet med Item och Answer matchar /lookup key:rules en cell med Rules även om skiftläge eller omgivande blanksteg skiljer sig. De valda fälten visas i ett tillfälligt svar som bara den som körde kommandot kan se.

   Testa en känd och en okänd nyckel. En okänd nyckel ger ett svar utan träff, inte en partiell sökning. Om nyckeln finns på flera rader rapporterar modulen en dubblett. Rätta uppgifterna och testa igen.

5. Förstå uppdatering och fel

   Modulen hämtar fliken när någon söker. Giltiga data kan sparas i minnet i upp till fem minuter, eller kortare enligt källans cachepolicy. Svaret visar tiden för den senaste lyckade uppdateringen; en ny ändring kanske inte syns vid nästa sökning.

   Om länken inte fungerar, publicera fliken som CSV igen och kontrollera HTTPS-adressen på docs.google.com. Om kolumner saknas, kontrollera positionerna och rubrikraden. Gränserna är 1 MiB, 5 000 datarader som inte är tomma och 100 kolumner. Undvik upprepade försök efter ett fel: det finns en väntetid på 30 sekunder mellan uppdateringar.

6. Underhåll en liten och tydlig referens

   Berätta för medlemmarna vad kommandot heter och vilken nyckel de ska ange: en regeletikett, en artikelkod eller en annan exakt identifierare. Beskriv inte modulen som chatsökning: ungefärliga eller partiella sökningar, flera flikar, formelutvärdering och skrivning stöds inte.

   Granska fliken när du ändrar rubriker eller fält som visas. Om du ändrar adressen eller stänger av modulen rensas cachen i minnet. Modulen skriver inte sökhistorik till disk; ett svar bevisar inte att kalkylarket är privat eller permanent.