Shopify Flowలో ఉపయోగించే API డేటాను ప్రివ్యూ చేయండి

చాలా వర్క్‌ఫ్లోలు మీ స్టోర్ నుండి డేటాను యాక్సెస్ చేస్తాయి, తద్వారా మీరు దాన్ని కండిషన్‌లు మరియు చర్యలలో ఉపయోగించవచ్చు. Shopify Flow అనేది GraphQL Admin APIని కాల్ చేయడం ద్వారా స్టోర్ డేటాను యాక్సెస్ చేస్తుంది, ఇది APIలోని దాదాపు అన్ని ఫీల్డ్‌లకు మీకు యాక్సెస్‌ను అందిస్తుంది.

మీరు ఒక వర్క్‌ఫ్లోను నిర్మించేటప్పుడు, API ఆధారంగా మీరు తరచుగా ఫీల్డ్ పేర్లను మరియు వివరణలను చూస్తారు, కానీ ఆ డేటాకు సంబంధించిన విలువలను మీరు తెలుసుకోవాల్సి రావచ్చు. ఉదాహరణకు, ఒక డ్రాఫ్ట్ ఆర్డర్ నుండి సృష్టించబడిన ఒక ఆర్డర్‌కు సంబంధించిన యాప్ పేరు గురించి మీరు తెలుసుకోవాలనుకోవచ్చు. అదనంగా, మీ వర్క్‌ఫ్లో మీరు ఆశించిన డేటాను లేదా మీరు ఆశించిన ఫార్మాట్‌లో అవుట్‌పుట్‌గా అందిస్తుందో లేదో మీరు నిర్ధారించుకోవాలనుకోవచ్చు.

ఆ డేటాకు సంబంధించిన విలువలను రివ్యూ చేయడానికి, Shopify Flow‌లో మీకు పలు ఆప్షన్‌లు ఉన్నాయి.

Shopify అడ్మిన్‌లో ఫీల్డ్‌ను కనుగొనండి

చాలా సందర్భాలలో, మీరు Shopify అడ్మిన్‌లో చూడటం ద్వారా డేటాను కనుగొనవచ్చు. ఉదాహరణకు, product.title అనేది ఉత్పత్తి పేజీలో లిస్ట్ చేయబడింది.

నమూనా డేటాను పొందండి

మీరు వర్క్‌ఫ్లోను నిర్మించేటప్పుడు, మీరు Flow ఎడిటర్‌లో నేరుగా నమూనా డేటాను పొందవచ్చు. Flow డేటా ఈవెంట్‌ల ద్వారా అందించబడుతుంది కాబట్టి, కచ్చితమైన నమూనా డేటాను పొందడానికి, మీరు సంబంధిత ఈవెంట్‌ను ఎంచుకోవడం ద్వారా ప్రారంభించాలి:

  1. Flow ఎడిటర్‌లో, మీరు డేటాను ఎక్కడైతే ఉపయోగించాలనుకుంటున్నారో అక్కడ ఒక చర్యను తెరిచి, వేరియబుల్‌ను జోడించండి మీద క్లిక్ చేయండి. ప్రత్యామ్నాయంగా, ఒక షరతులో, క్రైటీరియాను జోడించండి మీద క్లిక్ చేయండి.
  2. నమూనా డేటాను కాన్ఫిగర్ చేయండి మీద క్లిక్ చేయండి.
  3. వర్క్‌ఫ్లో యొక్క ట్రిగ్గర్ ఆధారంగా మునుపటి ఈవెంట్‌లను Flow ప్రదర్శిస్తుంది. ఇటీవలి రన్‌ల నుండి ఈవెంట్‌లను పొందడానికి ఈవెంట్‌లను రిఫ్రెష్ చేయండి మీద క్లిక్ చేయండి లేదా లైవ్ ఈవెంట్‌ల కోసం వినడం ప్రారంభించండి మీద క్లిక్ చేసి, ఆపై అడ్మిన్ లేదా సంబంధిత యాప్‌లో (యాప్ ఆధారిత ట్రిగ్గర్‌ల కోసం) ఈవెంట్‌ను మాన్యువల్‌గా ట్రిగ్గర్ చేయండి.
  4. ఈవెంట్ జరిగిన తర్వాత, ఆ ఈవెంట్ గురించిన వివరాలను Flow ప్రదర్శిస్తుంది. నమూనా డేటాను పొందడం కోసం మీరు ఉపయోగించాలనుకునే ఈవెంట్‌ను ఎంచుకోండి. ఈ ట్రిగ్గర్ ఈవెంట్‌ను ఉపయోగించండి మీద క్లిక్ చేయండి.
  5. ఇప్పుడు, మీరు ఈవెంట్‌లను బ్రౌజ్ చేస్తుండగా, ప్రతి వేరియబుల్ కోసం నమూనా డేటా ప్రదర్శించబడుతుంది.

