Zum Inhalt springen

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

CommunityUmfrage
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
VereinEine schnelle Abfrage vor der Versammlung, mit dem Ergebnis zum Fristende

So funktioniert es

Wer was darf

AktionWer
Eine Umfrage anlegenEigentümer, Administrator und Moderator
Abstimmen, Stimme ändern und zurückziehenJedes Mitglied, das den Beitrag sieht
Das Ergebnis sehenDas Team immer; andere Mitglieder nach der Abstimmung oder sobald die Umfrage beendet ist
Bearbeiten, sehen, wer abgestimmt hat, und beendenEigentü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.

  1. Öffne den Feed- oder Inhalte-Bereich.
  2. 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.
  3. 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.
  4. 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

  1. Klicke in der Karte der Umfrage auf die Option (bei Einfachauswahl ist das schon die Stimme).
  2. Bei Mehrfachauswahl markiere die Optionen und klicke auf Abstimmen.
  3. 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.

  1. Im Menü ⋮ der Karte Umfrage beenden.
  2. 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

SituationWas 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 bearbeitenDie 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 nichtEs hat noch nicht abgestimmt, und die Umfrage ist offen
Abstimmen geht nichtDie 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) und retract_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.

RouteWas sie tutWer
GET /api/polls/{id}Das Ergebnis, so wie die Person es sehen darfWer den Beitrag sieht
POST /api/polls/{id}/voteStimmt ab (optionIds); erneutes Abstimmen ersetzt die StimmeMitglied, das den Beitrag sieht
DELETE /api/polls/{id}/voteZieht die Stimme zurückMitglied, das den Beitrag sieht
PUT /api/polls/{id}Bearbeitet Optionen, allowMultiple und closesAtEigentümer, Administrator und Moderator
POST /api/polls/{id}/closeBeendet, ohne Weg zurückEigentümer, Administrator und Moderator
GET /api/polls/{id}/votesWer abgestimmt hat, mit Filter optionIdEigentü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).

FehlerWann
400Bereich, 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
403Die Rolle legt keine Umfragen an oder verwaltet sie nicht, oder die Person ist kein Mitglied der Community
404Die Umfrage existiert nicht oder gehört zu einer anderen Community
409closed (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.

Verwandte Artikel