Таблица api: Расшифровка классификации масла по API

Содержание

Классификация МАСЕЛ по API

API система классификации моторных масел (API Engine Service Classification System) развивалась с 1969 года в результате совместной работы API, ASTM и SAE. Система полностью изложена в стандартах ASTM D 4485«Стандартная спецификация на качество эксплуатационных свойств моторных масел» (Standart Performance Specification for Performance of Engine Oils) и SAE J183 APR96 «Качество эксплуатационных свойств моторных масел и эксплуатационные классификации двигателей (за исключением энергосберегающих масел)»(Engine Oil Performance and Engine Service Classifications (Other than «Energy Conserving»). Новый качественный шаг в развитии качества и классификации моторных масел был сделан в 1983-1992 годах, когда под руководством API и участии представителей производителей автомобилей (ААМА), двигателей (ЕМА) и технических союзов (ASTM иSAE) была создана и развита «Система лицензирования и сертификации моторных масел EOLCS» (Engine Oil Licensing and Certification System, API Publication No. 1509). Эта система постоянно совершенствуется. В настоящее время аттестация моторных масел проводится согласно требованиям EOLCS и «Свода правил СМА» (СМА Code of Practice).

По системе API (ASTM D 4485, SAE J183 APR96) установлены три эксплуатационные категории (три ряда) назначения и качества моторных масел:

S (Service) — состоит из категорий качества моторных масел для бензиновых двигателей, идущих в хронологическом порядке. Для каждой новой генерации присваивается дополнительная буква по алфавиту:
API SA, API SB, API SC, API SD, API SE, API SF, API SG, API SH и API SJ (категория SI — намеренно пропущена API, для исключения путаницы с Международной системой мер).
Категории API SA, API SB, API SC, API SD, API SE, API SF, API SG на сегодняшний день признаны недействительными, как устаревшие, однако в некоторых странах масла этих категорий еще выпускаются, категория API SH является «условно действующей» и может использоваться только как дополнительная, например API CG-4/SH.
Класс SL введен 2001 г. и отличается от SJ существенно лучшими антиокислительными, противоизносными, противопенными свойствами, а также меньшей испаряемостью;

C (Commercial) — состоит из категорий качества и назначения масел для дизельных двигателей, идущих в хронологическом порядке. Для каждой новой генерации присваивается дополнительная буква по алфавиту:
API СA, API СB, API СC, API СD, API СD-II, API CE, API CF, API CF-2, API CF-4, API CG-4 и API CH-4.
Категории API СA, API СB, API СC, API СD, API СD-II на сегодняшний день признаны недействительными, как устаревшие, однако в некоторых странах масла этих категорий еще выпускаются;

EC (Energy Conserving) — энергосберегающие масла — новый ряд высококачественных масел, состоящий из маловязких, легкотекущих масел, уменьшающих расход топлива по результатам тестов на бензиновых двигателях.
Моторные масла, отличающиеся низкой вязкостью как при низкой, так и при высокой температуре могут быть сертифицированы на соответствие категории API EC «энергосберегающее» масло («Energy Conserving» Oil). Ранее энергосбережение определялось по методике Последовательности VI (Sequence VI, ASTM RR D02 1204). Данная методика использовалась для сертификации масел категории API SH на уровни (степени) энергосбережения: API SH/EC — 1,5% экономии топлива и API SH/ECII — 2,7% экономии топлива, по сравнению с эталонным маслом SAE 20w-30. Римские цифры после букв ЕС указывают уровень получаемой экономии топлива (ЕС II — 2,5%).

Влияние систем по контролю эмиссии вредных веществ

Универсальные масла для бензиновых и для дизельных двигателей обозначаются двумя символами соответствующих категорий: первый символ является основным, а второй указывает на возможность применения этого масла для двигателя другого типа. Например, API CG-4/SH — масло, оптимизированное для применения в дизельных двигателях, но его можно применять и в бензиновых двигателях, для которых предписывается масло категории API SH и ниже (SG, SF, SE и т.д.).

Для бензиновых двигателей — классы масел по шкале S
Группа масел Рекомендуемая область применения Годы выпуска автомобилей Качественные показатели
SN Введена в октябре 2010г. Это по­след­няя сер­вис­ная ка­те­го­рия для ав­то­мо­би­лей с бен­зи­но­вы­ми дви­га­те­ля­ми. Этот но­вый се­ве­ро­аме­ри­кан­ский стан­дарт за­ме­нил пре­ды­ду­щую сер­вис­ную ка­те­го­рию SM, ко­то­рая бы­ла вве­дена в 2004 г. Мо­тор­ные мас­ла, от­ве­ча­ю­щие API SN, мо­гут ис­поль­зо­вать­ся в дви­га­те­лях, ко­то­рым пред­пи­са­ны ка­те­го­рии API SM и бо­лее ран­ние ка­те­го­рии S. Мас­ла API SN улуч­ше­ны по срав­не­нию с API SM в об­ла­стях окис­ли­тель­ной ста­биль­но­сти и кон­тро­ля от­ло­же­ний и шла­мов. API так­же вве­ло но­вое обо­зна­че­ние «Сбе­ре­га­ю­щее Ре­сур­сы» (Resource Conserving), ко­то­рое мо­жет ис­поль­зо­вать­ся в связ­ке с API SN. Обо­зна­че­ние «Сбе­ре­га­ю­щее Ре­сур­сы» за­ме­ни­ло пре­ды­ду­щее обо­зна­че­ние «Сбе­ре­га­ю­щее Энер­гию» (Energy Conserving). В то вре­мя как обо­зна­че­ние «Сбе­ре­га­ю­щее Энер­гию» бы­ло сфо­ку­си­ро­ва­но толь­ко на экономии топ­ли­ва, но­вое обо­зна­че­ние «Сбе­ре­га­ю­щее Ре­сур­сы» охва­ты­ва­ет эко­но­мию топ­ли­ва, за­щи­ту си­сте­мы очист­ки вы­хлоп­ных га­зов и тур­бо­над­ду­вов, а так­же сов­ме­сти­мость с топ­ли­ва­ми, со­дер­жа­щи­ми эта­нол (вплоть до Е85, т.е. с топ­ли­ва­ми, со­дер­жа­щи­ми до 85 % биоэта­но­ла). Другими словами основное отличие API SN от предыдущих классификаций API в ограничении содержания фосфора для совместимости с современными системами нейтрализации выхлопных газов, а также комплексное энергосбережение. То есть, масла, классифицируемые по API SN, приблизительно соответствовуют АСЕА С2, С3, С4, без поправки на высокотемпературную вязкость. с 2011
SM Введена в ноябре 2004.
Тенденции развития техники направлены на повышение их экологической безопасности, увеличение интервалов техобслуживания при сохранении надежности работы. Естественно, это вносит свои коррективы в процесс совершенствования двигателей, отображаясь и на качествах смазывающих материалов. Следуя данным тенденциям, в ноябре 2004 года в классификации API появился класс на моторные масла для бензиновых двигателей — SM, предполагающий, по сравнению с SL, повышенные требования к смазывающим материалам относительно стойкости к окислению, защите от отложений, износа и т.д. С октября 2006 года пополнилась категория и для дизельных масел классом CJ-4.
с 2004
SL (Действующая). API планировал разрабатывать проект PS-06 как следующую категорию API SK, но один из поставщиков моторных масел в Корее использует сокращение «SK» как часть своего корпоративного имени. Для исключения возможной путаницы буква «К» будет пропущена для следующей категории «S».
— стабильность энергосберегающих свойств;
— пониженная летучесть;
— удлиненные интервалы замены.
c 2001
SJ (Действующая). Категория утверждена 06.11.1995, лицензии стали выдаваться с 15.10.1996. Автомобильные масла данной категории предназначены для всех используемых в настоящее время бензиновых двигателей и полностью заменяют масла всех существовавших ранее категорий в более старых моделях двигателей. Максимальных уровень эксплуатационных свойств. Возможность сертификации по категории энергосбережения API SJ/EC. c 1996
SH (Условно действующая). Лицензированная категория, утвержденная в 1992 году. На сегодняшний день категория является условно действующей и может быть сертифицирована только как дополнительная к категориям API C (например API AF-4/SH). По требованиям соответствует категории ILSAC GF-1, но без обязательного энергосбережения. Автомобильные масла данной категории предназначены для бензиновых двигателей моделей 1996 года и старше. При проведении сертификации на энергосбережение, в зависимости от степени экономии топлива присваивались категории API SH/EC и API SH/ECII. с 1993 высшее для моделей с 1995 г.в.
SG Лицензированная категория, утвержденная в 1988 году. Выдача лицензий прекращена в конце 1995 года. Автомобильные масла предназначены для двигателей моделей 1993 года и старше. Топливо — неэтилированный бензин с оксигенатами. Удовлетворяют требованиям, выдвигаемым к автомобильным маслам для дизельных двигателей категории API CC и API CD. Имеют более высокую термическую и противоокислительную стабильность, улучшенные противоизносные свойства, уменьшенную склонность к образованию отложений и шлама.
Автомобильные масла API SG заменяют масла категорий API SF, SE, API SF/CC и API SE/CC.
1989-1993 высшее для четырехтактных моторов
SF Автомобильные масла данной категории предназначены для двигателей моделей 1988 года и старше. Топливо — этилированный бензин. Они имеют более эффективные, чем предыдущие категории, противоокислительные, противоизносные, антикоррозийные свойства и обладают меньшей склонностью к образованию высоко- и низкотемпературных отложений и шлака.
Автомобильные масла API SF заменяют масла API SC, API SD и API SE в более старых двигателях.
1981-1988 высшее для двухтактных моторов
SE Высокофорсированные двигатели, работающие в тяжелых условиях. 1972-1980 высшее
SD Среднефорсированные двигатели, работающие в тяжелых условиях. 1968-1971 среднее
SC Двигатели, работающие с повышенными нагрузками. 1964-1967
SB Двигатели, работающие при умеренных нагрузках, используется только по требованию производителя.
SA Двигатели, работающие в легких условиях, используется только по требованию производителя.

 

Для дизельных двигателей — классы масел по шкале C
Группа масел Рекомендуемая область применения Годы выпуска автомобилей Качественные показатели
CJ-4 Введена в 2006. Для быстроходных четырёхтактных двигателей, проектируемых для удовлетворения норм по токсичности отработавших газов 2007 года на магистральных дорогах. Масла CJ-4 допускают использование топлива с содержанием серы вплоть до 500 ррт (0,05% от массы). Однако работа с топливом, в котором содержание серы превышает 15 ррт (0,0015% от массы), может сказаться на работоспособности систем очистки выхлопных газов и/или интервалах замены масла.
Масла CJ-4 рекомендованы для двигателей, оборудованных дизельными сажевыми фильтрами и другими системами обработки выхлопных газов.
Масла со спецификацией CJ-4 превышают рабочие свойства CI-4, CI-4 Plus, CH-4, CG-4, CF-4 и могут применяться в двигателях, которым рекомендуются масла этих классов.
с 2006
СI-4 Введена в 2002 году. Для быстроходных четырёхтактных двигателей, проектируемых для удовлетворения нормам по токсичности отработавших газов, осуществляемым в 2002 году. Масла СI-4 допускают использование топлива с содержание серы вплоть до 0,5% от массы, а также применяются в двигателях с системой рециркуляции отработанных газов (EGR). Заменяет CD, СЕ, CF-4, CG 4 и СН-4 масла.
В 2004 году была введена дополнительная категория API CI-4 PLUS. Ужесточены требования к сажеобразованию, отложениям, вязкостным показателям, ограничение значения TBN.
с 2002
СH-4 Введена в 1998 году. Для быстроходных четырёхтактных двигателей, удовлетворяющих требования по токсичности выхлопных газов, введенных в США с 1998 года. Масла СН-4 позволяют использовать топливо с содержанием серы вплоть до 0,5% от массы. Можно использовать вместо CD, СЕ, CF-4 и CG-4 масел. с 1998
СG-4 Введена в 1995 году. Для двигателей быстроходной дизельной техники, работающей на топливе с содержанием серы менее чем 0,5%. Масла CG-4 для двигателей, выполняющих требования по токсичности отработанных газов, введенные в США с 1994 года. Заменяет масла CD, СЕ и CF-4 категорий. с 1995 высшее для моделей с 1995 г.
СF-4 Введена в 1990 году. Для быстроходных четырехтактных дизельных двигателей с турбонаддувом и без него. Можно применять вместо CD и СЕ масел. с 1990 высшее для четырехтактных моторов
СF-2 Введена в 1994 году. Улучшенные характеристики, используется вместо CD-II для двухтактных двигателей. с 1994 высшее для двухтактных моторов
CF Введена в 1994 году. Масла для внедорожной техники, двигателей с разделительным впрыском, в том числе работающих на топливе с содержанием серы 0,5% от массы и выше. Заменяет масла CD. с 1994
CE Высокофорсированные перспективные двигатели с высоким турбонаддувом, работающие в тяжелых условиях, может использоваться вместо масел классов CC и CD. с 1987 высшее
CD Класс масел для скоростных дизельных двигателей с турбонаддувом и высокой удельной мощностью, работающих на больших скоростях и при высоких давлениях и требующих повышенных противоиносных свойств и предотвращения образования нагара. с 1955 среднее
CC Высокофорсированные двигатели (в том числе с умеренным наддувом), работающие в тяжелых условиях. с 1961 низкие
CB Среднефорсированные двигатели без наддува, работающие при повышенных нагрузках на сернистом топливе. 1949-1960
CA Двигатели, работающие при умеренных нагрузках на малосернистом топливе. 1940-1950

 

Универсальные масла для бензиновых двигателей и дизелей имеют обозначения обеих категорий, например API SG/CD, API SJ/CF.

Классы дизельных масел подразделяются дополнительно для двухтактных (CD-2, CF-2) и четырехтактных дизелей (CF-4, CG-4, СН-4).

В настоящее время API сертифицирует моторные масла классов SJ, SL, CF, CF-2, CF-4, CG-4, СН-4. Масла остальных классов по API, отмененных в США, следует использовать, если они допущены производителями автомобилей.

Знаки API

 

 

Масла, соответствующие требованиям действующих категорий качества и прошедшие официальные испытания API — SAE, имеют на своих этикетках графический круглый знак (donut mark) — «API символ обслуживания» (API Service Symbol), в котором указаны степень вязкости по SAE, категория качества и назначения по API и возможная степень энергосбережения.

 

 

 

Мас­ла, ли­цен­зи­ро­ван­ные API и от­ве­ча­ю­щие API SN отоб­ра­жа­ют­ся на зад­нем лей­б­ле сер­вис­ным сим­во­лом «коль­цо» API. Све­де­ния о том, что ли­цен­зи­ро­ван­ное мас­ло так­же от­ве­ча­ет обо­зна­че­нию Resource Conserving, изоб­ра­же­ны на ниж­ней ча­сти коль­ца.

 

 

Новейшие категории масел сертифицированные API, в случае соответствия требованиям ILSAC, обозначаются «Символом Свидетельства сертификации API» (API Certification Mark), так называемым знаком «Звездного взрыва» («Starburst»). Этот знак может присваиваться только энергосберегающим, легкотекучим маслам наивысшего уровня качества, с вязкостями SAE 0W-…, 5W-… и 10W-… . Система требований к маслам серии ILSAC GF является составной частью системы API Обеспечения Качества Американских Масел (EOLCS).

Системы API — ILSAC предназначены для удовлетворения требований к маслам, используемым в двигателях американских и японских автомобилей. Требования европейских автопроизводителей несколько отличаются по причине конструктивных особенностей европейских двигателей. Несмотря на это, большинство моторных масел, поступающих на европейский рынок, маркируются знаками соответствия категориям качества API и, в редких случаях, даже «Символом Обслуживания API» (API Service Symbol).

 

Классификации трансмиссионных масел по API и SAE J 306 C

Классификации трансмиссионных масел по API и SAE J 306 C

Эксплуатационные свойства трансмиссионных масел согласно условиям эксплуатации и конструкции агрегатов устанавливает наиболее распространенный в мире стандарт, разработанный American Petroleum Institute (API). Указателем класса API для трансмиссионных масел является аббревиатура GL (Gear Lubricant) с нумерацией от 1 до 6. В современных легковых автомобилях различных типов используются масла GL-4 и GL-5. GL 1 – GL-3 применяются только в трансмиссиях старых автомобилей.

Группа GL-6 в настоящее время не используется, так как считается, что класс GL-5 отвечает наиболее строгим требованиям.

В 1998 г. API, работая в контакте с SAE (Society of Automotive Engineers – Американская Ассоциация Автомобильных Инженеров) и ASTM (American Society for Testing and Materials – Американское общество испытаний материалов), предложил две новые категории оценки качества трансмиссионных масел: PG-1 и PG-2 (PG-1 – для ручных коробок передач тяжелых грузовых автомобилей и автобусов; PG-2 – для ведущих осей грузовых автомобилей и автобусов). Особое внимание уделялось высокотемпературным свойствам этих масел. В технической литературе категорию PG-2 иногда обозначают группой GL-7.

Классификация API предусматривает деление трансмиссионных масел в основном по уровню противозадирных свойств. Чем больше номер группы GL, тем эффективнее присадки, обеспечивающие эти свойства. В них содержатся сернистые соединения, что в критических режимах работы зубчатых пар приводит к химическим изменениям поверхностного слоя металла, который преобразуется в тонкую модифицированную пленку – продукт износа. Несмотря на то, что металл при этом химически разъедается, суммарный ущерб в тяжелых условиях работы оказывается меньше.

Но такая химическая модификация масла позволяет снизить износ стали или чугуна. Цветные же металлы, из которых изготавливают синхронизаторы механических КПП, не всегда уживаются с сернистыми соединениями, поэтому изнашиваются быстрее. Именно поэтому на переднеприводных ВАЗах, пока российскими заводами не было налажено производство соответствующей «трансмиссионки», применялось обычное моторное масло. В этом случае при отличной сохранности синхронизаторов повышался износ шестерен.

Использование в механических КПП масла класса GL-5 может стать причиной затрудненного включения передач, так как принцип работы синхронизаторов основан на использовании такого явления как трение. Чем выше коэффициент трения рабочих поверхностей механизма синхронизации, тем легче включаются передачи. А так как эффективные противоизносные присадки этого масла снижают коэффициент трения, для включения передачи к рычагу КПП необходимо прикладывать большие усилия.

Эти примеры показывают, что классификация API во многом не отражает важных свойств масел, необходимых для эффективной работы агрегатов трансмиссий. В связи с этим автопроизводители выдвигают дополнительные требования к трансмиссионным маслам, используя классификацию API лишь как основу. Свои спецификации имеют такие фирмы-производители автомобилей и агрегатов как Chrysler, Ford, General Motors, Mack, MAN, Mercedes, Volvo.

Подводя итоги, можно сказать, что масло уровня GL-4 предназначено для работы в синхронизированных коробках передач легковых заднеприводных и переднеприводных автомобилей. Масло этого класса обеспечивает надежную защиту КПП и в то же время не агрессивно по отношению к синхронизаторам.

Масло GL-5 рекомендуется для работы в тех агрегатах трансмиссии, где имеются гипоидные зацепления. Одна из наиболее часто допускаемых ошибок – заправка маслом класса GL-4 редукторов заднеприводных автомобилей – ведет к более быстрому износу и, как следствие, быстрому выходу из строя шестерен главной пары. Оптимальным выбором можно считать трансмиссионное масло, получившее спецификацию производителя данного автомобиля. Как правило, ведущие производители масел указывают эти данные на канистре. Следует знать, что некоторые производители выпускают универсальные масла, предназначенные как для коробки передач с синхронизаторами, так и для нагруженных гипоидных передач.

Уровень противоизносных и противозадирных свойств трансмиссионного масла определяется не только составом и концентрацией присадок, но и вязкостью. Масла должны, с одной стороны, сохранять высокую вязкость при рабочих температурах, чтобы не разрушалась масляная пленка и нормально уплотнялись зазоры, с другой – не становиться слишком вязкими при минусовых температурах окружающей среды, чтобы на «холодную» не препятствовать вращению шестерен агрегатов. Слишком высокая вязкость усложняет работу синхронизаторов, ведь лишнее очень вязкое масло при переключении передач необходимо постоянно выдавливать из зазоров между контактирующими рабочими поверхностями. В сильные морозы из-за этого на «холодную» также затрудняется включение передач, а автомобиль может двигаться даже на нейтральной передаче (при включенном сцеплении).

SAE J 306 C классифицирует трансмиссионные масла следующим образом: 70W, 75W, 80W, 85W, 80, 85, 90, 140 и 250 (см. таблицы 3.3. и 3.4). Буква W (winter) означает, как и в маслах моторной группы, что вязкость определена при низких температурах, т.е. масло предназначено для эксплуатации в зимнее время. При указанных в таблице минусовых температурах вязкость масел должна быть в пределах 150000 сП (Санти-пуазов). Кроме того, масло должно соответствовать определенным минимальным требованиям при 1000С. Маркировка вязкости без буквы W – 85, 90 и т.д. говорит о принадлежности к летнему сорту. Для масел других классов SAE предельные характеристики вязкости в Санти-стоксах (сСт) определены при температуре 1000С. Довольно широкое признание получили всесезонные трансмиссионные масла, в маркировку которых введены два обозначения – зимнее 75W, 80W и т.д. и летнее 85, 90 – например, 75W-90 или 80W-90. Чтобы исключить нецелесообразную процедуру замены масел каждые полгода, автопроизводители рекомендуют использовать трансмиссионную «всесезонку».

Трансмиссионное масло должно выбираться с учетом максимальных и минимальных температур, при которых планируется эксплуатация автомобиля. Исходя из этих соображений, классификация SAE основана на показателях низкотемпературной и высокотемпературной вязкостей. Как показано в таблице 2, чтобы исключить большие потери энергии на трение, оптимальная «зимняя» вязкость в нашей климатической зоне должна соответствовать классу 80W. «Летнюю» вязкость лучше подбирать в соответствии с требованиями автопроизводителя, которые указаны в руководстве по эксплуатации машины.

Таблица 1. Классификация трансмиссионных масел по уровню эксплуатационных свойств (API)








Группа Область применения
GL-1 Предназначены для спирально-конусных, червячных передач и механических коробок передач (без синхронизаторов) грузовых автомобилей и сельскохозяйственных машин
GL-2 Червячные передачи, работающие при низких скоростях и нагрузках. Обычно применяются для смазывания трансмиссии тракторов и сельскохозяйственных машин
GL-3 Спирально-конические передачи, работающие в умеренно жестких условиях. Предназначены для смазывания конусных и других передач грузовых автомобилей. Не предназначены для гипоидных передач
GL-4 Гипоидные передачи, работающие в условиях высоких скоростей при малых крутящих моментах и малых скоростей при больших крутящих моментах. В настоящее время эти масла являются основными и для синхронизированных передач
GL-5 Гипоидные передачи, работающие в условиях высоких скоростей при малых крутящих моментах и ударных нагрузках на зубья шестерен. Основное предназначение – для гипоидных передач, имеющих смещение осей. Для синхронизированной механической коробки передач применяются только масла, имеющие специальное подтверждение о соответствии требованиям производителей машин. гипоидных передач, имеющих смещение осей. Для синхронизированной механической коробки передач применяются только масла, имеющие специальное подтверждение о соответствии требованиям производителей машин
GL-6 Гипоидные передачи с увеличенным смещением, работающие в условиях высоких скоростей, больших крутящих моментов и ударных нагрузок. В настоящее время класс GL-6 больше не применяется, так как считается, что класс API GL-5 достаточно хорошо удовлетворяет наиболее строгие требования

Таблица 2. Классификация трансмиссионных масел по вязкости (SAE)











Класс вязкости Минимальная температура, 0C Вязкость, сСт
70W -55 4,1 / –
75W -40 4,1 / –
80W -26 7,0 / –
85W -12 11,0 / –
80   7,0 / < 11,0
85   11,0 / < 13,5
90   13,5 / 24,0
140   24,0 / 41,0
250   41,0 / –

Серверное Callback API – Calltouch

 

 

Общая информация

API — это программный интерфейс для внешних программных продуктов. Рассматриваемый в данном разделе API интерфейс позволяет отправлять заявки на обратный звонок, информация о которых будет загружена в журнал звонков.

Благодаря этому API методу можно автоматизировать прозвоны колл-центром поступающих заявок, а также настроить автоматический прозвон базы клиентов с регулированием времени звонка и выбором нужного оператора колл-центра.
Важным преимуществом данного метода в том, что для передачи заявок на обратный звонок не обязательно наличие скрипта Calltouch на сайте.

 

 

Подключение

Для подключения необходимо:

  1. Пополнить баланс минут и активировать услугу обратного звонка
  2. Создать специальный тип виджета «Форма на сайте» и настроить его.
  3. Включить виджет
  4. Настроить передачу заявок с сервера с помощью серверного API.

Далее представлены варианты передаваемых параметров для отправки заявок на обратный звонок

 

 

API-метод для создания заявок на обратный звонок

Запрос

Поддерживаемые методы отправки: POST.

HTTP-заголовки:

  • POST /widget-service/v1/api/widget-request/user-form/create HTTP/1.1
  • Host: api.calltouch.ru
  • Access-Token: <API-токен Calltouch>

Тело запроса в формате JSON:

Скопировать скрипт

{
    "routeKey": "Ключ виджета "Форма на сайте", к которому будет привязана заявка",
    "phone": "Номер телефона клиента",
    "fields": [
    {"name": "Название произвольного поля",
     "value": "Значение произвольного поля"}
    ],
    "sessionId": "ID сессии Calltouch",
    "scheduleTime": "Время, на которое заказали обратный звонок, в формате
      yyyy-mm-dd hh:mm:ss 2020-10-01 02:10:00",
    "utmSource": "Произвольный источник",
    "utmMedium": "Произвольный канал",
    "utmCampaign": "Произвольная кампания",
    "utmContent": "Произвольное объявление",
    "utmTerm": "Произвольная ключевая фраза",
    "callUrl": "URL-адрес страницы, с которой была отправлена заявка",
    "tags": [
      "Тег 1"
    ],
    "unitId": Идентификатор отдела в виджете "Форма на сайте"
}

 

Параметры запроса

 

 

Пример запроса

 

HTTP-заголовки:

POST /widget-service/v1/api/widget-request/user-form/create HTTP/1.1
Host: api.calltouch.ru
Access-Token: <token>
...

Минимальный запрос на создание заявки будет иметь вид:

Скопировать скрипт

{"routeKey": "routekey_1", "phone": "79992223344"}

Пример со всеми параметрами представлен ниже:

Скопировать скрипт

{
   "routeKey": "routekey_1",
   "phone": "79992223344",
   "fields": [
      {"name": "Имя", "value": "Иван"},
      {"name": "Фамилия", "value": "Иванов"},
      {"name": "Отчество", "value": "Иванович"},
{"name": "Город", "value": "Москва"},
{"name": "Тема", "value": "Заявка на консультацию"} ],
"sessionId": "11223344",
"scheduleTime": "2021-02-01 17:10:00", "utmMedium": "medium", "utmSource": "source", "utmCampaign": "campaign", "utmContent": "content", "utmTerm": "term", "tags": [ "tag1","tag2","tag3","tag10" ], "unitId": 112233
}

Обратите внимание, что если указаны одновременно utmSource, utmMedium, utmCampaign, utmContent, utmTerm и sessionId, то sessionId имеет более высокий приоритет и источник будет взят из сессии.

 

 

Авторизация (токен)

Для работы с API необходимо в заголовке запроса указать токен, который можно получить в разделе личного кабинета Интеграции -> API и Webhooks -> API.

 

Идентификатор сессии Calltouch

Для получении id сессии необходимо воспользоваться одним из способов:

1. Получение id сессии из скрипта подмены.

Идентификатор сессии Calltouch присутствует в коде сайта, с которого отправляется заявка, если в этом коде установлен скрипт отслеживания Calltouch. Чтобы получить ID сессии скрипта Calltouch или проверить отработал ли он или нет, используйте JS-функцию calltracking_params, например:

window.ct('calltracking_params','mod_id').sessionId

Где вместо mod_id нужно указать идентификатор скрипта Calltouch.

2. Получение id сессии из cookies.

Приведем пример реализации скрипта на PHP с использованием CURL:

$sessionId = $_COOKIE['_ct_session_id'];

В обоих случаях определившийся источник заявки на обратный звонок (с помощью переданного значения сессии) будет отображен в журнале звонков:

 

 

Техническая документация

Более полное описание метода /api/widget-request/user-form/create представлено по ссылке http://api.calltouch.ru/widget-service/v1/

Данная документация отображает технические параметры запроса, а также предоставляет возможность отправки тестовых заявок на прозвон виджетом «Форма на сайте».
Для просмотра необходимо перейти в параметры заявки:

Чтобы отправить тестовую заявку необходимо авторизоваться, используя API-токен проекта, к которому вы планируете подключиться по API:

 

Для ознакомления с описанием метода и просмотра массива можно открыть каждый метод отдельно (строки кликабельны):

Для просмотра примера воспользуйтесь блоком «Example Value» и кнопкой Try it out + Execute.

Вы увидите ответ с описание кода:

Через данный блок, при использовании рабочего токена и routeKey, можно создать боевую заявку, которая будет обработана через сервис обратного звонка:

Для просмотра списка полей перейдите в блок Model.
Ниже список полей для создания заявки на обратный звонок:

Список ошибок

Код Описание
1 Синтаксическая ошибка JSON в запросе или запрос пустой
10001 Невозможно создать заявку виджета, недостаточно минут обратного звонка
10002 Невозможно создать заявку виджета, услуга обратного звонка не включена
10003 Невозможно создать заявку виджета, не найдено включенных виджетов с указанным ключом
10004 Невозможно создать заявку виджета, указанная сессия не найдена
10005 Превышен лимит отправки заявок в рамках сессии, если передан sessionId
10006 Превышен лимит отправки заявок на один и тот же номер телефона, если не передан sessionId
10007

Превышен лимит минимального интервала между отправкой заявок по номеру телефону или сессии

 

 

Пример реализации

В данном примере будет рассмотрен прозвон клиентской базы, хранящейся в Google Sheets. Заявки на прозвон будут отправляться автоматически через сервис Альбато.

 

Подготовка таблицы Google Sheets

Для корректного прозвона списка клиентов и дальнейшей проверки необходимо подготовить данные к отправке.
На примере ниже подготовлена таблица с данными клиента (ФИО и телефон), произвольными значениями источников, заданным тегом и выбранным отделом.

Обратите внимание, что для корректной обработки полей таблицы на стороне Альбато, не должно быть пустых строк.

 

Настройка подключения и связок в Альбато

Для настройки связки необходимо будет создать следующие подключения:

  • Google Sheets
  • Calltouch
  • Webhooks

Подробное описание настройки подключения к Google Sheets и дальнейшей настройке связки можно найти в базе знаний Альбато.

В настройках подключения Webhooks необходимо будет указать:

     utmSource
     utmMedium
     utmCampaign
     utmContent
     utmTerm
     routeKey
     phone
     fields.0.name
     fields.0.value
     tags.0
     unitId

В настроенном виде связка выглядит так:

В настройке отправки вебхука необходимо задать соответствие столбцов таблицы и полей запроса:

 

Отображение результатов в журнале звонков

После запуска связки звонки начнут обрабатываться. В журнале звонков будут отображены звонки с полем ФИО, заданными источниками и тегом.

Таким образом был получен инструмент автоматического обзвона клиенткой базы.
При необходимости, можно обогатить передаваемую информацию дополнительными полями, что позволит передавать оператору колл-центра более полные данные о клиенте через синтез речи.

Документация для API сервиса email-маркетинга

lists.get
(
int list_id )

Получаем список баз пользователя

lists.add
(
string name, string abuse_email, string abuse_name, string company, string address, string city, string zip, string country, string url, string phone )

Добавляем адресную базу

lists.update
(
int list_id, string name, string abuse_email, string abuse_name, string company, string address, string city, string zip, string country, string url, string phone )

Обновляем контактную информацию адресной базы

lists.delete
(
int list_id )

Удаляем адресную базу и всех активных подписчиков в ней.

lists.get_members
(
int list_id, string state, int start, int limit, string order, int member_id, string email )

Получаем подписчиков в адресной базе с возможность фильтра и регулировки выдачи.

lists.get_unsubscribed
(
int start, int limit, string order )

Получаем список отписавшихся подписчиков из всех баз.

lists.member_activity
(
string email, string filter )

Получаем активность подписчика в различных рассылках

lists.upload
(
int list_id, string file, int email, int merge_1, int merge_2, int merge_3, int merge_4, int merge_5, int merge_6, int merge_7, int merge_8, int merge_9, int merge_10, enum gender, string type, string update, int sheet_index, string sheet_name )

Импорт подписчиков из файла

lists.add_member
(
int list_id, string email, string merge_1, string merge_2, string merge_3, string merge_4, string merge_5, string merge_6, string merge_7, string merge_8, string merge_9, string merge_10, enum gender, string update, string no_check )

Добавляем подписчика в базу

lists.add_member_batch
(
int list_id, string batch, string update, string no_check )

Добавляем несколько подписчиков в базу

lists.update_member
(
int member_id, string email, int list_id, string merge_1, string merge_2, string merge_3, string merge_4, string merge_5, string merge_6, string merge_7, string merge_8, string merge_9, string merge_10, enum gender )

Редактируем подписчика в базе

lists.delete_member
(
int member_id )

Удаляем подписчика из базы.

lists.unsubscribe_member
(
int member_id, string email, string list_id )

Отписываем подписчика из базы.

lists.move_member
(
int member_id, int list_id )

Перемещаем подписчика в другую адресную базу.

lists.copy_member
(
int member_id, int list_id )

Копируем подписчика в другую адресную базу.

lists.add_merge
(
int list_id, string type, serialized array choices, string title, string req, string var )

Добавить дополнительное поле в адресную базу.

lists.update_merge
(
int list_id, int merge_id, serialized array choices, string title, string req, string var )

Обновить настройки дополнительного поля в адресной базе.

lists.delete_merge
(
int list_id, int merge_id )

Удалить дополнительное поле из адресной базы.

lists.last_status
(
string email, int list_id )

Получить последний статус конкретного email в адресных базах

lists.get_import_history
(
int list_id )

Получить историю и результаты импорта адресной базы

API

Таблицы данных — Ядро

$ ()

Выполнение действия выбора jQuery для всей таблицы.

Таблицы данных — Ядро

ajax

Пространство имен для методов Ajax

Таблицы данных — Ядро

ajax.json ()

Получить последние данные JSON, полученные из последнего запроса Ajax. DataTables сделал

DataTables — Core

ajax.params ()

Получить данные, отправленные DataTables на сервер в последнем запросе Ajax

Таблицы данных — Ядро

ajax.reload ()

Перезагрузить данные таблицы из источника данных Ajax

Таблицы данных — Ядро

ajax.url ()

Получить / установить URL-адрес, который DataTables использует для выборки данных Ajax

DataTables — Core

ajax.url (). load ()

Загрузить данные из вновь установленного URL источника данных

Таблицы данных — Ядро

прозрачный ()

Очистить таблицу от всех данных.

Таблицы данных — Ядро

данные ()

Получить данные для всей таблицы.

Таблицы данных — Ядро

уничтожить ()

Уничтожить таблицы данных в текущем контексте.

Таблицы данных — Ядро

draw ()

Перерисуйте таблицу.

Таблицы данных — Ядро

i18n ()

Поиск токена интернационализации.

Таблицы данных — Ядро

init ()

Получить параметры инициализации, используемые для таблицы.

Таблицы данных — Ядро

выкл. ()

Удаление событий таблицы.

Таблицы данных — Ядро

на ()

Приемник событий таблицы.

Таблицы данных — Ядро

один ()

Прослушайте событие таблицы один раз, а затем удалите его.

Таблицы данных — Ядро

заказать ()

Получить / установить порядок, примененный к таблице.

Таблицы данных — Ядро

заказ.фиксированная ()

Получить / установить фиксированный порядок, примененный к таблице.

DataTables — Core

order.listener ()

Добавить слушателя упорядочивания к элементу для заданного столбца.

Таблицы данных — Ядро

стр. ()

Получить / установить текущую страницу таблицы.

Таблицы данных — Ядро

стр.info ()

Получить пейджинговую информацию о таблице

Таблицы данных — Ядро

page.len ()

Получить / установить длину страницы таблицы.

Таблицы данных — Ядро

поиск ()

Поиск данных в таблице.

Таблицы данных — Ядро

настройки ()

Получить объект настройки таблицы

Таблицы данных — Ядро

состояние ()

Получить последнее сохраненное состояние таблицы

Таблицы данных — Ядро

состояние.прозрачный ()

Очистить сохраненное состояние таблицы.

DataTables — Core

state.loaded ()

Получить состояние таблицы, загруженной во время инициализации.

Таблицы данных — Ядро

state.save ()

Запуск сохранения состояния.

Таблицы данных — Ячейки

Ячейка ()

Выберите одну ячейку в таблице.

DataTables — Cells

cell (). Cache ()

Получить кэшированные данные DataTables для выбранной ячейки

DataTables — Cells

cell (). Data ()

Получить / установить данные для выбранной ячейки

DataTables — Cells

cell (). Index ()

Получить индексную информацию о выбранной ячейке

DataTables — Cells

cell ().недействительный ()

Сделать недействительными данные, содержащиеся в DataTables для выбранных ячеек

Таблицы данных — Ячейки

ячейка (). Узел ()

Получить элемент DOM для выбранной ячейки

DataTables — Cells

cell (). Render ()

Получить обработанные данные для ячейки

Таблицы данных — Ячейки

ячеек ()

Выберите несколько ячеек в таблице.

Таблицы данных — Ячейки

ячеек (). Cache ()

Получить кэшированные данные DataTables для выбранных ячеек

Таблицы данных — Ячейки

ячеек (). Data ()

Получить данные для выбранных ячеек

Таблицы данных — Ячейки

ячеек (). Каждые ()

Итерация по каждой выбранной ячейке с заданным контекстом функции соответствующей ячейкой.

Таблицы данных — Ячейки

ячеек (). Индексы ()

Получить индексную информацию о выбранных ячейках

Таблицы данных — Ячейки

ячеек (). Invalidate ()

Сделать недействительными данные, содержащиеся в DataTables для выбранных ячеек

Таблицы данных — Ячейки

ячеек (). Узлы ()

Получить элементы DOM для выбранных ячеек

Таблицы данных — Ячейки

ячеек ().render ()

Получить обработанные данные для набора ячеек

Таблицы данных — столбцы

столбец ()

Выберите один столбец в таблице.

Таблицы данных — столбцы

столбец (). Cache ()

Получить кэшированные данные DataTables для выбранного столбца.

Таблицы данных — столбцы

столбец ().данные ()

Получить данные для ячеек в выбранном столбце.

Таблицы данных — столбцы

столбец (). DataSrc ()

Получить свойство источника данных для выбранного столбца.

Таблицы данных — столбцы

столбец (). Нижний колонтитул ()

Получить узел нижнего колонтитула для выбранного столбца.

Таблицы данных — столбцы

столбец ().заголовок ()

Получить узел заголовка для выбранного столбца.

Таблицы данных — столбцы

столбец (). Index ()

Получить индекс выбранного столбца.

Таблицы данных — столбцы

столбец (). Узлов ()

Получить узлы ячеек для выбранного столбца.

Таблицы данных — столбцы

столбец ().заказ ()

Упорядочить таблицу по выбранному столбцу.

Таблицы данных — столбцы

столбец (). Search ()

Поиск данных в выбранном столбце.

Таблицы данных — столбцы

столбец (). Visible ()

Получить / установить видимость одного выбранного столбца.

Таблицы данных — столбцы

столбец.индекс ()

Преобразование между форматами индекса столбца

Таблицы данных — столбцы

столбцов ()

Выберите несколько столбцов в таблице.

Таблицы данных — столбцы

столбцов (). Cache ()

Получить кэшированные данные DataTables для выбранных столбцов.

Таблицы данных — столбцы

столбцов ().данные ()

Получить данные для ячеек в выбранных столбцах.

Таблицы данных — Столбцы

столбцов (). DataSrc ()

Получить свойство источника данных для выбранных столбцов.

Таблицы данных — столбцы

столбцов (). Каждые ()

Итерировать по каждому выбранному столбцу, задав контекст функции как соответствующий столбец.

Таблицы данных — столбцы

столбцов (). Нижний колонтитул ()

Получить узлы нижнего колонтитула для выбранных столбцов.

DataTables — Columns

columns (). Header ()

Получить узел заголовка для выбранных столбцов.

Таблицы данных — Столбцы

столбцов (). Индексы ()

Получить индексы выбранных столбцов.

Таблицы данных — столбцы

столбцов (). Узлов ()

Получить узлы ячеек для выбранных столбцов.

Таблицы данных — столбцы

столбцов (). Order ()

Упорядочить таблицу по выбранным столбцам.

Таблицы данных — Столбцы

столбцов (). Search ()

Поиск данных в выбранных столбцах.

Таблицы данных — столбцы

столбцов (). Visible ()

Получить / установить видимость выбранных столбцов.

Таблицы данных — столбцы

columns.adjust ()

Пересчитать ширину столбцов

Таблицы данных — строки

строка ()

Выберите одну строку из таблицы.

DataTables — Rows

row (). Cache ()

Получить кэшированные данные DataTables для выбранной строки.

DataTables — Rows

row (). Child

Пространство имен дочернего метода строки

DataTables — Rows

row (). Child ()

Получить / установить дочерние строки выбранной строки основной таблицы

DataTables — Rows

row ().ребенок (). скрыть ()

Скрыть дочерние строки после создания новых дочерних строк

DataTables — Rows

row (). Child (). Remove ()

Удалить дочерние строки для выбранной родительской строки

DataTables — Rows

row (). Child (). Show ()

Сделать видимыми вновь определенные дочерние строки

DataTables — Rows

row ().child.hide ()

Скрыть дочернюю строку (строки) родительской строки

DataTables — Rows

row (). Child.isShown ()

Проверить, видны ли дочерние строки родительской строки

DataTables — Rows

row (). Child.remove ()

Удалить дочерние строки для выбранной родительской строки

DataTables — Rows

row ().child.show ()

Сделать дочернюю строку (и) родительской строки видимой

DataTables — Rows

row (). Data ()

Получить / установить данные для выбранной строки.

DataTables — Rows

row (). Id ()

Получить идентификатор выбранной строки.

DataTables — Rows

row ().индекс ()

Получить индекс выбранной строки.

DataTables — Rows

row (). Invalidate ()

Сделать недействительными данные, содержащиеся в DataTables для выбранной строки

DataTables — Rows

row (). Node ()

Получить узел строки TR для выбранной строки.

DataTables — Rows

row ().удалить ()

Удалить выбранную строку из DataTable.

DataTables — Rows

row.add ()

Добавить новую строку в таблицу.

Таблицы данных — строки

строк ()

Выберите несколько строк в таблице.

Таблицы данных — строки

строк (). Cache ()

Получить кэшированные данные DataTables для выбранных строк.

DataTables — Rows

rows (). Data ()

Получить данные для выбранных строк.

Таблицы данных — строки

строк (). Каждые ()

Итерировать по каждой выбранной строке с заданным контекстом функции соответствующей строкой.

Таблицы данных — строки

строк (). Ids ()

Получить идентификаторы выбранных строк.

Таблицы данных — Строки

строк (). Индексы ()

Получить индексы выбранных строк.

Таблицы данных — Строки

строк (). Invalidate ()

Сделать недействительными данные, содержащиеся в DataTables для выбранных строк

Таблицы данных — строки

строк (). Узлов ()

Получить строку TR узлов для выбранных строк.

Таблицы данных — Строки

строк (). Remove ()

Удалить выбранные строки из DataTable.

DataTables — Rows

rows.add ()

Добавить несколько новых строк в таблицу.

Таблицы данных — Таблицы

таблица ()

Выбрать таблицу на основе селектора из контекста API

DataTables — Таблицы

table ().корпус ()

Получить узел tbody для таблицы в контексте API

Таблицы данных — Таблицы

table (). Container ()

Получить узел контейнера div для таблицы в контексте API

Таблицы данных — Таблицы

таблица (). Нижний колонтитул ()

Получить узел tfoot для таблицы в контексте API

DataTables — Таблицы

table ().заголовок ()

Получить узел thead для таблицы в контексте API

Таблицы данных — Таблицы

table (). Node ()

Получить узел таблицы для таблицы в контексте API

Таблицы данных — Таблицы

таблиц ()

Выбрать таблицы на основе селектора из контекста API

Таблицы данных — Таблицы

таблиц ().корпус ()

Получить узлы tbody для таблиц в контексте API

Таблицы данных — Таблицы

таблицы (). Контейнеры ()

Получить узлы контейнера div для таблиц в контексте API

Таблицы данных — Таблицы

таблицы (). Нижний колонтитул ()

Получить узлы tfoot для таблиц в контексте API

Таблицы данных — Таблицы

таблиц ().заголовок ()

Получить узлы thead для таблиц в контексте API

Таблицы данных — Таблицы

таблиц (). Узлов ()

Получить узлы таблицы для таблиц в контексте API

DataTables — Utility

любой ()

Определить, есть ли какие-либо записи в наборе результатов

DataTables — Утилита

concat ()

Объедините несколько экземпляров API, чтобы создать один новый экземпляр.

Таблицы данных — Утилита

count ()

Получить количество элементов, содержащихся в экземпляре API

Таблицы данных — Утилиты

каждый ()

Перебирать содержимое набора результатов API.

DataTables — Utility

eq ()

Сократите экземпляр Api до одного контекста и набора результатов.

Таблицы данных — Утилита

фильтр ()

Создайте новый экземпляр API со всеми элементами из набора результатов, которые проходят данный тест.

DataTables — Utility

flatten ()

Преобразование экземпляра API со структурой 2D-массива в структуру 1D-массива.

DataTables — Утилита

indexOf ()

Найдите первый экземпляр значения в наборе результатов экземпляра API.

DataTables — Утилита

итератор ()

Итерация по результирующему набору индексов таблицы, строки, столбца или ячейки

DataTables — Утилита

join ()

Объедините элементы в наборе результатов в строку.

DataTables — Утилита

lastIndexOf ()

Найдите последний экземпляр значения в наборе результатов экземпляра API.

Таблицы данных — Утилита

длина

Количество элементов в наборе результатов экземпляра API.

Таблицы данных — Утилита

карта ()

Создайте новый экземпляр API с набором результатов, определенным значениями, возвращаемыми функцией обратного вызова.

Таблицы данных — Утилита

pluck ()

Создайте новый экземпляр API со значением свойства из объектов в текущем наборе результатов.

Таблицы данных — Утилиты

pop ()

Удалить последний элемент из набора результатов экземпляра API.

DataTables — Утилита

push ()

Добавьте один или несколько элементов в конец набора результатов экземпляра API.

DataTables — Утилита

уменьшить ()

Примените функцию обратного вызова к аккумулятору и каждому элементу в наборе результатов Api (слева направо).

DataTables — Утилита

reduceRight ()

Примените функцию обратного вызова к аккумулятору и каждому элементу в наборе результатов Api (справа налево).

Таблицы данных — Утилиты

реверс ()

Обратный набор результатов экземпляра API.

Таблицы данных — Утилиты

смена ()

Удалить первый элемент из набора результатов экземпляра API.

Таблицы данных — Утилита

срез ()

Создайте независимую копию экземпляра API.

DataTables — Утилита

sort ()

Сортировка элементов набора результатов экземпляра API.

DataTables — Utility

splice ()

Измените содержимое набора результатов экземпляра Api, добавляя или удаляя элементы по мере необходимости.

DataTables — Утилиты

до $ ()

Преобразуйте экземпляр API в объект jQuery с объектами из набора результатов экземпляра в наборе результатов jQuery.

DataTables — Утилита

toArray ()

Создайте собственный объект массива Javascript из экземпляра API.

DataTables — Утилита

toJQuery ()

Преобразуйте экземпляр API в объект jQuery с объектами из набора результатов экземпляра в наборе результатов jQuery.

Таблицы данных — Утилита

уникальный ()

Создайте новый экземпляр API, содержащий только уникальные элементы из элементов в наборе результатов экземпляра.

DataTables — Utility

unshift ()

Добавьте один или несколько элементов в начало набора результатов экземпляра API.

Таблицы данных — статические

$.fn.dataTable.isDataTable ()

Проверить, является ли узел таблицы DataTable

DataTables — статический

$ .fn.dataTable.tables ()

Получить все таблицы данных на странице

Таблицы данных — статические

$ .fn.dataTable.util.escapeRegex ()

Экранировать специальные символы в строке регулярного выражения

Таблицы данных — статические

$.fn.dataTable.util.throttle ()

Регулировка вызовов метода для уменьшения частоты вызовов

DataTables — статический

$ .fn.dataTable.versionCheck ()

Функция проверки совместимости номера версии

AutoFill

autoFill (). Disable ()

Отключить взаимодействие автозаполнения

Автозаполнение

Автозаполнение ().включить ()

Включение или отключение взаимодействия автозаполнения

Автозаполнение

автозаполнение (). Включено ()

Определить, включено ли автозаполнение

Кнопки

$ .fn.dataTable.fileSave ()

Сохранить файл, созданный на стороне клиента

Кнопки

кнопка ()

Выберите одну кнопку

Кнопки

кнопка ().действие ()

Получить / установить функцию действия для выбранной кнопки

Кнопки

кнопка (). Active ()

Получить / установить активное состояние выбранной кнопки

Кнопки

кнопка (). Добавить ()

Создайте новую кнопку и добавьте ее в документ

Кнопки

кнопка ().отключить ()

Отключить выбранную кнопку

Кнопки

кнопка (). Enable ()

Включение / отключение выбранной кнопки

Кнопки

кнопка (). Узел ()

Получить узел кнопки для выбранной кнопки

Кнопки

кнопка (). Popover ()

Показать всплывающее окно для кнопки, позволяющее вводить дополнительный пользовательский ввод

Кнопки

кнопка ().обработка ()

Получить / установить состояние обработки для кнопки

Кнопки

кнопка (). Remove ()

Удалить и удалить выбранную кнопку

Кнопки

кнопка (). Текст ()

Получить / установить текст для выбранной кнопки

Кнопки

кнопка (). Триггер ()

Запуск действия выбранной кнопки

Кнопки

кнопок ()

Выберите одну или несколько кнопок

Кнопки

кнопок ().действие ()

Получить / установить функции действий для выбранных кнопок

Кнопки

кнопок (). Active ()

Установить активное состояние для выбранных кнопок

Кнопки

кнопок (). Контейнер ()

Получить элемент контейнера для одного экземпляра Buttons

Кнопки

кнопок ().контейнеры ()

Получить элементы контейнера для одного или нескольких экземпляров кнопки

Кнопки

кнопок (). Destroy ()

Уничтожить один или несколько экземпляров кнопки и удалить из документа

Кнопки

кнопок (). Disable ()

Отключить выбранные кнопки

Кнопки

кнопок ().включить ()

Включение / отключение выбранных кнопок

Кнопки

кнопок (). Узлов ()

Получить узлы кнопок для выбранных кнопок

Кнопки

кнопок (). Обработка ()

Установить состояние обработки для нескольких кнопок

Кнопки

кнопок ().удалить ()

Удалить и удалить выбранные кнопки

Кнопки

кнопок (). Текст ()

Получить / установить текст для выбранных кнопок

Кнопки

кнопок (). Триггер ()

Запуск действия выбранных кнопок

Кнопки

кнопок.exportData ()

Получить данные из DataTable, которые подходят для экспорта

Кнопки

кнопок.exportInfo ()

Получение метаинформации об экспорте, которая является общей для многих различных типов кнопок

Кнопки

buttons.info ()

Отображение и скрытие информации для конечного пользователя в модальном окне

Кнопки

кнопок. Размер ()

Изменение размера всех кнопок Flash после того, как таблица стала видимой

ColReorder

colReorder.отключить ()

Отключить взаимодействие ColReorder

ColReorder

colReorder.enable ()

Включение или отключение взаимодействия ColReorder

ColReorder

colReorder.move ()

Программное перемещение столбцов

ColReorder

colReorder.order ()

Получить / установить порядок столбцов

ColReorder

colReorder.сброс ()

Восстановить порядок загруженных столбцов

ColReorder

colReorder.transpose ()

Преобразование одного или нескольких индексов столбцов в текущий и исходный индексы и обратно

FixedColumns

ячейка (). FixedNode ()

Получить узел ячейки с фиксированным столбцом для ячейки

FixedColumns

ячеек ().fixedNodes ()

Получить узлы ячеек с фиксированным столбцом для нескольких ячеек

FixedColumns

fixedColumns ()

Пространство имен для методов FixedColumns

FixedColumns

fixedColumns (). CellIndex ()

Получить индекс ячейки в фиксированном столбце

FixedColumns

fixedColumns ().реле ()

Перерисовать фиксированные столбцы в соответствии с новым размером таблицы

FixedColumns

fixedColumns (). RowIndex ()

Получить индекс строки в фиксированном столбце

FixedColumns

fixedColumns (). Update ()

Обновление данных, отображаемых в FixedColumns

FixedColumns

строк ().recalcHeight ()

Пересчитать высоту одной или нескольких строк после изменения данных

FixedHeader

fixedHeader.adjust ()

Пересчитать положение таблицы и перерисовать фиксированные элементы

FixedHeader

fixedHeader.disable ()

Отключить неподвижные элементы

FixedHeader

fixedHeader.включить ()

Включение / отключение фиксированных элементов

FixedHeader

fixedHeader.enabled ()

Получить текущий включенный статус

FixedHeader

fixedHeader.footerOffset ()

Получить / установить смещение фиксированного нижнего колонтитула

FixedHeader

fixedHeader.headerOffset ()

Получить / установить фиксированное смещение заголовка

KeyTable

ячейка ().фокус ()

Фокус на ячейке

KeyTable

cell.blur ()

Размытие в фокусе из таблицы

KeyTable

keys.disable ()

Отключить взаимодействие KeyTable (мышь и клавиатура)

KeyTable

keys.enable ()

Включение или отключение взаимодействия KeyTable (мышь и клавиатура)

KeyTable

ключей.включен ()

Определить состояние включения KeyTable для таблицы

KeyTable

keys.move ()

Переместить фокус на соседнюю ячейку

Адаптивный

столбец (). ResponseiveHidden ()

Получить состояние видимости столбца в таблице

Адаптивный

столбцов ().responseiveHidden ()

Получить состояние видимости столбцов в таблице

Адаптивный

Адаптивный.hasHidden ()

Определить, не скрыл ли Responsive какие-либо столбцы в таблице

Адаптивный

responseive.index ()

Получить индекс ячейки из элемента сведений li

Адаптивный

Адаптивный.перестроить ()

Пересчитать контрольные точки столбца на основе информации о классе ячеек заголовка столбца

Адаптивный

Адаптивный.recalc ()

Пересчитать ширину, используемую отзывчивым, после изменения дисплея

RowGroup

rowGroup (). DataSrc ()

Получить / установить источник данных для группы строк

RowGroup

rowGroup ().отключить ()

Отключить взаимодействие RowGroup с таблицей

RowGroup

rowGroup (). Enable ()

Включение или отключение взаимодействия RowGroup с таблицей

RowGroup

rowGroup (). Enabled ()

Определить, включена ли RowGroup для таблицы

RowReorder

rowReorder.отключить ()

Отключить возможность пользователя изменять порядок строк.

RowReorder

rowReorder.enable ()

Включение / отключение возможности пользователя изменять порядок строк.

Скроллер

row (). ScrollTo ()

Прокрутка до определенной строки

Скроллер

scroller.measure ()

Пересчитать кэшированные измерения, которые использует Scroller

Скроллер

Скроллер.страница ()

Получить информацию о строках, которые отображаются в данный момент

Скроллер

scroller.toPosition ()

Прокрутка к определенному индексу отображения строки

SearchBuilder

searchBuilder.container ()

Возвращает узел контейнера SearchBuilder.

SearchBuilder

searchBuilder.getDetails ()

Получить подробную информацию о текущих настройках поиска

SearchBuilder

searchBuilder.rebuild ()

Восстановить поиск до заданного состояния

SearchPanes

searchPanes.clearSelections ()

Удаляет выбор на всех панелях

SearchPanes

searchPanes.контейнер ()

Возвращает узел контейнера панелей.

SearchPanes

searchPanes.rebuildPane ()

Восстановите панель, собрав параметры из таблицы.

SearchPanes

searchPanes.resizePanes ()

Измените размер всех панелей, чтобы соответствующим образом заполнить контейнер SearchPanes.

Выберите ячейку

().отменить выбор ()

Отменить выделение отдельной ячейки

Выберите

ячейку (). Select ()

Выбрать одну ячейку

Выберите

ячеек (). Deselect ()

Отменить выбор ячеек

Выберите

ячеек (). Select ()

Выбрать ячейки

Выберите столбец

().отменить выбор ()

Отменить выбор одного столбца

Выберите

столбец (). Select ()

Выберите одну колонку

Выберите

столбцов (). Deselect ()

Отменить выбор столбцов

Выберите

столбцов (). Select ()

Выбрать столбцы

Выберите

строку ().отменить выбор ()

Отменить выделение одной строки

Выберите

ряд (). Select ()

Выберите одну строку

Выбрать

строк (). Отменить выбор ()

Отменить выбор строк

Выберите

строк (). Select ()

Выбрать строки

Выбрать

Выбрать ()

Инициализация Выбрать вне конструктора

Выбрать

Выбрать.blurable ()

Получить / установить голубое состояние опций выбора элементов таблицы

Выбрать

select.info ()

Получить / установить состояние отображения сводной информации

Выбрать

select.items ()

Получить / установить элементы, которые Select будет выбирать на основе взаимодействия с пользователем (строки, столбцы или ячейки)

Выбрать

Выбрать.селектор ()

Получить / установить селектор элементов для захвата событий мыши

Выбрать

select.style ()

Получить / установить стиль, с помощью которого конечный пользователь может выбирать элементы в таблице

Выбрать

select.toggleable ()

Получить / установить поведение, если элементы могут быть отменены при щелчке по выбранному элементу на

ряд ()

Начиная с: DataTables 1.10

Выберите несколько строк в таблице.

Описание

Работа со строками является фундаментальной частью DataTables, и вы хотите иметь возможность легко выбирать нужные строки из таблицы. Этот метод является строковым аналогом методов columns () и cells () для работы со столбцами и ячейками в таблице соответственно. Используя селектор и опцию селектор-модификатор , строки в таблице могут быть получены с помощью собственных связанных методов этого метода, обеспечивающих возможность получать данные из строк, узлов строк и, среди прочего, аннулировать данные.

В то время как этот метод rows () обеспечивает доступ к нескольким строкам с помощью одного вызова, его единственный аналог row () используется для выбора и управления одной строкой за раз, что позволяет более точно контролировать усиление и использовать дополнительные методы, недоступные в множественный метод, такой как обновление данных и работа с дочерними строками.

У метода есть две формы, отражающие тот факт, что строки можно выбирать разными способами в зависимости от требований вашей реализации:

Типы

функциональные строки ([модификатор])

Описание:

Выбрать все строки

Параметры:
Возвращает:

Экземпляр DataTables API с выбранными строками

функциональные строки (rowSelector [, модификатор])

Описание:

Выбрать строки, найденные с помощью селектора строк

Параметры:
Возвращает:

Экземпляр DataTables API с выбранными строками в наборе результатов

Связанные

Следующие параметры напрямую связаны и также могут быть полезны при разработке приложений.

стол | BigQuery | Google Cloud

вид

строка

Тип идентификатора ресурса.

etag

строка

Только выход. Хеш этого ресурса.

id

строка

Только выход.Непрозрачный идентификатор, однозначно идентифицирующий таблицу.

selfLink

строка

Только выход. URL-адрес, который можно использовать для повторного доступа к этому ресурсу.

таблица Ссылка

объект ( TableReference )

Обязательно.Ссылка, описывающая идентификатор этой таблицы.

friendlyName

строка

Необязательно. Описательное имя для этой таблицы.

описание

строка

Необязательно.Удобное описание этой таблицы.

этикетки

карта (ключ: строка, значение: строка)

Ярлыки, связанные с этой таблицей. Вы можете использовать их для организации и группировки таблиц. Ключи и значения меток не могут быть длиннее 63 символов, могут содержать только строчные буквы, цифры, символы подчеркивания и дефисы. Допускаются международные символы.Значения метки необязательны. Ключи меток должны начинаться с буквы, и каждая метка в списке должна иметь разные ключи.

Объект, содержащий список из пар «ключ: значение» . Пример: {"name": "гаечный ключ", "масса": "1,3 кг", "count": "3"} .

схема

объект ( TableSchema )

[Необязательно] Описывает схему этой таблицы.

timePartitioning

объект ( TimePartitioning )

Если указано, настраивает разбиение по времени для этой таблицы.

диапазон Разбивка на разделы

объект ( RangePartitioning )

Если указано, настраивает разделение диапазонов для этой таблицы.

кластеризация

объект ( Кластеризация )

Спецификация кластеризации для таблицы. Должно быть указано с разбиением по времени, данные в таблице будут сначала разбиты на разделы, а затем кластеризованы.

requirePartitionFilter

логический

[Необязательно] Если задано значение true, запросы по этой таблице требуют указания фильтра раздела, который можно использовать для исключения раздела.

числоБайт

строка (формат Int64Value)

Только выход. Размер этой таблицы в байтах, исключая любые данные в буфере потоковой передачи.

numLongTermBytes

строка (формат Int64Value)

Только выход.Количество байтов в таблице, которые считаются «долгосрочным хранилищем».

число строк

строка (формат UInt64Value)

Только выход. Количество строк данных в этой таблице, исключая любые данные в буфере потоковой передачи.

Время создания

строка (формат int64)

Только выход.Время создания этой таблицы в миллисекундах с начала эпохи.

expirationTime

строка (формат Int64Value)

Необязательно. Время истечения срока действия этой таблицы в миллисекундах с начала эпохи. Если нет, таблица будет существовать бесконечно. Таблицы с истекшим сроком действия будут удалены, а их хранилище освобождено. Свойство defaultTableExpirationMs инкапсулирующего набора данных можно использовать для установки expirationTime по умолчанию для вновь созданных таблиц.

lastModifiedTime

строка (формат fixed64)

Только выход. Время последнего изменения этой таблицы в миллисекундах с начала эпохи.

тип

строка

Только выход.Описывает тип таблицы. Поддерживаются следующие значения: ТАБЛИЦА: обычная таблица BigQuery. ПРОСМОТР: виртуальная таблица, определенная SQL-запросом. ВНЕШНИЙ: таблица, которая ссылается на данные, хранящиеся во внешней системе хранения, такой как Google Cloud Storage. MATERIALIZED_VIEW: предварительно вычисленное представление, определенное запросом SQL. Значение по умолчанию — ТАБЛИЦА.

вид

объект ( ViewDefinition )

Необязательно.Определение представления.

материализованный Просмотр

объект ( MaterializedViewDefinition )

Необязательно. Определение материализованного представления.

externalDataConfiguration

объект ( ExternalDataConfiguration )

Необязательно.Описывает формат данных, расположение и другие свойства таблицы, хранящейся вне BigQuery. После определения этих свойств к источнику данных можно будет запросить, как если бы это была стандартная таблица BigQuery.

местонахождение

строка

Только выход. Географическое положение, в котором находится таблица. Это значение наследуется от набора данных.

потоковый буфер

объект ( Streamingbuffer )

Только выход. Содержит информацию о буфере потоковой передачи этой таблицы, если таковой имеется. Это поле будет отсутствовать, если таблица не передается в поток или если в буфере потоковой передачи нет данных.

шифрование Конфигурация

объект ( EncryptionConfiguration )

Пользовательская конфигурация шифрования (например,g., ключи Cloud KMS).

снимок Определение

объект ( SnapshotDefinition )

Только выход. Содержит информацию о снимке. Это значение устанавливается при создании снимка.

Таблица API прослушивателя (Руководства по Java ™> Создание графического интерфейса пользователя с помощью JFC / Swing> Написание прослушивателей событий)

Учебники по Java были написаны для JDK 8.Примеры и методы, описанные на этой странице, не используют улучшений, представленных в более поздних версиях, и могут использовать технологии, которые больше не доступны.
Обзор обновленных языковых функций в Java SE 9 и последующих выпусках см. В разделе «Изменения языка Java».
См. Примечания к выпуску JDK для получения информации о новых функциях, улучшениях, а также удаленных или устаревших параметрах для всех выпусков JDK.

В следующей таблице в первом столбце указано имя интерфейса прослушивателя со ссылкой на страницу руководства, на которой обсуждается прослушиватель, или, если в руководстве не обсуждается прослушиватель, ссылка на документы API.Во втором столбце указывается соответствующий класс адаптера, если таковой имеется. (Для обсуждения использования адаптеров см. Использование адаптеров и внутренних классов для обработки событий.) В третьем столбце перечислены методы, которые содержит интерфейс слушателя, и показан тип объекта события, переданного в метод. Обычно прослушиватель, адаптер и тип события имеют одинаковый префикс имени, но это не всегда так.

Чтобы узнать, какие компоненты Swing могут запускать какие типы событий, см. Слушатели, поддерживаемые компонентами Swing.

+

mouseDisplay (MouseEvent)
93

MouseD MouseAdapter (MouseEvent)

9 WindowEvent

7

9 WindowEvent

Интерфейс слушателя Адаптер класса Методы слушателя
ActionListener нет выполнено действие (ActionEvent)
AncestorListener нет ancestorAdded (AncestorEvent)
ancestorMoved (AncestorEvent)
ancestorRemoved (AncestorEvent)
CaretListener нет caretUpdate (CaretEvent)
CellEditorListener нет редактирование остановлено (ChangeEvent)
редактирование отменено (ChangeEvent)
ChangeListener нет stateChanged (ChangeEvent)
ComponentListener Адаптер для компонентов componentHidden (ComponentEvent)
componentMoved (ComponentEvent)
componentResized (ComponentEvent)
componentShown (ComponentEvent)
ContainerListener Контейнер Адаптер componentAdded (ContainerEvent)
componentRemoved (ContainerEvent)
DocumentListener нет changedUpdate (DocumentEvent)
insertUpdate (DocumentEvent)
removeUpdate (DocumentEvent)
ExceptionListener нет exceptionThrown (Исключение)
FocusListener Фокус адаптер focusGained (FocusEvent)
focusLost (FocusEvent)
HierarchyBoundsListener HierarchyBoundsAdapter ancestorMoved (HierarchyEvent)
ancestorResized (HierarchyEvent)
HierarchyListener нет hierarchyChanged (HierarchyEvent)
HyperlinkListener нет HyperlinkUpdate (HyperlinkEvent)
InputMethodListener нет caretPositionChanged (InputMethodEvent)
inputMethodTextChanged (InputMethodEvent)
InternalFrameListener Внутренний адаптер рамки internalFrameActivated (InternalFrameEvent)
internalFrameClosed (InternalFrameEvent)
internalFrameClosing (InternalFrameEvent)
internalFrameDeactivated (InternalFrameEvent)
internalFrameDeiconified (InternalFrameEvent)
internalFrameIconified (InternalFrameEvent)
internalFrameOpened (InternalFrameEvent)
ItemListener нет itemStateChanged (ItemEvent)
KeyListener KeyAdapter keyPressed (KeyEvent)
keyReleased (KeyEvent)
keyTyped (KeyEvent)
ListDataListener нет contentsChanged (ListDataEvent)
intervalAdded (ListDataEvent)
intervalRemoved (ListDataEvent)
ListSelectionListener нет valueChanged (ListSelectionEvent)
MenuDragMouseListener нет menuDragMouseDragged (MenuDragMouseEvent)
menuDragMouseEntered (MenuDragMouseEvent)
menuDragMouseExited (MenuDragMouseEvent)
menuDragMouseReleased (MenuDragMouseReleased)
MenuKeyListener нет menuKeyPressed (MenuKeyEvent)
menuKeyReleased (MenuKeyEvent)
menuKeyTyped (MenuKeyEvent)
MenuListener нет menuCanceled (MenuEvent)
menuDeselected (MenuEvent)
menuSelected (MenuEvent)
MouseInputListener (расширяет MouseListener и MouseMotionListener MouseInputAdapter
MouseAdapter
mouseClicked (MouseEvent)
mouseEntered (MouseEvent)
mouseExited (MouseEvent)
mousePressed (MouseEvent)
mouseReleased (MouseEvent)
93
MouseListener MouseAdapter , MouseInputAdapter mouseClicked (MouseEvent)
mouseEntered (MouseEvent)
mouseExited (MouseEvent)
mousePressed (MouseEvent)
mouseReleased (MouseEvent)
MouseMotionListener MouseMotionAdapter , MouseInputAdapter mouseDragged (MouseEvent)
mouseMoved (MouseEvent)
MouseWheelListener MouseAdapter mouseWheelMoved (MouseWheelEvent)
MouseAdapter
PopupMenuListener нет popupMenuCanceled (PopupMenuEvent)
popupMenuWillBecomeInvisible (PopupMenuEvent)
popupMenuWillBecomeVisible (PopupMenuEvent)
PropertyChangeListener нет propertyChange (PropertyChangeEvent)
TableColumnModelListener нет columnAdded (TableColumnModelEvent)
columnMoved (TableColumnModelEvent)
columnRemoved (TableColumnModelEvent)
columnMarginChanged (ChangeEvent)

79 9SelectionChanged (Список изменений)

79

TableModelListener нет tableChanged (TableModelEvent)
TreeExpansionListener нет treeCollapsed (TreeExpansionEvent)
treeExpanded (TreeExpansionEvent)
TreeModelListener нет treeNodesChanged (TreeModelEvent)
treeNodesInserted (TreeModelEvent)
treeNodesRemoved (TreeModelEvent)
treeStructureChanged (TreeModelEvent)
TreeSelectionListener нет valueChanged (TreeSelectionEvent)
TreeWillExpandListener нет treeWillCollapse (TreeExpansionEvent)
treeWillExpand (TreeExpansionEvent)
UndoableEditListener нет undoableEditHappened (UndoableEditEvent)
VetoableChangeListener нет vetoableChange (PropertyChangeEvent)
WindowFocusListener Оконный адаптер windowGainedFocus (WindowEvent)
windowLostFocus (WindowEvent)
WindowListener Оконный адаптер windowActivated (WindowEvent)
windowClosed (WindowEvent)
windowClosing (WindowEvent)
windowDeactivated (WindowEvent)
windowDeconified (WindowEvent)

7

WindowStateListener Оконный адаптер windowStateChanged (WindowEvent)

neelpatel05 / period-table-api: API для извлечения элементов периодической таблицы в формате JSON.Использует Pandas для сброса данных .csv в .json и Flask для интеграции API. Развернут на pythonanywhere.com.

API для получения элементов периодической таблицы в формате JSON. Использует Pandas для сброса данных .csv в .json и Flask для интеграции API. Развернут на pythonanywhere.com.
Ознакомьтесь со следующим репозиторием period-table-api-go, написанным на golang для быстрой работы API

Обзор

В следующем документе будет указано, как использовать API для получения периодических элементов в JSON.Также в нем будут указаны различные методы, с помощью которых можно получить элементы.

Объект данных
символ
наименование
атомная масса
атомный номер
atomicRadius
Точка кипения
склеивание Тип
cpkHexColor
плотность
электронАффинити
электроотрицательность
электронная конфигурация
группа Блок
ionRadius
ионизация Энергия
Точка плавления
состояния окисления
стандартное состояние
vanDerWaalsRadius
год Открыто

Методы

Всего существует 6 методов, с помощью которых вы можете получить данные:

Все

Это извлечет все 118 элементов из периодической таблицы.

Атомный номер

Будет извлечен элемент из периодической таблицы с атомным номером 20. Замените 20 любым другим атомным номером, чтобы получить этот элемент из 118.

Атомное имя

Будет извлечен элемент из периодической таблицы, имеющий атомное имя "Меркурий". Замените «Меркурий» любым другим атомным именем, чтобы получить этот элемент.

Атомный символ

Будет извлечен элемент из периодической таблицы, имеющий атомный символ "H", то есть водород. Замените "H" любым другим атомарным символом, чтобы получить этот элемент.

Тип соединения

Это приведет к извлечению всех элементов из таблицы Менделеева, имеющих металлическую связь. Замените металлический на любой другой тип склеивания для извлечения элементов.

Групповой блок

Это извлечет все элементы из таблицы Менделеева, принадлежащие к группе металлов. Для извлечения элементов замените металл любым другим типом соединения.

Государство

Это извлечет все элементы из таблицы Менделеева, принадлежащие газу. Замените газ любым другим состоянием для извлечения элементов.

ТАБЛИЦЫ

Все приведенные ниже примеры включают набор данных Mergent Global Fundamentals, в частности, таблицу MER / F1. Эта конкретная таблица фильтруется по нескольким столбцам, включая compnumber , mapcode и reportdate . Это означает, что пользователи могут сузить свой запрос до строк с конкретными значениями для этих (и всех доступных) фильтров.

📘

ПРИМЕЧАНИЕ:

API таблиц ограничен 10 000 строками на вызов.Однако при использовании библиотеки Python добавление аргумента paginate = True расширит ограничение до 1 000 000 строк. Таким образом, мы рекомендуем использовать paginate = True для всех вызовов. Обратите внимание, что некоторые наборы данных могут возвращать больше данных, чем позволяет Python. Если это произойдет, вам нужно будет дополнительно отфильтровать вызов, чтобы загрузить меньше данных, как показано в примерах ниже. Или вы можете рассмотреть возможность использования экспортера данных Quandl.

Можно загрузить только определенные требуемые строки из таблицы, указав один или несколько столбцов, которые будут служить критериями для фильтрации строк.Если значение в данном столбце соответствует аргументу фильтра, то возвращается строка, содержащая это значение.

Только столбцы, обозначенные как фильтруемые на странице документации таблицы, могут использоваться в качестве критериев для фильтрации строк.

Скачать данные для Nokia ( compnumber = 39102 )

Python

  data = quandl.get_table ('MER / F1', compnumber = "39102", paginate = True)
  

Загрузить данные для Nokia (номер = 39102 ) и Deutsche Bank AG (номер = 2438 )

Python

  data = quandl.get_table ('MER / F1', compnumber = ["39102", "2438"], paginate = True)
  

Можно выбрать определенные столбцы таблицы для загрузки, указав их с помощью параметра qopts.columns .

Скачать номер столбец

Python

  data = quandl.get_table ('MER / F1', qopts = {"columns": "compnumber"}, paginate = True)
  

Скачать номер и тикер столбцы

Python

  data = quandl.get_table ('MER / F1', qopts = {"columns": ["compnumber", "ticker"]}, paginate = True)
  

Загрузите столбец reportdate для Nokia ( compnumber = 39102 )

Python

  data = quandl.get_table ('MER / F1', compnumber = "39102", qopts = {"columns": "reportdate"}, paginate = True)
  

Загрузите reportdate , индикатор и количество столбцов для Nokia ( compnumber = 39102 )

Python

  data = quandl.get_table ('MER / F1', compnumber = "39102", qopts = {"columns": ["compnumber", "ticker"]}, paginate = True)
  

Загрузите цены закрытия для Apple (AAPL) и Microsoft (MSFT) за период с 01.01.2016 по 31.12.2016.

Python

  data = quandl.get_table ('WIKI / PRICES', qopts = {'columns': ['ticker', 'date', 'close']}, ticker = ['AAPL', 'MSFT'] , date = {'gte': '2016-01-01', 'lte': '2016-12-31'})
  

Для получения данных таблицы:

Python

  quandl.get_table ('MER / F1', paginate = True)
  

Это синтаксис для вызова всей таблицы. Хотя большинство таблиц можно загрузить с помощью такого вызова, размер MER / F1 требует, чтобы вы сузили свой запрос с помощью фильтров, как показано выше.

Обратите внимание, что этот вызов возвращает максимум 1 000 000 строк. Чтобы получить больше строк, вам нужно использовать функцию export_table :

Python

  quandl.export_table ('MER / F1')
  

Этот вызов сохранит данные в zip-файле с именем MER_F1.zip в свой рабочий каталог. Вы можете указать местоположение загруженного zip-файла, используя параметр filename :

Python

  quandl.export_table ('MER / F1', filename = '/ my / path / db.zip')
  

Вы также можете экспортировать подмножество данных, используя фильтруемые столбцы для фильтрации по строкам и параметр qopts для фильтрации по столбцам:

Python

  quandl.export_table ('ZACKS / FC', ticker = ['AAPL', 'MSFT'], per_end_date = {'gte': '2015-01-01'}, qopts = {'columns': ['тикер', 'per_end_date']})
  

В зависимости от размера таблицы создание zip-файла может занять некоторое время.Во время создания файла будет напечатано сообщение. После создания файла и завершения загрузки будет напечатан путь к загруженному zip-файлу.

SQL API - Создание таблиц

Создание таблиц с помощью SQL API

Запись данных в вашу учетную запись CARTO позволяет вам управлять данными с помощью SQL-запросов, она не подключает автоматически таблицы как наборы данных к Your datasets dashboard в CARTO.

Вы должны применить функцию CDB_CartodbfyTable к целевой таблице, чтобы создавать и отображать связанные наборы данных в вашей учетной записи. Этот дополнительный шаг «CARTOfying» данных представляет собой процесс преобразования произвольной таблицы PostgreSQL в действительную таблицу CARTO и ее регистрацию в системе, чтобы ее можно было использовать в графическом интерфейсе пользователя и в CARTO Engine для создания карт и анализ.

Создание таблиц

Чтобы создать видимую таблицу в CARTO, выполните следующий запрос SQL с помощью SQL API:

  
 1
2
3
4
5
6
7
 
 СОЗДАТЬ ТАБЛИЦУ {table_name}
 (
 {column1} {тип данных},
 {column2} {тип данных},
 {column3} {тип данных},
 ...
 );
 

Пока начинается процесс создания структуры таблицы, она все еще не отображается на вашей панели инструментов. Выполните следующий запрос, чтобы сделать таблицу видимой.

  
 1
 
 ВЫБРАТЬ cdb_cartodbfytable ({table_name});
 

Совет: Если вы принадлежите к организации, вы также должны указать имя пользователя как часть запроса.

  
 1
 
 ВЫБРАТЬ cdb_cartodbfytable ({username}, {table_name});
 

Вы получите ошибку Пожалуйста, установите квоту пользователя перед cartodbfying tables , если вы не укажете имя пользователя как часть запроса.

Таблица создается и добавляется как связанный набор данных в Your datasets dashboard. Обновите браузер, чтобы убедиться, что вы можете визуализировать это в своей учетной записи.Как только таблица подключена к Your datasets dashboard в CARTO, любые изменения, которые вы применяете к своим данным через SQL API, автоматически обновляются.

Переименовать таблицы

Чтобы переименовать связанный набор данных в Your datasets dashboard, выполните следующий запрос SQL с помощью SQL API:

  
 1
 
 ALTER TABLE {table_name} ПЕРЕИМЕНОВАТЬ на {renamed table_name};
 

Переименование подключенной таблицы может занять несколько секунд.Обновите страницу в браузере, чтобы убедиться, что вы можете визуализировать изменения на панели инструментов Your datasets .

Удалить стол

Если вы удалите таблицу, будут затронуты любые карты, использующие подключенный набор данных. . Удаленный набор данных не может быть восстановлен. Даже если вы создадите новую таблицу с тем же именем, что и удаленная, CARTO все равно усвоит ее как другую таблицу.

Некоторые пользователи и сторонние библиотеки обновляют данные из набора картографических данных, создавая в таблице DROP TABLE + CREATE TABLE + INSERT .Это повлияет на вашу карту, если вы не сделаете DROP TABLE + CREATE TABLE внутри транзакции . Но мы рекомендуем использовать TRUNCATE TABLE + INSERT .

Чтобы удалить связанный набор данных из панели мониторинга Your datasets , выполните следующий SQL-запрос с помощью SQL API:

  
 1
 
 DROP TABLE {table_name};
 

Это удаляет связанную таблицу из Your datasets приборной панели.Обновите браузер, чтобы убедиться, что подключенный набор данных был удален.

.

Related Post

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *