microsoftgraph / microsoftgraph/msgraph-sdk-php

V2 pagination with getValue unclear

Ouverte
#1,491 3 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Needs: Attention :wave: question
Langage dominant
PHP
Étoiles
669
Forks
150
Merge moyen
15 h 21 min
PR mergées (30 j)
3

Description

The documentation Get a collection of items mentions paging, but the example and code are not entirely clear here.

The call $messages->getValue() from the example would return a native php array type.

Is that array already filled with all items from all pages? Is that guaranteed? Or do I only get a single page here?


On a side note, it might have been better to return a \Generator that can be iterated over, independent on the page size, that will simply call the next page when it's its turn.

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Commencez par la section sur la pagination dans docs/Examples.md, en particulier l’exemple « Get a collection of items » et son appel à $messages->getValue(). Suivez le comportement de pagination concerné dans le SDK, puis documentez si getValue() contient une page ou toutes les pages et clarifiez l’exemple ; l’idée demandée concernant Generator est une considération distincte.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
php
Domaine
documentation
Type d'issue
Documentation
Difficulté
2/5
Temps estimé
1-3 heures
Activité
À l'abandon
Clarté
À clarifier
Accessibilité débutants
30/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.