[{"data":1,"prerenderedAt":336},["ShallowReactive",2],{"navigation":3,"page-\u002Fcreating-datasets\u002Frun-and-troubleshoot-the-dataflow":130,"\u002Fcreating-datasets\u002Frun-and-troubleshoot-the-dataflow-surround":330,"comments-\u002Fcreating-datasets\u002Frun-and-troubleshoot-the-dataflow":335},[4],{"title":5,"path":6,"stem":7,"children":8,"page":129},"En","\u002Fen","en",[9,53,87],{"title":10,"path":11,"stem":12,"children":13,"icon":52},"CRM Analytics Foundations","\u002Fen\u002Ffoundations","en\u002F1.foundations\u002F1.index",[14,16,20,24,28,32,36,40,44,48],{"title":15,"path":11,"stem":12},"Welcome & Dev Org",{"title":17,"path":18,"stem":19},"Graded Quiz","\u002Fen\u002Ffoundations\u002Fquiz","en\u002F1.foundations\u002F10.quiz",{"title":21,"path":22,"stem":23},"What Is CRM Analytics?","\u002Fen\u002Ffoundations\u002Fwhat-is-crm-analytics","en\u002F1.foundations\u002F2.what-is-crm-analytics",{"title":25,"path":26,"stem":27},"Architecture","\u002Fen\u002Ffoundations\u002Farchitecture-and-data-flow","en\u002F1.foundations\u002F3.architecture-and-data-flow",{"title":29,"path":30,"stem":31},"The Data Layer","\u002Fen\u002Ffoundations\u002Fthe-data-layer","en\u002F1.foundations\u002F4.the-data-layer",{"title":33,"path":34,"stem":35},"The Design Layer","\u002Fen\u002Ffoundations\u002Fthe-design-layer","en\u002F1.foundations\u002F5.the-design-layer",{"title":37,"path":38,"stem":39},"The Intelligence Layer","\u002Fen\u002Ffoundations\u002Fthe-intelligence-layer","en\u002F1.foundations\u002F6.the-intelligence-layer",{"title":41,"path":42,"stem":43},"Hands-On Tour","\u002Fen\u002Ffoundations\u002Fhands-on-tour","en\u002F1.foundations\u002F7.hands-on-tour",{"title":45,"path":46,"stem":47},"Six Adoption Steps","\u002Fen\u002Ffoundations\u002Fsix-steps-and-interview-prep","en\u002F1.foundations\u002F8.six-steps-and-interview-prep",{"title":49,"path":50,"stem":51},"Interview Questions","\u002Fen\u002Ffoundations\u002Finterview-questions","en\u002F1.foundations\u002F9.interview-questions","i-lucide-compass",{"title":54,"path":55,"stem":56,"children":57,"icon":86},"Setup & User Provisioning","\u002Fen\u002Fsetup","en\u002F2.setup\u002F1.index",[58,60,64,68,72,76,80,83],{"title":59,"path":55,"stem":56},"Provisioning Users",{"title":61,"path":62,"stem":63},"Licenses & Permissions","\u002Fen\u002Fsetup\u002Flicenses-and-permission-sets","en\u002F2.setup\u002F2.licenses-and-permission-sets",{"title":65,"path":66,"stem":67},"Integration User","\u002Fen\u002Fsetup\u002Fthe-integration-user","en\u002F2.setup\u002F3.the-integration-user",{"title":69,"path":70,"stem":71},"Security User","\u002Fen\u002Fsetup\u002Fthe-security-user","en\u002F2.setup\u002F4.the-security-user",{"title":73,"path":74,"stem":75},"Analytics Settings","\u002Fen\u002Fsetup\u002Fanalytics-settings","en\u002F2.setup\u002F5.analytics-settings",{"title":77,"path":78,"stem":79},"Hands-On Access","\u002Fen\u002Fsetup\u002Fhands-on-assigning-access","en\u002F2.setup\u002F6.hands-on-assigning-access",{"title":17,"path":81,"stem":82},"\u002Fen\u002Fsetup\u002Fquiz","en\u002F2.setup\u002F7.quiz",{"title":49,"path":84,"stem":85},"\u002Fen\u002Fsetup\u002Finterview-questions","en\u002F2.setup\u002F8.interview-questions","i-lucide-settings-2",{"title":88,"path":89,"stem":90,"children":91,"icon":128},"Creating Datasets","\u002Fen\u002Fcreating-datasets","en\u002F3.creating-datasets\u002F1.index",[92,94,97,101,105,109,113,117,121,125],{"title":93,"path":89,"stem":90},"What Is a Dataset?",{"title":17,"path":95,"stem":96},"\u002Fen\u002Fcreating-datasets\u002Fquiz","en\u002F3.creating-datasets\u002F10.quiz",{"title":98,"path":99,"stem":100},"The Data Landscape","\u002Fen\u002Fcreating-datasets\u002Fthe-data-landscape","en\u002F3.creating-datasets\u002F2.the-data-landscape",{"title":102,"path":103,"stem":104},"Upload a CSV","\u002Fen\u002Fcreating-datasets\u002Fload-data-from-csv","en\u002F3.creating-datasets\u002F3.load-data-from-csv",{"title":106,"path":107,"stem":108},"Grain, Lookups & Joins","\u002Fen\u002Fcreating-datasets\u002Fgrain-lookups-and-joins","en\u002F3.creating-datasets\u002F4.grain-lookups-and-joins",{"title":110,"path":111,"stem":112},"Dataset Builder","\u002Fen\u002Fcreating-datasets\u002Fbuild-with-dataset-builder","en\u002F3.creating-datasets\u002F5.build-with-dataset-builder",{"title":114,"path":115,"stem":116},"Run the Dataflow","\u002Fen\u002Fcreating-datasets\u002Frun-and-troubleshoot-the-dataflow","en\u002F3.creating-datasets\u002F6.run-and-troubleshoot-the-dataflow",{"title":118,"path":119,"stem":120},"Build with a Recipe","\u002Fen\u002Fcreating-datasets\u002Fbuild-the-same-dataset-with-a-recipe","en\u002F3.creating-datasets\u002F7.build-the-same-dataset-with-a-recipe",{"title":122,"path":123,"stem":124},"Combine Datasets","\u002Fen\u002Fcreating-datasets\u002Fcombine-datasets","en\u002F3.creating-datasets\u002F8.combine-datasets",{"title":49,"path":126,"stem":127},"\u002Fen\u002Fcreating-datasets\u002Finterview-questions","en\u002F3.creating-datasets\u002F9.interview-questions","i-lucide-database",false,{"id":131,"title":132,"access":133,"body":134,"description":320,"extension":321,"interview":133,"links":133,"meta":322,"navigation":323,"passScore":133,"path":115,"quiz":133,"seo":324,"stem":116,"video":325,"__hash__":329},"docs\u002Fen\u002F3.creating-datasets\u002F6.run-and-troubleshoot-the-dataflow.md","Run and Troubleshoot the Dataflow",null,{"type":135,"value":136,"toc":310},"minimark",[137,141,150,155,171,182,189,193,204,211,215,219,229,233,239,267,270,274,281,299],[138,139,132],"h1",{"id":140},"run-and-troubleshoot-the-dataflow",[142,143,144,145,149],"p",{},"You clicked Create Dataset, which ",[146,147,148],"strong",{},"executes the dataflow",". Now let's watch it run, understand what it's actually doing, and fix the error that catches almost everyone the first time.",[151,152,154],"h2",{"id":153},"what-run-the-dataflow-really-does","What \"run the dataflow\" really does",[142,156,157,158,161,162,166,167,170],{},"When Dataset Builder writes to the ",[146,159,160],{},"default dataflow",", it doesn't just build ",[163,164,165],"em",{},"your"," dataset — it runs ",[146,168,169],{},"everything"," in that dataflow. In a training org that's not empty: it comes pre-packaged with other datasets and instructions. So running the default dataflow executes all of it, not only the opportunities dataset you just designed.",[172,173,175],"tip",{"icon":174},"i-lucide-git-branch",[142,176,177,178,181],{},"This is exactly why experienced builders eventually create their ",[146,179,180],{},"own"," dataflows. A single shared default dataflow means every build re-runs everything. As you grow, you'll split work into named dataflows (or recipes) so each one refreshes a known set of datasets on its own schedule.",[142,183,184,185,188],{},"Head to ",[146,186,187],{},"Data Manager → Monitor"," and you'll see your default dataflow running.",[151,190,192],{"id":191},"the-classic-first-run-error","The classic first-run error",[142,194,195,196,199,200,203],{},"On a brand-new org — or the first time you run this — the dataflow may ",[146,197,198],{},"fail with an error",". Don't panic. The cause is almost always simple: the dataflow is asking for objects that ",[146,201,202],{},"haven't been pulled into the sync layer yet",".",[142,205,206,207,210],{},"Remember the chain: the dataflow reads from ",[146,208,209],{},"Connect\u002FSync",", not from Salesforce directly. If Connect hasn't populated Account, Opportunity, and User, the dataflow has nothing to read and it errors out.",[151,212,214],{"id":213},"the-fix-run-connect-manually","The fix: run Connect manually",[216,217],"lesson-steps",{":items":218},"[{\"title\":\"Go to Connect\",\"description\":\"In Data Manager, switch to the Connect tab where your synced objects live.\"},{\"title\":\"Run everything once\",\"description\":\"Open the dropdown and manually run the sync. This pulls the data from Salesforce into the staging layer — the purple layer on the landscape diagram.\"},{\"title\":\"Let the dataflow re-run\",\"description\":\"With the objects now synced, run the default dataflow again. It reads the freshly staged data and builds your dataset successfully.\"}]",[172,220,222],{"icon":221},"i-lucide-workflow",[142,223,224,225,228],{},"When everything is ",[146,226,227],{},"scheduled"," properly, this is automatic: the dataflow asks the sync layer \"is the data here?\" and, if not, Connect kicks off and brings it in before the dataflow proceeds. You only do this by hand when an environment is out of sync — typically a fresh training org on day one.",[151,230,232],{"id":231},"forgot-a-field-edit-the-digest-node","Forgot a field? Edit the digest node",[142,234,235,236,203],{},"Because you can't reopen the Dataset Builder field picker, editing fields later happens in the ",[146,237,238],{},"dataflow's digest nodes",[240,241,242,253,260],"ul",{},[243,244,245,246,249,250,203],"li",{},"Open the dataflow, click the relevant digest node (say, ",[146,247,248],{},"Account","), and re-add the field via ",[146,251,252],{},"Select Fields",[243,254,255,256,259],{},"Save, and when prompted, choose to ",[146,257,258],{},"propagate"," the field all the way down to the final register node — otherwise it stops partway and never reaches your dataset.",[243,261,262,263,266],{},"Update and ",[146,264,265],{},"run the dataflow again"," so the new field is materialized.",[142,268,269],{},"We cover digest nodes, field attributes, and dataflow editing properly in the Data Manager lessons — this is just enough to unstick you.",[151,271,273],{"id":272},"youve-built-your-first-dataset","You've built your first dataset",[142,275,276,277,280],{},"Once the dataflow finishes green, hop back to Analytics Studio and there it is — your opportunities dataset, sitting in your private app, ready to explore. On the landscape diagram it now lives in the ",[146,278,279],{},"dataset layer",", built by a dataflow that reads from sync.",[172,282,284],{"icon":283},"i-lucide-check-check",[142,285,286,287,290,291,294,295,298],{},"Mental checklist when a dataflow fails: ",[146,288,289],{},"(1)"," Are the source objects synced? ",[146,292,293],{},"(2)"," Did Connect actually finish before the dataflow ran? ",[146,296,297],{},"(3)"," Does every field you need propagate to the register node? Nine out of ten first-run failures are answered by those three questions.",[142,300,301,302,305,306,309],{},"Dataset Builder is friendly, but it locks you into lookups and a dataflow. Next we build the ",[146,303,304],{},"exact same dataset"," with a ",[146,307,308],{},"recipe"," — more clicks up front, far more control, and the direction the platform is heading.",{"title":311,"searchDepth":312,"depth":313,"links":314},"",1,2,[315,316,317,318,319],{"id":153,"depth":313,"text":154},{"id":191,"depth":313,"text":192},{"id":213,"depth":313,"text":214},{"id":231,"depth":313,"text":232},{"id":272,"depth":313,"text":273},"Execute the default dataflow to build your dataset, monitor it in Data Manager, and fix the most common first-run error — objects that haven't been synced yet — by running Connect manually.","md",{},{"title":114},{"title":132,"description":320},{"id":326,"start":327,"end":328},"-0mp2mUjyVI",1291,1632,"UVhV0szUm0nkZVBpR7w5d4kBHl1GJU0n_UL6mppgDlI",[331,333],{"title":110,"path":111,"stem":112,"description":332,"children":-1},"Use Dataset Builder to create an opportunities dataset from Salesforce data. Start from the lowest-grain object, walk relationships up to Account and User, pick fields, and let it write the dataflow for you.",{"title":118,"path":119,"stem":120,"description":334,"children":-1},"Recreate the opportunities dataset with a CRM Analytics recipe: select objects, join Account and User with the right keys, prefix and trim columns, and add an output node — the modern, flexible way to build datasets.",[],1783475169355]