MyCap - idea-labs/documentation GitHub Wiki

Das ist noch keine vollständige Anleitung, sondern es sind nur erste Hinweise zur Nutzung von MyCap.

Allgemeines

  • Die App funktioniert unterschiedlich auf iOS und Android, man sollte es also immer auf beiden Geräten testen.
  • Es darf kein Längsschnitt in RC aktiviert werden (dazu unten mehr). Durch die Verwendung von Repeating Instruments kann man aber dennoch mit einem Längsschnitt-Design arbeiten.
  • Was bisher nicht funktioniert (kann sich aber mit Updates ändern): Calculated Fields, Piping, Smart Variables, Descriptive Fields, Matrix.
  • Innerhalb einer Umfrage ist es nicht möglich, Links einzufügen, man kann es also auch nicht zur Weiterleitung nutzen.
  • Unter Help findet man eine Übersicht über alle möglichen Variablenformen und welche Weiterentwicklungen geplant sind.
  • Zwischen verschiedenen Gestaltungsformen von Fragen (Drop Down, Buttons, Forms oder Questionnaire) sieht man in der App keinen Unterschied.
  • Langfristig soll MyCap in RC integriert werden (ev. noch 2021).
  • Alle Survey-Einstellungen, die man in REDCap einstellt, erscheinen nicht in der App, stören aber auch nicht.
  • Das erste Instrument (Template: MyCap Daten) darf nicht gelöscht werden und muss an erster Stelle sein, der Name des Instruments und die Feldnamen können aber geändert werden (z.B. anonym).

Neues MyCap-Projekt 

Zum Erstellen eines Projekts, das MyCap verwenden soll, bitte an einen Admin wenden. Wir erstellen das Projekt für Euch. In das Projekt können dann bereits vorhandene Instrumente, Versuchspersonen sowie User aus anderen Projekten importiert werden. Solltet Ihr aus irgendeinem Grund doch ein bereits vorhandenes Projekt verwenden, ist es wichtig, dass dort zu keiner Zeit Längsschnitt aktiviert wurde oder gar aktiviert ist. Im IDeA-Template ist z.B. Längsschnitt voreingestellt, die meisten Projekte wurden mit dem IDeA-Template erstellt. Deshalb besser für MyCap immer ein neues Projekt starten, für das wir das MyCap-Template verwenden.

Instrumente erstellen

  • Instrumente aus anderen Projekten können ganz einfach als ZIP-Datei importiert werden.
  • Ihr solltet darauf achten, dass nur Variablentypen verwendet werden, die auch von MyCap unterstützt werden (mit Updates können neue Variablen hinzukommen).
  • Unter Help in MyCap findet man eine Übersicht aller möglichen Variablentypen und was zu beachten ist.
  • Hinweise für spezielle Variablen (erst mit den jeweiligen Annotations funktionieren sie richtig):
    • Foto hochladen: Annotation @MC-FIELD-FILE-IMAGECAPTURE
    • Slider: mit den Annotations @MC-FIELD-SLIDER-BASIC=0:10:1 und @MC-FIELD-SLIDER-CONTINUOUS=0:100:0 kann man die Endpunkte einer Sliderskala festlegen (default: 0 bis 100) und ob die Abstufung in Schritten (1) oder kontinuierlich (0) erfolgen soll.

Mit MyCap arbeiten

  • About: Startbildschirm für Teilnehmer
  • Ein Instrument heißt in MyCap „Task“
  • Alle Fragebogen müssen in Tasks aktiviert werden, damit sie in der App sichtbar sind.
  • Auf Fix klicken: Annotations, die für MyCap notwendig sind, werden hinzugefügt, wenn man die Tasks freischaltet,
  • Hinweis zu den Annotations:
    • @MC-PARTICIPANT-* Annotations: dürfen nur im ersten Instrument vorkommen.
    • @MC-TASK-* Annotations: dürfen nicht im ersten Instrument vorkommen sondern nur in den nachfolgenden.
  • Im weiteren Dialog: Titel der Umfrage muss ausgefüllt werden, alles andere kann man bei den Voreinstellungen belassen.
  • Options: Muss man ausprobieren, durch "Instruction" und "Completion step" kann man zusätzlichen Text hinzufügen.
  • Schedule: Muss man planen und ausprobieren, zum Testen der Instrumente ist "Infinite" und "ends Never" sinnvoll (voreingestellt), dann kann man es immer wieder ausprobieren.
  • Wichtig: Immer wenn man Veränderungen vorgenommen hat, auf Publish gehen, sonst erscheinen sie nicht in der App.
  • Da bei Publish die Versionen durchnummeriert werden, wird es sehr schnell unübersichtlich. Eventuell ist es hilfreich, ein eigenes Veränderungslog zu führen.
  • Zudem gibt es auch keine Hinweis darauf, warum Veränderungen nicht übernommen werden (weil es grundsätzlich nicht geht, oder weil man etwas falsch gemacht hat).

Daten erheben

  • Ablauf für Versuchspersonen: MyCap herunterladen, QR-Code scannen und Projekt starten.
  • Für jede Versuchsperson wird ein Record angelegt (sowohl in MyCap als auch in RC möglich) und der Person der individuelle QR-Code zugeschickt.
  • Die Felder "Lastname" und "Firstname" müssen ausgefüllt werden (können natürlich auch Codes sein).
  • Pro Projekt und Handy kann nur ein Record angelegt werden.

Probleme / Schwierigkeiten

  • Das Feld für die Datumseingabe ist weiß auf hellgrau, sodass man denkt, man könnte es nicht antippen (anderes Farbschema auswählen).
  • Die Sprache der App ist Englisch, momentan gibt es keine Möglichkeit, das zu ändern. Einige andere Sprachen sind schon möglich: Französisch, Brasilianisch, Portugiesisch, Spanisch.
  • An manchen Rechnern lässt sich das Symbolbild des Projekts nicht ändern.
  • Darauf achten, dass im Laufe des Projekts NIE die Längsschnittfunktion aktiviert ist, am besten das MyCap-Template verwenden und schon fertige Instrumente hinein kopieren. Ansonsten gibt es Probleme, z.B. lassen sich keine Records über REDCap hinzufügen.
  • Wenn etwas nicht funktioniert, gibt es keine Fehlermeldung, sodass man nicht weiß, wo das Problem liegt.
  • Es gibt keine Vorschau, Veränderungen lassen sich nur in der App überprüfen.
  • Antworten auf Messages sieht man nur wenn man auf Participant klickt.
  • Versuchspersonen müssen nach dem ausfüllen des Fragebogens auf "Next" klicken, erst dann wird der Fragebogen abgeschickt.
⚠️ **GitHub.com Fallback** ⚠️