Umfragen
Wie du der Community in einem Feed- oder Inhalte-Bereich eine Frage stellst: die Umfrage anlegen (Optionen, Mehrfachauswahl, Frist), abstimmen, die Stimme ändern und zurückziehen, wer das Ergebnis wann sieht, bearbeiten, sehen, wer abgestimmt hat, beenden, und dieselben Aktionen über die API und den Assistenten.
Eine Umfrage ist ein Beitrag mit einer Frage und 2 bis 10 Optionen, über die die Community abstimmt. Sie entsteht in einem Feed-Bereich (als Status, dessen Text die Frage ist) oder in einem Inhalte-Bereich (als Beitrag, dessen Titel die Frage ist), und ansonsten ist sie ein Beitrag wie jeder andere: Sie erscheint im Feed, bekommt Reaktionen und Kommentare, lässt sich anheften und benachrichtigt wie ein neuer Beitrag.
Umfragen gibt es nur in Feed- oder Inhalte-Bereichen; in jeder anderen Art von Bereich lehnt die API sie ab.
Wozu sie dient
| Community | Umfrage |
|---|---|
| Event | „Welcher Monat passt am besten für die APICON Rio?", mit März, April und Mai |
| Online-Schule | „Welches Thema möchtest du in der nächsten Live-Stunde?", mit Mehrfachauswahl |
| Coworking | „Welche Reinigungszeit stört am wenigsten?", mit Frist bis Freitag |
| Verein | Eine schnelle Abfrage vor der Versammlung, mit dem Ergebnis zum Fristende |
So funktioniert es
Wer was darf
| Aktion | Wer |
|---|---|
| Eine Umfrage anlegen | Eigentümer, Administrator und Moderator |
| Abstimmen, Stimme ändern und zurückziehen | Jedes Mitglied, das den Beitrag sieht |
| Das Ergebnis sehen | Das Team immer; andere Mitglieder nach der Abstimmung oder sobald die Umfrage beendet ist |
| Bearbeiten, sehen, wer abgestimmt hat, und beenden | Eigentümer, Administrator und Moderator |
Die Rolle Finanzen stimmt wie jedes Mitglied ab, legt aber keine Umfragen an und verwaltet sie nicht. Wer den Beitrag ohne Anmeldung sieht, findet Melde dich an, um abzustimmen; wer angemeldet, aber kein Mitglied der Community ist, sieht Nur Mitglieder der Community können abstimmen.
Einfach- oder Mehrfachauswahl
Die Karte zeigt das Label Umfrage und unter der Frage Wähle eine Option oder Wähle eine oder mehrere Optionen:
- Eine Option: Ein Klick auf die Option ist schon die Stimme.
- Mehrfachauswahl (wenn die Umfrage mit Mehrfachauswahl erlauben angelegt wurde): Die Person markiert die Optionen und klickt auf Abstimmen.
Nach der Abstimmung ist die gewählte Option als Deine Stimme markiert, und Stimme ändern und Stimme zurückziehen erscheinen. Solange die Umfrage offen ist, lässt sich die Stimme beliebig oft ändern oder zurückziehen.
Wer das Ergebnis sieht
- Mitglieder sehen die Balken mit Prozent und Gesamtzahl nach der Abstimmung oder sobald die Umfrage beendet ist. Vorher zeigt die Karte Stimme ab, um das Ergebnis zu sehen.
- Das Team (Eigentümer, Administrator und Moderator) sieht das Ergebnis immer, ob es abgestimmt hat oder nicht.
Der Prozentsatz jeder Option bezieht sich auf die Personen, die abgestimmt haben, nicht auf die Gesamtzahl der Stimmen. Bei Mehrfachauswahl ergibt die Summe mehr als 100 %: Haben 10 Personen abgestimmt und 7 März markiert, hat März 70 %, auch wenn sie weitere Optionen markiert haben. Unten steht „N Personen haben abgestimmt" (oder Noch keine Stimmen).
Frist und Beenden
Mit einer Frist endet die Umfrage von selbst zum gewählten Datum und zur gewählten Uhrzeit, in der Zeitzone der Community, und die Karte zeigt bis dahin Endet am …. Ohne Frist bleibt sie offen, bis jemand aus dem Team auf Umfrage beenden klickt.
Beendet, bekommt sie das Label Beendet und die Zeile Beendet am …: Niemand kann mehr abstimmen, die Stimme ändern oder zurückziehen, und alle sehen das Endergebnis. Die Stimmen bleiben erhalten. Eine beendete Umfrage lässt sich nicht wieder öffnen.
Anonyme Stimmen für Mitglieder
Mitglieder sehen nur die Zahlen. Wer wofür gestimmt hat, sieht nur das Team, unter Sehen, wer abgestimmt hat.
Benachrichtigung
Die Umfrage nimmt den Weg eines neuen Beitrags im Bereich: dieselben Benachrichtigungen und E-Mails wie ein Status im Feed oder ein Beitrag in Inhalte, je nach den Einstellungen jeder Person. Abstimmen benachrichtigt niemanden.
Schritt für Schritt
Eine Umfrage anlegen
Rolle: Eigentümer, Administrator oder Moderator.
- Öffne den Feed- oder Inhalte-Bereich.
- Klicke im Kopf auf den Pfeil neben Neuer Status (in Inhalte Neuer Inhalt) und wähle Neue Umfrage. Im selben Menü steht Inhalte importieren, das nur Eigentümer und Administrator sehen.
- Fülle aus:
- Frage: im Feed der Text des Status (bis 500 Zeichen); in Inhalte der Titel des Beitrags (bis 255).
- Optionen: 2 bis 10, je bis 100 Zeichen, ohne Wiederholung. Option hinzufügen fügt eine hinzu; das × entfernt sie.
- Mehrfachauswahl erlauben: Jede Person kann mehr als eine Option markieren.
- Wer sie sieht, nur im Feed: Öffentlich (Standard), Mitglieder oder Abonnenten, wie bei Neuer Status. In Inhalte gibt es keine Wahl: Die Umfrage ist öffentlich, wie bei Neuer Inhalt.
- Frist (optional): Datum und Uhrzeit in der Zeitzone der Community, die der Bildschirm zeigt. Ohne Frist entfernt sie.
- Klicke auf Umfrage veröffentlichen.
In Inhalte entsteht der Beitrag nur mit der Frage als Titel. Um einen Text darunter zu setzen, bearbeite den Beitrag danach.
Abstimmen
- Klicke in der Karte der Umfrage auf die Option (bei Einfachauswahl ist das schon die Stimme).
- Bei Mehrfachauswahl markiere die Optionen und klicke auf Abstimmen.
- Zum Ändern Stimme ändern; zum Verzichten Stimme zurückziehen.
Eine Umfrage bearbeiten
Rolle: Eigentümer, Administrator oder Moderator.
Im Menü ⋮ der Karte Umfrage bearbeiten.
- Vor der ersten Stimme lässt sich alles ändern: die Optionen (Text, Reihenfolge, hinzufügen und entfernen), Mehrfachauswahl erlauben und die Frist.
- Nach der ersten Stimme ändern sich die Optionen nicht mehr, weder Text noch Reihenfolge: Die Felder erscheinen deaktiviert („Es gibt bereits Stimmen: Die Optionen ändern sich nicht mehr, damit die Auswahl der Leute gleich bleibt."), und Mehrfachauswahl erlauben ist gesperrt. Die Frage bleibt über den Beitrag bearbeitbar, und die Frist lässt sich weiterhin setzen, verschieben oder entfernen.
- Beendet ohne Stimmen nur noch der Text der Optionen.
Die Frage ist der Text (oder Titel) des Beitrags: Um sie zu ändern, bearbeite den Beitrag.
Sehen, wer abgestimmt hat
Rolle: Eigentümer, Administrator oder Moderator.
Im Menü ⋮ der Karte Sehen, wer abgestimmt hat. Der Dialog Wer abgestimmt hat listet die Personen, die neueste Stimme zuerst, mit den Optionen jeder Person. Nach Option filtern zeigt nur, wer eine davon gewählt hat.
Beenden
Rolle: Eigentümer, Administrator oder Moderator.
- Im Menü ⋮ der Karte Umfrage beenden.
- Bestätige mit Beenden. Es gibt keinen Weg zurück: Die Umfrage lässt sich nicht wieder öffnen.
Beispiele
Termin des Events. Im Feed der Home: „Welcher Monat passt am besten für die APICON Rio?", mit März, April und Mai, Einfachauswahl und Frist zum Monatsende. Hefte sie oben an, damit alle sie sehen.
Thema der nächsten Stunde. In einem Inhalte-Bereich der Klasse: „Welches Thema möchtest du in der nächsten Live-Stunde?", mit fünf Themen und Mehrfachauswahl erlauben. Das Team verfolgt das Ergebnis ab der ersten Stimme und beendet die Umfrage, wenn es entschieden hat.
Häufige Fehler und ihre Lösung
| Situation | Was tun |
|---|---|
| Neue Umfrage erscheint nicht im Menü | Nur Eigentümer, Administrator und Moderator legen Umfragen an |
| Die Umfrage braucht mindestens 2 Optionen. oder Die Umfrage kann bis zu 10 Optionen haben. | Passe die Anzahl der Optionen an |
| Einige Optionen sind doppelt. | Zwei Optionen haben denselben Text (Groß- und Kleinschreibung zählt nicht): Ändere eine |
| Wähle eine Frist in der Zukunft. | Die Frist ist schon vorbei; wähle ein anderes Datum oder lass sie ohne Frist |
| Die Optionen lassen sich nicht bearbeiten | Die Umfrage hat schon Stimmen: Die Optionen bleiben, wie über sie abgestimmt wurde. Für eine andere Frage lege eine neue Umfrage an |
| Das Mitglied sieht das Ergebnis nicht | Es hat noch nicht abgestimmt, und die Umfrage ist offen |
| Abstimmen geht nicht | Die Umfrage ist beendet |
Häufige Fragen
Lässt sich eine beendete Umfrage wieder öffnen? Nein. Um erneut zu fragen, lege eine neue an.
Lässt sich ein bestehender Beitrag in eine Umfrage umwandeln? Nein. Die Umfrage entsteht mit dem Beitrag, über Neue Umfrage.
Löscht das Löschen des Beitrags die Umfrage? Ja, die Umfrage geht mit dem Beitrag.
Wissen die Mitglieder, wofür ich gestimmt habe? Nein. Nur das Team sieht, wer wofür gestimmt hat.
Über den Assistenten
Der Assistent legt Umfragen an, stimmt ab und verfolgt sie, mit denselben Regeln:
create_poll: legt sie im Feed (die Frage ist der Text) oder in Inhalte (die Frage ist der Titel) an. Eigentümer, Administrator und Moderator, ohne Bestätigung.get_poll: das Ergebnis. Jede Rolle; für Personen, die nicht abgestimmt haben, bleiben die Zahlen bis zum Ende der Umfrage verborgen.vote_poll(nach Option oder ihrem Text) undretract_poll_vote: im Namen der Person, die verbunden hat, ohne Bestätigung.update_poll: bearbeitet und fragt nach Bestätigung, wenn sich die Optionen ändern.close_poll: beendet, immer mit Bestätigung.list_poll_votes: wer abgestimmt hat. Diese drei sind fürs Team.
Frag so: „Lege im Feed eine Umfrage an, welcher Monat am besten für die APICON Rio passt, mit März, April und Mai." In Claude baut das Rezept Die Community fragen (Umfrage) die Anfrage. Siehe Tools · Inhalte.
In der API
Die Umfrage steht im Feld poll von POST /api/status (Feed) und POST /api/content (Inhalte): options (2 bis 10 Texte), allowMultiple und closesAt (optional, in der Zukunft). Nur Eigentümer, Administrator und Moderator; eine andere Rolle bekommt 403 mit param: "poll", und nichts wird gespeichert. poll kommt in den Einträgen von GET /api/feed, in Status, in Inhalten und in den Empfehlungen.
| Route | Was sie tut | Wer |
|---|---|---|
GET /api/polls/{id} | Das Ergebnis, so wie die Person es sehen darf | Wer den Beitrag sieht |
POST /api/polls/{id}/vote | Stimmt ab (optionIds); erneutes Abstimmen ersetzt die Stimme | Mitglied, das den Beitrag sieht |
DELETE /api/polls/{id}/vote | Zieht die Stimme zurück | Mitglied, das den Beitrag sieht |
PUT /api/polls/{id} | Bearbeitet Optionen, allowMultiple und closesAt | Eigentümer, Administrator und Moderator |
POST /api/polls/{id}/close | Beendet, ohne Weg zurück | Eigentümer, Administrator und Moderator |
GET /api/polls/{id}/votes | Wer abgestimmt hat, mit Filter optionId | Eigentümer, Administrator und Moderator |
Für Personen, die das Ergebnis nicht sehen dürfen, ist resultsVisible false, und votes, percentage und totalVoters sind null (verborgen, nicht null Stimmen).
| Fehler | Wann |
|---|---|
400 | Bereich, der weder Feed noch Inhalte ist, weniger als 2 oder mehr als 10 Optionen, leere Option oder über 100 Zeichen, doppelte Option, Frist in der Vergangenheit oder ungültig, mehr als eine Option bei Einfachauswahl |
403 | Die Rolle legt keine Umfragen an oder verwaltet sie nicht, oder die Person ist kein Mitglied der Community |
404 | Die Umfrage existiert nicht oder gehört zu einer anderen Community |
409 | closed (die Umfrage ist beendet) oder optionsLocked (Optionen nach der ersten Stimme ändern, auch Text oder Reihenfolge); auch beim Versuch, allowMultiple mit Stimmen zu ändern |
Siehe Polls.