పరిమితులు:

  • స్థల పరిమితుల కారణంగా, లిస్ట్‌లో ఉండే డేటా కోసం, లిస్ట్‌లోని మొదటి ఐటెమ్ నుండి మాత్రమే Flow డేటాను ప్రదర్శిస్తుంది.
  • Flow వర్క్‌ఫ్లోకి గరిష్ఠంగా ఒకేసారి 5 ఈవెంట్‌లను స్టోర్ చేస్తుంది.
  • షెడ్యూల్ చేసిన సమయం, సృష్టించిన మెటాఆబ్జెక్ట్ ఎంట్రీ, కస్టమర్ సెగ్మెంట్‌లో చేరారు లేదా కస్టమర్ సెగ్మెంట్ నుండి నిష్క్రమించారు వంటి కొన్ని ట్రిగ్గర్‌లకు సంబంధించిన ఇటీవలి రన్‌ల నుండి Flow ఈవెంట్‌లను పొందలేదు.

లైవ్ వర్క్‌ఫ్లోలో ఫీల్డ్‌ను ఉపయోగించండి

మీరు లాగ్ అవుట్‌పుట్ చర్యను ఉపయోగించడం ద్వారా వర్క్‌ఫ్లోలోని ఫీల్డ్‌లను సురక్షితంగా ఉపయోగించవచ్చు. మీరు వర్క్‌ఫ్లోను రన్ చేసినప్పుడు, లాగ్ అవుట్‌పుట్ చర్య అనేది ఏవైనా వేరియబుల్స్, టెక్స్ట్ యొక్క అవుట్‌పుట్‌ను రన్ చరిత్ర పేజీకి ప్రింట్ చేస్తుంది. మీరు అంతర్గత ఇమెయిల్‌ను పంపండి వంటి నోటిఫికేషన్ చర్యలను కూడా ఉపయోగించవచ్చు.

లాగ్ అవుట్‌పుట్‌ను ఉపయోగించడానికి దశలు:

  1. మాన్యువల్‌గా ట్రిగ్గర్ చేయగల ఒక ట్రిగ్గర్‌ను ఎంచుకోండి.
  2. వర్క్‌ఫ్లోకి లాగ్ అవుట్‌పుట్ చర్యను జోడించి, దాన్ని ట్రిగ్గర్‌కు కనెక్ట్ చేయండి.
  3. లాగ్ అవుట్‌పుట్ కాన్ఫిగరేషన్‌లో, అవుట్‌పుట్ విభాగానికి మీరు తనిఖీ చేయాలనుకునే వేరియబుల్‌లను జోడించడానికి వేరియబుల్‌ను జోడించండి మీద క్లిక్ చేయండి.
  4. పూర్తయిన తర్వాత, వర్క్‌ఫ్లో ఆన్ చేయండి మీద క్లిక్ చేయండి.
  5. మాన్యువల్‌గా రన్ చేయడం ద్వారా లేదా ట్రిగ్గర్ ఫైర్ అయ్యేలా చేయడం ద్వారా, వర్క్‌ఫ్లోను ట్రిగ్గర్ చేయండి. ఉదాహరణకు, మీరు ఆర్డర్ సృష్టించబడింది ట్రిగ్గర్‌ను ఉపయోగిస్తుంటే, అప్పుడు ఒక పరీక్ష ఆర్డర్‌ను సృష్టించండి.
  6. వర్క్‌ఫ్లో రన్ అయిన తర్వాత, వేరియబుల్స్ కోసం యాక్టివిటీ లాగ్‌ని తనిఖీ చేయండి.

