Shopify Flow இல் பயன்படுத்தப்படும் API தரவின் முன்னோட்டம்

பணிப்பாய்வுகள் பெரும்பாலும் உங்கள் ஸ்டோரிலிருந்து தரவை அணுகும், எனவே நீங்கள் அவற்றை நிபந்தனைகள் மற்றும் செயல்களில் பயன்படுத்தலாம். GraphQL Admin API ஐ அழைப்பதன் மூலம் Shopify Flow ஸ்டோர் தரவை அணுகுகிறது, இதன் மூலம் API இல் உள்ள கிட்டத்தட்ட அனைத்து புலங்களுக்கும் உங்களுக்கு அணுகல் கிடைக்கும்.

ஒரு பணிப்பாய்வை உருவாக்கும்போது, API அடிப்படையிலான புலம் பெயர்கள் மற்றும் விளக்கங்களை நீங்கள் அடிக்கடி சந்திப்பீர்கள், ஆனால் அந்தத் தரவின் மதிப்புகளை நீங்கள் அறிய வேண்டியிருக்கலாம். எடுத்துக்காட்டாக, வரைவு ஆர்டரில் இருந்து உருவாக்கப்பட்ட ஆர்டருக்கான செயலியின் பெயரை நீங்கள் அறிய விரும்பலாம். கூடுதலாக, உங்கள் பணிப்பாய்வு நீங்கள் எதிர்பார்க்கும் தரவை, அல்லது நீங்கள் எதிர்பார்க்கும் வடிவத்தில் வெளியிடுகிறதா என்பதை உறுதிசெய்ய விரும்பலாம்.

தரவின் மதிப்புகளைச் சரிபார்க்க, Shopify Flow இல் உங்களுக்குப் பல விருப்பங்கள் உள்ளன.

இந்தப் பக்கத்தில்

Shopify நிர்வாகியில் ஒரு புலத்தைக் கண்டறிதல்

பெரும்பாலான சந்தர்ப்பங்களில், நீங்கள் Shopify நிர்வாகியைப் பார்ப்பதன் மூலம் தரவைக் கண்டறியலாம். எடுத்துக்காட்டாக, product.title என்பது தயாரிப்பு பக்கத்தில் பட்டியலிடப்பட்டுள்ளது.

மாதிரித் தரவைப் பெறுதல்

நீங்கள் ஒரு பணிப்பாய்வை உருவாக்கும்போது, Flow எடிட்டரில் நேரடியாக மாதிரித் தரவைப் பெறலாம். Flow-இன் தரவு நிகழ்வுகளில் இருந்து வருவதால், துல்லியமான மாதிரித் தரவைப் பெற, தொடர்புடைய நிகழ்வைத் தேர்ந்தெடுப்பதன் மூலம் தொடங்க வேண்டும்:

Flow-இன் எடிட்டரில், நீங்கள் தரவைப் பயன்படுத்த விரும்பும் செயலைத் திறந்து மாறியைச் சேர் என்பதைக் கிளிக் செய்யவும். மாற்றாக, ஒரு நிபந்தனையில், அளவுகோலைச் சேர் என்பதைக் கிளிக் செய்யவும்.
மாதிரித் தரவை உள்ளமை என்பதைக் கிளிக் செய்யவும்.
பணிப்பாய்வின் தூண்டுதலின் அடிப்படையில் முந்தைய நிகழ்வுகளை Flow காண்பிக்கும். சமீபத்திய ரன்களிலிருந்து நிகழ்வுகளைப் பெற நிகழ்வுகளைப் புதுப்பி என்பதைக் கிளிக் செய்யவும், அல்லது நேரலை நிகழ்வுகளைக் கேட்கத் தொடங்கு என்பதைக் கிளிக் செய்து, நிர்வாகி அல்லது தொடர்புடைய செயலியில் (செயலி அடிப்படையிலான தூண்டுதல்களுக்கு) நிகழ்வை மேனுவலாகத் தூண்டவும்.
நிகழ்வு ஏற்பட்ட பிறகு, நிகழ்வைப் பற்றிய விவரங்களை Flow காண்பிக்கும். மாதிரித் தரவைப் பெற, நீங்கள் பயன்படுத்த விரும்பும் நிகழ்வைத் தேர்ந்தெடுக்கவும். இந்தத் தூண்டுதல் நிகழ்வைப் பயன்படுத்து என்பதைக் கிளிக் செய்யவும்.
இப்போது, நீங்கள் நிகழ்வுகளை உலாவும்போது, ஒவ்வொரு மாறிக்கும் மாதிரித் தரவு காண்பிக்கப்படும்.

வரம்புகள்:

இடக் கட்டுப்பாடுகள் காரணமாக, ஒரு பட்டியலில் உள்ள தரவுக்கு, பட்டியலில் உள்ள முதல் உருப்படியின் தரவை மட்டுமே Flow காண்பிக்கும்.
ஒரு பணிப்பாய்வுக்கு, ஒரே நேரத்தில் 5 நிகழ்வுகள் வரை Flow சேமிக்கும்.
திட்டமிடப்பட்ட நேரம், மெட்டாஆப்ஜெக்ட் உள்ளீடு உருவாக்கப்பட்டது, வாடிக்கையாளர் பிரிவில் சேர்ந்தார் அல்லது வாடிக்கையாளர் பிரிவிலிருந்து வெளியேறினார் போன்ற சில தூண்டுதல்களுக்கான சமீபத்திய ரன்களில் இருந்து நிகழ்வுகளை Flow-ஆல் பெற முடியாது.