రీసోర్స్ JSON పేజీని రిఫర్ చేయండి

Shopify అడ్మిన్‌లోని ఆర్డర్, ఉత్పత్తి లేదా కస్టమర్ పేజీలు వంటి చాలా రీసోర్స్ పేజీలు ఆ పేజీకి అందించబడే డేటాను వీక్షించడానికి మిమ్మల్ని అనుమతిస్తాయి. ఈ డేటా కచ్చితంగా Shopify Flow ఉపయోగించే అదే నామకరణం, ఫార్మాట్‌ని కలిగి ఉండదు, కానీ వాటి విలువలు GraphQL Admin API‌లోని వాటికి సరిపోలుతాయి. డేటాను రివ్యూ చేయడానికి, URLకి .jsonను జోడించండి.

ఉదాహరణకు, Shopify అడ్మిన్‌లోని ఆర్డర్‌లు పేజీకి వెళ్లి, ఒక ఆర్డర్ మీద క్లిక్ చేయడం ద్వారా ఆర్డర్‌కి నావిగేట్ చేయండి. మీ బ్రౌజర్‌లోని అడ్రస్ బార్‌లోని ఆ పేజీ అడ్రస్‌ను దీని నుండి మార్చండి:

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234

కింది దానికి:

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234.json

GraphiQL లేదా ఒక థర్డ్-పార్టీ API టూల్‌ను ఉపయోగించండి

Postman లేదా Shopify ద్వారా అందించబడే ఉచిత టూల్ అయిన GraphiQL వంటి ఒక థర్డ్-పార్టీ API టూల్‌ను ఉపయోగించడం ద్వారా మీరు APIని నేరుగా క్వెరీ చేయవచ్చు. ఈ ఆప్షన్ అత్యంత కచ్చితమైన ఫలితాలను అందిస్తుంది, అయితే దీని కోసం GraphQL క్వెరీలను సృష్టించడం పట్ల మీకు కొంత అవగాహన ఉండాలి.

GraphiQL కోసం, Shopify సాధారణ డేటాతో వెబ్-ఆధారిత GraphiQL ఎక్స్‌ప్లోరర్ మరియు GraphiQL యాప్ రెండింటినీ అందిస్తుంది. GraphiQLతో, మీరు Shopify Flowలోని ఫీల్డ్ పేర్లకు కచ్చితంగా సరిపోలే GraphQL క్వెరీని నిర్మించవచ్చు. మీరు యాప్‌ను ఉపయోగిస్తే, ఆ విలువలు మీ స్టోర్‌కు కచ్చితంగా సరిపోలుతాయి.

ఈ టూల్‌ను ఉపయోగించడం ద్వారా, మీ వాస్తవ షాప్ డేటాతో Shopify Flow కచ్చితంగా ఏ డేటాను ఉపయోగిస్తుందో మీరు కనుగొనవచ్చు. ఉదాహరణకు, మీరు కింది క్వెరీని సృష్టించవచ్చు:

{
  orders(first:5, reverse:true) {
    nodes {
      createdAt
      app {
        name
      }
      channelInformation {
        app {
          title
        }
      }
    }
  }
}

కింది ఫలితాలలో, order / app / name వేరియబుల్ అనేది ఆర్డర్ కోసం యాప్ పేరును ప్రదర్శిస్తుంది. ఈ సందర్భంలో, డ్రాఫ్ట్ ఆర్డర్‌ల యాప్ నుండి ఆర్డర్ సృష్టించబడింది, కాబట్టి దాని విలువ Draft Ordersగా ఉంటుంది. కేవలం Point of Sale యాప్ కోసం మాత్రమే ఛానెల్ సమాచారం అందుబాటులో ఉంటుంది.

{
  "data": {
    "orders": {
      "nodes": [
        {
          "createdAt": "2023-04-10T12:32:41Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-04-10T12:29:12Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:23:10Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:20:53Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T15:45:15Z",
          "app": {
            "name": "Point of Sale"
          },
          "channelInformation": {
            "app": {
              "title": "Point of Sale"
            }
          }
        }
      ]
    }
  }