நேரலைப் பணிப்பாய்வில் புலத்தைப் பயன்படுத்துதல்

பதிவு வெளியீடு (Log output) செயலைப் பயன்படுத்தி, பணிப்பாய்வில் உள்ள புலங்களை நீங்கள் பாதுகாப்பாகப் பயன்படுத்தலாம். ஒரு பணிப்பாய்வை நீங்கள் ரன் செய்யும்போது, எந்தவொரு மாறிகள் மற்றும் உரைக்கான வெளியீட்டையும் ரன் வரலாறு (Run history) பக்கத்தில் பதிவு வெளியீடு செயல் அச்சிடும். உள் மின்னஞ்சலை அனுப்பு (Send internal email) போன்ற அறிவிப்புச் செயல்களையும் நீங்கள் பயன்படுத்தலாம்.

பதிவு வெளியீட்டைப் பயன்படுத்துவதற்கான படிகள்:

மேனுவலாகத் தூண்டக்கூடிய ஒரு தூண்டுதலைத் தேர்ந்தெடுக்கவும்.
பணிப்பாய்வில் பதிவு வெளியீடு (Log output) செயலைச் சேர்த்து, அதைத் தூண்டுதலுடன் இணைக்கவும்.
பதிவு வெளியீடு (Log output) உள்ளமைவில், நீங்கள் ஆய்வு செய்ய விரும்பும் மாறிகளை வெளியீடு (Output) பிரிவில் சேர்க்க, மாறியைச் சேர் என்பதைக் கிளிக் செய்யவும்.
முடித்ததும், பணிப்பாய்வை ஆன் செய் என்பதைக் கிளிக் செய்யவும்.
மேனுவலாக ரன் செய்வதன் மூலமாகவோ தூண்டுதலைச் செயல்படுத்துவதன் மூலமாகவோ பணிப்பாய்வைத் தூண்டவும். எடுத்துக்காட்டாக, ஆர்டர் உருவாக்கப்பட்டது என்ற தூண்டுதலைப் பயன்படுத்தினால், ஒரு சோதனை ஆர்டரை உருவாக்கவும்.
பணிப்பாய்வு ரன் ஆன பிறகு, மாறிகளுக்கான செயல்பாட்டுப் பதிவைச் சரிபார்க்கவும்.

ஆதார 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

குறிப்பு

.json வடிவமைப்பு REST API-ஐப் பின்பற்றுகிறது. REST API-இல் உள்ள மாறிப் பெயர்களின் எழுத்து வடிவம் line_items போன்ற அடிக்கோடுகளைப் (underscores) பயன்படுத்துகிறது. GraphQL மற்றும் Shopify Flow ஆகியவை lineItems போன்ற கேமல்கேஸிங்கைப் (camelCasing) பயன்படுத்துகின்றன. கூடுதலாக, சில சமயங்களில் customAttributes-க்கு பதிலாக properties எனப் புலம் பெயர்கள் மாறுபடும். இந்த முறையைப் பயன்படுத்தி நீங்கள் கண்டறியும் தகவலைச் சரிபார்க்கவும்.

GraphiQL அல்லது மூன்றாம் தரப்பு API கருவியைப் பயன்படுத்துதல்

Postman போன்ற மூன்றாம் தரப்பு API கருவி அல்லது Shopify வழங்கும் இலவசக் கருவியான GraphiQL-ஐப் பயன்படுத்தி நீங்கள் நேரடியாக API-ஐக் வினவலாம். இந்த விருப்பம் மிகவும் துல்லியமான முடிவுகளை வழங்குகிறது, ஆனால் இதற்கு GraphQL வினவல்களை உருவாக்குவதில் சிறிது பரிச்சயம் தேவை.

GraphiQL-க்காக, பொதுவான தரவைக் கொண்ட இணைய அடிப்படையிலான GraphiQL எக்ஸ்ப்ளோரர் மற்றும் GraphiQL செயலி ஆகிய இரண்டையும் Shopify வழங்குகிறது. GraphiQL மூலம், Shopify Flow-இல் உள்ள புலம் பெயர்களுடன் சரியாகப் பொருந்தக்கூடிய GraphQL வினவலை நீங்கள் உருவாக்கலாம். நீங்கள் செயலியைப் பயன்படுத்தினால் மதிப்புகளும் உங்கள் ஸ்டோருடன் சரியாகப் பொருந்தும்.

இந்தக் கருவியைப் பயன்படுத்துவதன் மூலம், உங்கள் உண்மையான ஷாப் தரவைக் கொண்டு, Shopify Flow என்ன தரவைப் பயன்படுத்துகிறது என்பதை உங்களால் துல்லியமாகத் தீர்மானிக்க முடியும். எடுத்துக்காட்டாக, பின்வரும் வினவலை நீங்கள் உருவாக்குகிறீர்கள்:

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

பின்வரும் முடிவுகளில், order / app / name என்ற மாறி ஆர்டருக்கான செயலி பெயரைக் காண்பிக்கிறது. இந்தச் சந்தர்ப்பத்தில், ஆர்டர், வரைவு ஆர்டர்கள் (draft orders) செயலியில் இருந்து உருவாக்கப்பட்டதால், மதிப்பு 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"
            }
          }
        }
      ]
    }
  }